> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/objednavky/export-objednavek.md). # Export objednávek Automatický export objednávek umožňuje pravidelně synchronizovat data z e-shopu do externích systémů pomocí URL odkazů. Tento typ exportu je určen primárně pro integraci s WMS systémy, sklady, ERP systémy nebo vlastní aplikace. ## Základní princip Na rozdíl od [exportu daňových dokladů](/objednavky/export-dokladu.md), který je určen pro manuální stahování, export objednávek funguje jako **automatická API služba**: * Vytvoříte export s definovanými pravidly a filtry * Systém vygeneruje unikátní URL pro tento export * Externí systém pravidelně volá tuto URL a stahuje nové/změněné objednávky * Objednávky se automaticky označí jako synchronizované po stažení ## Typy exportů ### Rocketoo XML Export objednávek ve formátu Rocketoo XML poskytuje kompletní datovou strukturu včetně zákaznických údajů, fakturačních i dodacích adres, jednotlivých položek, cen a DPH. Díky své detailnosti se hodí pro napojení na systémy typu WMS, ERP nebo pro vlastní integrace. Formát je určen pro automatizované zpracování a práci s daty na úrovni systému. [Formát a struktura Rocketoo XML](/objednavky/export-objednavek/format-a-struktura-rocketoo-xml.md) ### Rocketoo CSV Zjednodušený export objednávek do formátu CSV umožňuje rychlé zpracování dat v tabulkových procesorech, jako je Excel nebo Google Sheets. Obsahuje základní informace o objednávkách a je ideální pro analytické účely, reporting nebo jednoduché napojení na další nástroje. Data jsou oddělena středníkem, což zajišťuje kompatibilitu s většinou běžných editorů. [Formát a struktura Rocketoo CSV](/objednavky/export-objednavek/format-a-struktura-rocketoo-csv.md) *** ## Vytvoření nového exportu {% stepper %} {% step %} ### Základní nastavení Navigace: `Objednávky → Export objednávek → Tlačítko Vytvořit` Typ exportu, vyberte formát exportu: * **Rocketoo XML** - Pro komplexní integrace * **Rocketoo CSV** - Pro jednoduché zpracování v Excelu {% endstep %} {% step %} ### Rozsah exportovaných objednávek * **Všechny** \ Exportuje všechny objednávky bez časového omezení.\ **Varování: Může vrátit tisíce objednávek!** * **Jen nové nebo změněné** (Doporučeno)\ Exportuje pouze objednávky, které: * Jsou nové (od posledního stažení) * Byly změněny (stav, zaplacení, atd.) **Ideální pro pravidelnou synchronizaci (CRON)** * **Vytvořené v rozmezí datumů** Od: 01.01.2024\ Do: 31.01.2024 Exportuje objednávky vytvořené v daném období * **Vytvořené před zadaným počtem dnů** Maximální stáří: 7 dnů Exportuje objednávky mladší než 7 dní\ **Vhodné pro pravidelné exporty "posledních X dní"** {% endstep %} {% step %} ### Omezení počtu objednávek Zvolte volbu **Omezit počet exportovaných objednávek**. ``` Maximální počet: 100 ``` **Proč omezovat?** * Ochrana před timeoutem * Postupné stahování velkých objemů * Rychlejší zpracování na straně příjemce **Jak to funguje:** 1. První volání stáhne prvních 100 objednávek 2. Tyto se označí jako synchronizované 3. Druhé volání stáhne dalších 100 4. Opakujete, dokud nejsou všechny stažené {% endstep %} {% step %} ### Pravidla pro filtrování Exportované objednávky můžete filtrovat podle **stavů**, **plateb**, **dopravy** nebo podle toho, zda jsou **zaplacené**. #### Režim filtrování: * Exportovat objednávky, které vyhovují VŠEM podmínkám (AND) ``` ✅ Zaplacené ✅ S dopravou: PPL ✅ Se stavem: Vyřízeno ``` \ → Exportují se POUZE objednávky, které jsou SOUČASNĚ: *zaplacené + PPL + vyřízené* * Exportovat objednávky, které vyhovují ALESPOŇ JEDNÉ podmínce (OR) ``` ✅ Zaplacené ✅ Se stavem: Vyřízeno ``` \ → Exportují se objednávky, které jsou: *zaplacené* NEBO *vyřízené* (nebo obojí) #### Dostupné filtry | Filtr | Popis | Příklad použití | | ------------------------ | ------------------------------ | ------------------------------- | | Zaplacené objednávky | Pouze zaplacené | Export pro vyskladnění | | S vybraným typem platby | Bankovní převod, Dobírka, atd. | Export pouze dobírek | | S vybraným typem dopravy | PPL, Zásilkovna, DPD | Export pro konkrétního dopravce | | S vybraným stavem | Nová, Vyřízeno, Expedováno | Export podle workflow | #### Archivované objednávky **Vynechat archivované objednávky**\ Archivované objednávky nebudou v exportu (doporučeno). {% endstep %} {% step %} ### Zabezpečení exportu Export objednávek obsahuje citlivá data (jména, adresy, telefony). Proto je důležité ho správně zabezpečit. #### Omezení podle IP adresy (Doporučeno) Zaškrtněte volbu **Povolit pouze z konkrétní IP adresy**. **Povolené IP adresy:** ``` 192.168.1.100 10.0.0.50 ``` **Proč?** * Export je přístupný pouze z whitelistovaných IP * Nelze zneužít, i když někdo získá URL * Ideální pro servery s pevnou IP **Jak zjistit IP adresu?** ```bash # Na serveru, odkud budete volat export: curl ifconfig.me ``` #### HTTP Basic Authentication Zaškrtněte volbu **Použít přihlášení pomocí HTTP Basic Auth**. A následně zadejte ***Přihlašovací jméno*** a ***Přihlašovací heslo***. **Použití v kódu:** ```bash # cURL curl -u api_user:7h#mK9$pL2@q https://eshop.cz/api/v1/rocketoo/type/orderexports/xyz123 # PHP $ch = curl_init('https://eshop.cz/api/v1/rocketoo/type/orderexports/xyz123'); curl_setopt($ch, CURLOPT_USERPWD, 'api_user:7h#mK9$pL2@q'); $response = curl_exec($ch); # Python import requests response = requests.get( 'https://vas-eshop.cz/api/v1/rocketoo/type/orderexports/eyJpdiI6Ik', auth=('api_user', '7h#mK9$pL2@q') ) ``` {% hint style="warning" %} Kombinace obou metod = maximální bezpečnost! {% endhint %} {% endstep %} {% step %} ### Uložení a získání URL Po uložení exportu se zobrazí unikátní URL odkaz: ``` https://vase-eshop.cz/api/v1/rocketoo/type/orderexports/eyJpdiI6Ik... ``` Důležité: * URL je vygenerována automaticky * Obsahuje šifrovaná nastavení exportu * Nelze ji uhodnout nebo "hacknout" * Použijte ji ve svém CRON jobu nebo aplikaci {% endstep %} {% step %} ### Log přístupů Každý přístup k exportu se loguje pro kontrolu a audit. Zobrazení logu: `Objednávky → Export objednávek → Log přístupů` Co se loguje? | Sloupec | Popis | | ------------ | ------------------------------ | | Datum | Kdy byl export volán | | IP adresa | Z jaké IP adresy | | Výsledek | Úspěch / Chyba / Blokováno | | Trvání \[ms] | Jak dlouho trvalo vygenerování | Možné výsledky | Výsledek | Popis | Co dělat | | ------------------------- | ------------------------- | ------------------------------ | | Úspěch | Export proběhl v pořádku | Vše OK | | Chyba | Chyba během generování | Zkontrolovat logy serveru | | Blokované IP adresou | IP není na whitelistu | Přidat IP do povolených | | Blokované HTTP autorizací | Špatné přihlašovací údaje | Zkontrolovat username/password | | {% endstep %} | | | | {% endstepper %} | | | ## Řešení problémů ### Export nevrací žádná data **Příčiny:** 1. Všechny objednávky jsou již synchronizované 2. Filtry jsou příliš omezující 3. Není splněna žádná podmínka **Řešení:** * Zkuste export s rozsahem "Všechny" * Odstraňte filtry a zkuste znovu * Zkontrolujte log přístupů ### Export je blokován IP adresou ``` Výsledek: Blokované IP adresou ``` **Řešení:** 1. Zjistěte svou IP adresu: `curl ifconfig.me` 2. Přidejte ji do whitelistu v nastavení exportu 3. Uložte změny 4. Zkuste export znovu ### Export je blokován HTTP autorizací ``` Výsledek: Blokované HTTP autorizací ``` **Řešení:** 1. Zkontrolujte správnost přihlašovacích údajů 2. Ujistěte se, že je HTTP Basic Auth správně implementován 3. Test v prohlížeči: Zkuste URL otevřít přímo ### Export je pomalý **Příčiny:** * Velký počet objednávek * Komplexní filtry * Pomalé připojení **Řešení:** 1. Použijte omezení počtu (např. 100 objednávek) 2. Stahujte v menších dávkách 3. Použijte "Jen nové nebo změněné" ### CSV se nezobrazuje správně v Excelu **Příčina:** * Excel nerozpozná UTF-8 bez BOM * Špatný oddělovač (očekává čárku místo středníku) **Řešení:** 1. Import dat přes "Data → Z textu/CSV" 2. Nastavte kódování UTF-8 3. Nastavte oddělovač na středník (;) *** ## Často kladené otázky
Jak často mohu volat export? * Bez omezení * Doporučeno: každých 5-15 minut * Pro velké objemy: každou hodinu * Používejte "Jen nové nebo změněné"
Jsou data v exportu aktuální? Ano, data jsou **real-time**: * Export se generuje při každém zavolání * Vždy obsahuje aktuální stav objednávek * Změny ve stavech se projeví okamžitě
Můžu mít více exportů? Ano! Můžete vytvořit neomezené množství exportů s různými: * Filtry (např. jeden pro PPL, druhý pro Zásilkovnu) * Formáty (XML i CSV současně) * Zabezpečením (různé IP/autentizace)
Co se stane s označenými objednávkami? Objednávky označené jako "synchronizované": * Nebudou v dalším exportu typu "Jen nové nebo změněné" * Budou v exportu typu "Všechny"