Definujte jeden řádkový model a mapování každého pole, používejte interní ID objednávky i stabilní externí ID a exportujte podle času změny s uloženým kurzorem. Každou dávku očíslujte, předejte šifrovaně, potvrďte její přijetí a porovnejte počty, částky a chybové řádky. Formát verzujte spolu s příkladem a přechodným obdobím. Kurzoru důvěřujte až po potvrzení celé dávky.
Export objednávek z WooCommerce může být jednorázový soubor pro kontrolu nebo pravidelný datový tok do skladu, účetnictví a analytiky. Největší riziko není jen nesprávný formát sloupce. Objednávka se po vytvoření mění, obsahuje více položek, refundace a vlastní pole, takže jednoduchý export podle data může záznam vynechat nebo odeslat opakovaně bez možnosti rozlišení.
Spolehlivý export potřebuje jasný účel, datový kontrakt, stabilní identifikátory a potvrzení přijetí. Tento návod ukazuje, jak navrhnout ruční i automatizovaný výstup, inkrementální dávky, bezpečné doručení a kontrolu počtů. Nezabývá se právním určením účetních položek; význam a rozsah finančních dat musí schválit odpovědný odborník firmy.
Praktická ukázka: tři testovací řádky před ostrým exportem
Veřejné prodejní projekty, například By You Shop a ZOPA, najdete v portfoliu Webiant. U exportu objednávek je však třeba prověřit konkrétní způsob evidence a účtování. Následující řádky jsou umělá testovací data; neobsahují údaje zákazníků ani výsledky těchto projektů.
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 cílovém systému |
|---|---|
| Ztráta úvodních nul | external_id importovat jako text, ne jako číslo |
| Rozdílné oddělovače a desetinná čísla | Dohodnout tečku nebo čárku a oddělovač polí |
| Nejasná data | Uložit UTC, nebo výslovně uvést časové pásmo |
| Storna a refundace | Dohodnout, zda se mají zahrnout a jak se účtují |
| Opakovaný import | Použít stabilní ID a zabránit duplicitnímu zápisu |
Nejprve exportujte malý kontrolní vzorek a porovnejte počet objednávek, měny, stav a součet podle jednotlivých měn. Částku stornovaných či refundovaných objednávek nelze automaticky považovat za tržbu. Pravidla stanovte s osobou, která bude údaje zpracovávat.
Při větším objemu použijte dávky a stabilní řazení. Pokud se objednávky během exportu mění, musíte definovat časový řez nebo evidovat změny, aby záznam nevypadl mezi stránkami. U souboru pro Excel otestujte UTF-8 a zachování diakritiky. Hodnoty začínající znaky =, +, – nebo @ zpracujte tak, aby se při otevření nespustily jako vzorce.
Dokončení ověřte opětovným importem téhož vzorku: počet záznamů se nesmí zdvojnásobit. Souvisí s tím idempotence API a dohoda o integraci systémů.
Začněte účelem a datovým kontraktem
Příjemce má uvést, k jakému rozhodnutí každý údaj používá. Export pro balení potřebuje položky a adresu, analytický výstup může potřebovat události a účetní systém schválené finanční členění. Nevytvářejte jeden obrovský soubor pro všechny; rozšiřuje přístup k údajům a komplikuje změny.
U každého pole zapište zdroj, typ, formát, povinnost, povolenou prázdnou hodnotu a příklad. Rozlišujte ID objednávky, veřejné číslo a ID v cílovém systému. Částky přenášejte s měnou a významem včetně toho, zda jde o uložený řádek, základ, daň nebo výsledek po refundaci.
- Účel a vlastník exportu
- Jednoznačný význam každého pole
- Stabilní identifikátory a měny
- Verze formátu a pravidla změn
Vyberte správný tvar pro objednávku a položky
Objednávka má jednu hlavičku a více řádků. Široký CSV soubor s opakovanými údaji hlavičky je jednoduchý pro tabulku, ale příjemce musí řádky správně seskupit. Dva související soubory snižují opakování, ale potřebují referenční ID a atomické doručení. JSON přirozeně zachová vnoření, pokud jej cíl podporuje.
Vlastní pole a metadata neexportujte automaticky všechna. Vyberte schválený seznam a transformujte významové hodnoty. Interní technický příznak nemusí být stabilním kontraktem. U variant přeneste ID varianty, SKU a atributy uložené v objednávce; aktuální produkt se mohl později změnit nebo být odstraněn.
Navrhněte inkrementální export bez mezer
Export podle času vytvoření nezachytí pozdější změnu stavu, adresy nebo refundaci. Použijte čas poslední relevantní změny, stabilní řazení a kurzor uložený až po potvrzeném zpracování dávky. Při shodném čase doplňte ID jako druhé kritérium řazení, aby se na hranici dávky žádný záznam nevynechal.
Příjemce musí umět přijmout stejnou objednávku znovu jako aktualizaci, nikoli jako duplikát. Upsert važte na stabilní klíč a verzi záznamu. Smazání nebo zrušení přeneste explicitním stavem, nikoli zmizením z dalšího souboru. Plný kontrolní export pravidelně porovná stav po inkrementálních dávkách.
Chraňte soubory a provozní přístup
Objednávky obsahují osobní a obchodní údaje. Soubory ukládejte mimo veřejně dostupné uploady, přenášejte šifrovaným kanálem a přístup omezte podle role. Název s tajným náhodným řetězcem není jedinou ochranou. Nastavte expiraci, mazání a audit stahování podle schválených potřeb.
Při ručním exportu zobrazte rozsah dat před potvrzením a u velkého souboru použijte frontu místo blokování administrace. Odkaz ke stažení ať je časově omezený a vázaný na oprávněného uživatele. Log nezapisuje celý obsah řádků; stačí dávka, rozsah, počty, kontrolní součet a výsledek.
Sjednoťte dávku s obchodními kontrolami
Po každém běhu porovnejte počet objednávek, položek, součty podle měny a počty stavů mezi zdrojem a přijatým výsledkem. Odmítnuté řádky evidujte samostatně i s důvodem. Nulová technická chyba neznamená úplný export, pokud filtr omylem vybral prázdný rozsah nebo příjemce přeskočil část souboru.
Testujte dlouhé názvy, diakritiku, více položek, nákup bez registrace, slevu, refundaci, vlastní stav a objednávku změněnou během exportu. Změnu formátu vydejte jako novou verzi s přechodným obdobím. Runbook popíše bezpečné opakování dávky a rekonstrukci kurzoru bez ručního přepisování neověřeného data.
Časté dotazy
Je lepší CSV, nebo JSON export objednávek?
Záleží na příjemci. CSV je dostupné pro tabulky, ale potřebuje jasný model opakovaných řádků. JSON lépe zachová vnořené položky. Důležitější než formát je verzovaný kontrakt a kontrola úplnosti.
Podle jakého data exportovat nové objednávky?
U pravidelného toku obvykle podle poslední relevantní změny, nejen vytvoření. Použijte stabilní kurzor s časem a ID a uložte jej až po potvrzení celé dávky.
Jak zabránit duplicitám po opakovaném exportu?
Každý záznam přenášejte se stabilním klíčem a verzí. Příjemce provede idempotentní upsert a dávka má vlastní identifikátor, takže opakování obnoví stejný výsledek místo dalšího záznamu.
Zdroje a další čtení
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.
