GST APIEnvironment:
Default OTP575757
API Reference
Overview
Public
Authentication
GSTR
GSTR1
GSTR1A
GSTR2A
GSTR2B
GSTR2X
GSTR3B
GSTR4
GSTR4A
GSTR4Annual
Save GSTR4Annual dataPUT
Get tdscmp InvoicesGET
Get txios InvoicesGET
Get validate turnover for GSTR4 Annual formGET
Get validate the liability provided in table 6 for GSTR4 Annual formGET
Get autopopulated data for table 4A/4B of GSTR4 Annual formGET
Get summary InvoicesGET
File GSTR4Annual dataPOST
File GSTR4 Annual dataPOST
GSTR5
GSTR6
GSTR6A
GSTR7
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
CMP
Payment
Ledger
e-Invoice
Notices
GST APIGSTR4AnnualSave GSTR4Annual data

Save GSTR4Annual data

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

Used to save entire GSTR4Annual 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
Supplier GSTIN
Example: "27AHQPA7588L1ZJ"
agg_turnoverintegeroptional
Aggregate Turnover
Example: 10000
fpstringoptional
Financial Period
Example: "022024"
isnilstringoptional
Action Type
Example: "N"
isresetstringoptional
Action
Example: "N"
b2borarray<object>optional
Array items:
ctinstringoptional
Supplier GSTIN
Example: "27AHQPA7588L1ZJ"
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
itmsarray<object>optional
Array items:
rtnumberoptional
rate
Example: 5
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
iamtnumberoptional
IGST Amount as per invoice
Example: 325
camtnumberoptional
CGST Amount as per invoice
Example: 0
samtnumberoptional
SGST Amount as per invoice
Example: 0
csamtnumberoptional
Cess Amount as per invoice
Example: 500
b2brarray<object>optional
Array items:
ctinstringoptional
Supplier GSTIN
Example: "27AHQPA7588L1ZJ"
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
itmsarray<object>optional
Array items:
rtnumberoptional
rate
Example: 5
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
iamtnumberoptional
IGST Amount as per invoice
Example: 325
camtnumberoptional
CGST Amount as per invoice
Example: 0
samtnumberoptional
SGST Amount as per invoice
Example: 0
csamtnumberoptional
Cess Amount as per invoice
Example: 500
b2burarray<object>optional
Array items:
rchrgstringoptional
Reverse Charge
Example: "Y"
itmsarray<object>optional
Array items:
rtnumberoptional
rate
Example: 5
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
iamtnumberoptional
IGST Amount as per invoice
Example: 325
camtnumberoptional
CGST Amount as per invoice
Example: 0
samtnumberoptional
SGST Amount as per invoice
Example: 0
csamtnumberoptional
Cess Amount as per invoice
Example: 500
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
trdnmstringoptional
trade name
Example: "ABC ltd"
sply_tystringoptional
Supply Type
Example: "INTER"
cpanstringoptional
PAN Number
Example: "AABCE2207R"
impsarray<object>optional
Array items:
itmsarray<object>optional
Array items:
rtnumberoptional
rate
Example: 5
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000
iamtnumberoptional
IGST Amount as per invoice
Example: 325
csamtnumberoptional
Cess Amount as per invoice
Example: 500
posstringoptional
Maintained in GST System common database POS as provided in law / actual provision of service.
Example: "06"
outsupplyarray<object>optional
Array items:
rtnumberoptional
rate
Example: 5
txvalnumberoptional
Taxable value of Goods or Service as per invoice
Example: 10000

Response

Not Found. If requested entity is not found or if requested API is not found.
PUT/gstr4annual/retsave
1const response = await fetch('https://apisandbox.whitebooks.in/gstr4annual/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": "27AHQPA7588L1ZJ",
16 "agg_turnover": 10000,
17 "fp": "022024",
18 "isnil": "N",
19 "isreset": "N",
20 "b2bor": [
21 {
22 "ctin": "27AHQPA7588L1ZJ",
23 "pos": "06",
24 "itms": [
25 {
26 "rt": 5,
27 "txval": 10000,
28 "iamt": 325,
29 "camt": 0,
30 "samt": 0,
31 "csamt": 500
32 }
33 ]
34 }
35 ],
36 "b2br": [
37 {
38 "ctin": "27AHQPA7588L1ZJ",
39 "pos": "06",
40 "itms": [
41 {
42 "rt": 5,
43 "txval": 10000,
44 "iamt": 325,
45 "camt": 0,
46 "samt": 0,
47 "csamt": 500
48 }
49 ]
50 }
51 ],
52 "b2bur": [
53 {
54 "rchrg": "Y",
55 "itms": [
56 {
57 "rt": 5,
58 "txval": 10000,
59 "iamt": 325,
60 "camt": 0,
61 "samt": 0,
62 "csamt": 500
63 }
64 ],
65 "pos": "06",
66 "trdnm": "ABC ltd",
67 "sply_ty": "INTER",
68 "cpan": "AABCE2207R"
69 }
70 ],
71 "imps": [
72 {
73 "itms": [
74 {
75 "rt": 5,
76 "txval": 10000,
77 "iamt": 325,
78 "csamt": 500
79 }
80 ],
81 "pos": "06"
82 }
83 ],
84 "outsupply": [
85 {
86 "rt": 5,
87 "txval": 10000
88 }
89 ]
90}),
91});
92
93const data = await response.json();
94console.log(data);
No example available.