Definujte jeden riadkový model a mapovanie každého poľa, používajte interné ID objednávky aj stabilné externé ID a exportujte podľa času zmeny s uloženým kurzorom. Každú dávku očíslujte, šifrovane odovzdajte, potvrďte prijatie a porovnajte počty, sumy a chybové riadky. Formát verzujte spolu s príkladom a prechodným obdobím. Kurzoru dôverujte až po potvrdení celej dávky.
Export objednávok z WooCommerce môže byť jednorazový súbor pre kontrolu alebo pravidelný dátový tok do skladu, účtovníctva a analytiky. Najväčšie riziko nie je iba nesprávny formát stĺpca. Objednávka sa po vytvorení mení, obsahuje viac položiek, refundácie a vlastné polia, takže jednoduchý export podľa dátumu môže záznam vynechať alebo poslať opakovane bez možnosti rozlíšenia.
Spoľahlivý export potrebuje jasný účel, dátový kontrakt, stabilné identifikátory a potvrdenie prijatia. Tento návod ukazuje, ako navrhnúť ručný aj automatizovaný výstup, inkrementálne dávky, bezpečné doručenie a kontrolu počtov. Nezaoberá sa právnym určením účtovných položiek; význam a rozsah finančných dát musí schváliť zodpovedný odborník firmy.
Praktická ukážka: tri testovacie riadky pred ostrým exportom
Verejné predajné projekty, napríklad By You Shop a ZOPA, nájdete v portfóliu Webiant. Pri exporte objednávok však treba preveriť konkrétny spôsob evidencie a účtovania. Nasledujúce riadky sú umelé testovacie údaje; neobsahujú údaje zákazníkov ani výsledky týchto projektov.
order_id;external_id;created_at_utc;currency;total;status
1001;000042;2026-10-01T08:30:00Z;EUR;129.90;completed
1002;000043;2026-10-01T09:15:00Z;EUR;0.00;cancelled
1003;000044;2026-10-02T16:45:00Z;EUR;49.50;refunded| Riziko | Kontrola v cieľovom systéme |
|---|---|
| Strata úvodných núl | external_id importovať ako text, nie ako číslo |
| Rozdielne oddeľovače a desatinné čísla | Dohodnúť bodku alebo čiarku a oddeľovač polí |
| Nejasné dátumy | Uložiť UTC alebo výslovne uviesť časové pásmo |
| Storná a refundácie | Dohodnúť, či sa majú zahrnúť a ako sa účtujú |
| Opakovaný import | Použiť stabilné ID a zabrániť duplicitnému zápisu |
Exportujte najprv malú kontrolnú vzorku a porovnajte počet objednávok, meny, stav a súčet po jednotlivých menách. Suma stornovaných či refundovaných objednávok sa nesmie automaticky považovať za tržbu. Pravidlá určte s osobou, ktorá údaje spracuje.
Pri väčšom objeme použite dávky a stabilné zoradenie. Ak sa objednávky počas exportu menia, potrebujete definovať časový rez alebo evidovať zmeny, aby sa záznam nevynechal medzi stránkami. Pri súbore pre Excel otestujte UTF-8 a zachovanie diakritiky. Hodnoty začínajúce znakmi =, +, – alebo @ spracujte tak, aby sa pri otvorení nespustili ako vzorce.
Dokončenie overte opätovným importom tej istej vzorky: počet záznamov sa nesmie zdvojnásobiť. Súvisí s tým idempotencia API a dohoda o integrácii systémov.
Začnite účelom a dátovým kontraktom
Príjemca má povedať, na aké rozhodnutie každý údaj používa. Export pre balenie potrebuje položky a adresu, analytický výstup môže potrebovať udalosti a účtovný systém schválené finančné členenie. Nevytvárajte jeden obrovský súbor pre všetkých; zvyšuje prístup k údajom a komplikuje zmeny.
Pri každom poli zapíšte zdroj, typ, formát, povinnosť, povolenú prázdnu hodnotu a príklad. Rozlíšte ID objednávky, verejné číslo a ID v cieľovom systéme. Sumy prenášajte s menou a významom vrátane toho, či ide o uložený riadok, základ, daň alebo výsledok po refundácii.
- Účel a vlastník exportu
- Jednoznačný význam každého poľa
- Stabilné identifikátory a mena
- Verzia formátu a pravidlá zmeny
Vyberte správny tvar pre objednávku a položky
Objednávka má jednu hlavičku a viac riadkov. Široký CSV súbor s opakovanými údajmi hlavičky je jednoduchý pre tabuľku, no príjemca musí správne zoskupiť riadky. Dva súvisiace súbory znižujú opakovanie, ale potrebujú referenčné ID a atómové doručenie. JSON prirodzene zachová vnorenie, ak ho cieľ podporuje.
Vlastné polia a metadata neexportujte automaticky všetky. Vyberte schválený zoznam a transformujte významové hodnoty. Interný technický príznak nemusí byť stabilný kontrakt. Pri variantoch preneste ID variantu, SKU a atribúty uložené v objednávke; aktuálny produkt sa mohol neskôr zmeniť alebo byť odstránený.
Navrhnite inkrementálny export bez medzier
Export podľa času vytvorenia nezachytí neskoršiu zmenu stavu, adresy alebo refundácie. Použite čas poslednej relevantnej zmeny, stabilné poradie a kurzor uložený až po potvrdenom spracovaní dávky. Pri rovnakom čase doplňte ID ako druhú časť poradia, aby hranica nevynechala záznam.
Príjemca musí vedieť prijať rovnakú objednávku znova ako aktualizáciu, nie duplikát. Upsert viažte na stabilný kľúč a verziu záznamu. Vymazanie alebo zrušenie preneste explicitným stavom, nie zmiznutím z ďalšieho súboru. Plný kontrolný export pravidelne porovná stav po inkrementálnych dávkach.
Chráňte súbory a prevádzkový prístup
Objednávky obsahujú osobné a obchodné údaje. Súbory ukladajte mimo verejne dostupných uploadov, prenášajte šifrovaným kanálom a prístup obmedzte podľa roly. Názov s tajným náhodným reťazcom nie je jediná ochrana. Nastavte expiráciu, mazanie a audit stiahnutia podľa schválených potrieb.
Pri manuálnom exporte zobrazte rozsah dát pred potvrdením a pri veľkom súbore použite frontu namiesto blokovania administrácie. Odkaz na stiahnutie nech je časovo obmedzený a viazaný na oprávneného používateľa. Log nezapisuje celý obsah riadkov; stačí dávka, rozsah, počty, kontrolný súčet a výsledok.
Zosúlaďte dávku obchodnými kontrolami
Po každom behu porovnajte počet objednávok, položiek, súčty podľa meny a počty stavov medzi zdrojom a prijatým výsledkom. Samostatne evidujte odmietnuté riadky s dôvodom. Nulový technický error neznamená úplný export, ak filter omylom vybral prázdny rozsah alebo príjemca preskočil časť súboru.
Testujte dlhé názvy, diakritiku, viac položiek, hosťa, zľavu, refundáciu, vlastný stav a objednávku zmenenú počas exportu. Zmenu formátu vydajte ako novú verziu s prechodným obdobím. Runbook popíše bezpečné opakovanie dávky a rekonštrukciu kurzora bez ručného prepisovania neovereného dátumu.
Časté otázky
Je lepší CSV alebo JSON export objednávok?
Závisí od príjemcu. CSV je dostupný pre tabuľky, ale potrebuje jasný model opakovaných riadkov. JSON lepšie zachová vnorené položky. Dôležitejší než formát je verzovaný kontrakt a kontrola úplnosti.
Podľa akého dátumu exportovať nové objednávky?
Pri pravidelnom toku zvyčajne podľa poslednej relevantnej zmeny, nie iba vytvorenia. Použite stabilný kurzor s časom a ID a uložte ho až po potvrdení celej dávky.
Ako zabrániť duplicitám po opakovanom exporte?
Každý záznam prenášajte so stabilným kľúčom a verziou. Príjemca vykoná idempotentný upsert a dávka má vlastný identifikátor, takže opakovanie obnoví rovnaký výsledok namiesto ďalšieho záznamu.
Zdroje a ďalšie čítanie
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
