Upload GSTR-3B
GSTR-3B return is a simplified summary that you must file every month as a registered taxpayer. Sandbox API to upload GSTR-3B to GST Network.
Overview
- Upload GSTR-3B
RAW_BODYto GSTN System for the authenticated taxpayer (gstin) for a particularyearandmonth.
Endpoint
| HTTP Method | Resource | Description |
|---|---|---|
POST | /gsp/tax-payer/{gstin}/gstrs/gstr-3b/{year}/{month} | Takes in gstin, year and month and JSON RAW_BODY to upload it on to GSTN. |
Path Parameters
| Param | Type | Description | Example |
|---|---|---|---|
| gstin | string | 15-character alpha-numeric unique identifier assigned to business entities registering under the GST regime | AAAAA0000A |
| year | string | Year for which Advance Tax needs to be fetched. | 2020 |
| month | string | Month for which Advance Tax needs to be fetched. | 01 |
curl --request POST \
--url https://api.sandbox.co.in/gsp/tax-payer/22AAAAA0000A1Z5/gstrs/gstr-3b/2020/01 \
--header 'Authorization: xxxxxxxxxx' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: xxxxxxxxxx' \
--header 'x-api-version: 1.0' \
--data '
{
"ret_period": "022020",
"inward_sup": {
"isup_details": [
{
"intra": 0,
"ty": "GST",
"inter": 0
},
{
"intra": 0,
"ty": "NONGST",
"inter": 0
}
]
},
"sup_details": {
"osup_nil_exmp": {
"txval": 0
},
"osup_nongst": {
"txval": 0
},
"osup_zero": {
"csamt": 0,
"iamt": 0,
"txval": 0
},
"osup_det": {
"samt": 0,
"csamt": 0,
"camt": 0,
"iamt": 0,
"txval": 0
},
"isup_rev": {
"samt": 0,
"csamt": 0,
"camt": 0,
"iamt": 0,
"txval": 0
}
},
"intr_ltfee": {
"intr_details": {
"csamt": 0,
"samt": 0,
"camt": 0,
"iamt": 0
}
},
"inter_sup": {
"comp_details": [],
"uin_details": [],
"unreg_details": []
},
"itc_elg": {
"itc_avl": [
{
"samt": 0,
"csamt": 0,
"camt": 0,
"ty": "IMPG",
"iamt": 0
},
{
"samt": 0,
"csamt": 0,
"camt": 0,
"ty": "IMPS",
"iamt": 0
},
{
"samt": 0,
"csamt": 0,
"camt": 0,
"ty": "ISRC",
"iamt": 0
},
{
"samt": 0,
"csamt": 0,
"camt": 0,
"ty": "ISD",
"iamt": 0
},
{
"samt": 0,
"csamt": 0,
"camt": 0,
"ty": "OTH",
"iamt": 0
}
],
"itc_rev": [
{
"csamt": 0,
"samt": 0,
"camt": 0,
"ty": "RUL",
"iamt": 0
},
{
"csamt": 0,
"samt": 0,
"camt": 0,
"ty": "OTH",
"iamt": 0
}
],
"itc_net": {
"csamt": 0,
"samt": 0,
"camt": 0,
"iamt": 0
},
"itc_inelg": [
{
"csamt": 0,
"samt": 0,
"camt": 0,
"ty": "RUL",
"iamt": 0
},
{
"csamt": 0,
"samt": 0,
"camt": 0,
"ty": "OTH",
"iamt": 0
}
]
},
"gstin": "24AAACJ3770E2ZZ"
}
'
Request Body
RAW_BODY
| Param | Type | Description | Example |
|---|---|---|---|
| gstin | string | 24AAACJ3770E2ZZ | |
| ret_period | num | 022020 | |
| inward_sup | object | Look Below | Look Below |
| sup_details | object | Look Below | Look Below |
| intr_ltfee | object | Look Below | Look Below |
| inter_sup | object | Look Below | Look Below |
| itc_elg | string | Look Below | Look Below |
| b2cs | object | Look Below | Look Below |
| txpd | object | Look Below | Look Below |
| ata | object | Look Below | Look Below |
| inv | object | Look Below | Look Below |
inward_supentity
| Param | Type | Description | Example |
|---|---|---|---|
| intra | num | 0 | |
| ty | string | GST | |
| inter | num | 0 |
sup_detailsentity
| Param | Type | Description | Example |
|---|---|---|---|
| osup_nil_exmp | object | "txval": 0 | |
| osup_nongst | object | "txval": 0 | |
| osup_zero | object | "csamt": 0, "iamt": 0, "txval": 0 | |
| osup_det | object | "samt": 0, "csamt": 0, "camt": 0, "iamt": 0, "txval": 0 | |
| isup_rev | object | "samt": 0, "csamt": 0, "camt": 0, "iamt": 0, "txval": 0 |
intr_ltfeeentity
| Param | Type | Description | Example |
|---|---|---|---|
| intr_ltfee | "csamt": 0, "samt": 0, "camt": 0, "iamt": 0 |
inter_supentity
| Param | Type | Description | Example |
|---|---|---|---|
| comp_details | |||
| uin_details | |||
| unreg_details |
itc_elgentity
| Param | Type | Description | Example |
|---|---|---|---|
| itc_avl | "samt": 0, "csamt": 0, "camt": 0, "ty": "IMPG", "iamt": 0 | ||
| itc_rev | "csamt": 0, "samt": 0, "camt": 0, "ty": "RUL", "iamt": 0 | ||
| itc_net | "csamt": 0, "samt": 0, "camt": 0, "iamt": 0 | ||
| itc_inelg | "csamt": 0, "samt": 0, "camt": 0, "ty": "RUL", "iamt": 0 |
Once the values are added, Your curl will look something like this
Test Environment Not Available
Response
The response includes the following GSTR-3B details below
| Param | Type | Description | Example |
|---|---|---|---|
| reference_id | string | 243255 |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Upload 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 about 2 months ago