Ako sledovať nové a zmenené doklady v Pohode
Pohoda nemá webhooky. Nové a zmenené doklady preto zistíte pravidelným dotazom na endpointy updated — bez nutnosti sťahovať zakaždým celú agendu.
Účtovníčka v Pohode vystaví faktúru, prijme platbu alebo upraví sklad — a vy sa to vo svojom systéme chcete dozvedieť bez toho, aby ste každú chvíľu sťahovali celú agendu znova. Pohoda ale webhooky nemá: desktopová aplikácia žiadnu udalosť von neodosiela. Riešením je pravidelný dotaz na endpointy updated, ktoré vrátia len to, čo sa od posledného dotazu zmenilo.
Ako endpoint updated funguje
Každá hlavná agenda má svoj GET /api/v1/{agenda}/updated s jediným povinným parametrom from — dátumom a časom, od ktorého chcete zmeny vidieť:
curl "https://api.apios.cz/api/v1/invoice/updated?from=2026-11-19T08:00:00" \
-H "X-AUTH-TOKEN: VAS_API_TOKEN"
To isté volanie nájdete v dokumentácii so všetkými parametrami a môžete si ho tam rovno vyskúšať:
Vrátia sa faktúry vytvorené aj upravené od zadaného okamihu — stačí potom prejsť zoznam a vo vašom systéme založiť alebo aktualizovať len to, čo je nové.
Rovnaký endpoint existuje aj pre ďalšie agendy, s rovnakým správaním:
| Agenda | Endpoint |
|---|---|
| Vydané faktúry | GET /api/v1/invoice/updated |
| Vydané objednávky | GET /api/v1/order/issued/updated |
| Prijaté objednávky | GET /api/v1/order/received/updated |
| Skladové zásoby | GET /api/v1/stock/updated |
| Ponuky | GET /api/v1/offer/updated |
Pravidelný dotaz namiesto webhooku
Naplánujte si dotaz ako cron úlohu, napríklad každých päť minút, a ako from vždy pošlite čas posledného úspešného behu:
# uložený čas z minulého behu
FROM="2026-11-19T08:00:00"
curl "https://api.apios.cz/api/v1/invoice/updated?from=$FROM" \
-H "X-AUTH-TOKEN: VAS_API_TOKEN"
# po úspešnom spracovaní uložte nový čas pre ďalší beh
Interval voľte podľa toho, ako rýchlo potrebujete reagovať — pri faktúrach a platbách stačí často rádovo minúty, pri sklade podľa toho, ako rýchlo sa musí prejaviť v e-shope (pozrite Ako udržať stav skladu v e-shope podľa Pohody).
Keď dotaz nič nevráti
Prázdna odpoveď je úplne v poriadku — znamená, že sa od posledného dotazu nič nezmenilo. Nemusíte to nijak ošetrovať, len ďalší beh pošlite s rovnakým from, aké ste použili tentoraz.