Skip to main content
POST
Create an invoice

Authorizations

Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Body

application/json
client_id
string
required

Existing client CzUid (required if client_data not provided)

items
object[]
required
Minimum array length: 1
client_data
object

Inline client creation (required if client_id not provided)

series_id
string

Invoice series CzUid

reservation_token
string

Offline-mode only. Token returned by POST /invoice-series/{id}/reserve-numbers. When supplied, the server uses the reservation's pre-allocated number instead of calling nextNumber(), and flips the reservation to consumed. Must match the same series_id and belong to the caller's device. See Offline Mode.

force_chronology
boolean
default:true

Set to false to bypass the chronology check when syncing an offline draft dated before the last invoice on the series.

date
string<date>

Invoice date (defaults to today)

due_date
string<date>

Payment due date

currency
string
default:RON
currency_rate
number

Exchange rate to RON (required for foreign currency)

document_type
enum<string>
default:fiscal
Available options:
fiscal,
proforma,
receipt
is_draft
enum<integer>
default:0

1 to save as draft without invoice number

Available options:
0,
1
efactura_enabled
enum<integer>
default:1

Whether to submit to e-Factura (Romanian e-invoicing)

Available options:
0,
1
spv_environment
enum<string>

e-Factura environment (test for SPV testing)

Available options:
test,
live
with_vat_inverted
enum<integer>
default:0

1 for reverse charge (taxare inversă)

Available options:
0,
1
payment_method
string
payment_type
string
payment_installments
integer
send_email
boolean
default:false

Automatically send invoice by email after creation

email_address
string<email>

Override recipient email (uses client email if not specified)

with_delegate
enum<integer>

Include delegate information

Available options:
0,
1
delegate
object
info
string

Additional invoice information

observations
string

Internal notes

notes
string

Customer-visible notes

Response

Invoice created

success
boolean
data
object
meta
object