File GSTR-3B

GSTR-3B return is a simplified summary that you must file every month as a registered taxpayer. Sandbox API to file the uploaded GSTR-3B to GST Network.

Overview

  • Authenticated taxpayer (gstin) can file the uploaded GSTR-3B RAW Body to the GST portal.

Endpoint

HTTP MethodResource
POST/gsp/tax-payer/{gstin}/gstrs/gstr-3b/{year}/{month}/file

API Endpoint  Contact Us  Free Trial

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime22AAAAA0000A1Z5
yearstringYear for which Advance Tax needs to be fetched.2020
monthstringMonth for which Advance Tax needs to be fetched.01

Request Body

Once the values are added, Your curl will look something like this

curl --request POST \
     --url https://api.sandbox.co.in/gsp/tax-payer/22AAAAA0000A1Z5/gstrs/gstr-3b/2020/01/file \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
     "gstin": "29HJKPS9689A8Z4",
     "ret_period": "072016",
     "sup_details": {
          "osup_det": {
               "txval": 250,
               "iamt": 100,
               "camt": 200,
               "samt": 300,
               "csamt": 400
          },
          "osup_zero": {
               "txval": 250,
               "iamt": 100,
               "csamt": 400
          },
          "osup_nil_exmp": {
               "txval": 250
          },
          "isup_rev": {
               "txval": 250,
               "iamt": 100,
               "camt": 200,
               "samt": 300,
               "csamt": 400
          },
          "osup_nongst": {
               "txval": 250
          }
     },
     "inter_sup": {
          "unreg_details": [
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               },
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               },
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               }
          ],
          "comp_details": [
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               },
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               },
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               }
          ],
          "uin_details": [
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               },
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               },
               {
                    "pos": "07",
                    "txval": 250,
                    "iamt": 200
               }
          ]
     },
     "eco_dtls": {
          "eco_sup": {
               "txval": 250,
               "iamt": 100,
               "camt": 200,
               "samt": 300,
               "csamt": 400
          },
          "eco_reg_sup": {
               "txval": 250
          }
     },
     "itc_elg": {
          "itc_avl": [
               {
                    "ty": "IMPG",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               },
               {
                    "ty": "IMPS",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               },
               {
                    "ty": "ISRC",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               },
               {
                    "ty": "ISD",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               },
               {
                    "ty": "OTH",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               }
          ],
          "itc_rev": [
               {
                    "ty": "RUL",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               },
               {
                    "ty": "OTH",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               }
          ],
          "itc_net": {
               "iamt": 136.53,
               "camt": 274,
               "samt": 162.99,
               "csamt": 103
          },
          " itc_inelg": [
               {
                    "ty": "RUL",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               },
               {
                    "ty": "OTH",
                    "iamt": 136.53,
                    "camt": 274,
                    "samt": 162.99,
                    "csamt": 103
               }
          ]
     },
     "inward_sup": {
          "isup_details": [
               {
                    "ty": "GST",
                    "inter": 100,
                    "intra": 200
               },
               {
                    "ty": "NONGST",
                    "inter": 300,
                    "intra": 400
               }
          ]
     },
     "tx_pmt": {
          "tx_py": [
               {
                    "trans_typ": 30002,
                    "trans_desc": "Other than reverse charge",
                    "liab_ldg_id": 11191,
                    "sgst": {
                         "intr": 100,
                         "tx": 100,
                         "fee": 100
                    },
                    "cgst": {
                         "intr": 100,
                         "tx": 100,
                         "fee": 100
                    },
                    "cess": {
                         "intr": 100,
                         "tx": 100
                    },
                    "igst": {
                         "intr": 100,
                         "tx": 100
                    }
               },
               {
                    "trans_typ": 30003,
                    "trans_desc": "Reverse charge",
                    "liab_ldg_id": 11191,
                    "sgst": {
                         "intr": 100,
                         "tx": 100,
                         "fee": 100
                    },
                    "cgst": {
                         "intr": 100,
                         "tx": 100,
                         "fee": 100
                    },
                    "cess": {
                         "intr": 100,
                         "tx": 100
                    },
                    "igst": {
                         "intr": 100,
                         "tx": 100
                    }
               }
          ],
          "pdcash": [
               {
                    "liab_ldg_id": 1233,
                    "trans_typ": 30002,
                    "ipd": 3517817,
                    "cpd": 3517817,
                    "spd": 3517817,
                    "cspd": 3517817,
                    "i_intrpd": 20,
                    "c_intrpd": 30,
                    "s_intrpd": 10,
                    "cs_intrpd": 15,
                    "c_lfeepd": 13,
                    "s_lfeepd": 13
               },
               {
                    "liab_ldg_id": 1233,
                    "trans_typ": 30003,
                    "ipd": 3517817,
                    "cpd": 3517817,
                    "spd": 3517817,
                    "cspd": 3517817,
                    "i_intrpd": 20,
                    "c_intrpd": 30,
                    "s_intrpd": 10,
                    "cs_intrpd": 15,
                    "c_lfeepd": 13,
                    "s_lfeepd": 13
               }
          ],
          "pditc": {
               "liab_ldg_id": 12321,
               "trans_typ": 30002,
               "i_pdi": 3517817,
               "i_pdc": 2290459,
               "i_pds": 2290459,
               "c_pdi": 3517817,
               "c_pdc": 2290459,
               "s_pdi": 3517817,
               "s_pds": 2290459,
               "cs_pdcs": 2290459
          }
     },
     "intr_ltfee": {
          "intr_details": {
               "iamt": 10,
               "camt": 20,
               "samt": 30,
               "csamt": 40
          },
          "ltfee_details": {
               "camt": 50,
               "samt": 60
          }
     },
     "liab_breakup": [
          {
               "ret_period": "032020",
               "liability": {
                    "iamt": 1000,
                    "camt": 150,
                    "samt": 200,
                    "csamt": 300
               }
          },
          {
               "ret_period": "022020",
               "liability": {
                    "iamt": 1000,
                    "camt": 150,
                    "samt": 200,
                    "csamt": 300
               }
          }
     ]
}
'

❗️

Test Environment Not Available


Response

ParamTypeDescriptionExample
ack_numstringAcknowledgment Number243255

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since File GSTR-3B is not a Paid API, no wallet charge will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here