Introduction

What is GST?

GST stands for Goods and Services Tax, which is an indirect tax levied on the supply of goods and services in India. Hence, at every point of sale, GST would be applied. In cases of intra-state sale, Central GST & State GST are applied, while in other transactions, i.e. in the case of inter-state sales, Integrated GST is applicable.

However, staying GST compliant can be a hassle for organisations & businesses.

  • They have to be registered with GST Network
  • They are also required to deduct GST from payments.
  • And to deposit the collected GST amount and receive challan for same.
  • Lastly file their returns on quarterly and/or annual basis.

All of this, has to be done through the GST portal. However, doing this every time is not as convenient as integrating them into your workflow. Sandbox's GST Compliance APIs allow you to integrate compliance requirements into your own workflow and make it frictionless.

πŸ“˜

Did you know?

Sandbox does pattern check against RegEx (eg GSTIN : "[0-9]{2}[a-zA-Z]{5}[0-9]{4}[a-zA-Z]{1}[1-9A-Za-z]{1}[CZ]{1}[0-9a-zA-Z]{1}") on input (Ignore case) and verifies checksum, preventing upstream query.

Available GST APIs

GST - Public APIs

  1. Track GST Return API lets you view E-filled returns. This tool can help buyers check the tax payment status of their suppliers and make claiming the input tax credit (ITC) easier.
  2. Search GSTIN API lets you verify GSTIN in real-time. The API takes the GSTIN and provides you with details associated with it from the GST Portal. If the GSTIN provided is incorrect, then you will get an error message.

GST - Taxpayer API

  1. Tax Payer Authentication API helps you to enable API access to your GST portal so you can seamlessly use our Taxpayer APIs.
  2. Ledgers APIs lets you fetch relevant ledgers uploaded on the GST portal.
  3. Returns APIs will help you get relevant invoices from the portal & help you file your GST-Returns.

πŸ“˜

Test these APIs

We provide Test Data for these APIs. You can access them on their respective endpoint page. Note that you need to use your test keys with this data.

GSTN Response codes

Sandbox connects you to the GSTN portal. Hence, GSTN can return error messages. Here are some of the common error codes from GSTN. You can find more information on the GSTN portal on GST Developer Portal.

Error codeError Description
AUTH_9002Invalid User ID or Password. Please try again
AUTH_9033Your Password has expired. Please change your password
AUTH_9035Account is Locked
AUTH_9036Username and ClientId combination is invalid
AUTH113Invalid Return Period
AUTH117GSTR1 is already filed for the current period
AUTH119GSTR3 is not filed for the previous period
AUTH141Mandatory Parameters - GSTIN or Return Period missing
AUTH143Invalid request parameters
AUTH150GST Practioner is not a valid-user
AUTH151You are not authorized to access GSTR1 for this return period
AUTH4032Invalid USER
AUTH4035Invalid Request Action
OTP0001GSTIN is null
OTP0002Url parameter and header GSTIN is not matching
OTP0003Pan number is null
OTP0004formType is null
OTP0005Invalid GSTIN
OTP0006Pan Number does not match with authorized signatory pan number
OTP0007OTP generation failed as the OTP server is down. Contact Support
OTP0008Auth Token is null
OTP0009User Name is null
OTP0010User does not have authorized signatory for Given Pan number and GSTIN
OTP0011User session is null for provided auth-token and user name
RET11400Header Value Missing
RET11401API Authentication Failed
RET11402Unauthorized User
RET11403Invalid API Request
RET11404State Code is not valid
RET11405Invalid API Request Parameters
RET11406Malformed API Request
RET11407AuthToken is invalid
RET11408Invalid Transaction ID
RET11409Username is not Valid
RET11410Invalid GSTIN
RET11420An invalid API Header value
RET12501System Failure
RET12502System Failure
RET12503System Failure
RET12504System Failure
RET12505Corrupted API Payload Data
RET12521GSTR1 is already submitted for the current period
RET12523GSTR1 submit is already in progress for the current period
RET12590GSTR-1 Save/Action on Counterparty Invoices / Submit are not allowed for current date, please visit https: //www.gst.gov.in for details on GSTR-1 timelines.
RET13500Invalid Return Type
RET13501Checksum mismatch while filing and submit
RET13502System Failure
RET13504Unable to process your request. Please try after sometime
RET13504System Failure
RET13505System Failure
RET13506Invalid DSC Signature
RET13507Mismatch of signed data and payload
RET13508No Details Found for the Provided Inputs
RET13509No Invoices found for the provided Inputs
RET13510No Record Found for the provided Inputs
RET13511Date format entered is Invalid
RET191101Decrypt request Failed. Values entered are null
RET191103Corrupted Data or File
RET191104GstRequest is null
RET191106Error in JSON structure validation
RET191107At least one line item should be present.
RET191110Approval date for the given GSTIN is not present.
RET191111Invoice No. already exist in GSTR 1. Do enter the correct invoice number.
RET191112Do enter the correct State code in POS.
RET191113GSTIN you entered is same as counter Party GSTIN. Do enter the correct GSTIN.
RET191113You are not authoried to access GSTR1 for this return period
RET191113The GSTIN is invalid. Please enter a valid GSTIN.
RET191113GSTIN you entered is same as counter Party GSTIN. Do enter the correct GSTIN.
RET191114Invoice date cannot be older than the registration date of the supplier TIN.
RET191115Following invoice has linked credit/debit note(s). Do delete the linked credit/debit note(s) before deleting the invoice.
RET191117Do not repeat the same rate for the invoice
RET191117Combination of HSN , Description and Uqc can not be repeatable. Please aggregate
RET191119GSTIN of Receiver does not match the original invoice records.
RET191120Date is Invalid. Revised invoice date cannot be later than the last day of the tax period when original invoice was uploaded.
RET191121Revised Invoice No.(s) already exist in GSTR 1 of
RET191122Do enter the correct recipient State Code.
RET191123Note No.(s) already exist in for the return period
RET191124Invalid Original Invoice Details. Original invoice cannot be tracked. Please enter correct invoice number and date
RET191125Counter party of Invoice and Credit/Debit Note are different. Please enter a valid GSTIN or State code.
RET191126Note Date is Invalid. Date of note cannot exceed the current tax period and be older than 18 months
RET191131Either GSTIN or return period is missing
RET191133Invoice already exists with different CTIN or same CTIN. Please delete the existing invoice and upload again.
RET191134Invoice may already exist in another section. Do enter the correct invoice number or delete existing invoice and upload again
RET191134Credit/Debit Note number may already exist in another section. Do enter it correctly or delete existing Credit/Debit note number and upload again
RET191135Invoice already exist with different state code. Please delete the existing invoice and upload again
RET191136Either Return period or GSTIN from the header and payload are different
RET191138Error in Processing the request
RET191139Decoded payload is null
RET191140Error while reading a file
RET191141Exception while getting the data from dist cache or sql table or hbase table
RET191141Exception while getting the data from Cache
RET191143Mismatch noted in the checksum. Please enter the correct checksum to take action
RET191148No section data or Gross Turnover is available to process the request
RET191150IGST is required for interstate supply. Do remove CGST and SGST as they are not applicable.
RET191150CGST and SGST is required for intrastate supply. Do remove IGST as they are not applicable.
RET191150CGST and SGST should not be present for INTER state supply: for the Supplier TIN : and the Place of suply is :
RET191150CGST and SGST values are mondatory for INTRA state supply: for the Supplier TIN : and the Place of suply is :
RET191150IGST should not be present for INTRA state supply: for the Supplier TIN : and the Place of Supply is :
RET191150IGST is mandatory for INTER state supply: for the Supplier TIN : and the Place of Supply is :
RET191150Error while trying to determine invoice is of intrastate or interstate supply
RET191150IGST must be present for With Pay transaction but none of amounts are required for Without Pay transaction
RET191150IGST is required for With Pay Exports transactions. Do remove CGST and SGST as it is not applicable.
RET191150IGST , CGST & SGST amounts are not required for Without Pay transaction
RET191150IGST is required for Deemed Exports transactions. Do remove CGST and SGST as it is not applicable.
RET191151Do enter the correct invoice date for credit/debit transaction that matches with the original invoice date.
RET191152The ETIN is invalid. Please enter a valid Ecommerce GSTIN.
RET191152The ETIN is invalid. The Ecommerce GSTIN you entered is same as Supplier GSTIN.
RET191152Do enter the correct Ecommerce GSTIN for B2CS supplies made through e-commerce operator
RET191152Ecommerce GSTIN cannot be present for B2CS supplies made through non e-commerce operator.
RET191153Original Invoice is of Type Intra State. Please enter a valid invoice of same supply type
RET191157Orignal data for B2CS doesn't exsist.
RET191158Original Invoice date entered is invalid. Please enter a valid invoice date.
RET191159Original note cannot be tracked. Please enter correct note number and date.
RET191159Original note is not amendable. Please enter different note number and date.
RET191159Revised note is duplicate. Please enter different note number and date.
RET191160State code of Supplier and POS/Receiver state code cannot be same for B2CL. Do enter the correct State Codes.
RET191164System Component failure
RET191165Request Payload mapping failure
RET191166Decryption/Decoding failed
RET191168Orignal data for AT can't be tracked.Kindly enter valid AT details.
RET191170Do file the invoice before accepting/rejecting.
RET191171Do file the note before accepting/rejecting.
RET191172Do enter an item number that does not exist in the payload.
RET191175Do enter the correct rate as per the rate list.
RET191176Do enter the correct shipping bill date that is on or after Invoice Date and on or before today's date.
RET191178Supplier state code and place of supply (POS) cannot be different for intrastate supply.
RET191179Supplier state code and place of supply (POS) cannot be same for interstate supply.
RET191180B2CL invoice value cannot be less than 2.5 lakhs.
RET191181Do select the correct invoice type that matches with the original invoice type.
RET191182Submit Request is in progress, Uploaded request can not be processed
RET191183GSTR1 has either been filed or submitted, Hence,uploaded request can not be processed
RET191184Invoice date must be prior to July 1st 2017 for Pre GSTIN
RET191185Return Period is future date. Kindly provide valid return period
RET191188Invalid Note reason
RET191189B2CS for SEZ gstin should be interstate.
RET191189SEZ gstin should always be an interstate.
RET191190Duplicate Invoice number '' found in the payload. Please correct.
RET191191Processing Retry timeout
RET191192Processing Retry timeout, Failed to process the section(s)
RET191193Refund note type is not allowed now
RET191194Either HSN or DESC is mandatory.
RET191195The UQC entered is not valid
RET191196Revised Invoice Number is not Valid
RET191197Orignal data for TXPD can't be tracked.Kindly enter valid TXPD details.
RET191198Data can not be amended for the same return period.
RET191199Invoice type can not be changed in CDN Amendments.Kindly enter same invoice type as orignal CDN .
RET191200Supply Type can not be changed for saved CDN .Kindly enter same supply type as orignal CDN .
RET191202Invoice date should be before note date and return period.
RET191203The invoice number entered is invalid. Please enter a valid invoice number
RET191203The invoice is of type . Please enter the valid invoice type
RET191204Please select the preference first and then proceed
RET191221Document date cannot be on or after implementation of the date of new returns.
RET191222GSTR1 for the period in which the document was originally reported has not been filed. Please file the same before amendment.
RET191223GSTR-1 for the period to which the document pertains has not been filed. Please add the document in the said period GSTR-1.
RET191224You are not allowed to add invoice for the disable section.
RET191229State code of Supplier and POS/Receiver state code cannot be same for B2CL section in a note. Do enter the correct State Codes..
RET31400API Header Value Missing
RET31401API Authentication Failed
RET31402API Authorization Failed
RET31403Invalid API Request
RET31404Invalid API Header value
RET31405Invalid API Request Parameters
RET31406Malformed API Request
RET32501System Failure
RET33500Invalid Return Type
RET33508No Details Found for the Provided Inputs
RET33509No Invoices found for the provided Inputs
RET33510No Record found for the provided Inputs
RET33511Date format entered is Invalid
RET33512GSTR3 is not filed for previous period
RET33513Please submit GSTR3 before filling
RET33514Gstr3 is already filled
RET33515GSTR3 not generated
RET33516GSTR1 has been filed GSTR2 has not been filed
RET33517GSTR1 has not been filed GSTR2 has been filed
RET33518GSTR1 has not been filed GSTR2 has not been filed
RET33519Unable to fetch Ledger Details
RT_FIL_017User Is not Registered to any DSC
RT_FIL_018Pan is not registered for the given gstin
RT_FIL_02GSTR1 is already filed
RT_FIL_09Signed summary is not the latest one
RT_FIL_10Please submit the invoices before filing
RT_FIL_24Some Error Occured while saving DSC data.Please try again.
RT_FIL_25Summary Checksum generation is in progress.Please Try after sometime
RT_FIL_31User is not authorized to File with EVC Option
RT-3BABD1002Error Occurred while saving GSTR3B
RT-3BABD1004Named Query retrieval is null
RT-3BABD1005No data found for given gstin and return period
RT-3BABD1006Gstr3B Save Still under processing
RT-3BAC1001API header has exception
RT-3BAC1003GSTIN is null/empty in API
RT-3BAC1004Return period is null/empty
RT-3BAC1011Auth token is null/empty
RT-3BAD1003Error Occurred while saving GSTR3B DSC data
RT-3BAS1015GSTR3B is not filed for previous period
RT-3BAS1021Payload is null/empty
RT-3BAS1025Exception occurred due to validation failure
RT-3BAS1026GSTR3B offsetting is not done and/or liabilities are not cleared and attempted filing
RT-3BAS1027Checksum mismatch while filing and submit
RT-3BAS1029Mismatch of signed data and payload
RT-3BAS1030Invalid DSC Signature
RT-3BAS1031Validating authentication has failed at emas
RT-3BAS1032Not Registered Pan for given GSTIN ID
RT-3BAS1033Invalid DSC Type
RT-3BAS1034Error In GSTR3B File Generation
RT-3BAS1035Could not generate ARN or ARN is null
RT-3BAS1036Error Occurred while updating the status
RT-3BAS1042Invalid File Request
RT-3BAS1052GSTR-3B for the tax period cannot be saved/submitted as GSTR-3 for this tax period is already generated
RT-3BAS1053Already Submitted/Filled For Current Return Period
RT-3BAS1054GSTR3B is not submitted
RT-3BAS1055Submitted TRAN-1 form but not Filled
RT-3BAS1056Clear the pending liability to proceed for filing
RT-3BAS1057Improper user details/gstmaster is null
RT-3BAS1058Previous return period is invalid
RT-3BAS1065Registration date is invalid for selected return period
RT-3BAS1066Invalid registration type
RT-3BGV1001GSTR3B form is not applicable for given return period
RT-3BGV1002Not a valid GSP
RT-3BGV1003Unauthorized User
RT-3BGV1004API Header Value Missing
RT-3BGV1005Return period is invalid in APIHeader
RT-3BGV1007State Code mismatch.
RT-3BGV1008Invalid Auth Token
RT-3BGV1009Transaction ID is Invalid
RT-3BGV1010Return Period is null/empty
RT-3BGV1011Return period is invalid
RT-3BGV1012User name is Invalid
RT-3BGV1013GSTIN is invalid
RT-3BGV1014User session is null/empty
RT-3BGV1017Transaction ID is null/empty
RT-CADS1001DSC verification failed
RT-CADS1002Invalid Pan/emsign data
RT-CARV1001Not DSC registered user
RTDSC04Pan Number or Sign is invalid
RTDSC05DSC verification failed.Please Try after sometime
RTN_02Invalid Return Date
RTN_11GSTR1 submit is under process
RTN_15Returns still under processing
RTN_17Invoices already Submitted
RTN_24File Generation is in progress, please try after sometime.
RTN_25Error In File Generation
RTN_27The User is not a Registered Normal Taxpayer
RTN_31File is Generated, please click the download button to download the file.
RTN_32Download request already in progress, please wait for the file to be generated.
RTN_FIL_28Certificate has Expired
RTN_FIL_29Certificate is not valid
RTN_FIL_30Signed summary data does not matches with encoded hash summary
TEC4001OTP generation failed as OTP server is down. Contact Support
TEC4001Technical Error
TEC4002Invalid Data Format

What’s Next