Zoho Subscriptions API changes for India GST

Zoho Subscriptions is now ready for India GST.

The information that you pass in our web application wrt India GST can also be passed/retrived through our API.

Here are the list of JSON nodes added to various entities. You can easily find these nodes with subtext as Applicable for India GST in our API Documentation.

PLAN:

NODE	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
product_type	The product type for plan can be either Goods or Service	String	Optional	“goods"
hsn_or_sac	HSN code or SAC for Goods or Service	String	Optional	"00440452"
item_tax_preferences*	Tax preferenece for plan	list	Optional	refer below

ADDON:

NODE	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
product_type	The product type for addon can be either Goods or Service	String	Optional	“goods"
hsn_or_sac	HSN code or SAC for Goods or Service	String	Optional	"00440452"
item_tax_preferences*	Tax preferenece for addon	list	Optional	refer below

Example: item_tax_preference

"item_tax_preferences": [{

"tax_specification": "intra",

"tax_name": "Standard Rate(12)",

"tax_percentage": 6.000000,

"tax_id": "3000000002404"

}, {

"tax_specification": "inter",

"tax_name": "IGST",

"tax_percentage": 18.000000,

"tax_id": "3000000002408"

}]

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

For the write action of item_tax_preferences using the HTTP methods POST and PUT, it is enough to pass tax_id and tax_specification while creation/updation of plan/addon.

INVOICES:

The following nodes will be available in each line item for the invoice entity.

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	String	NA	"74191010"

CUSTOMERS:

NODE	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
gst_treatment	GST Treatment for the customer. Possible values: business_gst - For a GST Registered business owner, business_none - For a GST unregistered business owner , consumer - For a individual consumer , overseas - deliver your goods or services for customers 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.

SUBSCRIPTIONS :

NODE	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
place_of_supply	Place of Supply for the customer' subscription (State code according to Indian Census 2011)	String	Optional	“TN"

NOTE:

If place_of_supply is empty, the state of the organisation is taken as the default value.

Node: item_tax_preferences*

NODE	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
tax_id	Tax ID to which you would like to associate with this plan/addon.	String	Required	"903000000065300"
tax_name	Name of the tax to which subscription is associated.	String	Optional	“IGST"
tax_percentage	Percentage of tax applied to the plan/addon	number	Optional	12
tax_specification	Tax specification for the addon. It can be either intra or inter.	String	Required	“inter"

If you have any queries related to migration or using these APIs. Please comment here or write to us at support@zohosubscriptions.com