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

        All-in-one knowledge management and training platform for your employees and customers.







                              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

                                                                                                                • zoho sheet stuck

                                                                                                                  I Need help. ZOHO sheets stuck on the loading screen. I've already deleted the system cache and cookies of my browser (google chrome) but it's still not opening. 
                                                                                                                • Tip of the Week #78 – Cut response time with multichannel shared inboxes

                                                                                                                  If you’ve ever felt your team juggling between multiple email accounts, social pages, and chat apps just to reply to customers, you’re not alone. Managing conversations in multiple channels can quickly turn messy. Important messages across inboxes, replies
                                                                                                                • Need a way to run a client script longet than 10 seconds

                                                                                                                  By The Grace of G-D. Hi, Currently, Client Scripts are Timing out at 10 seconds. We have complex logics that needs more time. Can you add a feature request to increase the timeout?
                                                                                                                • FSM Improvement Idea - Show an Import button when there is no data

                                                                                                                  I am setting up FSM for a client and I noticed that there is no option to import data, see screenshot below. Even when you click Create Contact there is only an option to Import from Zoho Invoice. It is only after you add at lease 1 record that the Import
                                                                                                                • UI Improvement - Ability to Collapse Flow

                                                                                                                  The UI for Flow is generally pretty good. However, when multiple decision trees are used, the layout can get pretty convoluted and hard-to-follow (see one of my Flows below): In these cases, even the auto-arrange fails to make this something that a normal
                                                                                                                • Tasks Statuses

                                                                                                                  Hi, The task status "Completed" is a final status which closes the task. We need to have a status "Cancelled". However, when the status is set to "Cancelled", the task prompt still has a blue button to Close Task. When the customer clicks that and closes
                                                                                                                • Add Lookup Field in Tasks Module

                                                                                                                  Hello, I have a need to add a Lookup field in addition to the ones that are already there in the Tasks module. I've seen this thread and so understand that the reason lookup fields may not be part of it is that there are already links to the tables (
                                                                                                                • Create New Tasks Layout in CRM

                                                                                                                  I am able to do this in Leads, Contacts, Meetings, Calls - every other module, but cannot create a new layout in tasks. I have the appropriate access but it's simply not appearing as an option. Only "Standard" option shows. Please help!
                                                                                                                • Using IMAP configuration for shared email inboxes

                                                                                                                  Our customer service team utilizes shared email boxes to allow multiple people to view and handle incoming customer requests. For example, the customer sends an email to info@xxxx.com and multiple people can view it and handle the request. How can I configure
                                                                                                                • Auto-sync field of lookup value

                                                                                                                  This feature has been requested many times in the discussion Field of Lookup Announcement and this post aims to track it separately. At the moment the value of a 'field of lookup' is a snapshot but once the parent lookup field is updated the values diverge.
                                                                                                                • Zoho Recruit Subscription

                                                                                                                  Hello Zoho Recruit Team, Good day! I would like to inquire about your recruitment subscription plans and would also like to verify the current subscription our company is enrolled in under Zoho Recruit. Thank you, and I look forward to your response.
                                                                                                                • Is it possible to create a meeting in Zoho Crm which automatically creates a Google Meet link?

                                                                                                                  We are using Google's own "Zoho CRM for Google" integration and also Zoho's "Google Apps Sync" tools, but none of them provide us with the ability to create a meeting in Zoho CRM that then adds a Google Meet link into the meeting. Is this something that
                                                                                                                • Automatic Portal invite

                                                                                                                  We have numerous customers we move through a blueprint in deals, when they get to a certain point we need to give them portal access, how can this be done through deluge or a workflow? Latest Update (December 2025): The option to automate portal invitations
                                                                                                                • Marketer's Space: Why mobile optimization deserves a place in your email strategy

                                                                                                                  Hello Marketers, Welcome back to Marketer's Space! Today, we'll talk about the importance of creating mobile-friendly email designs. While mobile phones were once used only to make phone calls, today they're used for almost everything, including texting,
                                                                                                                • Enhancements in Canvas

                                                                                                                  Dear All, Greetings! Canvas lets you design the record details page to suit your brand or business preferences. We are glad to introduce the following enhancements to uplift your design experience. Reusable Components Style Presets Let's go! Reusable
                                                                                                                • Introducing Dark Mode / Light Mode : A New Look For Your CRM

                                                                                                                  Hello Users, We are excited to announce a highly anticipated feature - the launch of Day, Night and Auto Mode implementation in Zoho CRM's NextGen user interface! This feature is designed to provide a visually appealing and comfortable experience for
                                                                                                                • ABN with Legal Entity Name

                                                                                                                  Hi, How can I execute this? The ABN number is entered in Accounts Module and ideally, it should display or suggest the correct Legal Entity Name based on the ABN lookup. ex. Account Name: JPG Resources ABN Number: 65 067 761 871 Legal Entity Name: (auto
                                                                                                                • Issue: Ticket Export Does Not Include Ticket Threads

                                                                                                                  Dear Zoho Desk Support Team, I hope you’re doing well. I wanted to bring to your attention that the current ticket export feature in Zoho Desk does not seem to include the ticket threads or conversation history. When exporting tickets, only the summary
                                                                                                                • Pushover Notification Module

                                                                                                                  Hello, it would be good if there would be a "Pushover" (https://pushover.net/) module besides the standard SMS module. Pushover is now very well known, especially in IT, and is becoming more and more popular. The biggest advantage are the customizable
                                                                                                                • Forward - no Ticket Number

                                                                                                                  Hello, when I send an email to Zoho Desk via Reply or Reply All, the ticket number is in the subject line. But if I use forward then not. Is there an option to change this? We often forward e-mails and a reply to this will of course create a new ticket
                                                                                                                • Checkout: Adding Images

                                                                                                                  Hello everyone, I’m trying to add a small GoGreen logo in the shipping section of the checkout to promote our sustainable shipping. While I can insert text without any issues, it seems that adding images is not supported in this area. Is there currently
                                                                                                                • [solved] #original_sender trick not working for us

                                                                                                                  Hello community ! We really like DESK.. it's working like a charm for us but I have a request. Some users are sending emails personnaly to me (instead of using the support adress).. and I saw there was a possibilty to use : #original_sender {mail@mail.com}
                                                                                                                • SalesIQ Chat Notifications

                                                                                                                  I am the admin of our salesIQ implementation. About two weeks ago, I started hearing/seeing notification for ALL chats messages from monitored agents/chat participants. I don't need to see these, we have a manager who deals with this. I can't stop the
                                                                                                                • Correlated subqueries not supported in Zoho Analytics. This creates huge limitations

                                                                                                                  Running into a major limitation in Zoho Analytics: correlated subqueries simply don’t work, even in completely standard SQL patterns inside a JOIN. Example: LEFT JOIN "Bills" b ON d."Id" = b."Deal ID" AND EXISTS ( SELECT 1 FROM "Bill
                                                                                                                • Batch Emails in CRM Plus without using a template?

                                                                                                                  Hi guys. Is it possible to send the same email to multiple people at the same time within CRM Plus without using an email template? At the moment we create a custom view in Contacts to display the people that we need. We then click the boxes on the left, and click 'Send Mail', but always need to select a template. Sometimes its better to write a quick one off message, without needing to set up a template first. Thanks.
                                                                                                                • bank charge

                                                                                                                  a charge to my account was made that I did not authorize, of $16.46, for something that looks like "computer maintenance or something to that matter". please refund.
                                                                                                                • [Free Webinar] Product Updates: Quick Catch-Up Session - Part II - Creator Tech Connect

                                                                                                                  Hello Everyone! We welcome you all to the upcoming free webinar on the Creator Tech Connect Series. The Creator Tech Connect series is a free monthly webinar featuring deep-dive technical sessions designed for developers, administrators, and app builders.
                                                                                                                • Introducing Liquid Glass UI on the Zoho Mail iOS app

                                                                                                                  Hello everyone! We're excited to announce that the Zoho Mail app is now fully optimised for iOS 26's Liquid Glass design on both iPhone and iPad! The updated interface features transparent layers, smooth animations, and refined visual elements that enhance
                                                                                                                • Plan change from Zoho One to Zoho Workplace

                                                                                                                  Hello Zoho, Following the recent pricing update for Zoho One, we are interested in transitioning to Zoho Workplace products. Please inform us about the necessary steps for this process so we can proceed promptly. Kind regards,
                                                                                                                • Links in Instagram

                                                                                                                  Hi there, I have been using Later for a while now but keen to come back to Zoho Social as Later doesn't offer tagging of pages on Facebook but they offer something Zoho doesn't. You can add a link to your bio which opens up your profile feed where images
                                                                                                                • Spotlight #7 - Automatic Transitions in Blueprint

                                                                                                                  Previously, records could not be moved from one state to another without user intervention. With automatic transitions, move records from one state to another automatically, when it elapses its pre-defined time. This Spotlight discusses how automatic
                                                                                                                • Sub Folders

                                                                                                                  It would be great if there could be sub-folders in reports. We have a ton of individual reports and folders that would be easier to navigate this way 
                                                                                                                • Zoho CRM Community Digest - November 2025 | Part 2

                                                                                                                  Hello Everyone! Second half of November brought several exciting updates, especially around Zia, making AI assistance smarter, faster, and more context-aware. We also feature engaging community snippets highlighting members who went the extra mile to
                                                                                                                • Zoho CRM - Writing Assistant Tone

                                                                                                                  Hi Zoho CRM Team, Text in my emails often gets underlined in yellow because I tend to use a more informal tone with my client's, like using "I'm" instead of "I am". Is there some way for me to tell the system that this is my preferred writing tone, so
                                                                                                                • Hide Contact Number for Field Users & Agents

                                                                                                                  Is it possible to hide the contact number in both the Service Appointment and Work Order modules for field users and agents? The agents are using the Zoho FSM mobile app, and we want to restrict them from viewing the contact number.
                                                                                                                • Form Submission Emails

                                                                                                                  Is there a current delay with submission emails being sent? We've had 10-20 forms completed today but only a handful of emails.
                                                                                                                • 【Zoho CRM for Everyone】設定画面のアップデート

                                                                                                                  ユーザーの皆さま、こんにちは。コミュニティチームの藤澤です。 今回は「Zoho CRM アップデート情報」の中から、Zoho CRM for Everyone の設定画面のアップデート情報をご紹介します。 目次 設定ホーム画面の追加 設定画面での検索結果の表示形式の変更 設定画面でのよく使用する機能の表示 設定メニューの展開/折りたたみ状態の保持 1. 設定ホーム画面の追加 ホーム画面の設定項目は、直感的に分類できるように"カテゴリごと"で分けられています。 このような一元化された表示により、各ツールが1つの画面に集約され、必要な機能をより簡単に見つけられるようになりました。
                                                                                                                • What's New - November 2025 | Zoho Backstage

                                                                                                                  A new month, a new set of updates. With a mix of new features and thoughtful improvements, you get smoother workflows and better control across registrations, exhibitors, and communications. Let's take a look at what's new and enhanced in Zoho Backstage
                                                                                                                • Zoho Checkout - Duplicate Customer record created for each payment received

                                                                                                                  Hi All. We are using Zoho Checkout to capture online payments for a club membership form (in Zoho Forms). We've noticed that each new payment seems to create a new customer record, regardless of whether the customer already exists in the Zoho Finance
                                                                                                                • Templates for Zoho Desk - Knowledge Base

                                                                                                                  We are looking at migrating our Knowledge base into Zoho Desk. Is there a way of creating templates for article in Knowledge base. We want to be able to set templates for certain types of content. Is this possible
                                                                                                                • Next Page