GST APIEnvironment:
Default OTP575757
API Reference
Overview
Public
Authentication
GSTR
GSTR1
GSTR1A
GSTR2A
GSTR2B
GSTR2X
GSTR3B
GSTR4
GSTR4A
GSTR4Annual
GSTR5
Get B2B InvoicesGET
Get B2BA InvoicesGET
Get CDNR InvoicesGET
Get CDNRA InvoicesGET
Get IMPG InvoicesGET
Get IMPGA InvoicesGET
Get IMPS InvoicesGET
Get IMPSA InvoicesGET
Save GSTR5 dataPUT
Get CDNA UnregisteredGET
Get GSTR5 SummaryGET
SubmitPOST
File GSTR5POST
File GSTR5 dataPOST
Get B2CL InvoicesGET
Get B2CS InvoicesGET
Get CDN UnregisteredGET
Get Tax LiabGET
Offset Liability GSTR5 dataPUT
Get B2CLA InvoicesGET
Get B2CSA InvoicesGET
GSTR6
GSTR6A
GSTR7
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
CMP
Payment
Ledger
e-Invoice
Notices
GST APIGSTR5Save GSTR5 data

Save GSTR5 data

PUThttps://apisandbox.whitebooks.in/gstr5/retsave

Used to save entire GSTR5 invoices.

Parameters

query parameters
emailstringrequired
User Email
header parameters
gstinstringrequired
GST Number
ret_periodstringrequired
Return Period (MMYYYY)
gst_usernamestringrequired
GST UserName
state_cdstringrequired
State Code
ip_addressstringrequired
IP Address
txnstringrequired
Transaction
client_idstringrequired
Client ID
client_secretstringrequired
Client Secret

Request Body

application/jsonrequired
gstinstringoptional
GSTIN number
Example: "0817GBR00014NRX"
fpstringoptional
Fp Type
Example: "082016"
b2barray<object>optional
Array items:
ctinstringoptional
GSTIN/UID of the Receiver taxpayer/UN,Govt Bodies
Example: "01AABCE2207R1Z5"
invarray<object>optional
Array items:
flagstringoptional
Gross TrunOver
Example: "D"
inumstringoptional
Supplier Invoice Number
Example: "S008400"
idtstringoptional
Supplier Invoice Date
Example: "24-01-2024"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
diff_percentnumberoptional
Differential percentage
Example: 0.65
itmsarray<object>optional
b2baarray<object>optional
Array items:
ctinstringoptional
GSTIN/UID of the Receiver taxpayer/UN,Govt Bodies
Example: "01AABCE2207R1Z5"
invarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
oinumstringoptional
Supplier Invoice Number
Example: "S008400"
oidtstringoptional
Supplier Invoice Date
Example: "24-01-2024"
inumstringoptional
Supplier Invoice Number
Example: "S008400"
idtstringoptional
Supplier Invoice Date
Example: "24-01-2024"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
diff_percentnumberoptional
Differential percentage
Example: 0.65
itmsarray<object>optional
b2clarray<object>optional
Array items:
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service
Example: "05"
invarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
inumstringoptional
Supplier Invoice Number
Example: "S008400"
idtstringoptional
Supplier Invoice Date
Example: "24-01-2024"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
diff_percentnumberoptional
Differential percentage
Example: 0.65
itmsarray<object>optional
b2claarray<object>optional
Array items:
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service
Example: "06"
invarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
inumstringoptional
Supplier Invoice Number
Example: "92661"
idtstringoptional
Supplier Invoice Date
Example: "24-01-2024"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
oinumstringoptional
Supplier Invoice Number
Example: "S008400"
oidtstringoptional
Supplier Invoice Date
Example: "24-01-2024"
diff_percentnumberoptional
Differential percentage
Example: 0.65
itmsarray<object>optional
b2csarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
suptystringoptional
Supply Type of B2cs
Example: "INTER"
rtnumberoptional
rate
Example: 5
posstringoptional
Recipient state code
Example: "05"
diff_percentnumberoptional
Differential percentage
Example: 0.65
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 100
iamtnumberoptional
IGST Amount as per invoice
Example: 10
csamtnumberoptional
Cess Amount as per invoice
Example: 10
b2csaarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
suptystringoptional
Supply Type of B2cs
Example: "INTER"
posstringoptional
Recipient state code
Example: "05"
diff_percentnumberoptional
Differential percentage
omonstringoptional
Original Month
Example: "122016"
itmsarray<object>optional
Array items:
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
rtnumberoptional
rate
Example: 5
iamtnumberoptional
IGST Amount as per invoice
Example: 10
camtnumberoptional
CGST Amount as per invoice
Example: 0
samtnumberoptional
SGST Amount as per invoice
Example: 0
csamtnumberoptional
Cess Amount as per invoice
Example: 10
cdnarray<object>optional
Array items:
ctinstringoptional
GSTIN/UID of the Receiver taxpayer/UN,Govt Bodies
Example: "01AABCE2207R1Z5"
ntarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
nttystringoptional
Credit/debit note type
Example: "C"
nt_numstringoptional
Credit/debit note number
Example: "533515"
nt_dtstringoptional
Credit/debit note date
Example: "23-03-2024"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
diff_percentnumberoptional
Differential percentage
Example: 0.65
itmsarray<object>optional
cdnaarray<object>optional
Array items:
ctinstringoptional
GSTIN/UID of the Receiver taxpayer/UN,Govt Bodies
Example: "01AABCE2207R1Z5"
ntarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
nttystringoptional
Credit/debit note type
Example: "C"
nt_numstringoptional
Credit/debit note number
Example: "533515"
nt_dtstringoptional
Credit/debit note date
Example: "23-03-2024"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
diff_percentnumberoptional
Differential percentage
Example: 0.65
ont_numstringoptional
Original Credit/debit note number
Example: "533515"
ont_dtstringoptional
Original Credit/debit note date
Example: "23-04-2024"
itmsarray<object>optional
cdnurarray<object>optional
items: any
cdnuraarray<object>optional
Array items:
flagstringoptional
Taxpayer action
Example: "E"
valnumberoptional
Supplier Invoice Value
Example: 729248.16
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
nttystringoptional
Credit/debit note type
Example: "C"
nt_numstringoptional
Credit/debit note number
Example: "533515"
nt_dtstringoptional
Credit/debit note date
Example: "23-03-2024"
ont_numstringoptional
Original Credit/debit note number
Example: "533515"
ont_dtstringoptional
Original Credit/debit note date
Example: "23-04-2024"
diff_percentnumberoptional
Differential percentage
Example: 0.65
itmsarray<object>optional
Array items:
numintegeroptional
Serial no
Example: 1
itm_detobjectoptional
imp_garray<object>optional
Array items:
flagstringoptional
Flag for identifying New/Modified
Example: "E"
boe_numstringoptional
Bill of Entry Number
Example: "2566212"
boe_dtstringoptional
Bill Of Entry Date
Example: "23-09-2016"
boe_valnumberoptional
Bill Of Entry Value
Example: 10000
port_codestringoptional
Port Code
Example: "24242A"
diff_percentnumberoptional
Differential Percentage of Tax
Example: 0.65
itmsarray<object>optional
Array items:
numintegeroptional
Serial no
Example: 1
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
rtnumberoptional
rate
Example: 5
iamtnumberoptional
IGST Amount as per invoice
Example: 325
csamtnumberoptional
Cess Amount as per invoice
Example: 500
elgstringoptional
Eligibility for ITC
Example: "ip"
tx_inumberoptional
Total IGST available as ITC
Example: 123.93
tx_csnumberoptional
Total CESS available as ITC
Example: 0
imp_gaarray<object>optional
Array items:
flagstringoptional
Flag for identifying New/Modified
Example: "E"
boe_numstringoptional
Bill of Entry Number
Example: "2566212"
boe_dtstringoptional
Bill Of Entry Date
Example: "23-09-2016"
boe_valnumberoptional
Bill Of Entry Value
Example: 10000
port_codestringoptional
Port Code
Example: "24242A"
oboe_numstringoptional
Original Bill of Entry Number
Example: "2566212"
oboe_dtstringoptional
Original Bill Of Entry Date
Example: "23-09-2016"
oport_codestringoptional
Original Port Code
Example: "24242A"
diff_percentnumberoptional
Differential Percentage of Tax
Example: 0.65
itmsarray<object>optional
Array items:
numintegeroptional
Serial no
Example: 1
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
rtnumberoptional
rate
Example: 5
iamtnumberoptional
IGST Amount as per invoice
Example: 325
csamtnumberoptional
Cess Amount as per invoice
Example: 500
elgstringoptional
Eligibility for ITC
Example: "ip"
tx_inumberoptional
Total IGST available as ITC
Example: 123.93
tx_csnumberoptional
Total CESS available as ITC
Example: 0

Response

Not Found. If requested entity is not found or if requested API is not found.
PUT/gstr5/retsave
1const response = await fetch('https://apisandbox.whitebooks.in/gstr5/retsave?email=value', {
2 method: 'PUT',
3 headers: {
4 gstin: "value",
5 ret_period: "value",
6 gst_username: "value",
7 state_cd: "value",
8 ip_address: "value",
9 txn: "value",
10 client_id: "value",
11 client_secret: "value",
12 Content-Type: "application/json"
13},
14 body: JSON.stringify({
15 "gstin": "0817GBR00014NRX",
16 "fp": "082016",
17 "b2b": [
18 {
19 "ctin": "01AABCE2207R1Z5",
20 "inv": [
21 {
22 "flag": "D",
23 "inum": "S008400",
24 "idt": "24-01-2024",
25 "val": 729248.16,
26 "pos": "06",
27 "diff_percent": 0.65,
28 "itms": [
29 "..."
30 ]
31 }
32 ]
33 }
34 ],
35 "b2ba": [
36 {
37 "ctin": "01AABCE2207R1Z5",
38 "inv": [
39 {
40 "flag": "E",
41 "oinum": "S008400",
42 "oidt": "24-01-2024",
43 "inum": "S008400",
44 "idt": "24-01-2024",
45 "val": 729248.16,
46 "pos": "06",
47 "diff_percent": 0.65,
48 "itms": [
49 "..."
50 ]
51 }
52 ]
53 }
54 ],
55 "b2cl": [
56 {
57 "pos": "05",
58 "inv": [
59 {
60 "flag": "E",
61 "inum": "S008400",
62 "idt": "24-01-2024",
63 "val": 729248.16,
64 "diff_percent": 0.65,
65 "itms": [
66 "..."
67 ]
68 }
69 ]
70 }
71 ],
72 "b2cla": [
73 {
74 "pos": "06",
75 "inv": [
76 {
77 "flag": "E",
78 "inum": "92661",
79 "idt": "24-01-2024",
80 "val": 729248.16,
81 "oinum": "S008400",
82 "oidt": "24-01-2024",
83 "diff_percent": 0.65,
84 "itms": [
85 "..."
86 ]
87 }
88 ]
89 }
90 ],
91 "b2cs": [
92 {
93 "flag": "E",
94 "supty": "INTER",
95 "rt": 5,
96 "pos": "05",
97 "diff_percent": 0.65,
98 "txval": 100,
99 "iamt": 10,
100 "csamt": 10
101 }
102 ],
103 "b2csa": [
104 {
105 "flag": "E",
106 "supty": "INTER",
107 "pos": "05",
108 "diff_percent": 0,
109 "omon": "122016",
110 "itms": [
111 {
112 "txval": 10000,
113 "rt": 5,
114 "iamt": 10,
115 "camt": 0,
116 "samt": 0,
117 "csamt": 10
118 }
119 ]
120 }
121 ],
122 "cdn": [
123 {
124 "ctin": "01AABCE2207R1Z5",
125 "nt": [
126 {
127 "flag": "E",
128 "ntty": "C",
129 "nt_num": "533515",
130 "nt_dt": "23-03-2024",
131 "val": 729248.16,
132 "pos": "06",
133 "diff_percent": 0.65,
134 "itms": [
135 "..."
136 ]
137 }
138 ]
139 }
140 ],
141 "cdna": [
142 {
143 "ctin": "01AABCE2207R1Z5",
144 "nt": [
145 {
146 "flag": "E",
147 "ntty": "C",
148 "nt_num": "533515",
149 "nt_dt": "23-03-2024",
150 "val": 729248.16,
151 "pos": "06",
152 "diff_percent": 0.65,
153 "ont_num": "533515",
154 "ont_dt": "23-04-2024",
155 "itms": [
156 "..."
157 ]
158 }
159 ]
160 }
161 ],
162 "cdnur": [
163 {}
164 ],
165 "cdnura": [
166 {
167 "flag": "E",
168 "val": 729248.16,
169 "pos": "06",
170 "ntty": "C",
171 "nt_num": "533515",
172 "nt_dt": "23-03-2024",
173 "ont_num": "533515",
174 "ont_dt": "23-04-2024",
175 "diff_percent": 0.65,
176 "itms": [
177 {
178 "num": 1,
179 "itm_det": {
180 "txval": "...",
181 "rt": "...",
182 "iamt": "...",
183 "csamt": "..."
184 }
185 }
186 ]
187 }
188 ],
189 "imp_g": [
190 {
191 "flag": "E",
192 "boe_num": "2566212",
193 "boe_dt": "23-09-2016",
194 "boe_val": 10000,
195 "port_code": "24242A",
196 "diff_percent": 0.65,
197 "itms": [
198 {
199 "num": 1,
200 "txval": 10000,
201 "rt": 5,
202 "iamt": 325,
203 "csamt": 500,
204 "elg": "ip",
205 "tx_i": 123.93,
206 "tx_cs": 0
207 }
208 ]
209 }
210 ],
211 "imp_ga": [
212 {
213 "flag": "E",
214 "boe_num": "2566212",
215 "boe_dt": "23-09-2016",
216 "boe_val": 10000,
217 "port_code": "24242A",
218 "oboe_num": "2566212",
219 "oboe_dt": "23-09-2016",
220 "oport_code": "24242A",
221 "diff_percent": 0.65,
222 "itms": [
223 {
224 "num": 1,
225 "txval": 10000,
226 "rt": 5,
227 "iamt": 325,
228 "csamt": 500,
229 "elg": "ip",
230 "tx_i": 123.93,
231 "tx_cs": 0
232 }
233 ]
234 }
235 ]
236}),
237});
238
239const data = await response.json();
240console.log(data);
No example available.