Ako opraviť alebo stornovať vystavenú faktúru
Faktúru v Pohode nemožno cez API upraviť ani zmazať. Opravný daňový doklad alebo storno vyrieši zlú sumu, chybné položky aj úplné zrušenie faktúry.
Vystavili ste faktúru so zlou sumou alebo zákazník objednávku stornoval a faktúra už je v Pohode. Čo teraz? Agenda Vydané faktúry v Pohode nemá actionType — cez XML rozhranie doklad nejde ani upraviť, ani zmazať. Jediná cesta je vystaviť k nemu ďalší doklad: opravný daňový doklad (dobropis) na zlú sumu alebo položky, prípadne storno na zrušenie celej faktúry.
Dobropis na zlú sumu alebo položky
POST /api/v1/invoice/{id}/corrective necháva Pohodu vytvoriť opravný daňový doklad k zadanej faktúre. V Česku ide o opravný daňový doklad, na Slovensku o dobropis — endpoint je rovnaký, líši sa len invoice_type.
curl -X POST https://api.apios.cz/api/v1/invoice/813/corrective \
-H "X-AUTH-TOKEN: VAS_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: dobropis-faktura-813" \
-d '{
"sym_var": "2026001",
"date": "2026-11-05"
}'
To isté volanie nájdete v dokumentácii so všetkými parametrami a môžete si ho tam rovno vyskúšať:
Prázdne telo požiadavky je v poriadku — Pohoda si položky aj sumu prevezme zo zdrojovej faktúry (riadi to item_transfer, predvolené true). Pošlite len to, čo sa má líšiť: iný dátum, iný variabilný symbol, alebo invoice_type pre slovenský dobropis (issuedCreditNotice / receivedCreditNotice).
Storno celej faktúry
Potrebujete faktúru zneplatniť celú, nielen opraviť sumu? POST /api/v1/invoice/{id}/storno vytvorí stornujúci doklad, ktorý faktúru zruší v plnej výške.
curl -X POST https://api.apios.cz/api/v1/invoice/813/storno \
-H "X-AUTH-TOKEN: VAS_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: storno-faktura-813"
To isté volanie nájdete v dokumentácii so všetkými parametrami a môžete si ho tam rovno vyskúšať:
Prázdne telo je tu najbežnejšie použitie — Pohoda prevezme všetko zo zdrojovej faktúry. Voliteľné polia v tele upravujú novovznikajúci stornujúci doklad, nie faktúru samotnú.
Obe volania vrátia ID a číslo nového dokladu rovnako ako bežné vystavenie faktúry:
{
"success": true,
"message": "Operace byla úspěšně provedena",
"data": { "id": 821, "number": "250100193", "action_type": "add" }
}
Čo použiť kedy
| Situácia | Endpoint |
|---|---|
| Faktúra má zlú sumu alebo položky, zvyšok je v poriadku | corrective |
| Faktúra nemala vôbec vzniknúť (zrušená objednávka, duplicita) | storno |
| Zákazník zaplatil menej alebo viac, než mal | corrective na rozdiel |