Přejít na obsah
FakturanetAPI v1.0.0
OpenAPI API klíče

Příručka

Synchronizace a souběžné změny

Čtěte jen změny a nepřepisujte cizí úpravy.

Pro zrcadlení dat do jiného systému nečtěte pokaždé všechno. Uložte si čas poslední synchronizace a čtěte jen to, co se od něj změnilo. Znak + v časové zóně zapište v adrese jako %2B:

curl "https://api.fakturanet.cz/v1/invoices?updated_since=2026-11-18T09:30:00%2B01:00&limit=100" \
  -H "Authorization: Bearer $FAKTURANET_API_KEY"
  • Seznam s updated_since je seřazený od nejstarší změny a obsahuje i smazané záznamy; ty mají vyplněné deleted_at. Funguje pro doklady, kontakty i výdaje.
  • Projděte všechny stránky podle links.next. Další synchronizaci začněte od největšího updated_at, které jste dostali. Hranice platí včetně, stejný záznam se proto může vrátit znovu – ukládejte ho podle id.
  • Úprava, vystavení, úhrada i smazání dokladu mění jeho updated_at.

Souběžné změny

Detail záznamu i odpověď na jeho změnu nesou hlavičku ETag. Pošlete ji při další změně v If-Match: když záznam mezitím změnil někdo jiný, API vrátí 412, nic neprovede a v hlavičce ETag pošle aktuální verzi. Bez If-Match se změna provede vždy.

ETAG=$(curl -s -o /dev/null -D - "https://api.fakturanet.cz/v1/invoices/123" \
  -H "Authorization: Bearer $FAKTURANET_API_KEY" | tr -d '\r' | awk 'tolower($1)=="etag:" {print $2}')

curl -X PATCH "https://api.fakturanet.cz/v1/invoices/123" \
  -H "Authorization: Bearer $FAKTURANET_API_KEY" \
  -H "If-Match: $ETAG" \
  -H "Content-Type: application/json" \
  --data-raw '{"note": "Upraveno po kontrole."}'

Při opakovaném čtení pošlete ETag v If-None-Match. Když se záznam nezměnil, API vrátí 304 bez těla. Hodí se to například pro čekání na hotový export.

Hledat v dokumentaci

Hledejte endpoint, pole, objekt, typ chyby nebo téma příručky.