Record expense
Record an expense with supplier, date and net and VAT amounts.
POST https://cotlet.dev/api/v1/fatture-in-cloud/expenses
write
Creates a received document and returns its ID and totals. It reaches nobody and can be deleted in Fatture in Cloud, so this call runs without asking first. Check list_expenses first to avoid a duplicate.
Parameters
| Name | Type | Description |
|---|---|---|
| company_id integer | integer | Company ID. Optional when your account has one company. |
| supplier string required | string | Supplier name. |
| date string required | string | Document date, ISO. |
| description string | string | What was bought. |
| amount_net number required | number | Net amount. |
| vat_percent number required | number | VAT rate in percent. |
Request
curl -X POST https://cotlet.dev/api/v1/fatture-in-cloud/expenses \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"supplier":"supplier","date":"date","amount_net":1,"vat_percent":1}'result = client.call("fatture-in-cloud", "record_expense", {"supplier":"supplier","date":"date","amount_net":1,"vat_percent":1})const result = await cotlet.call('fatture-in-cloud', 'record_expense', {"supplier":"supplier","date":"date","amount_net":1,"vat_percent":1});cotlet call fatture-in-cloud record_expense --data '{"supplier":"supplier","date":"date","amount_net":1,"vat_percent":1}'Example response
{
"id": 3310,
"date": "2026-10-09",
"supplier": "Office Supplies SRL",
"amount_net": 60,
"amount_vat": 13.2,
"amount_gross": 73.2
}