GST APIEnvironment:
Default OTP575757
API Reference
Overview
Public
Authentication
GSTR
GSTR1
GSTR1A
GSTR2A
GSTR2B
GSTR2X
GSTR3B
GSTR4
GSTR4A
GSTR4Annual
GSTR5
GSTR6
GSTR6A
GSTR7
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
Save ITC04 dataPUT
Get ITC04 SummaryGET
File ITC04 dataPOST
File ITC04 dataPOST
Validate TurnOver ITC04 dataGET
Get ITC04 InvoicesGET
CMP
Payment
Ledger
e-Invoice
Notices
GST APIITC04Save ITC04 data

Save ITC04 data

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

Used to save entire ITC04 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: "12AVVVH1234HA1X"
fpstringoptional
Financial Year
Example: "032019"
m2jwarray<object>optional
Array items:
flagstringoptional
Action to be taken
Example: "N"
jw_stcdstringoptional
Recipient state code
Example: "18"
chnumstringoptional
ch number
Example: "A4"
chdtstringoptional
ch date
Example: "12-09-2017"
itmsarray<object>optional
Array items:
goods_tystringoptional
Goods Type
Example: "5a"
descstringoptional
Goods description
Example: "fvsdfag"
uqcstringoptional
uqc
Example: "BKL"
qtynumberoptional
Quantity
Example: 11
valnumberoptional
value of goods
Example: 31231
tx_cnumberoptional
Total CGST Value
Example: 0
tx_snumberoptional
Total SGST Value
Example: 0
tx_inumberoptional
Total IGST Value
Example: 12
tx_csnumberoptional
Total cess Value
Example: 0
table5Aarray<object>optional
Array items:
ctinstringoptional
CTIN number
Example: "12AVVVH1234HA1X"
jw_stcdstringoptional
Recipient state code
Example: "27"
flagstringoptional
Action to be taken
Example: "N"
itemsarray<object>optional
Array items:
o_chnumstringoptional
Original Challan No
Example: "N1"
o_chdtstringoptional
Original Challan Date
Example: "12-07-2017"
jw2_chnumstringoptional
Fresh Challan No
Example: "12"
jw2_chdtstringoptional
Fresh Challan Date
Example: "12-07-2017"
nat_jwstringoptional
Nature of Job Done
Example: "afgadf"
descstringoptional
Goods description
Example: "fvsdfag"
uqcstringoptional
uqc
Example: "BKL"
qtynumberoptional
Quantity
Example: 11
lwqtynumberoptional
Quantity
Example: 4
lwuqcstringoptional
UQC
Example: "BAG"
table5Barray<object>optional
Array items:
ctinstringoptional
CTIN number
Example: "12AVVVH1234HA1X"
jw_stcdstringoptional
Recipient state code
Example: "27"
flagstringoptional
Action to be taken
Example: "D"
itemsarray<object>optional
Array items:
o_chnumstringoptional
Original Challan No
Example: "N2"
o_chdtstringoptional
Original Challan Date
Example: "12-07-2017"
jw2_chnumstringoptional
Fresh Challan No
Example: "12"
jw2_chdtstringoptional
Fresh Challan Date
Example: "12-07-2017"
nat_jwstringoptional
Nature of Job Done
Example: "fgafgdf"
descstringoptional
Goods description
Example: "fvsdfag"
uqcstringoptional
uqc
Example: "BKL"
qtynumberoptional
Quantity
Example: 11
lwqtynumberoptional
Quantity
Example: 4
lwuqcstringoptional
UQC
Example: "BAG"
table5Carray<object>optional
Array items:
ctinstringoptional
GSTIN number
Example: "12AVVVH1234HA1X"
jw_stcdstringoptional
Recipient state code
Example: "27"
flagstringoptional
Action to be taken
Example: "D"
itemsarray<object>optional
Array items:
o_chnumstringoptional
Original Challan No
Example: "A4"
o_chdtstringoptional
Original Challan Date
Example: "12-07-2017"
inumstringoptional
Fresh Invoice No
Example: "24"
idtstringoptional
Fresh Invocie Date
Example: "12-07-2017"
nat_jwstringoptional
Nature of Job Done
Example: "afsdfd"
descstringoptional
Goods description
Example: "fvsdfag"
uqcstringoptional
uqc
Example: "BKL"
qtynumberoptional
Quantity
Example: 11
lwqtynumberoptional
Quantity
Example: 4
lwuqcstringoptional
UQC
Example: "BAG"

Response

Not Found. If requested entity is not found or if requested API is not found.
PUT/itc04/retsave
1const response = await fetch('https://apisandbox.whitebooks.in/itc04/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": "12AVVVH1234HA1X",
16 "fp": "032019",
17 "m2jw": [
18 {
19 "flag": "N",
20 "jw_stcd": "18",
21 "chnum": "A4",
22 "chdt": "12-09-2017",
23 "itms": [
24 {
25 "goods_ty": "5a",
26 "desc": "fvsdfag",
27 "uqc": "BKL",
28 "qty": 11,
29 "val": 31231,
30 "tx_c": 0,
31 "tx_s": 0,
32 "tx_i": 12,
33 "tx_cs": 0
34 }
35 ]
36 }
37 ],
38 "table5A": [
39 {
40 "ctin": "12AVVVH1234HA1X",
41 "jw_stcd": "27",
42 "flag": "N",
43 "items": [
44 {
45 "o_chnum": "N1",
46 "o_chdt": "12-07-2017",
47 "jw2_chnum": "12",
48 "jw2_chdt": "12-07-2017",
49 "nat_jw": "afgadf",
50 "desc": "fvsdfag",
51 "uqc": "BKL",
52 "qty": 11,
53 "lwqty": 4,
54 "lwuqc": "BAG"
55 }
56 ]
57 }
58 ],
59 "table5B": [
60 {
61 "ctin": "12AVVVH1234HA1X",
62 "jw_stcd": "27",
63 "flag": "D",
64 "items": [
65 {
66 "o_chnum": "N2",
67 "o_chdt": "12-07-2017",
68 "jw2_chnum": "12",
69 "jw2_chdt": "12-07-2017",
70 "nat_jw": "fgafgdf",
71 "desc": "fvsdfag",
72 "uqc": "BKL",
73 "qty": 11,
74 "lwqty": 4,
75 "lwuqc": "BAG"
76 }
77 ]
78 }
79 ],
80 "table5C": [
81 {
82 "ctin": "12AVVVH1234HA1X",
83 "jw_stcd": "27",
84 "flag": "D",
85 "items": [
86 {
87 "o_chnum": "A4",
88 "o_chdt": "12-07-2017",
89 "inum": "24",
90 "idt": "12-07-2017",
91 "nat_jw": "afsdfd",
92 "desc": "fvsdfag",
93 "uqc": "BKL",
94 "qty": 11,
95 "lwqty": 4,
96 "lwuqc": "BAG"
97 }
98 ]
99 }
100 ]
101}),
102});
103
104const data = await response.json();
105console.log(data);
No example available.