# Formát a struktura Rocketoo XML

Export objednávek ve formátu Rocketoo XML umožňuje přehledné a detailní předání dat do vlastních systémů nebo aplikací třetích stran. Obsahuje kompletní strukturu objednávky včetně zákaznických údajů, položek, cen, DPH a stavu objednávky. Níže najdete popis jednotlivých částí XML souboru a jeho ukázku.

### Základní struktura

```xml
<?xml version="1.0" encoding="UTF-8" ?>
<ORDERS>
    <ORDER>
        <!-- Data objednávky -->
    </ORDER>
    <ORDER>
        <!-- Další objednávka -->
    </ORDER>
</ORDERS>
```

### Detailní struktura objednávky

```xml
<ORDER>
    <!-- Základní identifikace -->
    <ID>12345</ID>
    <ORDER_NUMBER>2024001</ORDER_NUMBER>
    <ORDER_SOURCE>web</ORDER_SOURCE>
    <!-- Možné hodnoty: web, api, import, manual -->
    
    <REFERER>https://google.com</REFERER>
    <!-- URL odkud přišel zákazník -->
    <IP>192.168.1.100</IP>
    <!-- IP adresa zákazníka -->
    
    <!-- Data a stavy -->
    <ORDERSTATE_DATE>2024-01-15 14:30:00</ORDERSTATE_DATE>
    <!-- Datum posledního změny stavu -->
    <PAID>1</PAID>
    <!-- 0 = nezaplaceno, 1 = zaplaceno -->
    <PAID_DATE>2024-01-15 15:00:00</PAID_DATE>
    <!-- Datum zaplacení - prázdné pokud není zaplaceno -->
    <ARCHIVED>0</ARCHIVED>
    <!-- 0 = aktivní, 1 = archivováno -->
    <ARCHIVED_DATE></ARCHIVED_DATE>
    <!-- Datum archivace -->
    
    <TRACKING_NUMBER>ABC123456789</TRACKING_NUMBER>
    <!-- Sledovací číslo zásilky -->
    <CUSTOMER_NOTES>Prosím zazvonit na domácí zvonek</CUSTOMER_NOTES>
    <!-- Poznámka zákazníka -->
    
    <!-- Ceny -->
    <PRICE_TOTAL_CURRENCY_VAT>12100.00</PRICE_TOTAL_CURRENCY_VAT>
    <PRICE_TOTAL_CURRENCY_NO_VAT>10000.00</PRICE_TOTAL_CURRENCY_NO_VAT>
    <CONVERSION_RATE>1.0000</CONVERSION_RATE>
    <!-- Kurzovní přepočet (např. EUR → CZK) -->
    <CREATED_AT>2024-01-15 14:30:00</CREATED_AT>
    <!-- Datum vytvoření objednávky -->
    
    <!-- Stav objednávky a země -->
    <ORDERSTATE>Vyřízeno</ORDERSTATE>
    <!-- Název stavu objednávky -->
    <STATE>CZ</STATE>
    <!-- ISO kód země objednávky -->
    <CURRENCY>CZK</CURRENCY>
    <!-- Měna objednávky -->
    
    <!-- Informace o zákazníkovi -->
    <CUSTOMER>
        <USERNAME>jan.novak</USERNAME>
        <!-- Přihlašovací jméno (pokud je registrovaný) -->
        <FIRST_NAME>Jan</FIRST_NAME>
        <LAST_NAME>Novák</LAST_NAME>
        <EMAIL>jan.novak@email.cz</EMAIL>
        <REGISTERED>1</REGISTERED>
        <!-- 0 = host (neregistrovaný), 1 = registrovaný zákazník -->
        <PHONE>+420 123 456 789</PHONE>
    </CUSTOMER>
    
    <!-- Adresy -->
    <ADDRESSES>
        <!-- Dodací adresa -->
        <SHIPPING>
            <ADDRESS_STATE>CZ</ADDRESS_STATE>
            <!-- ISO kód země -->
            <ADDRESS_FIRST_NAME>Jan</ADDRESS_FIRST_NAME>
            <ADDRESS_LAST_NAME>Novák</ADDRESS_LAST_NAME>
            <ADDRESS_COMPANY></ADDRESS_COMPANY>
            <!-- Název firmy - prázdné pro fyzické osoby -->
            <ADDRESS_COMPANY_NUMBER></ADDRESS_COMPANY_NUMBER>
            <!-- IČO -->
            <ADDRESS_COUNTY></ADDRESS_COUNTY>
            <!-- Název kraje/okresu -->
            <ADDRESS_STREET>Hlavní 123</ADDRESS_STREET>
            <ADDRESS_STREET2></ADDRESS_STREET2>
            <!-- Druhý řádek adresy -->
            <ADDRESS_STREET3></ADDRESS_STREET3>
            <!-- Třetí řádek adresy -->
            <ADDRESS_CITY>Praha</ADDRESS_CITY>
            <ADDRESS_ZIP>11000</ADDRESS_ZIP>
            <ADDRESS_VAT_NUMBER></ADDRESS_VAT_NUMBER>
            <!-- DIČ -->
            <ADDRESS_TAX_NUMBER></ADDRESS_TAX_NUMBER>
            <!-- Daňové číslo -->
            <ADDRESS_PHONE>+420 123 456 789</ADDRESS_PHONE>
        </SHIPPING>
        
        <!-- Fakturační adresa -->
        <BILLING>
            <ADDRESS_STATE>CZ</ADDRESS_STATE>
            <ADDRESS_FIRST_NAME>Jan</ADDRESS_FIRST_NAME>
            <ADDRESS_LAST_NAME>Novák</ADDRESS_LAST_NAME>
            <ADDRESS_COMPANY>Firma s.r.o.</ADDRESS_COMPANY>
            <ADDRESS_COMPANY_NUMBER>12345678</ADDRESS_COMPANY_NUMBER>
            <ADDRESS_COUNTY></ADDRESS_COUNTY>
            <ADDRESS_STREET>Firemní 45</ADDRESS_STREET>
            <ADDRESS_STREET2></ADDRESS_STREET2>
            <ADDRESS_STREET3></ADDRESS_STREET3>
            <ADDRESS_CITY>Praha</ADDRESS_CITY>
            <ADDRESS_ZIP>11000</ADDRESS_ZIP>
            <ADDRESS_VAT_NUMBER>CZ12345678</ADDRESS_VAT_NUMBER>
            <ADDRESS_TAX_NUMBER>CZ12345678</ADDRESS_TAX_NUMBER>
            <ADDRESS_PHONE>+420 123 456 789</ADDRESS_PHONE>
        </BILLING>
    </ADDRESSES>
    
    <!-- Položky objednávky -->
    <ITEMS>
        <!-- Položka produktu -->
        <ITEM>
            <ITEM_TYPE>product</ITEM_TYPE>
            <!-- Možné hodnoty: product, shipping, payment, discount -->
            
            <NAME>Produkt XY - Varianta S</NAME>
            <QUANTITY>2</QUANTITY>
            <QUANTITYUNIT>ks</QUANTITYUNIT>
            <!-- Měrná jednotka (ks, m, kg, atd.) -->
            <SKU>PROD-001-S</SKU>
            <!-- SKU kód produktu -->
            <VARIANT_ID>789</VARIANT_ID>
            <!-- ID varianty v databázi -->
            <WEIGHT>1.5</WEIGHT>
            <!-- Hmotnost položky v kg -->
            
            <VAT>21.00</VAT>
            <!-- Sazba DPH v % -->
            
            <!-- Ceny za JEDNOTKU (ne celkem!) v měně objednávky -->
            <PRICE_CURRENCY_VAT>605.00</PRICE_CURRENCY_VAT>
            <PRICE_CURRENCY_NO_VAT>500.00</PRICE_CURRENCY_NO_VAT>
            
            <!-- Ceny v základní měně e-shopu (pokud je jiná než měna objednávky) -->
            <PRICE_BASIC_CURRENCY_VAT>605.00</PRICE_BASIC_CURRENCY_VAT>
            <PRICE_BASIC_CURRENCY_NO_VAT>500.00</PRICE_BASIC_CURRENCY_NO_VAT>
            
            <!-- Nákupní ceny (pro výpočet marže) -->
            <PRICE_PURCHASE_CURRENCY_VAT>363.00</PRICE_PURCHASE_CURRENCY_VAT>
            <PRICE_PURCHASE_CURRENCY_NO_VAT>300.00</PRICE_PURCHASE_CURRENCY_NO_VAT>
            
            <AVAILABILITY>Skladem</AVAILABILITY>
            <!-- Název dostupnosti produktu -->
        </ITEM>
        
        <!-- Položka dopravy -->
        <ITEM>
            <ITEM_TYPE>shipping</ITEM_TYPE>
            <NAME>Doprava - PPL</NAME>
            <QUANTITY>1</QUANTITY>
            <QUANTITYUNIT>ks</QUANTITYUNIT>
            <SKU></SKU>
            <VARIANT_ID></VARIANT_ID>
            <WEIGHT>0</WEIGHT>
            <VAT>21.00</VAT>
            <PRICE_CURRENCY_VAT>181.50</PRICE_CURRENCY_VAT>
            <PRICE_CURRENCY_NO_VAT>150.00</PRICE_CURRENCY_NO_VAT>
            <PRICE_BASIC_CURRENCY_VAT>181.50</PRICE_BASIC_CURRENCY_VAT>
            <PRICE_BASIC_CURRENCY_NO_VAT>150.00</PRICE_BASIC_CURRENCY_NO_VAT>
            <PRICE_PURCHASE_CURRENCY_VAT>0</PRICE_PURCHASE_CURRENCY_VAT>
            <PRICE_PURCHASE_CURRENCY_NO_VAT>0</PRICE_PURCHASE_CURRENCY_NO_VAT>
            <AVAILABILITY></AVAILABILITY>
        </ITEM>
        
        <!-- Položka platby -->
        <ITEM>
            <ITEM_TYPE>payment</ITEM_TYPE>
            <NAME>Platba kartou</NAME>
            <QUANTITY>1</QUANTITY>
            <QUANTITYUNIT>ks</QUANTITYUNIT>
            <SKU></SKU>
            <VARIANT_ID></VARIANT_ID>
            <WEIGHT>0</WEIGHT>
            <VAT>21.00</VAT>
            <PRICE_CURRENCY_VAT>24.20</PRICE_CURRENCY_VAT>
            <PRICE_CURRENCY_NO_VAT>20.00</PRICE_CURRENCY_NO_VAT>
            <PRICE_BASIC_CURRENCY_VAT>24.20</PRICE_BASIC_CURRENCY_VAT>
            <PRICE_BASIC_CURRENCY_NO_VAT>20.00</PRICE_BASIC_CURRENCY_NO_VAT>
            <PRICE_PURCHASE_CURRENCY_VAT>0</PRICE_PURCHASE_CURRENCY_VAT>
            <PRICE_PURCHASE_CURRENCY_NO_VAT>0</PRICE_PURCHASE_CURRENCY_NO_VAT>
            <AVAILABILITY></AVAILABILITY>
        </ITEM>
        
        <!-- Položka slevy -->
        <ITEM>
            <ITEM_TYPE>discount</ITEM_TYPE>
            <NAME>Slevový kód: BLACKFRIDAY</NAME>
            <QUANTITY>1</QUANTITY>
            <QUANTITYUNIT>ks</QUANTITYUNIT>
            <SKU></SKU>
            <VARIANT_ID></VARIANT_ID>
            <WEIGHT>0</WEIGHT>
            <VAT>0</VAT>
            <PRICE_CURRENCY_VAT>-121.00</PRICE_CURRENCY_VAT>
            <!-- Záporná hodnota = sleva -->
            <PRICE_CURRENCY_NO_VAT>-100.00</PRICE_CURRENCY_NO_VAT>
            <PRICE_BASIC_CURRENCY_VAT>-121.00</PRICE_BASIC_CURRENCY_VAT>
            <PRICE_BASIC_CURRENCY_NO_VAT>-100.00</PRICE_BASIC_CURRENCY_NO_VAT>
            <PRICE_PURCHASE_CURRENCY_VAT>0</PRICE_PURCHASE_CURRENCY_VAT>
            <PRICE_PURCHASE_CURRENCY_NO_VAT>0</PRICE_PURCHASE_CURRENCY_NO_VAT>
            <AVAILABILITY></AVAILABILITY>
        </ITEM>
    </ITEMS>
</ORDER>
```

Důležité poznámky:

1. Všechny elementy jsou v UPPERCASE
2. Ceny v položkách jsou za JEDNOTKU, ne celkové (celkovou cenu získáte: `PRICE_* × QUANTITY`)
3. `PRICE_BASIC_CURRENCY_*` - ceny před slevou
4. `PRICE_PURCHASE_CURRENCY_*` - nákupní ceny pro výpočet marže
5. `WEIGHT` - hmotnost položky v kilogramech (kg)
6. `ITEM_TYPE` - explicitně uveden typ položky

### Typy položek (ITEM\_TYPE)

| Typ        | Popis              | Účel                           |
| ---------- | ------------------ | ------------------------------ |
| `product`  | Produkt z katalogu | Standardní produkty, varianty  |
| `shipping` | Doprava            | Poplatek za dopravu            |
| `payment`  | Platební metoda    | Poplatek za platbu             |
| `discount` | Sleva              | Slevové kupóny, manuální slevy |

### Stavy zaplacení (PAID)

| Hodnota | Význam      |
| ------- | ----------- |
| `0`     | Nezaplaceno |
| `1`     | Zaplaceno   |

### Stavy archivace (ARCHIVED)

| Hodnota | Význam                 |
| ------- | ---------------------- |
| `0`     | Aktivní objednávka     |
| `1`     | Archivovaná objednávka |

### Zdroje objednávek (ORDER\_SOURCE)

| Hodnota  | Popis                             |
| -------- | --------------------------------- |
| `web`    | Objednávka z webu                 |
| `api`    | Objednávka přes API               |
| `import` | Import z externího systému        |
| `manual` | Manuálně vytvořená v administraci |
