API documentation for GST ready features in Zoho Invoice

API documentation for GST ready features in Zoho Invoice

Hi All,

Zoho Invoice is now ready for India's new tax regime - the GST. All products of the Zoho Finance suite is now GST ready. And, not just that, our APIs are also ready for GST.

Here are some highlights about the information you would require to pass on while creating data in Zoho Invoice.

You canfind these nodes with the subtext  India Edition only in the  API Documentation.

Contacts :


Node Description Type Required Example
gst_treatment GST Treatment for the customer/vendor.
Possible values: 
business_gst - For a GST Registered business owner business_none - For a GST unregistered business owner consumer - For an individual consumer overseas - For customer/vendor 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.

 

Items:



Node Description Type Required Example
product_type The product type for the item can be either Goods or Service String Optional goods
hsn_or_sac HSN code or SAC for Goods or Service String Optional 440452
item_tax_preferences* Intra and Inter state tax preference for the item list Optional refer below


*Example: item_tax_preference 


"item_tax_preferences": 


[{"tax_id":"2000000002396","tax_specification":"intra"}, 
{"tax_id":"2000000002390","tax_specification":"inter"}]

]

 

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



Sales and Purchases:

 

product_type and hsn_or_sac nodes shall be given in each line item for the sales transactions in case you need to override the default value in the item.

 

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 respectively. String NA 74191010
place_of_supply Place where the goods/services are supplied to. (If not given, place of contact given for the contact will be considered for sales, and home state will be taken for purchase) String Required TN
gst_treatment GST Treatment for the customer/vendor.
Possible values: business_gst - For a GST Registered business owner business_none - For a GST unregistered business owner consumer - For an individual consumer overseas - For customer/vendor outside India
String optional business_gst
gst_no GSTIN for the customer. String optional 33AIRCA1234A1Z5

Refer the updated  API documentation here for more details.

Should you require any clarification, feel free to comment or write to  support[at]zohoinvoice[dot]com.

    Access your files securely from anywhere







                            Zoho Developer Community




                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                  • Ask the Experts



                                                            • Sticky Posts

                                                            • Zoho Finance Workshop 2023 is coming to the USA. Get exclusive training on Zoho Finance apps, one-on-ones, and more.

                                                              Hello all, We'd like to invite you to our biggest Zoho Finance workshop in the United States. After a brief break, we are excited to be back. This year, we're bringing together our customers and community members for two days of curated hands-on sessions,
                                                            • How to maintain steady cash flow during the COVID-19 crisis using Zoho Invoice

                                                              Dear customers, I hope this finds you and your loved ones in good health. As we are witnessing, the COVID-19 pandemic has started taking a toll on businesses of all types. Here are some useful tips that could help you streamline your invoicing and AR processes to keep your business healthy. 1. Communicate clearly with your customers: During this period, transparent communication with customers is a necessity. A lot of businesses have started displaying messages on their home pages, explaining their
                                                            • Introducing: Digital signature for estimates and invoices

                                                              Dear customers, We are pleased to announce that the much awaited Zoho Invoice - Zoho Sign integration is live! You can now sign your estimates and invoices before emailing it to your customers. Also, you can have them sign your estimates while accepting it. Here is our help document to help you get started: https://www.zoho.com/invoice/help/integrations/sign-integration.html Note: This feature is available across all editions of Zoho Invoice except the Indian edition. Out of all the feature requests
                                                            • Webinar: Introduction to the Client Portal

                                                              Business owners know there is never enough time in the day. Not only do you have to beat the competition and make the sale, you then have to make sure you get paid. In fact, the sales process starts way before the sale, and never really ends. Preparing and getting estimates approved, collecting payments, and fielding customer requests for information related to past transactions are all part of the day in the life of a business owner. Well, Zoho Invoice can offer some relief to weary business owners.


                                                            Manage your brands on social media



                                                                  Zoho TeamInbox Resources



                                                                      Zoho CRM Plus Resources

                                                                        Zoho Books Resources


                                                                          Zoho Subscriptions Resources

                                                                            Zoho Projects Resources


                                                                              Zoho Sprints Resources


                                                                                Qntrl Resources


                                                                                  Zoho Creator Resources



                                                                                      Zoho CRM Resources

                                                                                      • CRM Community Learning Series

                                                                                        CRM Community Learning Series


                                                                                      • Kaizen

                                                                                        Kaizen

                                                                                      • Functions

                                                                                        Functions

                                                                                      • Meetups

                                                                                        Meetups

                                                                                      • Kbase

                                                                                        Kbase

                                                                                      • Resources

                                                                                        Resources

                                                                                      • Digest

                                                                                        Digest

                                                                                      • CRM Marketplace

                                                                                        CRM Marketplace

                                                                                      • MVP Corner

                                                                                        MVP Corner









                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now


                                                                                            Zoho Show Resources

                                                                                              Zoho Writer

                                                                                              Get Started. Write Away!

                                                                                              Writer is a powerful online word processor, designed for collaborative work.

                                                                                                Zoho CRM コンテンツ



                                                                                                  Nederlandse Hulpbronnen


                                                                                                      ご検討中の方




                                                                                                              • Recent Topics

                                                                                                              • Ticket Loop from Auto Responce

                                                                                                                We’re seeing an issue where a client’s help desk triggers a ticket loop. When they email us, our system creates a ticket and sends the acknowledgement. Their system then creates a ticket from that acknowledgement and sends one back to us, which creates
                                                                                                              • validation rules doesn't work in Blueprint when it is validated using function?

                                                                                                                I have tried to create a validation rule in the deal module. it works if I try to create a deal manually or if I try to update the empty field inside a deal. but when I try to update the field via the blueprint mandatory field, it seems the validation
                                                                                                              • How to make rule to filter out some emails from receiving the notification "Receiving a new ticket"?

                                                                                                                Good Morning, We are currently using the "Receiving a new ticket" notification rule to provide that auto reply template to a customer that emails us for support. However, there are some emails we don't want to receive this auto-reply. Where can I set
                                                                                                              • Zoho Signatures Missing

                                                                                                                In the past after collecting signatures from two different PDFs I would merge them by calling an api and the signatures would appear in the combined PDF. Recently the signatures have disappeared whenever I combine the PDFs together. Why did this randomly
                                                                                                              • Stop the Workarounds: We Need Native Multi-Step Forms

                                                                                                                After over 17 years of community requests, I'm hoping the Zoho team can finally address the lack of native multi-page form support in Zoho Creator. This has been one of the longest-standing feature requests in the community, with threads spanning nearly
                                                                                                              • Filter button in the Zoho Sheet Android App doesn't toggle on

                                                                                                                I am a new Zoho Sheets user and experiencing a specific issue with the filter functionality in the Android mobile application. Detailed Issue Description: The filter icon appears correctly in the toolbar. Upon tapping the filter icon/button, the toggle
                                                                                                              • Automate pushing Zoho CRM backups into Zoho WorkDrive

                                                                                                                Through our Zoho One subscription we have both Zoho CRM and Zoho WorkDrive. We have regular backups setup in Zoho CRM. Once the backup is created, we are notified. Since we want to keep these backups for more than 7 days, we manually download them. They
                                                                                                              • Exciting Updates to the Kiosk Studio Feature in Zoho CRM!

                                                                                                                Hello Everyone, We are here again with a series of new enhancements to Kiosk Studio, designed to elevate your experience and bring even greater efficiency to your business processes. These updates build upon our ongoing commitment to making Kiosk a powerful
                                                                                                              • Reply to Email for SO/PO

                                                                                                                Hello, We are new to Zoho Books and running into an issue. Our support@ email is our integration user. When our team is sending out PO/SO's we are updating the sender email, but for some reason many of our responses are coming back to our support@ email
                                                                                                              • New activity options for workflows

                                                                                                                Greetings, We are excited to announce the addition of two new dynamic actions to our workflow functionality: Create Event and Schedule Call. These actions have been thoughtfully designed to enhance your workflow processes and bring more efficiency to
                                                                                                              • Remove the “One Migration Per User” Limitation in Zoho WorkDrive

                                                                                                                Hi Zoho WorkDrive Team, Hope you are doing well. We would like to raise a critical feature request regarding the Google Drive → Zoho WorkDrive migration process. Current Limitation: Zoho WorkDrive currently enforces a hard limitation: A Zoho WorkDrive
                                                                                                              • Important Update: Google Ads & YouTube Ads API Migration

                                                                                                                To maintain platform performance and align with Google's newest requirements, we are updating the Google Ads and YouTube Ads integrations by migrating from API v19 to the newer v22, before the official deprecation of v19 on February 11, 2026. Reference:
                                                                                                              • Kaizen #228 - Process Large-Scale Migrated Data Using Catalyst Solutions

                                                                                                                Howdy, tech wizards! This week’s Kaizen explores how Catalyst Solutions in the Zoho CRM Developer Hub help import large volumes of data into Zoho CRM while improving data quality and simplifying the migration process. Why Catalyst Solutions? Catalyst
                                                                                                              • Zoho Expense Import Reports Won't Work Because Default Accounts Already Exist

                                                                                                                Im trying to import reports from another Zoho expense account to mine and im getting errors that won't allow the import to happen The account name that you've entered 'Ground Transportation' already exists. Enter another name for the account and try again.z
                                                                                                              • Inactive License for free account.

                                                                                                                I recently upgraded my Cliq subscription not my team (on the free version), are unable to login to their accounts. The error message received is Inactive License Looks like you have not been covered under the current free plan of users. Please contact
                                                                                                              • 2026 Product Roadmap and Upcoming Features

                                                                                                                This is your guide to what is coming in Zoho Vertical Studio throughout 2026. We’ll update this post throughout the year as items move from development to release, and as and when new initiatives are added. Once a feature is released, it will be reflected
                                                                                                              • Please, make writer into a content creation tool

                                                                                                                I'm tired of relying on Google Docs. I'm actually considering moving to ClickUp, but if Writer were a good content creation tool instead of just a word processor, I would finally be able to move all my development within the Zoho ecosystem, rather than
                                                                                                              • Syncing zoho books into zoho crm

                                                                                                                I was wondering how I can use zoho books in crm as I have been using them separately and would like to sync the two. Is this possible and if so, how? Thanks
                                                                                                              • Release Notes | January 2026

                                                                                                                We have rolled out a set of powerful new enhancements across Zoho Vertical Studio that bring several long-awaited capabilities to your applications. These updates focus on deeper customization, smarter automation, better reporting, and improved usability
                                                                                                              • Live Chat for user

                                                                                                                Hi everyone, I’m new to Zoho Creator and wanted to ask if it’s possible to add a live chat option for all logged-in portal users so they can chat internally. I’m trying to create a customer portal similar to a service desk, but for vehicle breakdowns,
                                                                                                              • Power up your Kiosk Studio with Real-Time Data Capture, Client Scripts & More!

                                                                                                                Hello Everyone, We’re thrilled to announce a powerful set of enhancements to Kiosk Studio in Zoho CRM. These new updates give you more flexibility, faster record handling, and real-time data capture, making your Kiosk flows smarter and more efficient
                                                                                                              • Announcing new features in Trident for Mac (1.34.0)

                                                                                                                Hello everyone! We’re excited to introduce the latest updates to Trident, which are designed to take workplace communication to the next level. Let’s take a quick look at what’s new. Connect with customers using Zoho Voice integration. You can now easily
                                                                                                              • Massive Zoho Books failure

                                                                                                                We have not received any communication or notification from Zoho, but we have detected that Zoho Books is not working for all our users. We cannot access or use Zoho Books. This is critical. We are trying to contact Zoho on the Spain telephone number,
                                                                                                              • The Social Wall: January 2026

                                                                                                                Hello everyone, We’re back with the first edition of The Social Wall of 2026. There’s a lot planned for the year ahead, and we’re starting with a few useful features and improvements released in January to help you get started. Create a GBP in Social
                                                                                                              • How to block whole domain?

                                                                                                                I am getting at least 50-75sometimes over 100 spams emails a day. I see a lot of the spam is coming from .eu domains. I would like to block /reject all email coming for the .eu domain. I do not have any need for email from .EU domains. Why won't the BlackList
                                                                                                              • How Zoho Contracts Makes Negotiations Clear, Secure, and Transparent

                                                                                                                Negotiation is one of the most critical—and often most chaotic—stages of the contract lifecycle. Multiple stakeholders review the same document, propose changes, debate terms, and exchange feedback. Without the right tools, this collaborative process
                                                                                                              • Error: Invalid Element tax_override_preference

                                                                                                                In both Books and Inventory, we're getting the following error whenever we try to enter any Bill: I think this is a bug. Even cloning an old bill (that obviously was entered just fine), this error occurs.
                                                                                                              • Assign Income to Project Without Invoice

                                                                                                                Hello, Fairly new user here so apologies if there is a really obvious solution here that I am just missing... I have hundreds of small deposits into a bank account that I want to assign to a project but do not want to have to create an invoice every time
                                                                                                              • How to Print the Data Model Zoho CRM

                                                                                                                I have created the data model in Zoho CRM and I want the ability to Print this. How do we do this please? I want the diagram exported to a PDF. There doesnt appear to be an option to do this. Thanks Andrew
                                                                                                              • our customers have difficult to understand the Statements

                                                                                                                our costumers have big problems to understand Zohos Statements. we need a text box after the payment number to explain what the payments are for. Is it possible to develop a version of the Statement with that kind of box and if so whu can do it
                                                                                                              • How to track a list of ALL the items that ONE customer bought?

                                                                                                                Hello, I am interested in getting a list of all the items that only ONE of my customers bought, and the invoices are what show up instead. It's very tedious to go through every single invoice when we sell a lot of items to this customer. Surely there
                                                                                                              • Exchange Rate Updates

                                                                                                                Hi, It would be great that when you work with multiple currencies, the exchange rate updates automagically every day (as seen on Zoho Books) or at least that when you create/update an opportunity the exchange rate could be manually updated, or maybe both!
                                                                                                              • Locked Out of Super Admin Account

                                                                                                                I'm locked out of my Super Admin account and the external e-mail is no longer associated with it. There seems to be a problem during set up, the system ought to ask to assign a new password instead of using Google accounts. Please help me get back access.
                                                                                                              • Emails are going to notification folder and not in inbox

                                                                                                                emails are going to notification folder and not into inbox
                                                                                                              • 550 5.4.6 Unusual sending activity detected. Please try after sometime

                                                                                                                Hi, I am receiving this error message when trying to send my emails. The only reason I can think why this is happening is my previous two emails were bounced back to me due to a non working mailbox error. I have followed the online links for unblocking
                                                                                                              • Projects Home Customization

                                                                                                                Hello! We've been in Zoho One since July of last year, and my team has started providing feedback on what they'd like to do. Their latest wish is that they could have more control over the Projects Home content. For example, they want a card that shows
                                                                                                              • IMAP search support

                                                                                                                Does Zoho Mail support IMAP search? https://www.rfc-editor.org/rfc/rfc9051.html#name-search-command TEXT <string> Messages that contain the specified string in the header (including MIME header fields) or body of the message. Servers are allowed to implement
                                                                                                              • Performance is degrading

                                                                                                                We have used Mail and Cliq for about three years now. I used to use both on the browser. Both have, over the past 6 months, had a severe degradation in performance. I switched to desktop email, which appeared to improve things somewhat, although initial
                                                                                                              • Cannot reorder fields in Page Layout in Expenses and Purchase Requests

                                                                                                                It is very inconvenient that the custom fields in Page Layout cannot be re-ordered. The only way is to remove the fields and re-create them; however, it is impractical. This would affect the reports and dashboards we are having. Not able to re-order the
                                                                                                              • bouncing emails

                                                                                                                My recurring invoices have bounced back
                                                                                                              • Next Page