Introduction

What is GST?

GST which stands for Goods and Services Tax is an Indirect tax levied on the supply of goods and services in India. So, at every point of sale GST is applied. If the sale happens to be an intra-state sale 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?

Organizations with GST registration have to be compliant with each of the following steps. Failure to do so results in heavy TDS Penalties by Authorities.

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

👍

Want to know more?

Read more about GST Compliance requirements at Learn 💡 by Quicko

Why use Sandbox GST Compliance APIs?

The above GST compliance requirements are facilitated using the GST Portal. However, using the GST Portal every time is not as convenient as integrating them into your workflow. Sandbox's GST Compliance APIs allow you to integrate the compliance requirements into your own workflow and make it frictionless. 🚀

What are the different GST APIs under Sandbox?

Sandbox has grouped its GST Compliance APIs into three sections:

a. Track GST Returns API
b. Search GSTIN API
c. Search GSTIN by PAN API

a. Tax Payer Authentication API
b. Ledgers APIs
c. Registration APIs
d. Returns APIs

a. Verify GST entity using OTP API

📘

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.

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 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?