Cancel IRN

post

https://api.in.onefinops.com/v1/einvoices/cancel

Cancels an IRN within NIC's 24-hour cancellation window. Requests outside the window
return 409 einvoice.cancel_window_expired. The IRN to cancel is supplied in the request
body (not the URL).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Body for POST /v1/einvoices/cancel — the IRN to cancel, NIC's reason code, and free-text remarks.

irn

string

required

length between 64 and 64

^[0-9a-f]{64}$

The 64-character IRN to cancel.

reasonCode

string

enum

required

IRP cancel reason code. Required.

1 — Duplicate IRN (same invoice was IRN'd twice)
2 — Data entry error (re-issue with corrected fields)
3 — Order cancelled (business cancellation upstream)
4 — Others (free-text remarks recommended)

Allowed:

remarks

string

required

length ≤ 100

Free-text cancellation remark (max 100 chars).

Headers

gstin

string

required

length between 15 and 15

^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][A-Z0-9]{3}$

GSTIN whose NIC IRP / EWB-portal credential authorizes the call.
Seed each GSTIN's credential through the Developer Console.

X-Request-Id

uuid

Optional client-supplied UUID for correlation across logs and dashboards. If omitted, OneFinOps mints one and echoes it back on the response.

Responses

200Updated record reflecting cancellation.

404Resource not found.

409State conflict — see code for the specific reason.

422Body or query failed validation.