Validates, numbers, signs and stores the receipt on the open fiscal day; it is sent to ZIMRA in the background, so it is PENDING until ZIMRA accepts it. trader_invoice_number, your own invoice number, is required and is the idempotency key: retrying with the same number returns the receipt already issued rather than issuing another, and the same number with a different sale returns 409. A trader_invoice_number already sent to ZIMRA for another receipt on the device returns 409. A receipt that fails validation returns 400 with message "the receipt failed validation", metadata.codes (comma-separated rule codes, e.g. RCPT019) and metadata.violations (a JSON array of {code, colour, message, line_no, meta}). There is no separate open: the first receipt when no fiscal day is open opens one. Returns 412 if the day can't be opened (no ZIMRA registration, or a device that is not active or has no active certificate yet), or while DigiTax is closing it automatically - usually a few seconds, so retry.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||