GSTR-2A B2B
GSTR-2A is a purchase-related document that is provided to each business registered on the GST portal. Sandbox API for getting all business-to-business(B2B) invoices in GSTR 2A for a return period of the authenticated taxpayer.
Overview
- Get all B2B invoices in GSTR 2A for the authenticated taxpayer (
gstin) for a return period (yearandmonth). - You also need to provide the
ctin, the counter party's GSTIN for which you need the B2B invoices.
Endpoint
| HTTP Method | Resource | Description |
|---|---|---|
Get | https://api.sandbox.co.in/gsp/tax-payer/{gstin}/gstrs/gstr-1/at/{year}/{month} | Takes in gstin, year and month, ctin and returns B2B invoices. |
Request
Follow the below guidelines to pass GSTIN, year & month for getting B2B 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 |
Query Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| ctin | string | Counter party GSTIN | 22AABAA0000A1Z |
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-2a/b2b/2020/01?ctin=22AABAA0000A1Z' \
--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 business-to-business(B2B) invoice details below
b2bentity
| Param | Type | Description | Example |
|---|---|---|---|
| ctin | string | GSTIN/UID of the Supplier taxpayer/UN, Govt Bodies | 01AABCE2207R1Z5 |
| cfs | string | counter party Filing Status of GSTR1/5 | y |
| cfs3b | string | GSTR3B filing status | "Y/N" |
| dtcancel | string | Date of cancellation of supplier | 27-Aug-19 |
| fldtr1 | string | Date of filing GSTR1/5 of supplier | 27-Aug-19 |
| flprdr1 | string | Filing period of GSTR1/5 of supplier | Aug-19 |
| inv | object | look below | look below |
inventity
| Param | Type | Description | Example |
|---|---|---|---|
| inum | string | Supplier Invoice Number | S008400 |
| idt | string | Supplier Invoice Date | 24-11-2016 |
| oinum | string | Original Invoice Number | S008400 |
| oidt | string | Original Invoice Date | 03-02-2016 |
| val | string | Supplier Invoice Value | 729248 |
| pos | string | Place of supply | 06 |
| rchrg | string | Reverse Charge | N |
| inv_typ | string | flag to determine invoice type | R |
| diff_percent | string | Differential Percentage | 0.65 |
| aspd | string | Return period in which original invoice is visible | Dec-19 |
| atyp | string | flag to determine type of amendment | "R- Receiver GSTIN Amended N- Invoice Number Amended D- Details Amended" |
| itms | object | Look Below |
itmsentity
| Param | Type | Description | Example |
|---|---|---|---|
| rt | num | Tax Rate | 5 |
| txval | num | Taxable value of Goods or Service as per invoice | 6210.99 |
| iamt | num | IGST Amount as per invoice | 9 |
| camt | num | CGST Amount as per invoice | 614.44 |
| samt | num | SGST Amount as per invoice | 5.68 |
| csamt | num | CESS Amount as per invoice | 621.09 |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since GSTR-2A B2B 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