Introduction - GST Compliance API

What is GST?

GST which stands for Goods and Services Tax is an Indirect tax levied on the supply of certain goods and services in India. So, at every point of sale GST is applied. And if such point of sale happens to be intra-state sales then Central GST & State GST are applied. In other transactions,i.e. in the case of inter-state sales, Integrated GST is applicable.

What are the requirements to stay GST Compliant?

  • GST registration is a must for certain traders, however, voluntary GST Registration is also permissible in most cases.
  • Once, registered, GST must be deducted from payments
  • GST collected must be deposited, and challans are received as a confirmation for the same.
  • GST Returns must be filed on a quarterly and/or annual basis.

Organizations deducting GST have to maintain compliances for each of these steps. Failure to do so results in heavy TDS Penalties by Authorities.

All the above GST system functionalities like registration, return filing, payment of GST, uploading of invoices, etc. are available through the GST Portal. However, going on GST each and every time is not convenient as integrating them into your workflow itself.

How can Sandbox APIs simplify GST Compliance?

Use Sandbox GST Compliance to remain GST Compliant:

  • Track GST Returns
  • Search GSTIN
  • Search GSTIN by PAN
  • Taxpayer API
  • GST Portal API

📘

Want to know more?

To know more, head to Learn 💡 by Quicko

GSTN Response codes

Here are some of the common error codes from GSTN. You can find more information on the GSTN portal on GST Developer Portal. As GST System is still evolving and in the implementation phase, the developer community is informed about such changes through announcements on GST Developer Portal.

Error code

Error Description

AUTH_9002

Invalid User ID or Password. Please try again

AUTH_9033

Your Password has expired. Please change your password

AUTH_9035

Account is Locked

AUTH_9036

Username and ClientId combination is invalid

AUTH113

Invalid Return Period

AUTH117

GSTR1 is already filed for the current period

AUTH119

GSTR3 is not filed for the previous period

AUTH141

Mandatory Parameters - GSTIN or Return Period missing

AUTH143

Invalid request parameters

AUTH150

GST Practioner is not a valid-user

AUTH151

You are not authorized to access GSTR1 for this return period

AUTH4032

Invalid USER

AUTH4035

Invalid Request Action

OTP0001

GSTIN is null

OTP0002

Url parameter and header GSTIN is not matching

OTP0003

Pan number is null

OTP0004

formType is null

OTP0005

Invalid GSTIN

OTP0006

Pan Number does not match with authorized signatory pan number

OTP0007

OTP generation failed as the OTP server is down. Contact Support

OTP0008

Auth Token is null

OTP0009

User Name is null

OTP0010

User does not have authorized signatory for Given Pan number and GSTIN

OTP0011

User session is null for provided auth-token and user name

RET11400

Header Value Missing

RET11401

API Authentication Failed

RET11402

Unauthorized User

RET11403

Invalid API Request

RET11404

State Code is not valid

RET11405

Invalid API Request Parameters

RET11406

Malformed API Request

RET11407

AuthToken is invalid

RET11408

Invalid Transaction ID

RET11409

Username is not Valid

RET11410

Invalid GSTIN

RET11420

An invalid API Header value

RET12501

System Failure

RET12502

System Failure

RET12503

System Failure

RET12504

System Failure

RET12505

Corrupted API Payload Data

RET12521

GSTR1 is already submitted for the current period

RET12523

GSTR1 submit is already in progress for the current period

RET12590

GSTR-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.

RET13500

Invalid Return Type

RET13501

Checksum mismatch while filing and submit

RET13502

System Failure

RET13504

Unable to process your request. Please try after sometime

RET13504

System Failure

RET13505

System Failure

RET13506

Invalid DSC Signature

RET13507

Mismatch of signed data and payload

RET13508

No Details Found for the Provided Inputs

RET13509

No Invoices found for the provided Inputs

RET13510

No Record Found for the provided Inputs

RET13511

Date format entered is Invalid

RET191101

Decrypt request Failed. Values entered are null

RET191103

Corrupted Data or File

RET191104

GstRequest is null

RET191106

Error in JSON structure validation

RET191107

At least one line item should be present.

RET191110

Approval date for the given GSTIN is not present.

RET191111

Invoice No. already exist in GSTR 1. Do enter the correct invoice number.

RET191112

Do enter the correct State code in POS.

RET191113

GSTIN you entered is same as counter Party GSTIN. Do enter the correct GSTIN.

RET191113

You are not authoried to access GSTR1 for this return period

RET191113

The GSTIN is invalid. Please enter a valid GSTIN.

RET191113

GSTIN you entered is same as counter Party GSTIN. Do enter the correct GSTIN.

RET191114

Invoice date cannot be older than the registration date of the supplier TIN.

RET191115

Following invoice has linked credit/debit note(s). Do delete the linked credit/debit note(s) before deleting the invoice.

RET191117

Do not repeat the same rate for the invoice

RET191117

Combination of HSN , Description and Uqc can not be repeatable. Please aggregate

RET191119

GSTIN of Receiver does not match the original invoice records.

RET191120

Date is Invalid. Revised invoice date cannot be later than the last day of the tax period when original invoice was uploaded.

RET191121

Revised Invoice No.(s) already exist in GSTR 1 of

RET191122

Do enter the correct recipient State Code.

RET191123

Note No.(s) already exist in for the return period

RET191124

Invalid Original Invoice Details. Original invoice cannot be tracked. Please enter correct invoice number and date

RET191125

Counter party of Invoice and Credit/Debit Note are different. Please enter a valid GSTIN or State code.

RET191126

Note Date is Invalid. Date of note cannot exceed the current tax period and be older than 18 months

RET191131

Either GSTIN or return period is missing

RET191133

Invoice already exists with different CTIN or same CTIN. Please delete the existing invoice and upload again.

RET191134

Invoice may already exist in another section. Do enter the correct invoice number or delete existing invoice and upload again

RET191134

Credit/Debit Note number may already exist in another section. Do enter it correctly or delete existing Credit/Debit note number and upload again

RET191135

Invoice already exist with different state code. Please delete the existing invoice and upload again

RET191136

Either Return period or GSTIN from the header and payload are different

RET191138

Error in Processing the request

RET191139

Decoded payload is null

RET191140

Error while reading a file

RET191141

Exception while getting the data from dist cache or sql table or hbase table

RET191141

Exception while getting the data from Cache

RET191143

Mismatch noted in the checksum. Please enter the correct checksum to take action

RET191148

No section data or Gross Turnover is available to process the request

RET191150

IGST is required for interstate supply. Do remove CGST and SGST as they are not applicable.

RET191150

CGST and SGST is required for intrastate supply. Do remove IGST as they are not applicable.

RET191150

CGST and SGST should not be present for INTER state supply: for the Supplier TIN : and the Place of suply is :

RET191150

CGST and SGST values are mondatory for INTRA state supply: for the Supplier TIN : and the Place of suply is :

RET191150

IGST should not be present for INTRA state supply: for the Supplier TIN : and the Place of Supply is :

RET191150

IGST is mandatory for INTER state supply: for the Supplier TIN : and the Place of Supply is :

RET191150

Error while trying to determine invoice is of intrastate or interstate supply
RET191150
IGST must be present for With Pay transaction but none of amounts are required for Without Pay transaction
RET191150
IGST is required for With Pay Exports transactions. Do remove CGST and SGST as it is not applicable.
RET191150
IGST , CGST & SGST amounts are not required for Without Pay transaction
RET191150
IGST is required for Deemed Exports transactions. Do remove CGST and SGST as it is not applicable.
RET191151
Do enter the correct invoice date for credit/debit transaction that matches with the original invoice date.
RET191152
The ETIN is invalid. Please enter a valid Ecommerce GSTIN.
RET191152
The ETIN is invalid. The Ecommerce GSTIN you entered is same as Supplier GSTIN.
RET191152
Do enter the correct Ecommerce GSTIN for B2CS supplies made through e-commerce operator
RET191152
Ecommerce GSTIN cannot be present for B2CS supplies made through non e-commerce operator.
RET191153
Original Invoice is of Type Intra State. Please enter a valid invoice of same supply type
RET191157
Orignal data for B2CS doesn't exsist.
RET191158
Original Invoice date entered is invalid. Please enter a valid invoice date.
RET191159
Original note cannot be tracked. Please enter correct note number and date.
RET191159
Original note is not amendable. Please enter different note number and date.
RET191159
Revised note is duplicate. Please enter different note number and date.
RET191160
State code of Supplier and POS/Receiver state code cannot be same for B2CL. Do enter the correct State Codes.
RET191164
System Component failure
RET191165
Request Payload mapping failure
RET191166
Decryption/Decoding failed
RET191168
Orignal data for AT can't be tracked.Kindly enter valid AT details.
RET191170
Do file the invoice before accepting/rejecting.
RET191171
Do file the note before accepting/rejecting.
RET191172
Do enter an item number that does not exist in the payload.
RET191175
Do enter the correct rate as per the rate list.
RET191176
Do enter the correct shipping bill date that is on or after Invoice Date and on or before today's date.
RET191178
Supplier state code and place of supply (POS) cannot be different for intrastate supply.
RET191179
Supplier state code and place of supply (POS) cannot be same for interstate supply.
RET191180
B2CL invoice value cannot be less than 2.5 lakhs.
RET191181
Do select the correct invoice type that matches with the original invoice type.
RET191182
Submit Request is in progress, Uploaded request can not be processed
RET191183
GSTR1 has either been filed or submitted, Hence,uploaded request can not be processed
RET191184
Invoice date must be prior to July 1st 2017 for Pre GSTIN
RET191185
Return Period is future date. Kindly provide valid return period
RET191188
Invalid Note reason
RET191189
B2CS for SEZ gstin should be interstate.
RET191189
SEZ gstin should always be an interstate.
RET191190
Duplicate Invoice number '' found in the payload. Please correct.
RET191191
Processing Retry timeout
RET191192
Processing Retry timeout, Failed to process the section(s)
RET191193
Refund note type is not allowed now
RET191194
Either HSN or DESC is mandatory.
RET191195
The UQC entered is not valid
RET191196
Revised Invoice Number is not Valid
RET191197
Orignal data for TXPD can't be tracked.Kindly enter valid TXPD details.
RET191198
Data can not be amended for the same return period.
RET191199
Invoice type can not be changed in CDN Amendments.Kindly enter same invoice type as orignal CDN .
RET191200
Supply Type can not be changed for saved CDN .Kindly enter same supply type as orignal CDN .
RET191202
Invoice date should be before note date and return period.
RET191203
The invoice number entered is invalid. Please enter a valid invoice number
RET191203
The invoice is of type . Please enter the valid invoice type
RET191204
Please select the preference first and then proceed
RET191221
Document date cannot be on or after implementation of the date of new returns.
RET191222
GSTR1 for the period in which the document was originally reported has not been filed. Please file the same before amendment.
RET191223
GSTR-1 for the period to which the document pertains has not been filed. Please add the document in the said period GSTR-1.
RET191224
You are not allowed to add invoice for the disable section.
RET191229
State code of Supplier and POS/Receiver state code cannot be same for B2CL section in a note. Do enter the correct State Codes..
RET31400
API Header Value Missing
RET31401
API Authentication Failed
RET31402
API Authorization Failed
RET31403
Invalid API Request
RET31404
Invalid API Header value
RET31405
Invalid API Request Parameters
RET31406
Malformed API Request
RET32501
System Failure
RET33500
Invalid Return Type
RET33508
No Details Found for the Provided Inputs
RET33509
No Invoices found for the provided Inputs
RET33510
No Record found for the provided Inputs
RET33511
Date format entered is Invalid
RET33512
GSTR3 is not filed for previous period
RET33513
Please submit GSTR3 before filling
RET33514
Gstr3 is already filled
RET33515
GSTR3 not generated
RET33516
GSTR1 has been filed GSTR2 has not been filed
RET33517
GSTR1 has not been filed GSTR2 has been filed
RET33518
GSTR1 has not been filed GSTR2 has not been filed
RET33519
Unable to fetch Ledger Details
RT_FIL_017
User Is not Registered to any DSC
RT_FIL_018
Pan is not registered for the given gstin
RT_FIL_02
GSTR1 is already filed
RT_FIL_09
Signed summary is not the latest one
RT_FIL_10
Please submit the invoices before filing
RT_FIL_24
Some Error Occured while saving DSC data.Please try again.
RT_FIL_25
Summary Checksum generation is in progress.Please Try after sometime
RT_FIL_31
User is not authorized to File with EVC Option
RT-3BABD1002
Error Occurred while saving GSTR3B
RT-3BABD1004
Named Query retrieval is null
RT-3BABD1005
No data found for given gstin and return period
RT-3BABD1006
Gstr3B Save Still under processing
RT-3BAC1001
API header has exception
RT-3BAC1003
GSTIN is null/empty in API
RT-3BAC1004
Return period is null/empty
RT-3BAC1011
Auth token is null/empty
RT-3BAD1003
Error Occurred while saving GSTR3B DSC data
RT-3BAS1015
GSTR3B is not filed for previous period
RT-3BAS1021
Payload is null/empty
RT-3BAS1025
Exception occurred due to validation failure
RT-3BAS1026
GSTR3B offsetting is not done and/or liabilities are not cleared and attempted filing
RT-3BAS1027
Checksum mismatch while filing and submit
RT-3BAS1029
Mismatch of signed data and payload
RT-3BAS1030
Invalid DSC Signature
RT-3BAS1031
Validating authentication has failed at emas
RT-3BAS1032
Not Registered Pan for given GSTIN ID
RT-3BAS1033
Invalid DSC Type
RT-3BAS1034
Error In GSTR3B File Generation
RT-3BAS1035
Could not generate ARN or ARN is null
RT-3BAS1036
Error Occurred while updating the status
RT-3BAS1042
Invalid File Request
RT-3BAS1052
GSTR-3B for the tax period cannot be saved/submitted as GSTR-3 for this tax period is already generated
RT-3BAS1053
Already Submitted/Filled For Current Return Period
RT-3BAS1054
GSTR3B is not submitted
RT-3BAS1055
Submitted TRAN-1 form but not Filled
RT-3BAS1056
Clear the pending liability to proceed for filing
RT-3BAS1057
Improper user details/gstmaster is null
RT-3BAS1058
Previous return period is invalid
RT-3BAS1065
Registration date is invalid for selected return period
RT-3BAS1066
Invalid registration type
RT-3BGV1001
GSTR3B form is not applicable for given return period
RT-3BGV1002
Not a valid GSP
RT-3BGV1003
Unauthorized User
RT-3BGV1004
API Header Value Missing
RT-3BGV1005
Return period is invalid in APIHeader
RT-3BGV1007
State Code mismatch.
RT-3BGV1008
Invalid Auth Token
RT-3BGV1009
Transaction ID is Invalid
RT-3BGV1010
Return Period is null/empty
RT-3BGV1011
Return period is invalid
RT-3BGV1012
User name is Invalid
RT-3BGV1013
GSTIN is invalid
RT-3BGV1014
User session is null/empty
RT-3BGV1017
Transaction ID is null/empty
RT-CADS1001
DSC verification failed
RT-CADS1002
Invalid Pan/emsign data
RT-CARV1001
Not DSC registered user
RTDSC04
Pan Number or Sign is invalid
RTDSC05
DSC verification failed.Please Try after sometime
RTN_02
Invalid Return Date
RTN_11
GSTR1 submit is under process
RTN_15
Returns still under processing
RTN_17
Invoices already Submitted
RTN_24
File Generation is in progress, please try after sometime.
RTN_25
Error In File Generation
RTN_27
The User is not a Registered Normal Taxpayer
RTN_31
File is Generated, please click the download button to download the file.
RTN_32
Download request already in progress, please wait for the file to be generated.
RTN_FIL_28
Certificate has Expired
RTN_FIL_29
Certificate is not valid
RTN_FIL_30
Signed summary data does not matches with encoded hash summary
TEC4001
OTP generation failed as OTP server is down. Contact Support
TEC4001
Technical Error
TEC4002
Invalid Data Format


Did this page help you?