Hi All,

Zoho Books 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 Books.

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
reverse_charge_tax_id (only for purchase transactions)	If reverse tax is applicable for the purchase, provide the tax id here	String	optional

Refer the updated  API documentation here for more details.

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