Parameters
JSON body
Request body
application/jsonaccountingEntityExternalIdstringOptionalLength: 24–24
branchSlugstring | nullOptionalOne of 2:
Variant 1
string
Variant 2
null
supplierContactExternalIdstring | nullOptionalExternal id of the "PŘÍJEMCE" (payee) contact. Optional. When omitted or null, the expense is stored with supplier=NULL — the BFF does NOT invent a fallback (historically it auto-picked the org internal contact for write-offs, dropped 2026-07 so a genuinely unknown recipient stays unknown). Fill it in later via /update.
One of 2:
Variant 1
string
Length: 16–24
Variant 2
null
invoiceExternalIdstring | nullOptionalOne of 2:
Variant 1
string
Length: 16–24
Variant 2
null
purchaseInvoiceSequenceNumberstring | nullOptionalOne of 2:
Variant 1
string
Variant 2
null
orderHashstring | nullOptionalOne of 2:
Variant 1
string
Variant 2
null
category"fees" | "shipping" | "marketing" | "payroll" | "utilities" | "supplies" | "services" | "sw" | "storage" | "tax" | "insurance" | "travel" | "writeoff" | "refund" | "other"RequiredaccountCodestring | nullOptionalOne of 2:
Variant 1
string
Length: 0–16
Variant 2
null
vatRatenumber | nullOptionalOne of 2:
Variant 1
number
Variant 2
null
totalMoneynumber | nullOptionalOne of 2:
Variant 1
number
Variant 2
null
netMoneynumber | nullOptionalOne of 2:
Variant 1
number
Variant 2
null
vatMoneynumber | nullOptionalOne of 2:
Variant 1
number
Variant 2
null
currencystringOptionalLength: 3–3
effectiveDatestringRequiredYYYY-MM-DD
dueDatestring | nullOptionalOne of 2:
Variant 1
string
Variant 2
null
paidDatestring | nullOptionalOne of 2:
Variant 1
string
Variant 2
null
paymentMethodstring | nullOptionalOne of 2:
Variant 1
string
Length: 0–32
Variant 2
null
descriptionstringRequiredLength: 1–∞
internalNotestring | nullOptionalOne of 2:
Variant 1
string
Variant 2
null
payerContactExternalIdstring | nullOptionalExternal id of the "PLÁTCE" — the contact liable to pay the expense. Optional. When omitted or null, the expense is stored with payer=NULL — the BFF does NOT invent a fallback (operators sometimes don't know the counterparty at creation time; the admin fills the default at the UI layer). Fill it in later via /update.
One of 2:
Variant 1
string
Length: 16–24
Variant 2
null
attachmentBlobTokensstring[]Optional