Skip to main content
POST
/
consumers
/
{consumer_id}
/
accounting
/
expenses
Create an expense
curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/expenses \
  --header 'Content-Type: application/json' \
  --data '
{
  "employee_id": "<string>",
  "total": 123,
  "untaxed_amount": 123,
  "tax_amount": 123,
  "currency": "<string>",
  "date": "2023-12-25",
  "lines": [
    {
      "total": 123,
      "untaxed_amount": 123,
      "tax_amount": 123,
      "account_number": "<string>",
      "tax_rate": 123,
      "tax_id": "<string>",
      "description": "<string>"
    }
  ],
  "reference": "<string>",
  "number": "<string>",
  "currency_exchange_rate": 1,
  "pdf": "<string>",
  "pdf_name": "<string>"
}
'
{
  "employee_id": "<string>",
  "total": 123,
  "untaxed_amount": 123,
  "tax_amount": 123,
  "currency": "<string>",
  "date": "2023-12-25",
  "lines": [
    {
      "total": 123,
      "untaxed_amount": 123,
      "tax_amount": 123,
      "account_number": "<string>",
      "tax_rate": 123,
      "tax_id": "<string>",
      "description": "<string>"
    }
  ],
  "id": "<string>",
  "reference": "<string>",
  "number": "<string>",
  "currency_exchange_rate": 1,
  "pdf": "<string>",
  "pdf_name": "<string>"
}

Path Parameters

​
consumer_id
string<uuid>
required

Query Parameters

​
folder_id
string | null

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

Body

application/json
​
employee_id
string
required

Employee identifier in the accounting system.

​
total
number
required

Total amount including taxes for the expense.

​
untaxed_amount
number
required

Total untaxed amount for the expense.

​
tax_amount
number
required

Total tax amount for the expense.

​
currency
string
required

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

​
date
string<date>
required

Expense date.

​
lines
ExpenseLineItem · object[]
required

Expense lines.

Minimum array length: 1
​
reference
string | null

External reference.

​
number
string | null

Unique number for idempotency in the accounting system.

​
currency_exchange_rate
number | null
default:1

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

​
pdf
string | null

Base64 PDF attachment of the expense document.

​
pdf_name
string | null

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

Required string length: 1 - 200
Pattern: ^[a-zA-Z0-9\-_ ]{1,196}(?:.pdf)?$

Response

Successful Response

​
employee_id
string
required

Employee identifier in the accounting system.

​
total
number
required

Total amount including taxes for the expense.

​
untaxed_amount
number
required

Total untaxed amount for the expense.

​
tax_amount
number
required

Total tax amount for the expense.

​
currency
string
required

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

​
date
string<date>
required

Expense date.

​
lines
ExpenseLineItem · object[]
required

Expense lines.

Minimum array length: 1
​
id
string
required

Unique id of the expense in the accounting system.

​
reference
string | null

External reference.

​
number
string | null

Unique number for idempotency in the accounting system.

​
currency_exchange_rate
number | null
default:1

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

​
pdf
string | null

Base64 PDF attachment of the expense document.

​
pdf_name
string | null

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

Required string length: 1 - 200
Pattern: ^[a-zA-Z0-9\-_ ]{1,196}(?:.pdf)?$