Zoho Subscriptions API changes for India GST

Zoho Subscriptions API changes for India GST

Zoho Subscriptions is now ready for India GST.

The information that you pass in our web application wrt India GST can also be passed/retrived through our API.

Here are the list of JSON nodes added to various entities. You can easily find these nodes with subtext as  Applicable for India GST in our API Documentation.

PLAN:
NODE DESCRIPTION TYPE  REQUIRED EXAMPLE
product_type The product type for plan can be either Goods or Service String Optional “goods"
hsn_or_sac HSN code or SAC for Goods or Service String Optional "00440452"
item_tax_preferences* Tax preferenece for plan list Optional refer below


ADDON:
NODE DESCRIPTION TYPE  REQUIRED EXAMPLE
product_type The product type for addon can be either Goods or Service String Optional “goods"
hsn_or_sac HSN code or SAC for Goods or Service  String  Optional "00440452"
item_tax_preferences* Tax preferenece for addon list Optional refer below

Example: item_tax_preference
"item_tax_preferences": [{
    "tax_specification": "intra",
    "tax_name": "Standard Rate(12)",
    "tax_percentage": 6.000000,
    "tax_id": "3000000002404"
}, {
    "tax_specification": "inter",
    "tax_name": "IGST",
    "tax_percentage": 18.000000,
    "tax_id": "3000000002408"
}]

If the item_tax_preference is not given for a plan/addon during its creation/updation, the default intra & inter tax specified in the organisation tax settings will taken as the tax preference for the plan/addon.

For the write action of item_tax_preferences using the HTTP methods POST and PUT, it is enough to pass tax_id and tax_specification while creation/updation of plan/addon.  

INVOICES:

The following nodes will be available in each line item for the invoice entity.

NODE DESCRIPTION TYPE  REQUIRED EXAMPLE
product_type Product type can be either Goods or Service String NA “goods"
hsn_or_sac HSN code or SAC for Goods or Service  String NA "74191010"

CUSTOMERS:
NODE DESCRIPTION TYPE REQUIRED EXAMPLE
gst_treatment
GST Treatment for the customer.
Possible values: business_gst - For a GST Registered business owner,
business_none For a GST unregistered business owner ,
consumer - For a individual consumer
overseas
- deliver your goods or services for customers outside India
String optional "business_gst"
gst_no GSTIN for the customer. String optional "33AIRCA1234A1Z5"
place_of_contact Customer's place of contact. (State code according to Indian Census 2011) String optional "TN"
NOTE: 
  • If place_of_contact is empty, the state of the organization is taken as the default value.

SUBSCRIPTIONS :
NODE DESCRIPTION TYPE  REQUIRED EXAMPLE
place_of_supply Place of Supply for the customer' subscription
(State code according to Indian Census 2011)
String Optional “TN"
NOTE: 
  • If place_of_supply is empty, the state of the organisation is taken as the default value.

Node: item_tax_preferences*
NODE DESCRIPTION TYPE  REQUIRED EXAMPLE
tax_id Tax ID to which you would like to associate with this plan/addon. String Required  "903000000065300"
tax_name Name of the tax to which subscription is associated. String Optional “IGST"
tax_percentage Percentage of tax applied to the plan/addon number Optional 12
tax_specification Tax specification for the addon. It can be either intra or inter. String Required “inter"

If you have any queries related to migration or using these APIs. Please comment here or write to us at support@zohosubscriptions.com


    • Sticky Posts

    • Introducing Invoice Consolidation for Offline Subscriptions

      Hello Folks, Glad to announce the feature of Invoice Consolidation for Offline Subscriptions. If you are having multiple subscriptions for your customers, now, you can send a single consolidated invoice for all the Offline Subscriptions that are getting renewed on the same date. Advantage?  Customers will be receiving single invoice instead of multiple invoices upon renewal. Also reduces your efforts in follow-up with your customers for payment collections. For Example: If Customer has Subscription
    • New feature: Create back-dated subscriptions

      Hello from the Zoho Subscriptions team. :)   We’re happy to announce that today marks the launch of a much-awaited feature: creating back-dated subscriptions!   From here on out, whenever you create a new subscription with an activation date that is earlier than the present date, you’ll no longer get an error. Instead, you'll be creating a back-dated subscription. This means that the subscription started at that earlier point in time. The next billing date will be calculated automatically based on
    • Announcement Regarding Notification Emails

      Hello Everyone! This announcement is regarding the admin notification emails which you've been receiving from the email address "support@zohosubscriptions.com". From the 1st of October, 06:00 GMT, the emails with the following subjects will be sent from "no-reply@zohosubscriptions.com". Unable to send invoice for the profile - {profile_name} Unable to process auto payments. If you have set up any filters or workflow in your email account, please add "no-reply@zohosubscriptions.com” and  “support@zohosubscriptions.com”
    • Zoho Subscriptions plugin for WordPress

      Zoho Subscriptions plugin for WordPress allows you to easily embed your plan specific checkout page in an iframe with just a few mouse clicks and without a single line of code. How can WordPress Zoho Subscriptions Plugin boost your productivity? It's now easier to embed Zoho Subscriptions checkout page in your WordPress site. Forget the old method of logging in to Zoho Subscriptions, copying a URL and scripting to make adjustments. All this can be done automatically through this plugin. A great time
    • Indian GST organisation Migration Guide

      With respect to the new GST regime releasing on July 1, 2017in India, Zoho Subscriptions Indian edition is also gearing up to make your business GST Ready. This article focuses on how to get your existing organisation in Zoho Subscriptions to migrate to the new GST regime.    Note:  Any organisation created on or after July 1, 2017 will already be GST ready. You wouldn't have to migrate your organisation. Migrating your existing organisation to support GST To migrate your existing organisation to
      • Recent Topics

      • Schedule Zoho CRM reports only on Business Days

        Hello, Is it possible to schedule reports only on business days ? We currently get daily sales reports on weekend which has no value since the sales team doesn't work on weekends. Thanks
      • How to install Widget in inventory module

        Hi, I am trying to install a app into Sales Order Module related list, however there is no button allow me to do that. May I ask how to install widget to inventory module related list?
      • Cannot see Application from Lookup field

        Hi all, I am trying to access data for an application on our account via a lookup field; however, the application doesn't appear in the dropdown at all. Can anyone shed any light on this, please? I have asked Zoho support; however, they're just as confused,
      • How to track a contact or customer's past product purchases in Bigin Premiere?

        Hello there. I am the sole user of Bigin for a small company (chess club), and would like to track current and past purchases made by a contact (player) or company (family which includes the player). Players may register for multiple tournaments, take
      • LENTITUD EN RECIBIR MAIL

        Buenas tardes, Estamos experimentando lentitud en la recepción de correos electrónicos.
      • Items should display under specific warehouse

        I have configured the multi warehouse but it show all the items under all warehouse which is not correct according to our business logic, so i want that items should only display under that specific warehouse not under all the warehouses not even with zero quantity. Some items should be common but not all so is there any option for that purpose so i can specific the items to its warehouse. Regards
      • Partial refunds

        I am trying to process refund for a one item invoice, however the refund is partial: i am getting this error while creating credit note, can anyone share some wisdom about this
      • Best practice importing items and matching assemblies

        Hi, I was wondering what would be the best practice to import items and composite items (assemblies) From my backup, what should I import first? The items or the composite items? I am on Zoho one, using inventory and books. Kind regards, Sabine
      • Bulk Fill In & Edit PO/Bill/SO/Invoice

        Hello, I am adding stock in bulk on a PO, the system is automatically populating the Rate (price) and Tax from the item data. Problem is that the bill rate is different from the rate on the item data, so I have to manually erase each and enter the price.
      • Separate Items & Services

        Hi, please separate items and services into different categories. Thank you
      • Items Below Reorder Point Report?

        Is there a way to run a report of Items that are below the Reorder Point? I don't see this as a specific report, nor can I figure out how to customize any of the other stock reports to give me this information. Please tell me I'm missing something s
      • Allocating inventory to specific SO's

        Is there a way that allocate inventory to a specific sales order? For example, let's say we have 90 items in stock. Customer 1 orders 100 items. This allocates all 90 items to their order, and they have a back order for the remaining 10 items which could
      • Cancelled Transfer order problem

        Hello, We've canceled a transfer order, and we can't add the related items to a new Transfer Order. The system tells us that the bin doesn't have the required quantity, but when we check the item, it indicates that there are 2 units in the bin. It also
      • Creating a Chart from a Report

        In Zoho Analytics, is it possible to create a chart from a Pivot View report? We are looking to use Zoho Analytics to replace Excel for Sales reports and would like to be able to show both the table and the chart together.
      • Client Portal ZOHO ONE

        Dear Zoho one is fantastic option for companies but it seems to me that it is still an aggregation of aps let me explain I have zoho books with client portal so client access their invoice then I have zoho project with client portal so they can access their project but not their invoice without another URL another LOGIN Are you planning in creating a beautiful UI portal for client so we can control access to client in one location to multiple aps at least unify project and invoice aps that would
      • Email Insights included in Bigin emals are marked as SPAM everywhere

        Today I noticed that email recipients who use Office 365 never receive emails sent from Bigin. Further examination showed that all Email Insights links in email headers are marked as spam/phishing by Office 365. Example screen included. The problem is
      • Data Import | Zoho Analytics Custom Query Window Size

        Please increase the window size for the Custom Query Data Import. It's impossible to work with such a small query window.
      • Name changed in settings for mailbox but still not changed when typed in To field

        In the email account secretary@ i have updaetd the new staff members details but the old members name still appears when I type secretary@ in the To field. I cant work out where Zoho is finding the old name from. I have deleted the browser cache. If I
      • Cannot add my name to my domain name

        I want to have My name@mydomain.com and it says my name is linked to another account already. Please fix it since I do not have another account.
      • Invoice status on write-off is "Paid" - how do I change this to "Written off"

        HI guys, I want to write off a couple of outstanding invoices, but when I do this, the status of the invoices shows as "Paid". Clearly this is not the case and I need to be able to see that they are written off in the customer's history. Is there a way
      • Establishing new Zoho email account on laptop

        Good Morning: I am very long time Outlook business user and decided to try your email service last night and had established an account. I am trying to verify my account; how do I establish my Zoho email account on my laptop? I opened the account with
      • unable to send message reason 550 5.4.6 unusual sending activity

        My email account can't send message. It shows unable to send message reason 550 5.4.6 unusual sending activity detected
      • how to add email to existing organization i w

        I am already registered my organization and i have an email id. I need one more email id but i can't find anywhere .i want the cheapest email id . how to add ?
      • e-mail bloqueado

        Estou com meu e-mail lucas@peplus.me bloqueado, preciso desbloquear para retorno de usos em minhas atividades.
      • zoho labels api not working

        We're using n8n to automte email reply using zoho api. I'm facing issue with label api. I added the required scopes but its not working. i followed zoho api documentation but didn't work. also, where do i find/how do i create zoho oauth token mentioneeed
      • Desk DMARC forwarding failure for some senders

        I am not receiving important emails into Desk, because of DMARC errors. Here's what's happening: 1. email is sent from customer e.g. john@doe.com, to my email address, e.g info@acme.com 2. email is delivered successfully to info@acme.com (a shared inbox
      • Streams/Shared email doesn't show up in windows trident app. It works fine on MAC. Is there any difference between 2 install ?

        I can see streams/share email boxs on my MAC version of trident app but i can't see them in windows version of trident app. Is there any difference between 2 install? I try to find setting but not able to see any setting to add stream/share email boxes.
      • add zoho account

        How to add a zoho mail to previous zoho account? I have two
      • Zoho Desk Mobile App Year-End Roundup - 2025

        Dear Zoho Desk users, Greetings! As you gear up for the festive season, we are excited to share a quick journey into all that is released in 2025! Zia's generative AI capabilities Zia insights can be highly beneficial in helping agents manage daily support
      • Narrative 17: The role of Zia AI in customer support

        Behind the scenes of a successful ticketing system: BTS Series Narrative 17: The role of Zia AI in customer support Overview Zia in Zoho Desk is a layered AI assistant that combines generative AI, prediction, and automation to support agents, automate
      • Domain Transaction

        I have purchased a domain name called trainedworkforce.co.in I made the payment got the receipt but the domain is still not purchased after successful transaction .
      • Ability to Set a Unified Tab Order/View for All Users in Zoho Projects

        Hello Zoho Projects Team, We hope you are doing well. We would like to submit a feature request regarding tab/menu organization in Zoho Projects. Current Behavior: The tab (module) order in Zoho Projects is user-specific. Each user (internal or external)
      • Zohomail - The "All Messages" vs "In Box"

        Why do some new email message appear under the all messages view but not in my inbox? That's really annoying but to be fair I've experienced the same with gmail.
      • error while listing mails

        I can't access email in any of my folders: Oops, an error occurred - retry produces the second error response: error while listing mails (cannot parse null string). I've signed in and out of Zoho, restarted my iMac.
      • Introducing the Zoho Projects Learning Space

        Every product has its learning curve, and sometimes having a guided path makes the learning experience smoother. With that goal, we introduce a dedicated learning space for Zoho Projects, a platform where you can explore lessons, learn at your own pace,
      • Where to show Customization Field ?

        Dear Sir, I have made some New Field in Item Field Customisation. Now I don't require that field in Estimate, Sales Orders etc. I just wants that field in Sales Invoice to Show/Hide... Is that possible ?
      • Zoho Desk 2025 round-up: Key highlights on feature releases

        Hello everyone, As we gear up for 2026, here is a detailed round-up of all feature releases in Zoho Desk web throughout the year. For consolidated information on releases check out the What’s New page You can also watch these webinars. Zia in web Zia
      • Print Sales Orders, Purchase Orders or Invoices from API

        Hello, Is it possible to use the print option that is available in Sales Orders Purchase Orders and Invoices with the API?. I don't see any information in the docs about this. Thanks
      • How to show a hided report??

        in CRM Report , I clicked Hide incidently , how to show the floder again? Nowhere I can find the hided report floder...
      • Converting Customer Invoice to Purchase Bill

        Hi, In my service-based business, I sometimes create the customer invoice first, and later I receive the purchase bill from the vendor for the same job. Is there any option in Zoho Books to: Convert a customer invoice into a purchase bill, or Link/associate
      • Next Page