Add an expense
expense_addRecord one expense and return its id, its net/VAT split and its billable flag. The response states every default that was applied, so the caller can see what was assumed rather than having to guess.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vat | No | Alias for vat_rate | |
| date | No | ISO date YYYY-MM-DD, default today | |
| note | No | ||
| amount | Yes | Gross amount on the receipt, in major units, e.g. 12.34. It is stored as integer minor units in the expense's own currency, so nothing is lost to floating point. | |
| project | No | Project or client this belongs to | |
| billable | No | Rebillable to the client. Default: true when project is given (a receipt booked to a client project is normally rebilled), false otherwise. Pass it explicitly to override. | |
| category | No | Category, e.g. software, travel, office. Omit and the stored category rules are matched against the merchant to fill it in | |
| currency | No | ISO code. Defaults to your expense_settings default_currency, else the shared business profile's default_currency, else EUR | |
| merchant | No | Who was paid, e.g. Adobe | |
| tax_rate | No | Alias for vat_rate | |
| vat_rate | No | VAT percent already included in amount; it splits the gross into net and VAT. Omit to use the expense_settings default, or get no split at all when none is set | |
| receipt_path | No | Absolute path to the receipt file; it is checked and hashed |