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

Zoho Desk Resources

Desk Community Learning Series
Digest
Functions
Meetups
Kbase
Resources
Glossary
Desk Marketplace
MVP Corner
Word of the Day

Topic Participants
Syed Kaleemullah

Sticky Posts
Introducing Invoice Consolidation for Offline Subscriptions
Hello Folks, Glad to announce the feature of Invoice Consolidation for Offline Subscriptions. If you are having multiple subscriptions for your customers, now, you can send a single consolidated invoice for all the Offline Subscriptions that are getting renewed on the same date. Advantage? Customers will be receiving single invoice instead of multiple invoices upon renewal. Also reduces your efforts in follow-up with your customers for payment collections. For Example: If Customer has Subscription
New feature: Create back-dated subscriptions
Hello from the Zoho Subscriptions team. :) We’re happy to announce that today marks the launch of a much-awaited feature: creating back-dated subscriptions! From here on out, whenever you create a new subscription with an activation date that is earlier than the present date, you’ll no longer get an error. Instead, you'll be creating a back-dated subscription. This means that the subscription started at that earlier point in time. The next billing date will be calculated automatically based on
Announcement Regarding Notification Emails
Hello Everyone! This announcement is regarding the admin notification emails which you've been receiving from the email address "support@zohosubscriptions.com". From the 1st of October, 06:00 GMT, the emails with the following subjects will be sent from "no-reply@zohosubscriptions.com". Unable to send invoice for the profile - {profile_name} Unable to process auto payments. If you have set up any filters or workflow in your email account, please add "no-reply@zohosubscriptions.com” and “support@zohosubscriptions.com”
Zoho Subscriptions plugin for WordPress
Zoho Subscriptions plugin for WordPress allows you to easily embed your plan specific checkout page in an iframe with just a few mouse clicks and without a single line of code. How can WordPress Zoho Subscriptions Plugin boost your productivity? It's now easier to embed Zoho Subscriptions checkout page in your WordPress site. Forget the old method of logging in to Zoho Subscriptions, copying a URL and scripting to make adjustments. All this can be done automatically through this plugin. A great time
Indian GST organisation Migration Guide
With respect to the new GST regime releasing on July 1, 2017in India, Zoho Subscriptions Indian edition is also gearing up to make your business GST Ready. This article focuses on how to get your existing organisation in Zoho Subscriptions to migrate to the new GST regime. Note: Any organisation created on or after July 1, 2017 will already be GST ready. You wouldn't have to migrate your organisation. Migrating your existing organisation to support GST To migrate your existing organisation to