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_BODY
to GSTN System for the authenticated taxpayer (gstin
) for a particularyear
andmonth
.
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_sup
entity
Param | Type | Description | Example |
---|---|---|---|
intra | num | 0 | |
ty | string | GST | |
inter | num | 0 |
sup_details
entity
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_ltfee
entity
Param | Type | Description | Example |
---|---|---|---|
intr_ltfee | "csamt": 0, "samt": 0, "camt": 0, "iamt": 0 |
inter_sup
entity
Param | Type | Description | Example |
---|---|---|---|
comp_details | |||
uin_details | |||
unreg_details |
itc_elg
entity
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 4 months ago