GSP Implementation Framework V 3.0
GSP Implementation Framework V 3.0
(GSP)
IMPLEMENTATION
FRAMEWORK
Overview of GSP Ecosystem
GST System is following a platform approach for providing
services to Tax Payers.
All GST System functionalities like registration of entities,
uploading of invoices, filing of returns will all be available
through APIs.
GSTN believes in creating an ecosystem of Service
Providers viz GST Suvidha Provider (GSP) providing
innovative solutions (Portal, Mobile App, Enriched API)
either themselves or through its third party partners for
making tax filing more easy and convenient to tax payers.
GSTN envisages a very important role of GSPs in making
GST rollout easy and convenient for tax payers.
Who Could be GSP?
As per pre-qualification criteria published on
www.gstn.org/ecosystem/index.php
Functionalities Available for GSP through API
GST System will have following main Modules
Registration of Tax Payer and Tax Consultant
Returns (GSTR1 upto GSTR12)
Payments
Ledger Maintenance
Miscellaneous
For Tax professionals
Consolidated view of all clients
Ability to upload invoice data etc. from his
dashboard
Get update on their taxpayers from GST System
1. Taxpayer will register with one of the GSP, who is providing a portal similar to GST portal but
with enriched functionalities.
2. Taxpayer will get a userid and password for GSP portal.
3. To use GST API, Taxpayer has to authenticate with GST system. This authentication can be
done in two way:
Tax payer chooses to provide OTP for every interaction with GST System like uploading of
invoices, fetching GSTR2 auto populated data, filling returns etc.
Tax payer authorize GSP application to authenticate on his/her behalf to only provide
OTP once. (GSP Application will map its portal userid with GST System ID)
4. Tax payer will export his sales register entries( having invoice level details) in csv or excel
format from his/her existing application.
5. Tax payer will login in to the GSP portal (If Tax payer has chosen option-2 in third step above,
he/she will be asked one time GST portal userid and otp to provide his/her authorization to
GSP application) and upload csv file.
6. GSP application will process this csv and generate a JSON file , which is required by GST
System, instantly or after sometime based on application design and inform Tax payer. Tax
payer can also choose an option to auto submit prepared JSON to GST.
7. Tax payer can do this activity one or more time in a month and finally, when Tax payer is
planning to file return. Tax payer will go to the GSP portal and ask it to fetch GSTR1 summary
from GST system.
8. Taxpayer will view GSTR1 summary and will do digital sign using DSC or e-Sign or EVC as
required.
9. Taxpayer will submit signed GSTR1 and get an acknowledgement.
How this Model will work for filing GSTR-2
1.
1. Tax payer will login in to the GSP portal and ask for his/her auto populated invoice.
2. GSP portal will fetch those from GST System automatically(assuming tax payer has already given
authorization to GSP portal) and convert it in to csv/excel and make that available for download.
3. Tax payer can now upload this csv in to his/her application and compare with its purchase register
to accept/reject/modify/keep pending the invoice. (Existing application has to be modified to
provide this comparison).
4. Tax payer application will now prepare a csv/excel having all the received from GSP application
along action status (accept/reject/pending/modified) and new invoices.
5. Tax payer will upload again this excel on portal.
Or
1. Tax payer will export his purchase register entries( having invoice level details) in csv or excel
format from his/her existing application.
2. Tax payer will login in to the GSP portal and upload csv file .
3. GSP portal will process this csv and call GST System to get his/her auto populated invoices. GSP
portal will compare both the files and provide matching/non-matching or missing invoices.
4. Tax payer will take appropriate action on GSP application and submit it to GST System.
2. Tax payer will ask portal to fetch GSTR2 summary from GST system before filling date.
3. Taxpayer will view GSTR2 summary and will do digital sign using DSC or e-Sign or EVC as required.
4. Taxpayer will submit signed GSTR2 and get an acknowledgement.
For 1B Type TASPs
They will need help of a GSP, who will provide them enrich APIs like uploading of invoice data in
form of CSV or a Text file, APIs to compare GSTR2 downloaded data with their purchase register
data in csv format etc.
These application will also need access to GST Systems published APIs for knowing various other
thing like ledger balance etc. and keep their system updated.
GSP can provide combination of Enriched as well as original APIs.
They will fit in below model.
Tax Payer
Custom
Application
GSP Enriched MPL
GSP-
API Calls API Server GST
S GST
[uploadInvoice(csv format), System
Payload Server
compareGSTR2(GSTR2 Json, Encrypted Using
purchaseRegisterCSV)] Session Key
GSP Application
For 2nd Type TASPs
They will need original APIs of GST System in some wrapper. In this wrapper API will not do any
transformation but have additional parameter like a custom app-id, custom password or token.
In case of Tally they have standalone installation and they can build all the capabilities of GST in that
standalone installation. But these standalone clients need direct access to GST APIs on internet. As
these clients will be individual application and coming through public internet, GSP need to build
some authentication mechanism. GSP has to either do some modification in original API for such
authentication or create some new set like registration API to register such clients and provide them
some license key/app id.
As these application provider are mostly large player, so they will be themselves GSP and may follow
below model.
Tax Payer
Custom
Application
MPLS
GSP Wrapper API
GST
Server/GSP-GST
Server System
Cloud and
Mobile
Application by
Startups and
small companies
GSP Application
For 3rd Type TASPs
They will need mostly our original API as they will transform their application using their own API.
As these application are originally designed using APIs,they will only need our original API, so they
may follow below model.
Payload
Tax Payer
Custom
Encrypted
Using
MPLS
Application/Clou Session
d or Mobile Key GSP-GST GST
based Server System
Application by
Small companies
or Startups
Integration Approach With
GSP
GST System APIs will be RESTful, json-based, and
stateless services.
GST System will provide API only through MPLS to the
GSPs. This is to ensure controlled access of APIs and
avoid single point of failure.
To Authenticate/Authorize GSP , every GSP will be
provided a unique license key and ability to generate
more sub license keys. Through sub license keys GSP
could provide controlled access of APIs to its third
party partners.
To provide Tax Payer complete control, security and privacy, while
interacting with GST system through any channel (portal or API).
In case of Portal , tax payer will authenticate himself on the
Portal by providing userid/password and his data will travel
encrypted using https channel.
In case of API access, tax payer will also authenticate by
providing userid, OTP. The communication will again be
encrypted, with a symmetric session key that will be shared
between Tax payer Application and GST System electronically
during session initiation.
Tax payer shall have the flexibility and option to anytime
choose not to use API access of GSPs by simply logging in to
GST portal and uncheck option. This shall afford the tax payer
the independence of choice.
Tax payer can also choose a long time session in case Tax payer
application wants to interact regularly with GST System without
providing OTP for each session.
To interact with GST System, calling application has to provide
tax payer credentials and after successful authentication,
application will get a token and Session Key for that Tax payer.
Token and Session Key will be valid for certain duration and
using it application can call various GST System APIs for that Tax
payer without authentication.
Authentication and Authorization Implementation
Details
GST System Design
(Authentication and Authorization Interaction Diagram)
Thank You