GSTR-1 B2B

GSTR-1 is a sales return that is required to be filed by every GST-registered person or entity. Sandbox API for getting all business-to-business(B2B) invoice details for a return period of the authenticated taxpayer.

API Pricing Image

Overview

  • Get all B2B invoices for a return period for the authenticated taxpayer (gstin) for the particular year and month.
  • The result can be further filtered by adding from date and action_required. The action_required filter is used for filter invoices where the taxpayer has some pending actions.
  • You can also provide the ctin, the counter party's GSTIN for which you need the B2B invoices.

Endpoint

HTTP MethodResource
Get/gsp/tax-payer/{gstin}/gstrs/gstr-1/b2b/{year}/{month}

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass GSTIN, year & month for getting all business-to-business(B2BA) invoice details.

Path Parameters

Follow the below guidelines to pass GSTIN, year & month for getting all business-to-business(B2B) invoice details.

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
yearstringYear for which B2B invoices need to be fetched.2020
monthstringMonth for which B2B invoices need to be fetched.01

Query Parameters

ParamTypeDescriptionExample
ctinstringCounter party GSTIN22AABAA0000A1Z
action_requiredstringStatus filter for filtering the invoices. Possible values: Y or N. Status filter for filtering the invoices. Use filter value Y to fetches the invoices where taxpayer need to take action. Already accepted or uploaded invoices can be fetched by using filter value N.Y
fromstringFrom Date (DD/MM/YYYY)21/11/2020

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/b2b/2020/01?ctin=22AABAA0000A1Z&action_required=Y&from=21%2F11%2F2020' \
     --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 Invoices
ParamTypeDescriptionExample
ctinstringGSTIN/UID of the Receiver taxpayer/UN, Govt Bodies06ADECO9084R5Z4
cfsstringGSTR2 filing status of counter partyY (Yes) or N (No)
List{inv}Invoice DetailsRefer to the Table below
  • Invoice Details
ParamTypeDescriptionExample
flagstringInvoice StatusN - No Action
updbystringUploaded byR - Receiver
S - Supplier
chksumstringInvoice Check sum valueAflJufPlFStqKBZ
inumstringSupplier Invoice NumberS008400
idtstringSupplier Invoice Date03-02-2016
valnumSupplier Invoice Value10000.00
posstring Place of Supply (statecode)04
rchrgstringReverse ChargeY- Yes
N - No
etinstringEcomOperator06ADECO9084R5Z5
inv_typstringInvoice typeR - Regular B2B Invoices
DE - Deemed Exports
SEWP - SEZ Exports with payment
SEWOP - SEZ exports without payment
CBW - Custom Bonded Warehouse
cflagstringCounter Party FlagA - Accepted
R - Rejected
M - Modified
N - No action
U - Uploaded
P - Pending
DF - Deferred
FR - Forward
opdnumOriginal Period
(YYYY-MM)
2016-12
srctypstringSource Type of IRNE-invoice
irnstringIRN number897ADG56RTY78956HYUG90BNHHIJK453GFTD99845672FDHHHSHGFH4567FG56TR
irngendatestringIRN generation Date
(DD-MM-YYYY)
03-02-2016
diff_percentnumDifferential percentage.65 (65%)
list {itms}ItemsRefer to the table below
  • Items
ParamTypeDescriptionExample
numnumSerial no2
itm_detItem DetailsRefer to the table below
  • Item Details
ParamTypeDescriptionExample
rtnumRate of Invoice10
txvalnumTaxable value of Goods or Service as per invoice10000.00
iamtnumIGST Amount as per invoice650.00
camtnumCGST Amount as per invoice650.00
samtnumSGST Amount as per invoice650.00
csamtnumCess Amount as per invoice650.00

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since GSTR-1 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