Create an invoice

Create an invoice

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Account identifier (ID)

Body Params

The Invoice object in format JSON to create

boolean
enum
Defaults to false

Indicates whether the invoice should be automatically processed after creation/import.

When set to true and the invoice passes validations:

  • For sending transports (non-download), the invoice is queued to be sent asynchronously.
  • For download transport, the invoice is not sent. Instead, if tax report generation is enabled and required for this invoice, the invoice will be issued and the tax report generated
    (invoice ends in state=issued and exposes tax_report_ids). Otherwise, the invoice may end in state=error.

Note: This option is incompatible with the custom signature configuration.

Allowed:
boolean
enum
Defaults to false

Indicates whether the invoice should be issued synchronously after creation/import, without going through the transport send flow.

When set to true and the invoice passes validations:

  • The invoice transitions to state=issued (c1 corner) inline.
  • If the account has a before_send tax report setting enabled with auto_generate on and the invoice qualifies, the tax report is generated inline and exposed via tax_report_ids. When auto_generate is off the invoice is still issued but no report is created, consistent with the send flow — those reports are managed through the Tax Reports API.
  • Authorities that report after sending (for example SII or SDI) are not triggered by issuing; their reports are created when the invoice is sent or marked as sent.
  • No background send job is enqueued; the transport-level state (c2) remains untouched.
  • While in state=issued the invoice becomes read-only: it cannot be updated, deleted, or reverted to new until it is sent or downloaded.

If both send_after_import and issue_after_import are true, send_after_import wins (sending already issues the invoice). Ignored for non-invoice documents.

Allowed:
boolean
Defaults to false

When true, merges the descriptive data (address, city, etc.) of the invoice's contact hash into the matched contact. Routing and tax identifiers (cin_value, pin_value, routing_codes, tin_value) are only filled in when blank on the contact — a value already present is never overwritten. When false (default), a difference in the descriptive data or the routing identifiers leaves the matched contact unchanged and creates an office under it instead.

Ignored for received documents: an inbound invoice never rewrites an existing contact's data.

boolean
Defaults to false

Mark the invoice as acknowledged.

invoice
object
required

Represents an invoice as an object

Headers
string
Defaults to 2026-06-26

Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration
B2Brouter UI Application -> Developers -> API Keys -> API Version

Responses

400

Invalid status value

401

Unauthorized

403

Forbidden

422

Unprocessable Entity

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json