Seznamy a synchronizace

Všechny seznamy se stránkují a řadí od nejstarší změny, takže se dají spolehlivě synchronizovat.

Stránkování

Parametr	Význam
`page`	Číslo stránky od 1.
`pageSize`	Záznamů na stránce, 1–100 (výchozí 50).
`updatedSince`	Jen záznamy změněné po tomto čase.
`q`	Hledání v názvu, čísle, IČO nebo e-mailu.

{
  "items": [ … ],
  "page": 1,
  "pageSize": 50,
  "total": 132
}

Filtry dokladů

`kind`	Druh dokladu ve Fakturách vydaných (`invoice`, `proforma`, …).
`issuedFrom`, `issuedTo`	Datum vystavení od–do (včetně).
`paid`	`true` zaplacené, `false` s nedoplatkem.
`companyNumber`	IČO odběratele (Faktury vydané) nebo dodavatele (Faktury přijaté).

GET /api/v1/invoices?kind=invoice&paid=false&issuedFrom=2026-10-01&pageSize=100

Synchronizace

Uložte si updatedAt posledního zpracovaného záznamu a příště se ptejte jen na novější změny:

GET /api/v1/invoices?updatedSince=2026-10-26T08:30:00Z&page=1&pageSize=100

Procházejte stránky, dokud nedostanete méně záznamů než pageSize. Smazané doklady v seznamu nejsou; o smazání vám dají vědět webhooky (invoice.deleted).