# 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í.\ <mark style="background-color:red;">**Varování: Může vrátit tisíce objednávek!**</mark>
* **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.)

  <mark style="background-color:yellow;">**Ideální pro pravidelnou synchronizaci (CRON)**</mark>
* **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í\ <mark style="background-color:yellow;">**Vhodné pro pravidelné exporty "posledních X dní"**</mark>
  {% 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).&#x20;
{% 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

<details>

<summary>Jak často mohu volat export?</summary>

* Bez omezení
* Doporučeno: každých 5-15 minut
* Pro velké objemy: každou hodinu
* Používejte "Jen nové nebo změněné"

</details>

<details>

<summary>Jsou data v exportu aktuální?</summary>

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ě

</details>

<details>

<summary>Můžu mít více exportů?</summary>

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)

</details>

<details>

<summary>Co se stane s označenými objednávkami?</summary>

Objednávky označené jako "synchronizované":

* Nebudou v dalším exportu typu "Jen nové nebo změněné"
* Budou v exportu typu "Všechny"

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/objednavky/export-objednavek.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.