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 Writer

                                                                                            Get Started. Write Away!

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

                                                                                              Zoho CRM コンテンツ





                                                                                                Nederlandse Hulpbronnen


                                                                                                    ご検討中の方




                                                                                                          • Recent Topics

                                                                                                          • How can I get base64 string from filecontent in widget

                                                                                                            Hi, I have a react js widget which has the signature pad. Now, I am saving the signature in signature field in zoho creator form. If I open the edit report record in widget then I want to display the Signature back in signature field. I am using readFile
                                                                                                          • Email Integration - Zoho CRM - OAuth and IMAP

                                                                                                            Hello, We are attempting to integrate our Microsoft 365 email with Zoho CRM. We are using the documentation at Email Configuration for IMAP and POP3 (zoho.com) We use Microsoft 365 and per their recommendations (and requirements) for secure email we have
                                                                                                          • Creator roadmap for the rest of 2022

                                                                                                            Hi everyone, Hope you're all good! Thanks for continuing to make this community engaging and informative. Today we'd like to share with you our plans for the near future of Creator. We always strive to strike a good balance of features and enhancements
                                                                                                          • CRM x WorkDrive: File storage for new CRM signups is now powered by WorkDrive

                                                                                                            Availability Editions: All DCs: All Release plan: Released for new signups in all DCs. It will be enabled for existing users in a phased manner in the upcoming months. Help documentation: Documents in Zoho CRM Manage folders in Documents tab Manage files
                                                                                                          • Filtering repport for portal users

                                                                                                            Salut, I have a weird problem that I just cannot figure out : When I enter information as administrator on behalf of a "supplier" portal user (in his "inventory" in a shared inventory system), I can see it, "customer" portal users can see it, but the
                                                                                                          • Google Maps

                                                                                                            How can I add google maps to Zoho. I put a new lead in and want to be able to click on a link for google maps and it takes me to that new leads address? Thanks
                                                                                                          • Mapping Accounts on Google Maps

                                                                                                            Hello, Is there a way to map accounts within Zoho? I have exported to Google maps, but not ideal. Thanks, Keith
                                                                                                          • Sales tour mapping

                                                                                                            Hi Zoho people and users, Wouldn't be cool if one could import an itinerary say from Gmaps, specify a radius along the line and pop ! show a smattering of droplets on the maps, each representing a customer or lead ? Clicking on a droplet would open the
                                                                                                          • Does zoho have a feature that can help my sales team create a sales route?

                                                                                                            Does zoho have a feature that can help my sales team create a sales route? This will save us time instead of having to use mapquest or google maps.
                                                                                                          • Possible to Turn Off Automatic Notifications for Approvals?

                                                                                                            Hello, This is another question regarding the approval process. First a bit of background: Each of our accounts is assigned a rank based on potential sales. In Zoho, the account rank field is a drop-down with the 5 rank levels and is located on the account
                                                                                                          • Zoho Inventory. Preventing Negative Stock in Sales Orders – Best Practices?

                                                                                                            Dear Zoho Inventory Community, We’re a small business using Zoho Inventory with a team of sales managers. Unfortunately, some employees occasionally overlook stock levels during order processing, leading to negative inventory issues. Is there a way to
                                                                                                          • Converting Sales Order to Invoice via API; Problem with decimal places tax

                                                                                                            We are having problems converting a Sales Order to an Invoice via API Call. The cause of the issue is, that the Tax value in a Sales Order is sometimes calculated with up to 16 decimal places (e.g. 0.8730000000000001). The max decimal places allowed in
                                                                                                          • Importing data into Assets

                                                                                                            So we have a module in Zoho CRM called customers equipments. It links to customers modules, accounts (if needed) and products. I made a sample export and created extra fields in zoho fsm assets module. The import fails. Could not find a matching parent
                                                                                                          • Integración Books para cumplir la ley Crea y Crece y Ley Antifraude (VeriFactu)

                                                                                                            Hola: En principio, en julio de 2025, entra en vigor la ley Crea y Crece y Ley Antifraude (VeriFactu). ¿Sabéis si Zoho va a cumplir con la ley para cumplir con la facturación electrónica conectada a Hacienda? Gracias
                                                                                                          • Kaizen #157: Flyouts in Client Script

                                                                                                            Hello everyone! Welcome back to another exciting edition of our Kaizen series, where we explore fresh insights and innovative ideas to help you discover more and expand your knowledge!In this post, we'll walk through how to display Flyouts in Client Script
                                                                                                          • Zoho One - Syncing Merchants and Vendors Between Zoho Expense and Zoho Books

                                                                                                            Hi, I'm exploring the features of Zoho One under the trial subscription and have encountered an issue with syncing Merchant information between Zoho Expense and Zoho Books. While utilizing Zoho Expense to capture receipts, I noticed that when I submit
                                                                                                          • Translation support expanded for Modules, Subforms and Related Lists

                                                                                                            Hello Everyone!   The translation feature enables organizations to translate certain values in their CRM interface into different languages. Previously, the only values that could be translated were picklist values and field names. However, we have extended
                                                                                                          • How get stock name from other column ?

                                                                                                            How get stock name from other column ? e.g. =STOCK(C12;"price") where C12 is the code of the stock
                                                                                                          • Zoho Sheet for Desktop

                                                                                                            Does Zoho plans to develop a Desktop version of Sheet that installs on the computer like was done with Writer?
                                                                                                          • Create static subforms in Zoho CRM: streamline data entry with pre-defined values

                                                                                                            Last modified on (9 July, 2025): This feature was available in early access and is currently being rolled out to customers in phases. Currently available for users in the the AU, CA, and SA DCs. It will be enabled for the remaining DCs in the next couple
                                                                                                          • BUTTONS SHOWN AS AN ICON ON A REPORT

                                                                                                            Hi Is there any way to create an action button but show it as an icon on a report please? As per the attached example? So if the user clicks the icon, it triggers an action?
                                                                                                          • ZOHO Creator subform link

                                                                                                            Dear Community Support, I am looking for some guidance on how to add a clickable link within a Zoho Creator subform. The goal is for this link to redirect users to another Creator form where they can edit the data related to the specific row they clicked
                                                                                                          • Dropshipping Address - Does Not Show on Invoice Correctly

                                                                                                            When a dropshipping address is used for a customer, the correct ship-to address does not seem to show on the Invoice. It shows correctly on the Sales Order, Shipment Order, and Package, just not the Invoice. This is a problem, because the company being
                                                                                                          • RFQ MODEL

                                                                                                            A Request for quotation model is used for Purchase Inquiries to multiple vendors. The Item is Created and then selected to send it to various vendors , once the Prices are received , a comparative chart is made for the user. this will help Zoho books
                                                                                                          • Will zoho thrive be integrated with Zoho Books?

                                                                                                            title
                                                                                                          • Product Updates in Zoho Workplace applications | August 2025

                                                                                                            Hello Workplace Community, Let’s take a look at the new features and enhancements that went live across all Workplace applications this August. Zoho Mail Delegate Email Alias Now you can let other users send emails on your behalf—not just from your primary
                                                                                                          • Notebook audio recordings disappearing

                                                                                                            I have recently been experiencing issues where some of my attached audio recordings are disappearing. I am referring specifically to ones made within a Note card in Notebook on mobile, made by pressing the "+" button and choosing "Record audio" (or similar),
                                                                                                          • Unable to send message; Reason:554 5.1.8 Email Outgoing Blocked

                                                                                                            Hi, I sent few emails and got this: Unable to send message; Reason:554 5.1.8 Email Outgoing Blocked And now I have few days since I cant send any email. Is there something wrong I did? Also can someone fix this please
                                                                                                          • Want to use Zoho Books in Switzerland. CHF support planned?

                                                                                                            Hi, We're a Swiss company using other Zoho suite software and I discovered Zoho Books and other accounting SaaS when looking for an accounting tool. Do you intend to cover Switzerland and CHF based accounting anytime soon? Roy
                                                                                                          • Zoho sheet desktop version

                                                                                                            Hi Zoho team Where can I access desktop version of zoho sheets? It is important as web version is slow and requires one to be online all the time to do even basic work. If it is available, please guide me to the same.
                                                                                                          • Weekly Tips : Teamwork made easy with Multiple Assignees

                                                                                                            Let's say you are working on a big project where different parts of a single task need attention from several people at the same time—like reviewing a proposal that requires input from sales, legal, and finance teams. Instead of sending separate reminders
                                                                                                          • Celebrating Connections with Zoho Desk

                                                                                                            September 27 is a special day marking two great occasions: World Tourism Day and Google’s birthday. What do these two events have in common (besides the date)? It's something that Zoho Desk celebrates, too: making connections. The connect through tourism
                                                                                                          • What is Resolution Time in Business Hours

                                                                                                            HI, What is the formula used to find the total time spent by an agent on a particular ticket? How is Resolution Time in Business Hours calculated in Zohodesk? As we need to find out the time spent on the ticket's solution by an agent we seek your assistance
                                                                                                          • Upload API

                                                                                                            I'm trying to use the Upload API to upload some images and attach them to comments (https://desk.zoho.com/DeskAPIDocument#Uploads#Uploads_Uploadfile) - however I can only ever get a 401 or bad request back. I'm using an OAuth token with the Desk.tickets.ALL
                                                                                                          • Zoho Desk KB article embedded on another site.

                                                                                                            We embed KB articles from Zoho Desk on another site (our application). When opening the article in a new tab, there is no issue, but if we choose lightbox, we are getting an error "To protect your security, help.ourdomain.com will not allow Firefox to
                                                                                                          • Is Zoho Sheet available for Linux ?

                                                                                                            Is Zoho Sheet available for Linux ?
                                                                                                          • Adding Overlays to Live Stream

                                                                                                            Hello folks, The company I work for will host an online event through Zoho Webinar. I want to add an overlay (an image) at the bottom of the screen with all the sponsors' logos. Is it possible to add an image as an overlay during the live stream? If so,
                                                                                                          • Email Sending Failed - SMTP Error: data not accepted. - WHMCS Not sending emails due to this error

                                                                                                            I have been trying to figure out a fix for about a week now and I haven't found one on my own so I am going to ask for help on here.  After checking all the settings and even resetting my password for the email used for WHMCS it still says: Email Sending Failed - SMTP Error: data not accepted.  I have no clue how to fix it at this point. Any insight would be lovely. 
                                                                                                          • FSM setup

                                                                                                            So we have been tinkering with FSM to see if it is going to be for us. Now is the time to bite the bullet and link it to our zoho books and zoho crm. The help guides are good but it would really help if they were a bit more in depth on the intergrations.
                                                                                                          • Does Zoho Learn integrate with Zoho Connect,People,Workdrive,Project,Desk?

                                                                                                            Can we propose Zoho LEarn as a centralised Knowledge Portal tool that can get synched with the other Zoho products and serve as a central Knowledge repository?
                                                                                                          • Next Page