GSTR-1 B2BA

About

  • Get all B2B "amended" invoices for a return period for the authenticated taxpayer (gstin) for the particular year and month.
  • 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 and action_required. The action_required filter is used for filter invoices where the taxpayer has some pending actions.

Endpoint

HTTP Method

Resource

Description

Get

/gsp/tax-payer/{gstin}/gstrs/gstr-1/b2ba/{year}/{month}?ctin={}ctin{}&action_required={}action_required{}&from={}from{}

Takes in gstin, year and month and returns amended advance tax details.

API EndpointAPI Endpoint

Path Parameters

Param

Type

Description

Example

gstin

string

15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime

AAAAA0000A

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

AABAA0000A

action_required

string

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

string

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

string

GSTIN/UID of the Receiver taxpayer/UN, Govt Bodies

06ADECO9084R5Z4

cfs

string

GSTR2 filing status of counter party

Y (Yes) or N (No)

List{inv}

Invoice Details

Refer to the Table below

  • Invoice Details

Param

Type

Description

Example

flag

string

Invoice Status

N - No Action

updby

string

Uploaded by

R - Receiver
S - Supplier

chksum

string

Invoice Check sum value

AflJufPlFStqKBZ

oinum

string

Original Supplier Invoice Number

S008400

oidt

string

Supplier Invoice Date
(DD-MM-YYYY)

03-02-2016

inum

string

Supplier Invoice Number

S008400

idt

string

Supplier Invoice Date

03-02-2016

val

num

Supplier Invoice Value

10000.00

pos

string

Place of Supply (statecode)

04

rchrg

string

Reverse Charge

Y- Yes
N - No

etin

string

EcomOperator

06ADECO9084R5Z5

inv_typ

string

Invoice type

"R- Regular B2B Invoices, DE – Deemed Exports, SEWP – SEZ Exports with payment,
SEWOP – SEZ exports without payment
CBW - Custom Bonded Warehouse"

cflag

string

Counter Party Flag

A-Accepted ,R-Rejected,N-No action ,U-Uploaded, P-Pending, DF-Deferred, FR-Forward

opd

num

Original Period
(YYYY-MM)

2016-12

diff_percent

num

Differential percentage

.65 (65%)

list {itms}

Item

Refer to the table below

  • Items

Param

Type

Description

Example

num

num

Serial no

2

itm_det

Item Details

Refer to the table below

  • Item Details

Param

Type

Description

Example

rt

num

Rate of Invoice

5

txval

num

Taxable value of Goods or Service as per invoice

10000.00

iamt

num

IGST Amount as per invoice

650.00

camt

num

CGST Amount as per invoice

650.00

samt

num

SGST Amount as per invoice

650.00

csamt

num

Cess Amount as per invoice

650.00


Did this page help you?