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

File GSTR8 data

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

Used to File GSTR8 invoices.

Parameters

query parameters
emailstringrequired
API Developer User Email
panstringrequired
PAN Number
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 of Deductor
Example: "12AUGGC1893F3DQ"
fpstringoptional
Return Period
Example: "112017"
dflt_amtnumberoptional
Default Interest Amount
Example: 0
chksumstringoptional
Checksum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
tcsobjectoptional
gSuppMadenumberoptional
Gross Supplies Made
Example: 0
gSuppRtnnumberoptional
Gross Supplies Returned
Example: 0
ttl_iamtnumberoptional
Total IGST
Example: 0
ttl_camtnumberoptional
Total CGST
Example: 0
ttl_samtnumberoptional
Total SGST
Example: 0
ttl_amtcolnumberoptional
Total amount deducted
Example: 0
no_recintegeroptional
Total Record Count
Example: 0
chksumstringoptional
Checksum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
tcsaobjectoptional
gSuppMadenumberoptional
Gross Supplies Made
Example: 0
gSuppRtnnumberoptional
Gross Supplies Returned
Example: 0
ttl_iamtnumberoptional
Total IGST
Example: 0
ttl_camtnumberoptional
Total IGST
Example: 0
ttl_samtnumberoptional
Total IGST
Example: 0
ttl_amtcolnumberoptional
Total IGST
Example: 0
no_recintegeroptional
Total Record Count
Example: 0
chksumstringoptional
Checksum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
urdobjectoptional
gSuppMadenumberoptional
Gross Supplies Made
Example: 1000
gSuppRtnnumberoptional
Gross Supplies Returned
Example: 5000
ttl_amtcolnumberoptional
Total amount deducted
Example: -4000
no_recintegeroptional
Total Record Count
Example: 1
chksumstringoptional
Checksum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
urdaobjectoptional
gSuppMadenumberoptional
Gross Supplies Made
Example: 0
gSuppRtnnumberoptional
Gross Supplies Returned
Example: 0
ttl_amtcolnumberoptional
Total amount deducted
Example: 0
no_recintegeroptional
Total Record Count
Example: 0
chksumstringoptional
Checksum Value
Example: "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
tax_payobjectoptional
iamtobjectoptional
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 0
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 0
pennumberoptional
Penalty Amount
Example: 0
samtobjectoptional
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 0
feenumberoptional
Fee Amount
Example: 400
totnumberoptional
Total Amount
Example: 1518
pennumberoptional
Penalty Amount
Example: 0
camtobjectoptional
intrnumberoptional
Interest Amount
Example: 0
othnumberoptional
other Amount
Example: 0
txnumberoptional
Tax Amount
Example: 0
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 1518
pennumberoptional
Penalty Amount
Example: 0
liab_idintegeroptional
Liability id
Example: 0
trancdintegeroptional
Transaction code
Example: 30002
offsetarray<object>optional
Array items:
tran_cdintegeroptional
Transaction code
samtobjectoptional
intrnumberoptional
Interest Amount
Example: 0
txnumberoptional
Tax Amount
Example: 1518
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 1518
camtobjectoptional
intrnumberoptional
Interest Amount
Example: 0
txnumberoptional
Tax Amount
Example: 1518
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 1518
iamtobjectoptional
intrnumberoptional
Interest Amount
Example: 0
txnumberoptional
Tax Amount
Example: 1518
feenumberoptional
Fee Amount
Example: 0
totnumberoptional
Total Amount
Example: 1518

Response

Not Found. If requested entity is not found or if requested API is not found.
POST/gstr8/retfile
1const response = await fetch('https://apisandbox.whitebooks.in/gstr8/retfile?email=value&pan=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": "12AUGGC1893F3DQ",
16 "fp": "112017",
17 "dflt_amt": 0,
18 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5",
19 "tcs": {
20 "gSuppMade": 0,
21 "gSuppRtn": 0,
22 "ttl_iamt": 0,
23 "ttl_camt": 0,
24 "ttl_samt": 0,
25 "ttl_amtcol": 0,
26 "no_rec": 0,
27 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
28 },
29 "tcsa": {
30 "gSuppMade": 0,
31 "gSuppRtn": 0,
32 "ttl_iamt": 0,
33 "ttl_camt": 0,
34 "ttl_samt": 0,
35 "ttl_amtcol": 0,
36 "no_rec": 0,
37 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
38 },
39 "urd": {
40 "gSuppMade": 1000,
41 "gSuppRtn": 5000,
42 "ttl_amtcol": -4000,
43 "no_rec": 1,
44 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
45 },
46 "urda": {
47 "gSuppMade": 0,
48 "gSuppRtn": 0,
49 "ttl_amtcol": 0,
50 "no_rec": 0,
51 "chksum": "e019706b5c029430c81cc4f620c72adf0fc43ceb1805099abe0f1a41a79cfbc5"
52 },
53 "tax_pay": {
54 "iamt": {
55 "intr": 0,
56 "oth": 0,
57 "tx": 0,
58 "fee": 0,
59 "tot": 0,
60 "pen": 0
61 },
62 "samt": {
63 "intr": 0,
64 "oth": 0,
65 "tx": 0,
66 "fee": 400,
67 "tot": 1518,
68 "pen": 0
69 },
70 "camt": {
71 "intr": 0,
72 "oth": 0,
73 "tx": 0,
74 "fee": 0,
75 "tot": 1518,
76 "pen": 0
77 },
78 "liab_id": 0,
79 "trancd": 30002
80 },
81 "offset": [
82 {
83 "tran_cd": 0,
84 "samt": {
85 "intr": 0,
86 "tx": 1518,
87 "fee": 0,
88 "tot": 1518
89 },
90 "camt": {
91 "intr": 0,
92 "tx": 1518,
93 "fee": 0,
94 "tot": 1518
95 },
96 "iamt": {
97 "intr": 0,
98 "tx": 1518,
99 "fee": 0,
100 "tot": 1518
101 }
102 }
103 ]
104}),
105});
106
107const data = await response.json();
108console.log(data);
No example available.