GSTR1 - Get B2B Invoices Attributes

Download as xlsx, pdf, or txt
Download as xlsx, pdf, or txt
You are on page 1of 15

Get B2B invoices - Request (URL parameters other than actio

Sl No Parameter Name Description Field Specification


1 gstin GSTIN of the taxpayer Alphanumeric with 15 characters

2 ret_period Return Period MMYYYY


3 action_required Status filter for filtering the invoices. Action_r Character (Y/N)
4 ctin Counter party GSTIN Alphanumeric with 15 characters

5 from_time from which time taxpayer want Invoices String (dd-mm-yyyy) 10 Characters
Get B2B Response (data)
S No Response Actual Response format
1A Get B2B Response

Generic response.If the response data is within the max size alloted,
data will contain complete B2B invoice information
1B In case the response payload is above the allotted<<max size>>, Get B2B Token Response
token will be generated as response. Using this token the user can
call GetFileDetails, Download File API's.

Get B2B Response


S No Parameter Name Description Field Specifications
1 List{b2b} B2B Invoices Refer A 1.1

A 1.1 B2B Invoices


S No Parameter Name Description Field Specifications
1 ctin GSTIN/UID of the Receiver taxpayer/UN, Govt Alphanumeric with 15 characters
Bodies
2 cfs GSTR2 filing status of counter party Character (Y/N)
3 List{inv} Invoice Details Refer to B2B Invoice Data

B2B Invoice Data


A 1.1.1 Invoice Details
S No Parameter Name Description Field Specifications

1 flag Invoice Status One Character(A/R/N/U/P)

2 updby Uploaded by String


3 chksum Invoice Check sum value String (Max length:64)
4 inum Supplier Invoice Number String (Max length:16)
5 idt Supplier Invoice Date string (DD-MM-YYYY)
6 val Supplier Invoice Value Decimal(15,2)
7 pos Place of supply String(Max length:2)
8 rchrg Reverse Charge String
etin EcomOperator Alphanumeric with 15 characters
9

inv_typ Invoice type String (Max length: 5)


(R/SEWP/SEWOP/DE/CBW)

10

cflag Counter Party Flag


11 String(A/R/M/N/U/P/DF/FR)

12 opd Original Period YYYY-MM


13 srctyp Source Type of IRN String
irn IRN number Alphanumeric with 64 characters
14

15 irngendate IRN generation Date string (DD-MM-YYYY)


diff_percent Differential percentage Decimal (3,2)
16

17 List {itms} Items Refer A 1.1.2

A 1.1.2 Items
S No Parameter Name Description Field Specifications
1 num Serial no Integer
2 itm_det Item Details Refer to A 1.1.2.1

A 1.1.2.1 Items Details


S No Parameter Name Description Field Specifications
1 rt Rate Decimal(3,2)
2 txval Taxable value of Goods or Service as per invoice Decimal(11,2)

3 iamt IGST Amount as per invoice Decimal(11,2)


4 camt CGST Amount as per invoice Decimal(11,2)
5 samt SGST Amount as per invoice Decimal(11,2)
6 csamt cess Amount as per invoice Decimal(11,2)

Get B2B Token Response


S No Parameter Name Description Field Specifications
1 token Token String
2 est Estimated Time in minutes String
arameters other than action)

Mandatory Sample Value


Y 29HJKPS9689A8Z4

Y 072016
N Y
N 20GRRHF2562D3A3

N 04-02-2017

Sample Value
if ctin attribute is present in the GET
request, list contains only the invoices
corresponds to that cgstin

Sample Value
06ADECO9084R5Z4

N
ta

Sample Value
A-Accepted ,R-Rejected, N-No action ,U- The flag shows the invoice status from
Uploaded, P-Pending the supplier perspective
R/S S- Supplier, R- Receiver
AflJufPlFStqKBZ
S008400
03-02-2016
10000.00
04
Y/N
06ADECO9084R5Z5

R- Regular B2B Invoices, DE – Deemed


Exports, SEWP – SEZ Exports with
payment,
SEWOP – SEZ exports without payment
CBW - Custom Bonded Warehouse

A-Accepted ,R-Rejected, M-Modified,N-No


action ,U-Uploaded, P-Pending,DF-Deferred,
FR-Forward
2016-12
Einvoice
897ADG56RTY78956HYUG90BNHHIJK45
3GFTD99845672FDHHHSHGFH4567FG5
6TR

03-02-2016
.65 (65%) If the attribute is present then the
value should be only 0.65
Refer A 1.1.2

Sample Value
2

Sample Value
10.00
10000.00

650.00
650.00
650.00
65.00

Sample Value
XYZABC
30

You might also like