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ů, 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
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
Vytvoření nového exportu
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í"
Omezení počtu objednávek
Zvolte volbu Omezit počet exportovaných objednávek.
Maximální počet: 100Proč omezovat?
Ochrana před timeoutem
Postupné stahování velkých objemů
Rychlejší zpracování na straně příjemce
Jak to funguje:
První volání stáhne prvních 100 objednávek
Tyto se označí jako synchronizované
Druhé volání stáhne dalších 100
Opakujete, dokud nejsou všechny stažené
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
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).
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.50Proč?
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?
# Na serveru, odkud budete volat export:
curl ifconfig.meHTTP 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:
# 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')
)Kombinace obou metod = maximální bezpečnost!
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?
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
Ú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
Řešení problémů
Export nevrací žádná data
Příčiny:
Všechny objednávky jsou již synchronizované
Filtry jsou příliš omezující
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í:
Zjistěte svou IP adresu:
curl ifconfig.mePřidejte ji do whitelistu v nastavení exportu
Uložte změny
Zkuste export znovu
Export je blokován HTTP autorizací
Výsledek: Blokované HTTP autorizacíŘešení:
Zkontrolujte správnost přihlašovacích údajů
Ujistěte se, že je HTTP Basic Auth správně implementován
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í:
Použijte omezení počtu (např. 100 objednávek)
Stahujte v menších dávkách
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í:
Import dat přes "Data → Z textu/CSV"
Nastavte kódování UTF-8
Nastavte oddělovač na středník (;)
Často kladené otázky
Last updated
Was this helpful?