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-3BRAW Bodyto the GST portal.
Endpoint
| HTTP Method | Resource |
|---|---|
POST | /gsp/tax-payer/{gstin}/gstrs/gstr-3b/{year}/{month}/file |
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| gstin | string | 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | 22AAAAA0000A1Z5 |
| year | string | Year for which Advance Tax needs to be fetched. | 2020 |
| month | string | Month 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
| Param | Type | Description | Example |
|---|---|---|---|
| ack_num | string | Acknowledgment Number | 243255 |
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 a Paid API, a wallet charge of INR 0.25 + GST per API call will be applicable.
Versioning
This API is currently in major version 1.0. Refer to our versioning policies here
Updated 5 months ago