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.



      • 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.