Záznam je možné cez API zmazať dvoma spôsobmi — metódou DELETE na jeho adresu, alebo atribútom action="delete" v importnom XML či JSON. V jadre robia obe to isté, líšia sa tým, čo všetko dokážu obslúžiť.
Metóda DELETE
Zmaže jeden záznam určený adresou:
DELETE /c/{firma}/faktura-vydana/123
Úspech potvrdí odpoveď 200. Na adresu vnorenej evidencie (napríklad /faktura-vydana/123/polozkyDokladu) ju však použiť nemožno — server odpovie 405.
Atribút action="delete"
Mazanie je súčasťou bežného importu, takže v jednom požiadavku možno zmazať aj niekoľko záznamov naraz — a spojiť mazanie s ďalšími zmenami:
<winstrom version="1.0">
<faktura-vydana action="delete">
<id>code:VF1-0001/2026</id>
</faktura-vydana>
<faktura-vydana action="delete">
<id>ext:SHOP:1234</id>
</faktura-vydana>
</winstrom>
Odpoveď má podobu bežného importu — 201 a v štatistikách počet zmazaných záznamov:
<stats><created>0</created><updated>0</updated><deleted>2</deleted> … </stats>
Ten istý zápis vo formáte JSON — každý mazaný záznam je vlastný objekt v poli:
{
"winstrom": {
"@version": "1.0",
"faktura-vydana": [
{ "@action": "delete", "id": "code:VF1-0001/2026" },
{ "@action": "delete", "id": "ext:SHOP:1234" }
]
}
}
ℹ️ Pozor na rozdiel: pole id vnútri jedného objektu neznamená viac záznamov, ale jeden záznam určený niekoľkými identifikátormi zároveň — "id": [ "code:VF1-0001/2026", "ext:SHOP:1234" ] zmaže jediný doklad a všetky uvedené identifikátory musia ukazovať na ten istý záznam.
💡 action="delete" dokáže zmazať aj vnorený záznam, čo metódou DELETE nie je možné. Atribút sa uvádza priamo na konkrétnej položke:
<winstrom version="1.0">
<faktura-vydana>
<id>code:VF1-0001/2026</id>
<polozkyDokladu>
<faktura-vydana-polozka action="delete">
<id>1372</id>
</faktura-vydana-polozka>
</polozkyDokladu>
</faktura-vydana>
</winstrom>
Zmazaná položka sa v štatistikách prejaví ako aktualizácia nadradeného dokladu, nie ako deleted.
⚠️ Mazanie sa riadi väzbami dokladu: podľa ich druhu Flexi buď zmaže aj naviazané záznamy, zruší väzby, alebo akciu nepovolí. Pri systémových záznamoch (napríklad používateľoch alebo štandardných prehľadoch) akciu vykonať nemožno. Ak nechcete doklad stratiť z evidencie, zvážte namiesto mazania stornovanie.