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
Save ITC03 dataPUT
Get ITC03 SummaryGET
File ITC03 dataPOST
File ITC03 dataPOST
Get ITC03 InvoicesGET
Get ITC03 InvoicesGET
Offset Liability ITC03 dataPUT
ITC04
CMP
Payment
Ledger
e-Invoice
Notices
GST APIITC03File ITC03 data

File ITC03 data

POSThttps://apisandbox.whitebooks.in/itc03/retfile

Used to File ITC03 invoices.

Parameters

query parameters
emailstringrequired
API Developer User Email
typestringrequired
Filing Type (FIL4A / FIL4B)
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
Example: "02SUPHP0001A1ZI"
rtn_typstringoptional
return Type
Example: "ITC03-4A"
comp_arnstringoptional
Composition ARN
Example: "AA0705171234561"
dofstringoptional
Document Number (Alphanumeric with / and - are allowed)
Example: "22-10-2017"
isnilstringoptional
Returns NIL
Example: "N"
sec_5aobjectoptional
chksumstringoptional
check sum value
Example: "AflJufPlFStqKBZ"
ttl_igstnumberoptional
Total IGST
Example: 124.99
ttl_cgstnumberoptional
Total CGST
Example: 3423
ttl_cessnumberoptional
Total cess
Example: 3423
ttl_taxnumberoptional
Total tax
Example: 1234
ttl_valnumberoptional
Total value
Example: 12345
ttl_recnumberoptional
Total Rec amount
Example: 10
ttl_sgstnumberoptional
Total SGST
Example: 5589.87
sec_5bobjectoptional
chksumstringoptional
check sum value
Example: "AflJufPlFStqKBZ"
ttl_igstnumberoptional
Total IGST
Example: 124.99
ttl_cgstnumberoptional
Total CGST
Example: 3423
ttl_cessnumberoptional
Total cess
Example: 3423
ttl_taxnumberoptional
Total tax
Example: 1234
ttl_valnumberoptional
Total value
Example: 12345
ttl_recnumberoptional
Total Rec amount
Example: 10
ttl_sgstnumberoptional
Total SGST
Example: 5589.87
sec_5cobjectoptional
chksumstringoptional
check sum value
Example: "AflJufPlFStqKBZ"
ttl_igstnumberoptional
Total IGST
Example: 124.99
ttl_cgstnumberoptional
Total CGST
Example: 3423
ttl_cessnumberoptional
Total cess
Example: 3423
ttl_taxnumberoptional
Total tax
Example: 1234
ttl_valnumberoptional
Total value
Example: 12345
ttl_recnumberoptional
Total Rec amount
Example: 10
ttl_sgstnumberoptional
Total SGST
Example: 5589.87
sec_5dobjectoptional
chksumstringoptional
check sum value
Example: "AflJufPlFStqKBZ"
ttl_igstnumberoptional
Total IGST
Example: 124.99
ttl_cgstnumberoptional
Total CGST
Example: 3423
ttl_cessnumberoptional
Total cess
Example: 3423
ttl_taxnumberoptional
Total tax
Example: 1234
ttl_valnumberoptional
Total value
Example: 12345
ttl_recnumberoptional
Total Rec amount
Example: 10
ttl_sgstnumberoptional
Total SGST
Example: 5589.87
sec_5eobjectoptional
chksumstringoptional
check sum value
Example: "AflJufPlFStqKBZ"
ttl_igstnumberoptional
Total IGST
Example: 124.99
ttl_cgstnumberoptional
Total CGST
Example: 3423
ttl_cessnumberoptional
Total cess
Example: 3423
ttl_taxnumberoptional
Total tax
Example: 1234
ttl_valnumberoptional
Total value
Example: 12345
ttl_recnumberoptional
Total Rec amount
Example: 10
ttl_sgstnumberoptional
Total SGST
Example: 5589.87
tax_payarray<object>optional
Array items:
tran_descstringoptional
Transaction description
Example: "Reverse charge"
liab_idintegeroptional
Liability Id
Example: 7865
trancdintegeroptional
Trans Code
Example: 30002
igstobjectoptional
intrnumberoptional
Interest Amount
Example: 0.4
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 60
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 60
pennumberoptional
Penalty Amount
Example: 0
cgstobjectoptional
intrnumberoptional
Interest Amount
Example: 0.4
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 60
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 60
pennumberoptional
Penalty Amount
Example: 0
sgstobjectoptional
intrnumberoptional
Interest Amount
Example: 0.4
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 60
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 60
pennumberoptional
Penalty Amount
Example: 0
cessobjectoptional
intrnumberoptional
Interest Amount
Example: 0.4
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 60
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 60
pennumberoptional
Penalty Amount
Example: 0
tax_paidobjectoptional
pd_by_casharray<object>optional
Array items:
igstobjectoptional
cgstobjectoptional
sgstobjectoptional
cessobjectoptional
debit_idstringoptional
debit id
Example: "DC0410170000010"
liab_idintegeroptional
Liability Id
Example: 7687
trancdintegeroptional
Trans Code
Example: 30002
trandatestringoptional
Trans Date
Example: "11-02-2024"
pd_by_itcarray<object>optional
Array items:
debit_idstringoptional
debit id
Example: "DC0410170000010"
liab_idintegeroptional
Liability Id
Example: 234
trancdintegeroptional
Trans Code
Example: 23003
trandatestringoptional
Trans Date
Example: "24-10-2017"
igst_igst_amtnumberoptional
IGST as IGST
Example: 0
igst_cgst_amtnumberoptional
IGST as CGST
Example: 0
igst_sgst_amtnumberoptional
IGST as SGST
Example: 0
sgst_sgst_amtnumberoptional
SGST as SGST
Example: 0
sgst_igst_amtnumberoptional
SGST as IGST
Example: 0
cgst_cgst_amtnumberoptional
CGST as CGST
Example: 0
cgst_igst_amtnumberoptional
CGST as IGST
Example: 0
cess_cess_amtnumberoptional
CESS as CESS
Example: 0
attachmentobjectoptional
docIdstringoptional
document id
Example: "14523361"
hashstringoptional
hash
Example: "831d017f2553223cd290d2e689e39d829f6a03df91ad2046c0d3a8a4a43622c5"
caDetailsobjectoptional
canamestringoptional
Name of the certifying Chartered Accountant/Cost Accountant
Example: "AKHIL ARORA"
firmstringoptional
Name of the certifying Chartered Accountant/Cost Accountant
Example: "TALLY"
memberstringoptional
Membership Number
Example: "567899"
cadtstringoptional
Date of issuance of certificate
Example: "04-04-2017"

Response

Not Found. If requested entity is not found or if requested API is not found.
POST/itc03/retfile
1const response = await fetch('https://apisandbox.whitebooks.in/itc03/retfile?email=value&type=value', {
2 method: 'POST',
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": "02SUPHP0001A1ZI",
16 "rtn_typ": "ITC03-4A",
17 "comp_arn": "AA0705171234561",
18 "dof": "22-10-2017",
19 "isnil": "N",
20 "sec_5a": {
21 "chksum": "AflJufPlFStqKBZ",
22 "ttl_igst": 124.99,
23 "ttl_cgst": 3423,
24 "ttl_cess": 3423,
25 "ttl_tax": 1234,
26 "ttl_val": 12345,
27 "ttl_rec": 10,
28 "ttl_sgst": 5589.87
29 },
30 "sec_5b": {
31 "chksum": "AflJufPlFStqKBZ",
32 "ttl_igst": 124.99,
33 "ttl_cgst": 3423,
34 "ttl_cess": 3423,
35 "ttl_tax": 1234,
36 "ttl_val": 12345,
37 "ttl_rec": 10,
38 "ttl_sgst": 5589.87
39 },
40 "sec_5c": {
41 "chksum": "AflJufPlFStqKBZ",
42 "ttl_igst": 124.99,
43 "ttl_cgst": 3423,
44 "ttl_cess": 3423,
45 "ttl_tax": 1234,
46 "ttl_val": 12345,
47 "ttl_rec": 10,
48 "ttl_sgst": 5589.87
49 },
50 "sec_5d": {
51 "chksum": "AflJufPlFStqKBZ",
52 "ttl_igst": 124.99,
53 "ttl_cgst": 3423,
54 "ttl_cess": 3423,
55 "ttl_tax": 1234,
56 "ttl_val": 12345,
57 "ttl_rec": 10,
58 "ttl_sgst": 5589.87
59 },
60 "sec_5e": {
61 "chksum": "AflJufPlFStqKBZ",
62 "ttl_igst": 124.99,
63 "ttl_cgst": 3423,
64 "ttl_cess": 3423,
65 "ttl_tax": 1234,
66 "ttl_val": 12345,
67 "ttl_rec": 10,
68 "ttl_sgst": 5589.87
69 },
70 "tax_pay": [
71 {
72 "tran_desc": "Reverse charge",
73 "liab_id": 7865,
74 "trancd": 30002,
75 "igst": {
76 "intr": 0.4,
77 "oth": 0,
78 "tx": 60,
79 "fee": 0,
80 "tot": 60,
81 "pen": 0
82 },
83 "cgst": {
84 "intr": 0.4,
85 "oth": 0,
86 "tx": 60,
87 "fee": 0,
88 "tot": 60,
89 "pen": 0
90 },
91 "sgst": {
92 "intr": 0.4,
93 "oth": 0,
94 "tx": 60,
95 "fee": 0,
96 "tot": 60,
97 "pen": 0
98 },
99 "cess": {
100 "intr": 0.4,
101 "oth": 0,
102 "tx": 60,
103 "fee": 0,
104 "tot": 60,
105 "pen": 0
106 }
107 }
108 ],
109 "tax_paid": {
110 "pd_by_cash": [
111 {
112 "igst": {
113 "intr": 4,
114 "oth": 0,
115 "tx": 1,
116 "fee": 0,
117 "tot": 4,
118 "pen": 0
119 },
120 "cgst": {
121 "intr": 4,
122 "oth": 0,
123 "tx": 1,
124 "fee": 0,
125 "tot": 4,
126 "pen": 0
127 },
128 "sgst": {
129 "intr": 4,
130 "oth": 0,
131 "tx": 1,
132 "fee": 0,
133 "tot": 4,
134 "pen": 0
135 },
136 "cess": {
137 "intr": 4,
138 "oth": 0,
139 "tx": 1,
140 "fee": 0,
141 "tot": 4,
142 "pen": 0
143 },
144 "debit_id": "DC0410170000010",
145 "liab_id": 7687,
146 "trancd": 30002,
147 "trandate": "11-02-2024"
148 }
149 ],
150 "pd_by_itc": [
151 {
152 "debit_id": "DC0410170000010",
153 "liab_id": 234,
154 "trancd": 23003,
155 "trandate": "24-10-2017",
156 "igst_igst_amt": 0,
157 "igst_cgst_amt": 0,
158 "igst_sgst_amt": 0,
159 "sgst_sgst_amt": 0,
160 "sgst_igst_amt": 0,
161 "cgst_cgst_amt": 0,
162 "cgst_igst_amt": 0,
163 "cess_cess_amt": 0
164 }
165 ]
166 },
167 "attachment": {
168 "docId": "14523361",
169 "hash": "831d017f2553223cd290d2e689e39d829f6a03df91ad2046c0d3a8a4a43622c5",
170 "caDetails": {
171 "caname": "AKHIL ARORA",
172 "firm": "TALLY",
173 "member": "567899",
174 "cadt": "04-04-2017"
175 }
176 }
177}),
178});
179
180const data = await response.json();
181console.log(data);
No example available.