GSTR-1 B2CS
GSTR-1 is a sales return that is required to be filed by every GST-registered person or entity. Sandbox API for getting small business-to-consumer(B2CS) invoice(less than 2.5 lakhs) details for a return period of the authenticated taxpayer.
About
- Get all B2C HSN invoices for a return period for the authenticated taxpayer (
gstin) for the particularyearandmonth. - You also need to provide the
state_code.
Endpoint
| HTTP Method | Resource |
|---|---|
Get | /gsp/tax-payer/{gstin}/gstrs/gstr-1/b2cs/{year}/{month} |
Request
Follow the below guidelines to pass GSTIN, year & month for getting small business-to-consumer(B2CS) 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 |
Once the values are added, Your curl will look something like this
curl --request GET \
--url https://api.sandbox.co.in/gsp/tax-payer/22AAAAA0000A1Z5/gstrs/gstr-1/b2cs/2020/01 \
--header 'Authorization: xxxxxxxxxx' \
--header 'accept: application/json' \
--header 'x-api-key: xxxxxxxxxx' \
--header 'x-api-version: 1.0'
Test Environment Not Available
Response
The response includes the following small B2B invoices details below
| Param | Type | Description | Example |
|---|---|---|---|
| pos | string | Place of Supply | 06 |
| chksum | string | Invoice Check sum value | ASDFGJKLPTBBJKBJKBBJKBB |
| sply_ly | string | Supply Type | INTER |
| rt | num | Rate as per invoice | 5 |
| typ | string | Type | E |
| etin | string | Ecom Operator Gstin | 20ABCDE7588L1ZJ |
| txval | num | Taxable value of Goods or Service as per invoice | 110 |
| iamt | num | IGST Amount as per invoice | 10 |
| camt | num | CGST Amount as per invoice | 1000.00 |
| samt | num | SGST Amount as per invoice | 1000.00 |
| csamt | num | Cess Amount as per invoice | 10 |
| flag | string | Invoice Status | N |
| diff_percent | num | Differential percentage | .65 (65%) |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since GSTR-1 B2CS 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 5 months ago