v1

latestOpenAPI 3.1.02026-07-22155403592.5 KB

Accounting

Expenses

Create an expense

Create a new employee expense

post/consumers/{consumer_id}/accounting/expenses

Path parameters

consumer_idstring uuid required

Query parameters

folder_idstring nullable

Id of the accounting folder instance. A folder represents a legal entity within the system. Required when the multiple folders feature is enabled.

Request body

employee_idstring required

Employee identifier in the accounting system.

totalnumber required

Total amount including taxes for the expense.

untaxed_amountnumber required

Total untaxed amount for the expense.

tax_amountnumber required

Total tax amount for the expense.

referencestring nullable

External reference.

numberstring nullable

Unique number for idempotency in the accounting system.

currencystring required

Currency of the expense (e.g., EUR, USD).

currency_exchange_ratenumber nullable

Exchange rate at expense date if currency differs from folder currency. Must be positive if provided.

datestring date required

Expense date.

pdfstring nullable

Base64 PDF attachment of the expense document.

pdf_namestring nullable

A name for the PDF file to be created for accounting software that support it.

Response

Successful Response