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 version="1.0" encoding="UTF-8" ?>
<ORDERS>
<ORDER>
<!-- Data objednávky -->
</ORDER>
<ORDER>
<!-- Další objednávka -->
</ORDER>
</ORDERS>Detailní struktura objednávky
<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>[email protected]</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:
Všechny elementy jsou v UPPERCASE
Ceny v položkách jsou za JEDNOTKU, ne celkové (celkovou cenu získáte:
PRICE_* × QUANTITY)PRICE_BASIC_CURRENCY_*- ceny před slevouPRICE_PURCHASE_CURRENCY_*- nákupní ceny pro výpočet maržeWEIGHT- hmotnost položky v kilogramech (kg)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
Last updated
Was this helpful?