Save GSTR-1

GSTR-1 is a sales return that is required to be filed by every GST-registered person or entity. Sandbox API for saving the entire GSTR1 invoices data of authenticated taxpayers.

API Pricing Image

Overview

  • This is the first step in filing GSTR-1.
  • Upload GSTR-1 RAW_BODY to GSTN System for the authenticated taxpayer (gstin) for a particular year and month.

Endpoint

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass GSTIN, year & month for getting amended business-to-business(B2BA) invoice details.

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
yearstringYear for which Advance Tax needs to be fetched.2020
monthstringMonth for which Advance Tax needs to be fetched.01

Request Body

RAW BODY

ParamTypeDescriptionExample
gstinstringGSTIN of the Tax Payer22AAAAA0000A1Z5
fpstringReturn period032020
gtnumGross Turnover in the preceding Financial Year1000.00
cur_gtnumGross Turnover for the period1000.00
atobjectGSTR-1 AT
ataobjectGSTR-1 ATA
b2bobjectGSTR-1 B2B
b2baobjectGSTR-1 B2BA
b2clobjectGSTR-1 B2CL
b2claobjectGSTR-1 B2CLA
b2csobjectGSTR-1 B2CS
b2csaobjectGSTR-1 B2CSA
cdnrobjectGSTR-1 CDNR
cdnraobjectGSTR-1 CDNRA
cdnurobjectGSTR-1 CDNUR
cdnuraobjectGSTR-1 CDNURA
doc_issueobjectGSTR-1 Document Issued
expobjectGSTR-1 EXP
expaobjectGSTR-1 EXPA
hsnobjectGSTR-1 HSN Summary
nilobjectGSTR-1 NIL Supplies
txpdobject
txpdaobject

The CURL would look like this

curl --request POST \
     --url https://api.sandbox.co.in/gsp/tax-payer/%2022AAAAA0000A1Z5/gstrs/gstr-1/2020/01 \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
     "gstin": "27AHQPA7588L1ZJ",
     "fp": "122016",
     "gt": 3782969.01,
     "cur_gt": 3782969.01,
     "b2ba": [],
     "cdnur": [],
     "cdnr": [],
     "expa": [],
     "b2cs": [],
     "txpd": [],
     "ata": [],
     "nil": {
          "inv": [
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRB2B"
               },
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRB2C"
               },
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRAB2B"
               },
               {
                    "expt_amt": 0,
                    "nil_amt": 0,
                    "ngsup_amt": 0,
                    "sply_ty": "INTRAB2C"
               }
          ]
     },
     "b2b": [],
     "cdnura": [],
     "at": [],
     "b2cl": [],
     "b2cla": [],
     "b2csa": [],
     "exp": [],
     "cdnra": []
}
'

❗️

Test Environment Not Available


Response

The response includes the following Save GSTR-1 details below

ParamTypeDescriptionExample
reference_idstringReference ID243255

📘

You can always reset the data by using the Reset GSTR-1 API.

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Save GSTR-1 is a Paid API, a wallet charge of INR 0.25 + GST per API call will be applicable.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here