GSTR-1 B2BA


About
- Get all B2B "amended" invoices for a return period for the authenticated taxpayer (
gstin
) for the particularyear
andmonth
. - You also need to provide the
ctin
, the counter party's GSTIN for which you need the B2B invoices. - The result can be further filtered by adding
from
date andaction_required
. Theaction_required
filter is used for filter invoices where the taxpayer has some pending actions.
Endpoint
HTTP Method | Resource | Description |
---|---|---|
| /gsp/tax-payer/{gstin}/gstrs/gstr-1/b2ba/{year}/{month}?ctin={}ctin{}&action_required={}action_required{}&from={}from{} | Takes in |
Path Parameters
Param | Type | Description | Example |
---|---|---|---|
gstin |
| 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | AAAAA0000A |
year |
| Year for which Advance Tax needs to be fetched. | 2020 |
month |
| Month for which Advance Tax needs to be fetched. | 01 |
Query Parameters
Param | Type | Description | Example |
---|---|---|---|
ctin |
| Counter party GSTIN | AABAA0000A |
action_required |
| Status 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 |
from |
| From 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/AABAA0000A/gstrs/gstr-1/b2ba/2020/01?ctin=AABAA0000A&action_required=Y&from=22-06-22 \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxx' \
--header 'x-api-key: xxxxxxxxx' \
--header 'x-api-version: 1.0'
Response
- B2B Invoices
Param | Type | Description | Example |
---|---|---|---|
ctin |
| GSTIN/UID of the Receiver taxpayer/UN, Govt Bodies | 06ADECO9084R5Z4 |
cfs |
| GSTR2 filing status of counter party |
|
List{inv} | Invoice Details | Refer to the Table below |
- Invoice Details
Param | Type | Description | Example |
---|---|---|---|
flag |
| Invoice Status |
|
updby |
| Uploaded by |
|
chksum |
| Invoice Check sum value | AflJufPlFStqKBZ |
oinum |
| Original Supplier Invoice Number | S008400 |
oidt |
| Supplier Invoice Date | 03-02-2016 |
inum |
| Supplier Invoice Number | S008400 |
idt |
| Supplier Invoice Date | 03-02-2016 |
val |
| Supplier Invoice Value | 10000.00 |
pos |
| Place of Supply (statecode) | 04 |
rchrg |
| Reverse Charge |
|
etin |
| EcomOperator | 06ADECO9084R5Z5 |
inv_typ |
| Invoice type | "R- Regular B2B Invoices, DE – Deemed Exports, SEWP – SEZ Exports with payment, |
cflag |
| Counter Party Flag | A-Accepted ,R-Rejected,N-No action ,U-Uploaded, P-Pending, DF-Deferred, FR-Forward |
opd |
| Original Period | 2016-12 |
diff_percent |
| Differential percentage | .65 (65%) |
list {itms} | Item | Refer to the table below |
- Items
Param | Type | Description | Example |
---|---|---|---|
num |
| Serial no | 2 |
itm_det | Item Details | Refer to the table below |
- Item Details
Param | Type | Description | Example |
---|---|---|---|
rt |
| Rate of Invoice | 5 |
txval |
| Taxable value of Goods or Service as per invoice | 10000.00 |
iamt |
| IGST Amount as per invoice | 650.00 |
camt |
| CGST Amount as per invoice | 650.00 |
samt |
| SGST Amount as per invoice | 650.00 |
csamt |
| Cess Amount as per invoice | 650.00 |
Updated 5 days ago