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.
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 particularyear
andmonth
.
Endpoint
HTTP Method | Resource |
---|---|
Post | https://api.sandbox.co.in/gsp/tax-payer/{gstin}/gstrs/gstr-1/{year}/{month} |
Request
Follow the below guidelines to pass GSTIN, year & month for getting amended business-to-business(B2BA) invoice details.
Path Parameters
Param | Type | Description | Example |
---|---|---|---|
gstin | string | 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | 22AAAAA0000A1Z5 |
year | string | Year for which Advance Tax needs to be fetched. | 2020 |
month | string | Month for which Advance Tax needs to be fetched. | 01 |
Request Body
RAW BODY
Param | Type | Description | Example |
---|---|---|---|
gstin | string | GSTIN of the Tax Payer | 22AAAAA0000A1Z5 |
fp | string | Return period | 032020 |
gt | num | Gross Turnover in the preceding Financial Year | 1000.00 |
cur_gt | num | Gross Turnover for the period | 1000.00 |
at | object | GSTR-1 AT | |
ata | object | GSTR-1 ATA | |
b2b | object | GSTR-1 B2B | |
b2ba | object | GSTR-1 B2BA | |
b2cl | object | GSTR-1 B2CL | |
b2cla | object | GSTR-1 B2CLA | |
b2cs | object | GSTR-1 B2CS | |
b2csa | object | GSTR-1 B2CSA | |
cdnr | object | GSTR-1 CDNR | |
cdnra | object | GSTR-1 CDNRA | |
cdnur | object | GSTR-1 CDNUR | |
cdnura | object | GSTR-1 CDNURA | |
doc_issue | object | GSTR-1 Document Issued | |
exp | object | GSTR-1 EXP | |
expa | object | GSTR-1 EXPA | |
hsn | object | GSTR-1 HSN Summary | |
nil | object | GSTR-1 NIL Supplies | |
txpd | object | ||
txpda | object |
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
Param | Type | Description | Example |
---|---|---|---|
reference_id | string | Reference ID | 243255 |
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
Updated 4 months ago