Skip to main content
POST
/
gst
/
compliance
/
e-invoice
/
tax-payer
/
invoice
Generate E-Invoice
curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-invoice/tax-payer/invoice \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "Version": "1.1",
  "TranDtls": {
    "TaxSch": "GST",
    "SupTyp": "B2B",
    "RegRev": "Y",
    "EcmGstin": null,
    "IgstOnIntra": "N"
  },
  "DocDtls": {
    "Typ": "INV",
    "No": "DOC/113",
    "Dt": "01/01/2024"
  },
  "SellerDtls": {
    "Gstin": "29AAACQ3770E000",
    "LglNm": "Acme Industries Private Limited",
    "TrdNm": "Acme Industries Private Limited",
    "Addr1": "5th block, kuvempu layout",
    "Addr2": "kuvempu layout",
    "Loc": "BANGALORE",
    "Pin": 560091,
    "Stcd": "29",
    "Ph": "9000000000",
    "Em": "abc@gmail.com"
  },
  "BuyerDtls": {
    "Gstin": "29AWGPV7107B1Z1",
    "LglNm": "XYZ company pvt ltd",
    "TrdNm": "XYZ Industries",
    "Pos": "12",
    "Addr1": "7th block, kuvempu layout",
    "Addr2": "kuvempu layout",
    "Loc": "GANDHINAGAR",
    "Pin": 562160,
    "Stcd": "29",
    "Ph": "91111111111",
    "Em": "xyz@yahoo.com"
  },
  "ItemList": [
    {
      "SlNo": "1",
      "PrdDesc": "Rice",
      "IsServc": "N",
      "HsnCd": "1001",
      "Barcde": "123456",
      "Qty": 100.345,
      "FreeQty": 10,
      "Unit": "BAG",
      "UnitPrice": 99.545,
      "TotAmt": 9988.84,
      "Discount": 10,
      "PreTaxVal": 1,
      "AssAmt": 9978.84,
      "GstRt": 12,
      "IgstAmt": 1197.46,
      "CgstAmt": 0,
      "SgstAmt": 0,
      "CesRt": 5,
      "CesAmt": 498.94,
      "CesNonAdvlAmt": 10,
      "StateCesRt": 12,
      "StateCesAmt": 1197.46,
      "StateCesNonAdvlAmt": 5,
      "OthChrg": 10,
      "TotItemVal": 12897.7,
      "OrdLineRef": "3256",
      "OrgCntry": "AG",
      "PrdSlNo": "12345"
    }
  ],
  "ValDtls": {
    "AssVal": 9978.84,
    "CgstVal": 0,
    "SgstVal": 0,
    "IgstVal": 1197.46,
    "CesVal": 508.94,
    "StCesVal": 1202.46,
    "Discount": 10,
    "OthChrg": 20,
    "RndOffAmt": 0.3,
    "TotInvVal": 12908,
    "TotInvValFc": 12897.7
  },
  "DispDtls": {
    "Nm": "ABC company pvt ltd",
    "Addr1": "7th block, kuvempu layout",
    "Addr2": "kuvempu layout",
    "Loc": "Banagalore",
    "Pin": 562160,
    "Stcd": "29"
  },
  "ShipDtls": {
    "Gstin": "29AWGPV7107B1Z1",
    "LglNm": "CBE company pvt ltd",
    "TrdNm": "kuvempu layout",
    "Addr1": "7th block, kuvempu layout",
    "Addr2": "kuvempu layout",
    "Loc": "Banagalore",
    "Pin": 562160,
    "Stcd": "29"
  },
  "ExpDtls": {
    "ShipBNo": "A-248",
    "ShipBDt": "01/08/2020",
    "Port": "INABG1",
    "RefClm": "N",
    "ForCur": "AED",
    "CntCode": "AE",
    "ExpDuty": null
  },
  "EwbDtls": {
    "TransId": "12AWGPV7107B1Z1",
    "TransName": "XYZ EXPORTS",
    "Distance": 5,
    "TransDocNo": "DOC01",
    "TransDocDt": "05/01/2024",
    "VehNo": "ka123456",
    "VehType": "R",
    "TransMode": "1"
  }
}'
{
  "code": 200,
  "data": {
    "Data": {
      "AckDt": "2024-02-22 17:44:00",
      "AckNo": 112410188590033,
      "EwbDt": null,
      "EwbNo": null,
      "EwbValidTill": null,
      "Irn": "1f33d0856cf71d6f836ed56cd20648994ba0332fe2e3659a2638e01047d12ce9",
      "Remarks": null,
      "SignedInvoice": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMTI0MTAxODg1OTAwMzMsXCJBY2tEdFwiOlwiMjAyNC0wMi0yMiAxNzo0NDowMFwiLFwiSXJuXCI6XCIxZjMzZDA4NTZjZjcxZDZmODM2ZWQ1NmNkMjA2NDg5OTRiYTAzMzJmZTJlMzY1OWEyNjM4ZTAxMDQ3ZDEyY2U5XCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiQjJCXCIsXCJSZWdSZXZcIjpcIllcIixcIklnc3RPbkludHJhXCI6XCJOXCJ9LFwiRG9jRHRsc1wiOntcIlR5cFwiOlwiSU5WXCIsXCJOb1wiOlwiRE9DLzExMlwiLFwiRHRcIjpcIjAxLzAxLzIwMjRcIn0sXCJTZWxsZXJEdGxzXCI6e1wiR3N0aW5cIjpcIjI5QUFBQ1EzNzcwRTAwMFwiLFwiTGdsTm1cIjpcIlF1aWNrbyBJbmZvc29mdCBQcml2YXRlIExpbWl0ZWRcIixcIlRyZE5tXCI6XCJRdWlja28gSW5mb3NvZnQgUHJpdmF0ZSBMaW1pdGVkXCIsXCJBZGRyMVwiOlwiNXRoIGJsb2NrLCBrdXZlbXB1IGxheW91dFwiLFwiQWRkcjJcIjpcImt1dmVtcHUgbGF5b3V0XCIsXCJMb2NcIjpcIkJBTkdBTE9SRVwiLFwiUGluXCI6NTYwMDkxLFwiU3RjZFwiOlwiMjlcIixcIlBoXCI6XCI5MDAwMDAwMDAwXCIsXCJFbVwiOlwiYWJjQGdtYWlsLmNvbVwifSxcIkJ1eWVyRHRsc1wiOntcIkdzdGluXCI6XCIyOUFXR1BWNzEwN0IxWjFcIixcIkxnbE5tXCI6XCJYWVogY29tcGFueSBwdnQgbHRkXCIsXCJUcmRObVwiOlwiWFlaIEluZHVzdHJpZXNcIixcIlBvc1wiOlwiMTJcIixcIkFkZHIxXCI6XCI3dGggYmxvY2ssIGt1dmVtcHUgbGF5b3V0XCIsXCJBZGRyMlwiOlwia3V2ZW1wdSBsYXlvdXRcIixcIkxvY1wiOlwiR0FOREhJTkFHQVJcIixcIlBpblwiOjU2MjE2MCxcIlBoXCI6XCI5MTExMTExMTExMVwiLFwiRW1cIjpcInh5ekB5YWhvby5jb21cIixcIlN0Y2RcIjpcIjI5XCJ9LFwiSXRlbUxpc3RcIjpbe1wiSXRlbU5vXCI6MCxcIlNsTm9cIjpcIjFcIixcIklzU2VydmNcIjpcIk5cIixcIlByZERlc2NcIjpcIlJpY2VcIixcIkhzbkNkXCI6XCIxMDAxXCIsXCJCYXJjZGVcIjpcIjEyMzQ1NlwiLFwiUXR5XCI6MTAwLjM0NSxcIkZyZWVRdHlcIjoxMCxcIlVuaXRcIjpcIkJBR1wiLFwiVW5pdFByaWNlXCI6OTkuNTQ1LFwiVG90QW10XCI6OTk4OC44NCxcIkRpc2NvdW50XCI6MTAsXCJQcmVUYXhWYWxcIjoxLFwiQXNzQW10XCI6OTk3OC44NCxcIkdzdFJ0XCI6MTIsXCJJZ3N0QW10XCI6MTE5Ny40NixcIkNnc3RBbXRcIjowLFwiU2dzdEFtdFwiOjAsXCJDZXNSdFwiOjUsXCJDZXNBbXRcIjo0OTguOTQsXCJDZXNOb25BZHZsQW10XCI6MTAsXCJTdGF0ZUNlc1J0XCI6MTIsXCJTdGF0ZUNlc0FtdFwiOjExOTcuNDYsXCJTdGF0ZUNlc05vbkFkdmxBbXRcIjo1LFwiT3RoQ2hyZ1wiOjEwLFwiVG90SXRlbVZhbFwiOjEyODk3LjcsXCJPcmRMaW5lUmVmXCI6XCIzMjU2XCIsXCJPcmdDbnRyeVwiOlwiQUdcIixcIlByZFNsTm9cIjpcIjEyMzQ1XCJ9XSxcIlZhbER0bHNcIjp7XCJBc3NWYWxcIjo5OTc4Ljg0LFwiQ2dzdFZhbFwiOjAsXCJTZ3N0VmFsXCI6MCxcIklnc3RWYWxcIjoxMTk3LjQ2LFwiQ2VzVmFsXCI6NTA4Ljk0LFwiU3RDZXNWYWxcIjoxMjAyLjQ2LFwiRGlzY291bnRcIjoxMCxcIk90aENocmdcIjoyMCxcIlJuZE9mZkFtdFwiOjAuMyxcIlRvdEludlZhbFwiOjEyOTA4LFwiVG90SW52VmFsRmNcIjoxMjg5Ny43fX0iLCJpc3MiOiJOSUMgU2FuZGJveCJ9.tz3OfVG9_sGpvIaAzGbzblqp7diACw74nluAvvdFXq2PnMe8bG84c_gitoQVjI0ieZ3CLO0PmjKcs8psm12D4k5YkKrbg3bPB3UYXn7Tx43zDHdZtgIAs0OM45DHFA9zXX_e6YP_CIhs9aEZ9naE7ZJ4SUZ4GB333NZcFk_ou0K2HKXDRwtbnSPPX6FXoSy2GLS_LV4Y1KevnYM23ar0DaB5rq54B9ii_i0oIm7GwsRBwFc2zwhPW5F6BF81j4Jl6v0eQBP2k83RtIhaVicycANio-QClFx_Wj69gDBcQZwoAYKtVKxKcaWu8IEMCqxOolZ-QNF1Sg3WWHNBINLPzQ",
      "SignedQRCode": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjE1MTNCODIxRUU0NkM3NDlBNjNCODZFMzE4QkY3MTEwOTkyODdEMUYiLCJ4NXQiOiJGUk80SWU1R3gwbW1PNGJqR0w5eEVKa29mUjgiLCJ0eXAiOiJKV1QifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFBQ1EzNzcwRTAwMFwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBV0dQVjcxMDdCMVoxXCIsXCJEb2NOb1wiOlwiRE9DLzExMlwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwMS8wMS8yMDI0XCIsXCJUb3RJbnZWYWxcIjoxMjkwOCxcIkl0ZW1DbnRcIjoxLFwiTWFpbkhzbkNvZGVcIjpcIjEwMDFcIixcIklyblwiOlwiMWYzM2QwODU2Y2Y3MWQ2ZjgzNmVkNTZjZDIwNjQ4OTk0YmEwMzMyZmUyZTM2NTlhMjYzOGUwMTA0N2QxMmNlOVwiLFwiSXJuRHRcIjpcIjIwMjQtMDItMjIgMTc6NDQ6MDBcIn0iLCJpc3MiOiJOSUMgU2FuZGJveCJ9.f1zWJHifnxGZTCsMPZIj8iJ0hzqfetv18q7gbWGZiuz5JkfFQy27D2fDHTVuwJCVSZfNiFyegw6bOGMddvTFgI_F-vzUXRzqivw-mJSZrhbKusj6DEeOy9RdLTqTU7Alp7J6rOXhUOhLCOeumCduXnXeWBCjFwGPJ6C1Ht35GrSvPvduy8KMsI3TYY0xg1c6eQyCUy-je5fbLVVnfVLtlCZeHSVZJB2MUNG_nKa03Qa_DVr_eNt-cdjxZghMJXpdb8srZlQS_ixcHnLv5SO5plo68oFRYBbpbkptO7IDH96t2CtBD93GCSRWyUT6qyCC36SOwrJCBReexddH2_gk1w",
      "Status": "ACT"
    },
    "ErrorDetails": null,
    "InfoDtls": null,
    "Status": 1
  },
  "timestamp": 1763446641000,
  "transaction_id": "99969a01-34c2-4e22-82b9-302c492088a8"
}

Headers

ā€‹
Authorization
string
required

E-Invoice 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
object
required

Generate IRN

Response

200 - application/json

2258 Supplier state code does not match / 5002 Version field is required / 200 E-Invoice generated (Services) / 200 E-Invoice generated (Goods) / 2278 IRN generated and cancelled / 200 E-Invoice with EWB generated / 2150 Duplicate IRN / 2301 e-Commerce operator field empty / 3026 E-Invoice not enabled

ā€‹
code
number
Example:

200

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

1763446641000

ā€‹
transaction_id
string
Example:

"ebde421c-2720-4f24-a9ea-f71ec31fc31d"