Skip to main content
POST
/
gst
/
compliance
/
tax-payer
/
invoices
/
status
/
save
Save Invoice Status
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/invoices/status/save \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "RAW_BODY": "{ \"rtin\": \"05ABNTY3290P8ZB\", \"reqtyp\": \"SAVE\", \"invdata\": { \"b2b\": [ { \"stin\": \"24MAYAS0100J1JD\", \"inum\": \"b1\", \"inv_typ\": \"R\", \"action\": \"A\", \"srcform\": \"R1\", \"rtnprd\": \"012023\", \"idt\": \"23-01-2023\", \"val\": 1000, \"pos\": \"24\", \"txval\": 100, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"b2ba\": [ { \"oinum\": \"ab2\", \"oidt\": \"24-02-2023\", \"stin\": \"24MAYAS0100J1JD\", \"rtnprd\": \"012023\", \"inum\": \"b1a\", \"action\": \"A\", \"inv_typ\": \"R\", \"srcform\": \"R1\", \"idt\": \"24-02-2023\", \"val\": 1000, \"pos\": \"07\", \"txval\": 100, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"b2bdn\": [ { \"stin\": \"24MAYAS0100J1JD\", \"nt_num\": \"dn2\", \"action\": \"A\", \"inv_typ\": \"R\", \"srcform\": \"R1\", \"rtnprd\": \"012023\", \"nt_dt\": \"24-02-2023\", \"val\": 1000.1, \"pos\": \"07\", \"txval\": 1000.1, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"b2bdna\": [ { \"stin\": \"24MAYAS0100J1JD\", \"ont_num\": \"ca2\", \"ont_dt\": \"24-02-2023\", \"nt_num\": \"dn2\", \"action\": \"A\", \"inv_typ\": \"R\", \"srcform\": \"R1\", \"rtnprd\": \"012023\", \"nt_dt\": \"24-02-2023\", \"val\": 1000.1, \"pos\": \"07\", \"txval\": 1000.1, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"b2bcn\": [ { \"stin\": \"24MAYAS0100J1JD\", \"nt_num\": \"dn2\", \"action\": \"A\", \"inv_typ\": \"R\", \"srcform\": \"R1\", \"rtnprd\": \"012023\", \"nt_dt\": \"24-02-2023\", \"val\": 1000.1, \"pos\": \"07\", \"txval\": 1000.1, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"b2bcna\": [ { \"stin\": \"24MAYAS0100J1JD\", \"ont_num\": \"ca2\", \"ont_dt\": \"24-02-2023\", \"nt_num\": \"dn2\", \"action\": \"A\", \"inv_typ\": \"R\", \"srcform\": \"R1\", \"rtnprd\": \"012023\", \"nt_dt\": \"24-02-2023\", \"val\": 1000.1, \"pos\": \"07\", \"txval\": 1000.1, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"ecom\": [ { \"stin\": \"24MAYAS0100J1JD\", \"rtnprd\": \"012023\", \"inum\": \"sd3\", \"action\": \"A\", \"srcform\": \"R1\", \"idt\": \"24-02-2023\", \"val\": 1000, \"pos\": \"07\", \"txval\": 1000, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ], \"ecoma\": [ { \"stin\": \"24MAYAS0100J1JD\", \"oinum\": \"get5\", \"oidt\": \"24-02-2023\", \"rtnprd\": \"012023\", \"inum\": \"sd3\", \"action\": \"A\", \"srcform\": \"R1\", \"idt\": \"24-02-2023\", \"val\": 1000, \"pos\": \"07\", \"txval\": 1000, \"iamt\": 20, \"camt\": 20, \"samt\": 20, \"cess\": 0, \"prev_status\": \"A\" } ] } }"
}'
{
  "code": 200,
  "data": {
    "data": {
      "reference_id": "0032e479bcb644c"
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "0f7f60a2-862c-4a1b-b6b4-baa76c6faae6"
}

Headers

ā€‹
Authorization
string
required

Taxpayer access token

ā€‹
x-api-version
string
default:1.0.0

API version

ā€‹
x-api-key
string
required

API key for identification

Body

application/json
ā€‹
RAW_BODY
string<json>
default:{ "rtin": "05ABNTY3290P8ZB", "reqtyp": "SAVE", "invdata": { "b2b": [ { "stin": "24MAYAS0100J1JD", "inum": "b1", "inv_typ": "R", "action": "A", "srcform": "R1", "rtnprd": "012023", "idt": "23-01-2023", "val": 1000, "pos": "24", "txval": 100, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "b2ba": [ { "oinum": "ab2", "oidt": "24-02-2023", "stin": "24MAYAS0100J1JD", "rtnprd": "012023", "inum": "b1a", "action": "A", "inv_typ": "R", "srcform": "R1", "idt": "24-02-2023", "val": 1000, "pos": "07", "txval": 100, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "b2bdn": [ { "stin": "24MAYAS0100J1JD", "nt_num": "dn2", "action": "A", "inv_typ": "R", "srcform": "R1", "rtnprd": "012023", "nt_dt": "24-02-2023", "val": 1000.1, "pos": "07", "txval": 1000.1, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "b2bdna": [ { "stin": "24MAYAS0100J1JD", "ont_num": "ca2", "ont_dt": "24-02-2023", "nt_num": "dn2", "action": "A", "inv_typ": "R", "srcform": "R1", "rtnprd": "012023", "nt_dt": "24-02-2023", "val": 1000.1, "pos": "07", "txval": 1000.1, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "b2bcn": [ { "stin": "24MAYAS0100J1JD", "nt_num": "dn2", "action": "A", "inv_typ": "R", "srcform": "R1", "rtnprd": "012023", "nt_dt": "24-02-2023", "val": 1000.1, "pos": "07", "txval": 1000.1, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "b2bcna": [ { "stin": "24MAYAS0100J1JD", "ont_num": "ca2", "ont_dt": "24-02-2023", "nt_num": "dn2", "action": "A", "inv_typ": "R", "srcform": "R1", "rtnprd": "012023", "nt_dt": "24-02-2023", "val": 1000.1, "pos": "07", "txval": 1000.1, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "ecom": [ { "stin": "24MAYAS0100J1JD", "rtnprd": "012023", "inum": "sd3", "action": "A", "srcform": "R1", "idt": "24-02-2023", "val": 1000, "pos": "07", "txval": 1000, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ], "ecoma": [ { "stin": "24MAYAS0100J1JD", "oinum": "get5", "oidt": "24-02-2023", "rtnprd": "012023", "inum": "sd3", "action": "A", "srcform": "R1", "idt": "24-02-2023", "val": 1000, "pos": "07", "txval": 1000, "iamt": 20, "camt": 20, "samt": 20, "cess": 0, "prev_status": "A" } ] } }

Response

200 - application/json

200 Invoice status save initiated

ā€‹
code
number
Example:

200

ā€‹
data
object
ā€‹
timestamp
number
Example:

1763446641000

ā€‹
transaction_id
string
Example:

"0f7f60a2-862c-4a1b-b6b4-baa76c6faae6"