Save GSTR-3B Tax Figures as a Draft
PUT
https://apisandbox.whitebooks.in/gstr3b/retsaveUsed to save entire GSTR3B invoices.
Parameters
query parameters
emailstringrequiredUser Email
header parameters
gstinstringrequiredGST Number
ret_periodstringrequiredReturn Period (MMYYYY)
gst_usernamestringrequiredGST UserName
state_cdstringrequiredState Code
ip_addressstringrequiredIP Address
txnstringrequiredTransaction
client_idstringrequiredClient ID
client_secretstringrequiredClient Secret
Request Body
application/jsonrequired
Response
Not Found. If requested entity is not found or if requested API is not found.
Frequently Asked Questions
The payload accepts standard GSTR-3B sections:
sup_details (Table 3.1 outward and reverse-charge taxable supplies), inter_sup (Table 3.2 supplies to unregistered persons/composition taxpayers), eco_dtls (Table 3.1.1 e-commerce operator supplies), itc_elg (Table 4 eligible and ineligible ITC), and inward_sup (Table 5 exempt/nil/non-GST inward supplies).The
ret_period header must strictly follow the MMYYYY format (e.g. 042026 for April 2026). Passing invalid characters or wrong lengths returns a header validation error.After saving data via
/gstr3b/retsave, call /gstr3b/retoffset to offset tax liabilities against available cash and ITC ledger balances before initiating final filing with DSC or EVC.Yes. As long as tax liabilities have not been offset (
retoffset), you can submit an updated payload via /gstr3b/retsave to overwrite draft values.No example available.