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_BODYto GSTN System for the authenticated taxpayer (gstin) for a particularyearandmonth.
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