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 APIGSTR8Save GSTR8 data

Save GSTR8 data

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

Used to save entire GSTR8 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 of Deductor
Example: "12AUGGC1893F3DQ"
fpstringoptional
Return Period
Example: "112017"
tcsarray<object>optional
Array items:
stinstringoptional
GSTIN of Supplier
Example: "05AAFPQ6179B1ZQ"
supRnumberoptional
Gross value of supplies made
Example: 10000
retsupRnumberoptional
Gross value of supplies returned
Example: 0
supUnumberoptional
Gross value of supplies made to Unregistered receiver
Example: 0
retsupUnumberoptional
Gross value of supplies returned by Unregistered receiver
Example: 0
amtnumberoptional
Net amount liable for TCS
Example: 10000
camtnumberoptional
Central Tax
Example: 10000
samtnumberoptional
State/UT Tax
Example: 10000
iamtnumberoptional
Integrated Tax
Example: 0
flagstringoptional
Action to be taken
Example: "D"
tcsaarray<object>optional
Array items:
ofpstringoptional
Original return Period of TCS
Example: "112017"
stinstringoptional
Revised GSTIN of Supplier
Example: "05AAFPQ6179B1ZQ"
ostinstringoptional
Original GSTIN of Supplier
Example: "05AAFPQ6179B1ZQ"
supRnumberoptional
Gross value of supplies made
Example: 50000
retsupRnumberoptional
Gross value of supplies returned
Example: 0
supUnumberoptional
Gross value of supplies made to Unregistered receiver
Example: 0
retsupUnumberoptional
Gross value of supplies returned by Unresgistered receiver
Example: 0
amtnumberoptional
Net amount liable for TCS
Example: 50000
camtnumberoptional
Central Tax
Example: 50
samtnumberoptional
State/UT Tax
Example: 0
iamtnumberoptional
Integrated Tax
Example: 0
flagstringoptional
Action to be taken
Example: "D"
urdarray<object>optional
Array items:
eidstringoptional
Enrolment ID of Unregistered Supplier
Example: "072300000026ES1"
grsvalnumberoptional
Gross value of supplies made
Example: 0
supretnumberoptional
Gross value of supplies returned
Example: 0
amtnumberoptional
Net value of supplies
Example: 0
flagstringoptional
Action to be taken
Example: "A"
urdaarray<object>optional
Array items:
ofpstringoptional
Original return Period
Example: "082017"
eidstringoptional
Revised Enrolment ID of Unregistered Supplier
Example: "072300000026ES1"
oeidstringoptional
Original Enrolment ID of Unregistered Supplier
Example: "072300000026ES1"
grsvalnumberoptional
Gross value of supplies made
Example: 0
supretnumberoptional
Gross value of supplies returned
Example: 0
amtnumberoptional
Net value of supplies
Example: 0
flagstringoptional
Action to be taken
Example: "A"

Response

Not Found. If requested entity is not found or if requested API is not found.
PUT/gstr8/retsave
1const response = await fetch('https://apisandbox.whitebooks.in/gstr8/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": "12AUGGC1893F3DQ",
16 "fp": "112017",
17 "tcs": [
18 {
19 "stin": "05AAFPQ6179B1ZQ",
20 "supR": 10000,
21 "retsupR": 0,
22 "supU": 0,
23 "retsupU": 0,
24 "amt": 10000,
25 "camt": 10000,
26 "samt": 10000,
27 "iamt": 0,
28 "flag": "D"
29 }
30 ],
31 "tcsa": [
32 {
33 "ofp": "112017",
34 "stin": "05AAFPQ6179B1ZQ",
35 "ostin": "05AAFPQ6179B1ZQ",
36 "supR": 50000,
37 "retsupR": 0,
38 "supU": 0,
39 "retsupU": 0,
40 "amt": 50000,
41 "camt": 50,
42 "samt": 0,
43 "iamt": 0,
44 "flag": "D"
45 }
46 ],
47 "urd": [
48 {
49 "eid": "072300000026ES1",
50 "grsval": 0,
51 "supret": 0,
52 "amt": 0,
53 "flag": "A"
54 }
55 ],
56 "urda": [
57 {
58 "ofp": "082017",
59 "eid": "072300000026ES1",
60 "oeid": "072300000026ES1",
61 "grsval": 0,
62 "supret": 0,
63 "amt": 0,
64 "flag": "A"
65 }
66 ]
67}),
68});
69
70const data = await response.json();
71console.log(data);
No example available.