Overview

Get all B2B invoices in GSTR 2A for the authenticated taxpayer (gstin) for a return period (year and month).
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