Skip to content

Destroy invoice

DELETE/documents/invoices/{id}/permanent

Costs 2 rate-limit points · Rate limits

Deletes an invoice permanently so its number can be used again. For an invoice created by mistake (an order opened by accident) that was never emailed. When the invoice holds the latest sequential number, rewind_counter: true also sets the template's next invoice number back to it. Refused for an invoice that was emailed, has a credit note or has an e-invoice: raise a credit note for those instead. Paid plans only.

Permanent: the document, its PDF and its history are removed. Cannot be undone. Opening the order again creates a new invoice. Send it first without confirm: nothing changes and the 409 confirmation_required says what would, including whether the counter can be rewound. Tell the merchant, ask, and resend with confirm: true (?confirm=true on a DELETE) only after they agree. To hide an invoice without freeing its number, trash it instead (DELETE /documents/invoices/:id).

Also searched asdelete invoice permanentlypermanently delete invoiceerase invoicefree up invoice numberreuse invoice numberundo invoiceremove accidental invoicedelete invoice and reset numbering

Path parameters

  • idstringRequired

Query parameters

  • confirmboolean

    Send true only after the merchant agreed. Without it nothing is deleted and the 409 says what would be.

  • rewind_counterstring

    true also sets the numbering template's next invoice number back to this invoice's number. Only honoured when the invoice holds the latest number; otherwise rewinding would hand that number out twice.

Returns

  • idinteger
    Example: 980191001
  • numberstring
    Example: A26-1
  • deletedboolean
    Example: true
  • next_invoice_numberstring
    Example: 1

Errors

401

Missing or unknown X-Auth-Token, or the shop uninstalled the app.

403

v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.

404

The resource does not exist for this shop, or no action is registered at this path.

422

The request failed validation. Nothing was saved.

429

Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.

Every error has the same shape: see Errors.

DELETE/documents/invoices/{id}/permanent
curl -X DELETE "https://app.invoicefalcon.com/api/v3/external/documents/invoices/980191059/permanent" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "id": 980191001,
  "number": "A26-1",
  "deleted": true,
  "next_invoice_number": "1"
}