BizKitHub
DocsAPI ReferenceOrder/bff/order/reissue-invoice
postOrderAdmin BFF

/bff/order/reissue-invoice

Creates a replacement document with a new sequence number, marks the original as voided with a forward link (supersedes_invoice_id). Preserves the customer's original amount to the cent — only the VAT rate on items is recomputed from the current tax profile (which may have moved from PAYER to IDENTIFIED_PERSON since the original issue). Does not send any customer notification: this is a silent accounting-hygiene tool. Paid invoices inherit invoice_pay_date verbatim. Errors if the target invoice is already voided.

OrderpostBffOrderReissue-invoice

Parameters

JSON body

Request body

application/json
hashstringRequired

Order hash.

invoiceExternalIdstringRequired

16-char external id of the invoice to reissue.

reasonstringOptional

Short human-readable reason (max 32 chars, longer text is truncated). Stored on the old invoice as void_reason and mirrored to core__activity meta. Defaults to "reissued".

Response schema

1 status code documented

200Success
successbooleanRequired
Default: true
newInvoiceIdnumberRequired
newInvoiceExternalIdstringRequired
newSequenceNumberstringRequired
oldInvoiceIdnumberRequired
oldInvoiceExternalIdstringRequired
oldSequenceNumberstringRequired
supplierVatModeChangedbooleanRequired

Response example

application/json
{
  "success": true,
  "newInvoiceId": 0,
  "newInvoiceExternalId": "example_newInvoiceExternalId",
  "newSequenceNumber": "example_newSequenceNumber",
  "oldInvoiceId": 0,
  "oldInvoiceExternalId": "example_oldInvoiceExternalId",
  "oldSequenceNumber": "example_oldSequenceNumber",
  "supplierVatModeChanged": false
}

Request example

POST /bff/order/reissue-invoice

post
curl -X POST "https://api.bizkithub.com/bff/order/reissue-invoice" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "hash": "example_hash",
  "invoiceExternalId": "example_invoiceExternalId",
  "reason": "example_reason"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key