list_items
List/filter items, scoped to the caller's member companies (A1).
Optional period (YYYY-MM) filters by the item's effective date
(invoice date, falling back to the Europe/Zurich-local ingestion date); a
malformed value returns 422 {"msg": "period must be YYYY-MM"}.
exclude_triage_status drops items carrying that triage verdict (NULL-safe;
for unrelated not a booked one, ZCT-954).
Optional q: a case-insensitive substring match over the filename and both
counterparty names (linked, and extracted data.company).
duplicate filters on the row's is_duplicate flag (ZET-413); credit_note on
its is_credit_note flag (ZET-429) — both server-side, so total stays exact.
posted filters on the posting badge (ZCT-811): true = posted, false = held,
reversed or not booked; a copy filed with the booking of the same invoice ("Already
booked", posting.filed_with) is in neither (ZEN-1). overdue (D08-G14): due before
today (Zurich), still owing, not a credit note. Owing is the open item's rest; a document with
no open item is owing until a bank movement is linked to it (R2-2).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| paid | No | ||
| limit | No | ||
| order | No | date_desc | |
| offset | No | ||
| period | No | ||
| posted | No | ||
| source | No | ||
| overdue | No | ||
| direction | No | ||
| duplicate | No | ||
| company_id | No | ||
| credit_note | No | ||
| triage_status | No | ||
| archive_status | No | ||
| analysis_failed | No | ||
| counterparty_id | No | ||
| exclude_triage_status | No |