Simple Retino XML feed

Základní struktura feedu

Každý XML feed musí začínat standardní hlavičkou a obsahovat kořenový element ORDERS. Feed používá UTF-8 kódování:

<?xml version="1.0" encoding="UTF-8"?>
<ORDERS>
    <ORDER>
        <!-- data objednávky -->
    </ORDER>
</ORDERS>

Povinné elementy

Pro základní tracking zásilek potřebujete v každé objednávce tyto elementy:

Element PACKAGE_NUMBER je volitelný, ale pro sledování zásilek doporučujeme jeho vyplnění.

Struktura elementu CUSTOMER

• EMAIL - E-mailová adresa zákazníka (povinné)
• BILLING_ADDRESS - Fakturační adresa se všemi náležitostmi (povinné)
  • NAME - Jméno zákazníka
  • STREET - Ulice
  • CITY - Město
  • ZIP - PSČ
  • COUNTRY - Země
• SHIPPING_ADDRESS - Doručovací adresa se stejnou strukturou jako fakturační (povinné)

Struktura elementu TOTAL_PRICE

• WITH_VAT - Cena s DPH (povinné)
• WITHOUT_VAT - Cena bez DPH (povinné)

Příklad minimálního feedu

Ukázka kompletního feedu s jednou objednávkou:

<?xml version="1.0" encoding="UTF-8"?>
<ORDERS>
    <ORDER>
        <ORDER_ID>12345</ORDER_ID>
        <CODE>2024001</CODE>
        <DATE>2024-02-20 14:30:00</DATE>
        <CURRENCY>
            <CODE>CZK</CODE>
        </CURRENCY>
        <PACKAGE_NUMBER>DR1234567890</PACKAGE_NUMBER>
        <CUSTOMER>
            <EMAIL>zakaznik@email.cz</EMAIL>
            <BILLING_ADDRESS>
                <NAME>Jan Novák</NAME>
                <STREET>Hlavní 123</STREET>
                <CITY>Praha</CITY>
                <ZIP>110 00</ZIP>
                <COUNTRY>CZ</COUNTRY>
            </BILLING_ADDRESS>
            <SHIPPING_ADDRESS>
                <NAME>Jan Novák</NAME>
                <STREET>Hlavní 123</STREET>
                <CITY>Praha</CITY>
                <ZIP>110 00</ZIP>
                <COUNTRY>CZ</COUNTRY>
            </SHIPPING_ADDRESS>
        </CUSTOMER>
        <TOTAL_PRICE>
            <WITH_VAT>1499.00</WITH_VAT>
            <WITHOUT_VAT>1238.84</WITHOUT_VAT>
        </TOTAL_PRICE>
        <ORDER_ITEMS>
            <ITEM>
                <TYPE>product</TYPE>
                <NAME>Testovací produkt</NAME>
                <AMOUNT>1</AMOUNT>
                <CODE>TEST01</CODE>
                <UNIT_PRICE>
                    <WITH_VAT>1499.00</WITH_VAT>
                    <WITHOUT_VAT>1238.84</WITHOUT_VAT>
                    <VAT>260.16</VAT>
                    <VAT_RATE>21</VAT_RATE>
                </UNIT_PRICE>
                <TOTAL_PRICE>
                    <WITH_VAT>1499.00</WITH_VAT>
                    <WITHOUT_VAT>1238.84</WITHOUT_VAT>
                    <VAT>260.16</VAT>
                    <VAT_RATE>21</VAT_RATE>
                </TOTAL_PRICE>
            </ITEM>
        </ORDER_ITEMS>
    </ORDER>
</ORDERS>

Implementace a nastavení

Základní doporučení

• Feed by měl obsahovat objednávky za posledních 7 dní
• Aktualizujte feed alespoň každých 6 hodin
• Nastavte timeout odpovědi serveru na maximálně 60 sekund
• Používejte HTTPS pro zabezpečený přenos

Zabezpečení feedu

Pro ochranu dat doporučujeme použít jeden z těchto přístupů:

• HTTP Basic autentizace (preferované řešení)
• Náhodně generovaná URL feedu (např. www.vaseshop.cz/feed/9b9972387feb11eabc550242ac130003.xml)

Související články

• Objednávková integrace