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 (year
andmonth
). - 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
b2b
entity
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 |
inv
entity
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 |
itms
entity
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 not a Paid API, no wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to our versioning policies here
Updated about 1 month ago