Skip to content

Create eDocument by IRN#

Create eDocument by IRN is used to Create an eDocument by eDocument IRN.

Route

/invx/apis/{iridessa-version}/orgs/{org-id}/invoice/by-irn

- active 'iridessa-version': v1
- method: POST

URL Parameters#

Name Description Type
iridessa-version version of the API
for example, v1
string
org-id theodore organisation id string
doc-id documentation id string

Headers#

All headers are mentioned in common headers

Request#

Please refer the following request body for reference-

Sample request body

[
  {
    "irn": "02fd38fdaa67722da2373e0c9e77fd5d573caae6d1802f4cf7821f61754180af",
    "irnDt": null,
    "sellerGstin": null,
    "buyerGstin": null,
    "docType": null,
    "docNo": null,
    "docDt": null,
    "totInvVal": null,
    "itemCnt": null,
    "mainHsnCode": null
  }
]

Response#

Successful response will have the response in “data” attribute as a json.

Sample response body

{
  "status": "1",
  "data": [
    {
      "itemStatus": "1",
      "itemData": {
        "id": "3dcf56f1-3699-41a0-8087-7dba3a6f2215",
        "irn": "08c27d85081bc1a5abd4f17a64bc16963a2d55dcba4f904375278a1b6a09a976",
        "docNumber": "PBEAC9E7463154B9",
        "docType": "100",
        "docDate": "23/01/2023",
        "sellerGstin": "27AAAPI3182M002",
        "buyerGstin": "27ACBPN2353E1ZX",
        "irdDocType":"POST",
        "registeredOn": 1674449635000,
        "ewbNo": 231009845697,
        "ewbDate": 1674449640000,
        "ewbValidTill": 1674584940000,
        "amount": 100,
        "acceptanceComments": null,
        "denialComments": null,
        "disputeComments": null,
        "cancellationComments": null,
        "cancellationReason": null,
        "status": "200",
        "createdByUserId": "3e193e19-0d70-4938-9698-287f8bd947fb",
        "createdOn": 1674449575274,
        "lastUpdatedByUserId": null,
        "lastUpdated": null,
        "annotations": [],
        "irnResponse": {
          "ackDt": "09/12/2022",
          "ewbDt": "09/12/2022",
          "signedInvoice": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkVEQzU3REUxMzU4QjMwMEJBOUY3OTM0MEE2Njk2ODMxRjNDODUwNDciLCJ0eXAiOiJKV1QiLCJ4NXQiOiI3Y1Y5NFRXTE1BdXA5NU5BcG1sb01mUElVRWMifQ.eyJkYXRhIjoie1wiQWNrTm9cIjoxMjIyMTAwNzMzMDQ5NTksXCJBY2tEdFwiOlwiMjAyMi0xMi0wOSAxNDozNToxMlwiLFwiSXJuXCI6XCJlODJkN2VkYjg5MjY0YjVmZGQxOGFmZDJhZGMzYzYzNzZhMmIzZTg3MmZmMWFkZWRlYjQ4YWRjMDQwMDMzMzdjXCIsXCJWZXJzaW9uXCI6XCIxLjFcIixcIlRyYW5EdGxzXCI6e1wiVGF4U2NoXCI6XCJHU1RcIixcIlN1cFR5cFwiOlwiREVYUFwiLFwiUmVnUmV2XCI6XCJOXCIsXCJJZ3N0T25JbnRyYVwiOlwiTlwifSxcIkRvY0R0bHNcIjp7XCJUeXBcIjpcIklOVlwiLFwiTm9cIjpcIlVENjEyMjQyRDcyQjM0RjZcIixcIkR0XCI6XCIwOS8xMi8yMDIyXCJ9LFwiU2VsbGVyRHRsc1wiOntcIkdzdGluXCI6XCIyN0FBQVBJMzE4Mk0wMDJcIixcIkxnbE5tXCI6XCJBY21lIFdpZGdldHMgUHJpdmF0ZSBMaW1pdGVkXCIsXCJBZGRyMVwiOlwiMjM0NVwiLFwiTG9jXCI6XCJVdHRhciBQcmFkZXNoXCIsXCJQaW5cIjo0MDAwNDksXCJTdGNkXCI6XCIyN1wifSxcIkJ1eWVyRHRsc1wiOntcIkdzdGluXCI6XCIyN0FDQlBOMjM1M0UxWlhcIixcIkxnbE5tXCI6XCJMb25nIFRlcm0gRW50ZXJwcmlzZXMgTExQXCIsXCJQb3NcIjpcIjI3XCIsXCJBZGRyMVwiOlwiMTIzNFwiLFwiTG9jXCI6XCJQdW5lXCIsXCJQaW5cIjo0MDAwNDksXCJTdGNkXCI6XCIyN1wifSxcIkRpc3BEdGxzXCI6e1wiTm1cIjpcIkFjbWUgV2lkZ2V0cyBQcml2YXRlIExpbWl0ZWRcIixcIkFkZHIxXCI6XCIxMTJcIixcIkFkZHIyXCI6XCJBY21lIEJ1aWxkaW5nXCIsXCJMb2NcIjpcIkFCQ1wiLFwiUGluXCI6NDAwMDQ5LFwiU3RjZFwiOlwiMjdcIn0sXCJTaGlwRHRsc1wiOntcIkdzdGluXCI6XCIyN0FDQlBOMjM1M0UxWlhcIixcIkxnbE5tXCI6XCJBY21lIFdpZGdldHMgUHJpdmF0ZSBMaW1pdGVkXCIsXCJUcmRObVwiOlwiQWNtZSBXaWRnZXRzIFByaXZhdGUgTGltaXRlZFwiLFwiQWRkcjFcIjpcIjExMlwiLFwiQWRkcjJcIjpcIkFjbWUgQnVpbGRpbmdcIixcIkxvY1wiOlwiQUJDXCIsXCJQaW5cIjo0MDAwNDksXCJTdGNkXCI6XCIyN1wifSxcIkl0ZW1MaXN0XCI6W3tcIkl0ZW1Ob1wiOjAsXCJTbE5vXCI6XCIxXCIsXCJJc1NlcnZjXCI6XCJOXCIsXCJQcmREZXNjXCI6XCJBY21lIHByb2R1Y3RcIixcIkhzbkNkXCI6XCIzMzA1MjAwMFwiLFwiUXR5XCI6MSxcIlVuaXRcIjpcIkJBR1wiLFwiVW5pdFByaWNlXCI6MTAwLFwiVG90QW10XCI6MTAwLFwiRGlzY291bnRcIjowLFwiQXNzQW10XCI6MTAwLFwiR3N0UnRcIjowLFwiQ2dzdEFtdFwiOjAsXCJTZ3N0QW10XCI6MCxcIlRvdEl0ZW1WYWxcIjoxMDB9XSxcIlZhbER0bHNcIjp7XCJBc3NWYWxcIjoxMDAsXCJDZ3N0VmFsXCI6MCxcIlNnc3RWYWxcIjowLFwiSWdzdFZhbFwiOjAsXCJUb3RJbnZWYWxcIjoxMDB9LFwiUGF5RHRsc1wiOntcIk5tXCI6XCJBY21lIFdpZGdldHMgUHJpdmF0ZSBMaW1pdGVkXCIsXCJNb2RlXCI6XCJDYXNoXCIsXCJQYXlUZXJtXCI6XCIxMDBcIixcIlBheUluc3RyXCI6XCIxMDBcIixcIkNyVHJuXCI6XCIxMDBcIixcIkRpckRyXCI6XCIxMDBcIixcIkNyRGF5XCI6MTAwLFwiUGFpZEFtdFwiOjEwMCxcIlBheW10RHVlXCI6OTAwfSxcIlJlZkR0bHNcIjp7XCJJbnZSbVwiOlwiUmVtYXJrc1wiLFwiRG9jUGVyZER0bHNcIjp7XCJJbnZTdER0XCI6XCIwMS8xMS8yMDIyXCIsXCJJbnZFbmREdFwiOlwiMDEvMTEvMjAyMlwifX0sXCJFeHBEdGxzXCI6e1wiU2hpcEJOb1wiOlwic2hwYmlsbDEyM1wiLFwiU2hpcEJEdFwiOlwiMDEvMTEvMjAyMlwiLFwiUG9ydFwiOlwiSU5ZTkw2XCIsXCJSZWZDbG1cIjpcIk5cIixcIkZvckN1clwiOlwiSU5SXCIsXCJDbnRDb2RlXCI6XCJJTlwiLFwiRXhwRHV0eVwiOjB9LFwiRXdiRHRsc1wiOntcIlRyYW5zSWRcIjpcIjI3QUFBUEkzMTgyTTAwMlwiLFwiVHJhbnNOYW1lXCI6XCJEcml2ZXJcIixcIlRyYW5zTW9kZVwiOlwiMVwiLFwiRGlzdGFuY2VcIjo1LFwiVHJhbnNEb2NOb1wiOlwiMjAvMjJcIixcIlZlaE5vXCI6XCJLQTUxRVMxMTIyXCIsXCJWZWhUeXBlXCI6XCJPXCJ9fSIsImlzcyI6Ik5JQyJ9.tirLbmWwCQZlihQmlz57yblyCIRPg-lguQwFN5VcWWC1wdgKzopGDXZq4WKamRsnblel8K31k7tHU66UTIot71eQvwDds5Zv5QecopUdkaLNXxhFWmeOiSfYWkPDlZJPSutpl4wI2ue4o9d8a8-PTNxCslGditrg8PQ8aX3i9pfCIBKsINiRsPp1KVfCg1_3XnWA-iLz-M3iaK9A61pS0-ILQucv8t_XqZqhNqn0S9BAwTOdfXabw8x8vQgoVPVF65UmRxH-yXcrfoegNQQ-KZnQwKJHjpXo3XA2R6cjmKOSMUcmORL5olsA_Di5NiEZ3WQBCxbibSnRrI-qUglq0A",
          "ackNo": 122210073304959,
          "signedQRCode": "eyJhbGciOiJSUzI1NiIsImtpZCI6IkVEQzU3REUxMzU4QjMwMEJBOUY3OTM0MEE2Njk2ODMxRjNDODUwNDciLCJ0eXAiOiJKV1QiLCJ4NXQiOiI3Y1Y5NFRXTE1BdXA5NU5BcG1sb01mUElVRWMifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI3QUFBUEkzMTgyTTAwMlwiLFwiQnV5ZXJHc3RpblwiOlwiMjdBQ0JQTjIzNTNFMVpYXCIsXCJEb2NOb1wiOlwiVUQ2MTIyNDJENzJCMzRGNlwiLFwiRG9jVHlwXCI6XCJJTlZcIixcIkRvY0R0XCI6XCIwOS8xMi8yMDIyXCIsXCJUb3RJbnZWYWxcIjoxMDAsXCJJdGVtQ250XCI6MSxcIk1haW5Ic25Db2RlXCI6XCIzMzA1MjAwMFwiLFwiSXJuXCI6XCJlODJkN2VkYjg5MjY0YjVmZGQxOGFmZDJhZGMzYzYzNzZhMmIzZTg3MmZmMWFkZWRlYjQ4YWRjMDQwMDMzMzdjXCIsXCJJcm5EdFwiOlwiMjAyMi0xMi0wOSAxNDozNToxMlwifSIsImlzcyI6Ik5JQyJ9.HqbLxzB4OsPSyJk0iwydm5vlSrny1drkLEPxBS2j1fRGWilPicT9LNPKXEO2Bpl0NHeFtAqLgPJ8lge1WbclM7sSAQQ-Caj8K1JPPg4I1m3GB9G5MMUk7IfEpM680doI_dz-k72qHAAX2oMbwGxh3e1j_pnxDHjeULIzKGTqBf8gHKapyc00GvHyT3wYteF6VSc5K5BwFS6dz2LnX0yBGcIgGqwy1TJKae8wQzAGAoPmsNL8dk6IlXLlR3sXQo__dBrPnetEnMPE7brzF7ox2BL3xe3XyVI01bNR03VFidH9-O0DTX_WxcyMotm-KuLn5OBK-4NXSnbMqSwJes7TaA",
          "remarks": null,
          "status": "ACT",
          "irn": "e82d7edb89264b5fdd18afd2adc3c6376a2b3e872ff1adedeb48adc04003337c",
          "ewbNo": 221009839051,
          "ewbValidTill": "10/12/2022"
        }
      },
      "itemErrors": null,
      "itemInfo": null,
      "itemKey": null
    }
  ],
  "error": null,
  "info": null
}

Note#

status field in document is the state of the Document generated. Different Document states are as bellow -

  • 100 -> DRAFT
  • 120 -> REGISTRATIONFAILED
  • 200 -> CREATED
  • 210 -> ACCEPTED
  • 220 -> DENIED
  • 230 -> DISPUTED
  • 240 -> CANCELLED
  • 250 -> FROZEN
  • 260 -> DELETE

Last update: April 26, 2023