GSTR3B Summary

4 min

Introduction

This API provides a simplified way for businesses to file their GSTR-3B returns through the integration of their GSTIN and other essential details. This enables businesses to automate their return filing process and reduce the risk of errors or delays.

Sample CURL

curl --request POST \
  --url http://signzy.tech/api/v2/patrons/..your-patron-id../gstr3bs \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"task":"summary","essentials":{"gstin":"...gstin...","username":"...username...","sek":"...sek...","appKey":"...appKey...","authToken":"...authToken...","retPeriod":"...retPeriod..."}}'

Parameter	Type	Required	Description
url	string	Yes	The endpoint URL for the API request. In this case, it is . Replace "..your-patron-id.." with your patron ID.
request	string	Yes	The HTTP request method used for the API call. In this case, it is POST.
Accept	string	Yes	The expected response format. In this case, it is set to accept any format using "/"
Accept-Language	string	Yes	The preferred language for the response messages. In this case, it is set to English (en-US).
Authorization	string	Yes	The access token required to authenticate the user and authorize the API call. Replace "<Access-Token>" with the actual token.
content-type	string	Yes	The type of data being sent in the request. In this case, it is JSON format.
task	string	Yes	The type of task to be performed using the API. In this case, it is set to "summary" for generating a summary of the GSTR-3B return.
gstin	string	Yes	The GST Identification Number (GSTIN) of the business that needs to file the GSTR-3B return.
username	string	Yes	The username or account ID of the business owner or authorized user.
sek	string	Yes	The Secret Encryption Key (SEK) for encrypting sensitive data in the API request.
appKey	string	Yes	The application key or ID for identifying the application or system making the API call.
authToken	string	Yes	The authentication token or session ID for verifying the user's identity and permissions.
retPeriod	string	Yes	The return period or month for which the GSTR-3B return needs to be filed.

Sample API Response

{
  "result": {
      "message": "..message..",
      "data": {
          "gstin": "..gstin..",
          "retPeriod": "..retPeriod..",
          "supplyDetails": {
              "outwardTaxableSuppliesNonZero": {
                  "totalTaxableValue": "..totalTaxableValue..",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..centralTax..",
                  "cess": "..cess.."
              },
              "outwardTaxableSuppliesZero": {
                  "totalTaxableValue": "..totalTaxableValue..",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..centralTax..",
                  "cess": "..cess.."
              },
              "otherOutwardSupplies": {
                  "totalTaxableValue": "..totalTaxableValue..",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..centralTax..",
                  "cess": "..cess.."
              },
              "inwardSuppliesReverseCharge": {
                  "totalTaxableValue": "..totalTaxableValue..",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..centralTax..",
                  "cess": "..cess.."
              },
              "outwardSuppliesNonGst": {
                  "totalTaxableValue": "..totalTaxableValue..",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..centralTax..",
                  "cess": "..cess.."
              }
          },
          "interStateSupplies": {
              "unregisteredPersonSupplyDetails": ["..unregisteredPersonSupplyDetails..."],
              "compositionPersonSupplyDetails": ["..compositionPersonSupplyDetails.."],
              "uinHolderSupplydetails": ["..uinHolderSupplydetails..."]
          },
          "inputTaxCreditEligible": {
              "inputTaxCreditAvailable": [{
                  "type": "..type...",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..stateTax..",
                  "cess": "..cess.."
              }],
              "inputTaxCreditReversed": [{
                  "type": "..type...",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..stateTax..",
                  "cess": "..cess.."
              }],
              "inputTaxCreditNet": [{
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..stateTax..",
                  "cess": "..cess.."
              }],
              "inputTaxCreditIneligible": [{
                  "type": "..type...",
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..stateTax..",
                  "cess": "..cess.."
              }]
          },
          "inwardSupplies": {
              "inwardSuppliesDetails": [{
                  "type": "..type..",
                  "interStateSupplies": "..interStateSupplies..",
                  "intraStateSupplies": "..intraStateSupplies.."
              }]
          },
          "interestLateFeePayable": {
              "interestDetails": {
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..stateTax..",
                  "cess": "..cess.."
              },
              "latefeeDetails": {
                  "integratedTax": "..integratedTax..",
                  "centralTax": "..centralTax..",
                  "stateTax": "..stateTax..",
                  "cess": "..cess.."
              }
          },
          "taxPayment": {
              "taxPayable": [{
                  "transactionDescription": "..transactionDescription...",
                  "liabilityLedgerId": "..liabilityLedgerId...",
                  "transactionType": "..transactionType..",
                  "igst": {
                      "taxPayable": "...taxPayable...",
                      "interestPayable": "..interestPayable...",
                      "fee": "..fee.."
                  },
                  "cgst": {
                      "taxPayable": "...taxPayable...",
                      "interestPayable": "..interestPayable...",
                      "fee": "..fee.."
                  },
                  "sgst": {
                      "taxPayable": "...taxPayable...",
                      "interestPayable": "..interestPayable...",
                      "fee": "..fee.."
                  },
                  "cess": {
                      "taxPayable": "...taxPayable...",
                      "interestPayable": "..interestPayable...",
                      "fee": "..fee.."
                  }
              }],
              "paidThroughCash": [{
                  "liabilityLedgerId": "..liabilityLedgerId...",
                  "transType": "..transType...",
                  "igstPaid": "..igstPaid..",
                  "cgstPaid": "..cgstPaid..",
                  "sgstPaid": "..sgstPaid..",
                  "cessPaid": "..cessPaid..",
                  "interestPaidAgainstIGST": "..interestPaidAgainstIGST..",
                  "interestPaidAgainstCGST": "..interestPaidAgainstCGST..",
                  "interestPaidAgainstSGST": "..interestPaidAgainstSGST..",
                  "interestPaidAgainstCess": "..interestPaidAgainstCess..",
                  "lateFeePaidAgainstIGST": "..lateFeePaidAgainstIGST..",
                  "lateFeePaidAgainstCGST": "..lateFeePaidAgainstCGST..",
                  "lateFeePaidAgainstSGST": "..lateFeePaidAgainstSGST..",
                  "lateFeePaidAgainstCESS": "..lateFeePaidAgainstCESS.."
              }],
              "paidThroughCredit": {
                  "liabilityLedgerId": "..liabilityLedgerId...",
                  "transType": "..transType..",
                  "igstPaidusingIgst": "..igstPaidusingIgst...",
                  "igstPaidusingCgst": "..igstPaidusingCgst..",
                  "igstPaidusingSgst": "..igstPaidusingSgst..",
                  "cgstPaidusingIgst": "..cgstPaidusingIgst..",
                  "cgstPaidusingCgst": "..cgstPaidusingCgst..",
                  "sgstPaidusingIgst": "..sgstPaidusingIgst..",
                  "sgstPaidusingSgst": "..sgstPaidusingSgst..",
                  "cessPaidusingCess": "..cessPaidusingCess.."
              }
          }
      }
  }
}

Parameter Name	Description
message	A message associated with the response.
gstin	GST identification number of the taxpayer.
retPeriod	Return filing period.
outwardTaxableSuppliesNonZero	Details of outward taxable supplies with non-zero tax rates.
outwardTaxableSuppliesZero	Details of outward taxable supplies with zero tax rates.
otherOutwardSupplies	Details of other outward supplies.
inwardSuppliesReverseCharge	Details of inward supplies that attract reverse charge.
outwardSuppliesNonGst	Details of outward supplies that are not subject to GST.
interStateSupplies	Details of inter-state supplies.
unregisteredPersonSupplyDetails	Details of inter-state supplies made to unregistered persons.
compositionPersonSupplyDetails	Details of inter-state supplies made to composition taxpayers.
uinHolderSupplydetails	Details of inter-state supplies made to UIN holders.
inputTaxCreditAvailable	Details of input tax credit available.
inputTaxCreditReversed	Details of input tax credit reversed.
inputTaxCreditNet	Net input tax credit available.
inputTaxCreditIneligible	Details of input tax credit ineligible for claim.
inwardSupplies	Details of inward supplies.
inwardSuppliesDetails	Details of each type of inward supplies.
type	Type of inward supplies.
interStateSupplies	Value of inter-state supplies.
intraStateSupplies	Value of intra-state supplies.
interestLateFeePayable	Details of interest and late fee payable.
interestDetails	Details of interest payable.
latefeeDetails	Details of late fee payable.
taxPayment	Details of tax payment.
transactionDescription	Description of the transaction.
liabilityLedgerId	Ledger ID for the tax liability.
transactionType	Type of transaction.
igst	Details of IGST.
cgst	Details of CGST.
sgst	Details of SGST.
cess	Details of cess.
taxPayable	Amount of tax payable.
interestPayable	Amount of interest payable.
fee	Amount of fee payable.
liabilityLedgerId	The ledger ID of the liability account for the transaction
transType	The type of transaction (e.g. sale, purchase)
igstPaid	The amount of Integrated Goods and Services Tax (IGST) paid
cgstPaid	The amount of Central Goods and Services Tax (CGST) paid
sgstPaid	The amount of State Goods and Services Tax (SGST) paid
cessPaid	The amount of Cess paid
interestPaidAgainstIGST	The amount of interest paid against IGST
interestPaidAgainstCGST	The amount of interest paid against CGST
interestPaidAgainstSGST	The amount of interest paid against SGST
interestPaidAgainstCess	The amount of interest paid against Cess
lateFeePaidAgainstIGST	The amount of late fee paid against IGST
lateFeePaidAgainstIGST	The amount of late fee paid against CGST
lateFeePaidAgainstSGST	The amount of late fee paid against SGST
lateFeePaidAgainstCESS	The amount of late fee paid against Cess
igstPaidusingIgst	The amount of IGST paid using IGST
igstPaidusingCgst	The amount of IGST paid using CGST
igstPaidusingSgst	The amount of IGST paid using SGST
cgstPaidusingIgst	The amount of CGST paid using IGST
cgstPaidusingCgst	The amount of CGST paid using CGST
sgstPaidusingIgst	The amount of SGST paid using IGST
sgstPaidusingSgst	The amount of SGST paid using SGST
cessPaidusingCess	The amount of Cess paid using Cess