E-Way Bill System – User Manual for API Interface (Site-to-Site integration)
GST
Dated:- 31-3-2018
E-Way Bill System
\nUser Manual for API Interface (Site-to-Site integration)
\n1. Introduction
\n1.1 Background
\nIntroduction of Goods and Services Tax (GST) across India with effect from 1st of July 2017 is a very significant step in the field of indirect tax reforms in India. For quick and easy movement of goods across India without any hindrance, all the check posts across the country are abolished. The GST system provides a provision of e-Way Bill, a document to be carried by the person in charge of conveyance, generated electronically from the common portal. To implement the e-Way Bill system, ICT based solution is required. Hence, as approved by the Goods and Services Tax (GST) Council, a web based solution has been designed and developed by National Informatics Centre and it is being rolled out for the use of taxpayers and transporters. The API interface based mechanism <\/p>\n
= = = = = = = =<\/p>\n
Plain text (Extract) only<\/strong> = = = = = = = =<\/p>\n m system to system. This API interface facilitates the tax payers or transporters to enable their automated system to call the EWB system to generate, update and pull the data related to their e-way bills. = = = = = = = =<\/p>\n Plain text (Extract) only<\/strong> = = = = = = = =<\/p>\n or transporter needs to test his\/her modified system on the EWB pre-production site with all types of activities\/services. = = = = = = = =<\/p>\n Plain text (Extract) only<\/strong> = = = = = = = =<\/p>\n ax payer can decide his process\/method as per his business needs. No need to follow this only. = = = = = = = =<\/p>\n Plain text (Extract) only<\/strong> = = = = = = = =<\/p>\n Bill = = = = = = = =<\/p>\n Plain text (Extract) only<\/strong> = = = = = = = =<\/p>\n","protected":false},"excerpt":{"rendered":" E-Way Bill System – User Manual for API Interface (Site-to-Site integration) GSTDated:- 31-3-2018E-Way Bill System User Manual for API Interface (Site-to-Site integration) 1. Introduction 1.1 Background Introduction of Goods and Services Tax (GST) across India with effect from 1st of July 2017 is a very significant step in the field of indirect tax reforms in … Continue reading “E-Way Bill System – User Manual for API Interface (Site-to-Site integration)”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-11230","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=\/wp\/v2\/posts\/11230","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=11230"}],"version-history":[{"count":0,"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=\/wp\/v2\/posts\/11230\/revisions"}],"wp:attachment":[{"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=11230"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=11230"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/goodsandservicetax.in\/GST\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=11230"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
For full text:-Visit the Source <\/a><\/p>\n
\n2.1 Benefits
\nThese APIs can be used by the Tax Payers or Transporters or GST Suvidha Providers. The tax payers or transporters can have the following benefits by having API interface with their systems:
\n * Duplicate or double entry of invoice can be avoided. Generally, the employees of the tax payers enter the sales details in their computerised system and generate the invoice. After that they will come to e-way bill system and generate the e-way bill.
\n * Mistakes while generating e-way bill can be avoided. In a hurry to generate the e-way bill, the employee may do a mistake in data entry of e-way bill form, resulting in generation of incorrect e-way bill.
\n * Two prints of invoice and e-way bill can be avoided. That is, transporter or driver of the vehicle can be given invoice p<\/p>\n
For full text:-Visit the Source <\/a><\/p>\n
\n2.3 On-boarding process
\n * Read the API related documents
\n * After logging into the e-way bill system, the tax payer or transporter has to select the 'For API' option under 'Registration' menu.
\n * Enter the request details – domain name, static IP, etc.
\n * On submission, the EWB system generates the Client_Id, Client_Secret, UserName and Password and displays to the tax payer
\n * Using this, IT team of the tax payer will change or modify their automated system
\n * The tax payer will test modified system from his pre-production system with EWB pre-production system
\n * After thorough testing by the tax payer with all types of activities, at least 200 activities, he will be enabled to move to production.
\n2.4 Interfacing examples
\n2.4.1 API Interface for Tax Payer system – One of the ways of interfacing
\nNote: This is one sample method\/process of interfacing th<\/p>\n
For full text:-Visit the Source <\/a><\/p>\n
\n * On hourly basis, Transporter system pulls all the e-waybills assigned to him using EWB API and stores into his system.
\n * Before movement of goods, transporter enters vehicle no. for his LR and saves in his system
\n * Now, Transporter system calls EWB system with EBN No. and other details requesting to update Part B of particular e-way bill.
\n * EWB system after authentication and verification of details, updates vehicle details and gives ACK.
\n * Transporter system updates this ACK in his system and prints the Trip sheet or manifesto.
\n * Now, Transporter moves the goods along with this trip sheet or manifesto.
\n3. List of E-Way Bill API Services\/Methods
\nSl. No.
\nAPI Service
\nAPI Description
\nResponse (data)
\nApplicable To
\n1.
\nAuthenticate
\nAuthenticate with the credential to access the APIs
\nToken
\nTax Payer, Transporter, Suvidha Provider
\n2.
\nGet e-Way Bill
\nGet the e-Way Bill detai<\/p>\n
For full text:-Visit the Source <\/a><\/p>\n
\nGenerate e-Way Bill
\nEWB_No, Date
\nTax Payer, Transporter, Suvidha Provider
\n8.
\nUpdate Vehicle Number to E-Way Bill
\nUpdate new vehicle number for the e-way Bill
\nEWB_No, Date, Ref_Uniq_No
\nTax Payer, Transporter, Suvidha Provider
\n9.
\nCancel E-Way Bill
\nCancel the e-Way Bill
\nEWB_No, Date, Ref_Uniq_No
\nTax Payer, Transporter, Suvidha Provider
\n10.
\nReject E-Way Bill
\nReject the e-Way Bill
\nEWB_No, Date, Ref_Uniq_No
\nTax Payer, Suvidha Provider
\n11.
\nGenerate Consolidate E-Way Bill
\nGenerate Consolidated e-Way Bill
\nCEWB_No, Date
\nTax Payer, Transporter, Suvidha Provider
\n4. Authentication API
\nTo access the API, application should first authenticate using the credentials shared and get the access token issued. Same access token to be used to access subsequent APIs. Access token will be configured to expire after 360 minutes. On expiry, same authentication API needs to be invoked to get new Access Token issued.
\nThe API header information is used for authentication and authoriza<\/p>\n
For full text:-Visit the Source <\/a><\/p>\n