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

      • Sales Receipts Duplicating when I run reports why and how do we rectify this and any other report if this happens

        find attached extract of my report
      • No Functional Autosave or Manual Save Button

        Application : Zoho Notebook So I wanted to try Zoho Notebook(On Ubuntu) as an application, I installed the application and went solving my LeetCode problems visually(Drawing mode), at one point the app just stopped saving anything... Every time I tried
      • Enterprise subscription support

        My organization sells subscription services to enterprise customers, which is a different model from the consumer subscription model that Zoho Billing has been designed to support and I beleve this capability should be added. An enterprise subscription
      • Issue with Creator's IF logic

        Hi, I found the following code produces unexpected results: if(-1.0 < 0.0000000) {       info "True"; } else {       info "False"; } if(-1.0 < 0.000000) {       info "True"; } else {       info "False"; } The output returned is: False True However, the
      • Need option to send Package PDF in shipment email (Shipment PDF is missing Lot info)

        Is there any way to automatically attach the Package PDF instead of (or alongside) the Shipment PDF in the notification emails? We really need this feature because the default Shipment PDF creates a blind spot for our customers. It does not display Batch/Lot
      • zoho creator view is not present in the workspace and blank reports

        Hi Support,  Users who have "write" permissions keep getting this error for all of our embedded reports all of a sudden. See screen shot below: Meanwhile, my developer permissions account sees a blank screen in view and edit mode as shown in the screenshots
      • Customize portal email template

        Can i fetch only first name of the user in portal email template instead of the below code Hi ${User.FULL_NAME}
      • Can't we let users decide which options they'd like to add at embed widget?

        It seems embed widget DOES NOT offer a feature, where users can choose options upon subscribing plans. What Zoho has instead, is that admins have to manually create plan with options. How come no one in Zoho dev team never raised issue about usability
      • Reupload and rename from one field to another field (file upload)

        Hi Everyone, Sorry, i have question to use invoke url for rename and reupload attachments file to another field. Tested on development mode. Zoho C6. Refer to https://www.zoho.com/creator/help/api/v2/upload-file.html look my error notification. Does anyone
      • Printing Multi-Page Reports (PDF Export)

        Hi, I am moving a report from Google's Looker Studio to Zoho Analytics and trying to reproduce the Looker page by page dashboard editing experience. With Google, what you see is what you get when you print to PDF. But I can't seem to create the same experience
      • I NEED TO NUMBER TO TEXT NO HERE

        =NUMBERTEXT NEEED
      • Error: View is not present in the workspace

        When saving a dashboard, user receives a popup with the following error. "View is not present in the workspace" What does this mean or refer to? There is no further insight given.
      • Dear Zoho CEO: Business Growth is about how you prioritise!

        All of us in business know that when you get your priorities right, your business grows. Zoho CRM and Zoho Books are excellent products, but sadly, Zoho Inventory continues to lag behind. Just this morning, I received yet another one-sided email about
      • Bin Locations

        Dear all, I am wondering if someone has the ability to develop the bin locations option for zoho inventory (integrated with zoho books) Regards, Ryan
      • Create and populate a record in an instant: Introducing zero-shot field prompting to Zia's ICR

        A couple of months ago, we upgraded our in-house AI image detection and validation tool, Zia Vision, with intelligent character recognition (ICR). By training Zia with sample images, you could create and enrich CRM records with data extracted from standard
      • How to Prevent Users From Skipping LMS Videos in Zoho People

        How to Prevent Users From Skipping LMS Videos in Zoho People Hello Zoho Developers, In this blog, we will quickly look at how you can stop users from skipping or fast-forwarding videos in Zoho People LMS. Zoho People provides a feature called Disable
      • [Integration Edition] Deluge Learning Series – Custom API with Deluge | November 2025

        We’re excited to conclude this four-month Integration Edition of the Deluge Learning Series: Session 1 – Integrating Zoho Apps with Deluge Using Built-In Integration Tasks Session 2 – Integrating Zoho Apps with Deluge Using invokeURL and invokeAPI Session
      • Tips for Organizing Workflows and Improving Team Coordination in Zoho

        Hi everyone, I’m looking for some general advice on how different teams are organizing their daily work within Zoho’s apps. Our team recently expanded, and we’re trying to streamline how tasks, discussions, and documents are shared so everything stays
      • Prevent user from viewing all records?

        I have a report that is meant to be used by vendors to view only the records that are assigned to them. All the vendor information is stored in a separate application, so I need to call a function to get the current user's ID (not the zoho user ID). The report settings criteria doesn't support using function calls, so instead I'm embedding the report in an html page like this: if (thisapp.Global.CurrentUserIs("Vendor")) {       personID = common.getLoggedInPersonID();       query = "Assigned_Vendor.ID="
      • Zoho Site pages not displaying in iframes

        I simply want to show a Zoho Site page inside an iframe on another non Zoho website. When testing this across many browsers, the iframe content simply does not appear. IE reports that the host does not allow their content to be displayed in iframes. Very disappointing. Is there a way around this please? Here is the URL of the page I would like to appear in an iframe. http://ips-properties-to-rent.zohosites.com
      • Zoho Inventory as connector in Zoho Creator

        Hello, It doesn't appear that Zoho Inventory is one of the many built in connectors in Zoho Creator? I see that there are non-Zoho inventory applications that have built in connectors such as Cin7, which leads me to believe that I'm missing something
      • Send Zoho Forms Link using Zoho CRM Email Templates

        I have set up Zoho Forms and CRM integration to pre-populate data from Zoho CRM to Zoho Forms. The setup is working fine. I have also created an email template in the Zoho CRM deals module to send Zoho forms links. So when I send an email using that template
      • My go to On Load Client Script - Fast, efficient, and works for ALL profiles; Hides everything except initial fields

        This is my on Load client script that I use for Create pages. I use a modified version for Edit and Display pages which you can create yourself using the same basic structure that I will give you below. First up, the script. Below that will be an explanation
      • Custom Search using HTM+CSS Snippet

        Suppose I wanted to create my own list view using HTML and CSS snippets inside a Page with a custom search input at the top of the list (not the Search snippet). Without Javascript, is there a way to retrieve a user's entry from that search input and
      • Zoho CRM Kiosk Upload Files

        Hello all, We are trying out Kiosks at the moment to see where it can fit best in our business. We are still a bit off in the application but lets say we will sort this out. My question is the following - when I create a Kiosk I can add "File Upload"
      • Double opt-in notifications and customizable confirmation messages for your webforms

        Dear CRM Community, We are excited to announce a major upgrade to our Webforms feature. You can now customize the confirmation message shown to your users who double opt-in from your webform and also customize your confirmation emails when they submit
      • Has Anyone successfully integrated Zoho and Sage Intact?

        Hey all, We’re evaluating Zoho One + Sage Intacct and I’m trying to connect with anyone who has actually implemented the two together.Specifically, I’d love to know: -- Which functions you kept in Zoho vs. Intacct (e.g., Product Catalog, AR/AP, invoicing,
      • Introducing Image Upload Field

        Hello everyone, In this post we will discuss about the benefits and usage of the Image upload field. The field is available for standard and custom modules.  Usage: This field can be used to upload a gallery of images to a record and share the record with peers or customers. The record can be made accessible to users outside of Zoho CRM via Portals, where they can upload the necessary images. Preview, editing, and deleting images: The uploaded images can be directly edited and saved from the record
      • Trigger a Workflow Function if an Attachment (Related List) has been added

        Hello, I have a Case Module with a related list which is Attachment. I want to trigger a workflow if I added an attachment. I've seen some topics about this in zoho community that was posted few months ago and based on the answers, there is no trigger
      • Free webinar alert on November 19 - Email driven strategies - Master personality based styles

        Hello Zoho Community! Want to make email management easier, smarter, and more you? We’ve got just the session for you! Join our interactive, game-based webinar to discover how Zoho Mail adapts to your personality and work style. Learn practical hacks,
      • AI generated meeting notes associated to Account or Deal

        As our organization works to improve efficiency we are looking for a solution to leverage AI to generate meeting notes and then add those notes to a CRM record such as an Account or Deal. I see Zoho has a Notebook AI offering that talks about the ability
      • due date on cheue

        how to handle cheque in zoho books for customers and vendors including due date
      • 'Statement of Accounts does not exist' error received, when creating PO using api in Zoho Inventory

        Here is request json -- JSONString = { "date": "2019-09-24", "purchaseorder_number": "PO-6-1", "delivery_date": null, "delivery_org_address_id": 36221200000056XXX, "vendor_id": 362212000000564XXX, "attention": "Testing", "line_items": [{ "unit": "Pieces", "account_id": 36221200000003XXX, "quantity": 1, "item_id": 362212000000049XXX, "tax_type": "", "tax_name": "", "name": "One HD", "purchase_rate": 85, "tax_percentage": 0, "item_total": 85.00, "tax_id": "", "warehouse_id": 362212000000564XXX }] }
      • Zoho Projects API 100 requests/2 min. Limit

        Hi Requesting clarification on the API documentation. "You can invoke or call an API for 100 times in a span of two minutes. If you invoke more than 100 times, the particular API request will be locked for the next 30 minutes. " Does this limit apply
      • Integrate your Outlook/ Office 365 inbox with Zoho CRM via Graph API

        Hello folks, In addition to the existing IMAP and POP options, you can now integrate your Outlook/Office 365 inbox with Zoho CRM via Graph API. Why did we add this option? Microsoft Graph API offers a single endpoint to access data from across Microsoft’s
      • Zoho Projects - Attachments added to Task and Bug emails are not saved

        Hi Projects team, I have been experimenting with emails into projects to create tasks and bugs. I have noticed that attachments added to the emails are not saved to the task or bug. Is this normal behaviour? Thanks, Ashley
      • Zoho Inventory's latest shipping integration updates at a glance.

        Hello Users, We would like to share some important news about our latest improvements in the Shipping integration capabilities of Zoho Inventory that we achieved in 2024 with some of our major integration partners in key editions across APAC, North America,
      • Sorting a list of record acquired from the zoho.crm.searchRecords function.

        This is something for which I'm trying to figure out a straightforward way to do. The searchRecords does a great job fetching me the records that I want. However, in some cases, where it returns multiple records, I want it to sort the returned list by date of creation of that record, so that when I do records.get(0), I get the most recent record.  As an example, here's my sample pseudo code: records = zoho.crm.searchRecords("Clients", "Office_Number:equals:123456"); Now the "records" list above contains
      • Zoho Inventory Custom Field Update

        Hello All, In this post I am describing how can we Update the Custom Field Value in Zoho Inventory. // Get Org ID orgid = organization.get("organization_id"); // Field Value resvp = ifnull(item.get("purchase_rate"),null); // Record ID iid = item.get("item_id");
      • Alphabetically

        How can i arrange alphabetically - (Manage Manufacturer) Field in Item Master 
      • Next Page