e-Invoice IRN Cancellation API
POST
https://apisandbox.whitebooks.in/einvoice/type/CANCEL/version/V1_03Cancel Invoice Reference Number. You can cancel only past 24 hours of invoices from the time of IRN generation
e-Invoice Web App
Explore FeatureInstant B2B e-Invoice IRN & QR Code Generation
Generate 64-character IRNs and signed QR codes in bulk from Excel, ERP connectors, or web forms with instant IRP dispatch.
Parameters
query parameters
emailstringrequiredUser Email
irpstringoptionale-Invoice Server Type(NIC1/NIC2),given at the time of e-Invoice generation
header parameters
ip_addressstringrequiredIP Address
client_idstringrequiredClient ID
client_secretstringrequiredClient Secret
usernamestringrequiredUser name
auth-tokenstringrequiredToken
gstinstringrequiredGSTIN number
Request Body
application/jsonrequired
IrnstringoptionalIrn number
Example: "a5c12dca80e743321740b001fd70953e8738d109865d28ba4013750f2046f229"
CnlRsnstringoptionalnullableCancel Reason Number
Example: "1"
CnlRemstringoptionalCancel Reason
Example: "Wrong entry"
Response
Not Found. If requested entity is not found or if requested API is not found.
Frequently Asked Questions
The request body requires
Irn (the 64-character alphanumeric hash), CnlRsn (numeric cancellation reason code), and CnlRem (cancellation remarks). Authenticate via Authorization: Bearer <access_token> and x-api-key, along with standard routing headers (gstin, username, ip_address).Standard IRP cancellation codes are:
1 for Duplicate, 2 for Data entry error, 3 for Order cancelled, and 4 for Others. When using 4, descriptive text must be supplied in CnlRem.No. If an active e-Way Bill was generated against the IRN, the e-Way Bill must be cancelled first. Attempting to cancel the IRN while an e-Way Bill is active results in validation failure on the IRP.
No. Once an IRN is cancelled on the IRP, the specific document number cannot be reused for another IRN in the same financial year. A new invoice number must be issued.
No example available.