Objednávkový feed poskytujeme partnerům jako možnost získávání dat o objednávkách. Je naprosto nezávislý na typu nahrávání produktů, můžete ho tedy využít při všech typech napojení.
Důležité body:
- Objednávkový feed obsahuje pouze objednávky ve stavu OPEN. Jakmile změníte stav z OPEN, tak daná objednávka z feedu zmizí.
- Odkaz k objednávkovému feedu naleznete v MALL Partner portálu.
Pro typ napojení MALL XML feed je to v sekci Feedy.

U typu napojení Heureka XML feed odkaz naleznete v záložce Heureka Feed.

- Jestli využíváte jinou formu napojení než XML feed a Heureka feed, odkaz na objednávkový feed si můžete sestavit doplněním client_id (API klíč), které najdete v záložce Firemní profil v sekci Informace za následující URL adresu: https://partners.mallgroup.com/orders.xml?client_id=.
- Objednávkový feed lze využívat už ve fázi testingu pro testování objednávek. Naleznete zde své testovací objednávky ve stavu open.
- Struktura feedu popsaného níže platí za předpokladu, že do objednávek není zasahováno přes API
- Červeně označené elementy jsou pro správné napojení irelevantní, slouží pouze pro interní potřeby MALL.
Popis elementů objednávkového feedu
ORDERS | Kořenový element – označení začátku feedu pro objednávky |
ORDER | Kořenový element – označení začátku jedné objednávky |
ID | MALL číslo objednávky – primární identifikátor |
PURCHASE_ID | Interní MALL číslo objednávky. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
EXTERNAL_ORDER_ID | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
CURRENCY | Měna země, ve které byla objednávka vytvořena |
DELIVERY_PRICE | Poplatek za doručení – cena pouze za dopravu bez poplatku za dobírku |
COD_PRICE | Poplatek za dobírku |
DISCOUNT | Informace o slevě – je-li sleva v tomto elementu je poskytnuta pouze MALL, více informací naleznete zde |
PAYMENT_TYPE | Informace o tom zda je objednávka zaplacena předem nebo na dobírku je uvedena v elementu COD. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
DELIVERY_METHOD | ID zvolené dopravy v objednávce. Vaše dopravce naleznete zde |
DELIVERY_METHOD_ID | U dopravy na výdejní místo se jedná o ID zákazníkem zvolené pobočky. U dopravy na adresu toto pole ignorujte. Identifikace dopravy dle kódu můžete provést pomocí článku Přehled všech dopravců nebo v MALL Partner portálu. |
TRACKING_NUMBER | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
TRACKING_URL | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
SHIP_DATE | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
DELIVERY_DATE | Předpokládané datum doručení |
DELIVERED_AT | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
COD | K zaplacení – vždy zahrnuje celkovou částku, kterou musí zákazník zaplatit, a to včetně dopravy a doběrečného. V případě hodnoty 0 se jedná o platbu předem, když je hodnota větší než 0, jedná se o platbu na dobírku. |
ADDRESS | Nadřazený atribut, který obsahuje koncové atributy týkající se adresy zákazníka |
CUSTOMER_ID | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
NAME | Celé jméno zákazníka |
COMPANY | Název společnosti zákazníka – volitelné |
PHONE | Telefonní číslo zákazníka |
E-mailová adresa zákazníka | |
STREET | Adresa zákazníka: ulice + č. p. |
CITY | Adresa zákazníka: město |
ZIP | Adresa zákazníka: PSČ |
COUNTRY | Adresa zákazníka: země |
CONFIRMED | Informace, zda je objednávka potvrzená. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy nabývat hodnotu false. |
STATUS | Stav objednávky, ve které se objednávka nachází |
ITEMS | Nadřazený element – úvodní element pro jeden objednaný druh produktu, pokud je v objednávce více rozdílných produktů, vyskytuje se vícenásobně |
ID | Partnerské ID objednaného produktu/varianty |
ARTICLE_ID | MALL ID objednaného produktu/varianty |
QUANTITY | Počet objednaných kusů daného produktu |
PRICE | Prodejní cena objednaného produktu včetně DPH za jeden kus v době vzniku objednávky |
VAT | Sazba DPH objednaného produktu v době vzniku objednávky |
COMMISSION | Dohodnutá částka objednaného produktu v době vzniku objednávky |
TITLE | Název objednaného produktu |
SERIAL_NUMBERS | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
MDP | true = objednávka je expedována službou MALL delivery, false = není expedována službou MALL Delivery |
BRANCH_ID | Kód aktuální pobočky/výdejního místa, pokud je objednávka doručována na pickup point |
BRANCHES | Úvodní element pro pobočku |
SECONDARY_BRANCH_ID | Kód sekundární aktuální pobočky/výdejního místa, pokud je objednávka doručována na pickup point |
OVERRIDDEN | Element nabývá hodnot false v případě, že je vyplněný secondary branch. V případe, že secondary branch není vyplněn nabývá hodnotu true. |
LAST_CHANGE | Datum poslední aktualizace secondary branch |
FIRST_DELIVERY_ATTEMPT | Datum, kdy byl učiněn první pokus o doručení zákazníkovi. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
READY_TO_RETURN | Nabývá true/false hodnot. Pokud je true, MD objednávka je připravena k vrácení. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy nabývat false. |
SHIPPED | Poslední datum změny objednávky na stav SHIPPED. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
OPEN | Poslední datum změny objednávky na stav OPEN |
BLOCKED | Poslední datum změny objednávky na stav BLOCKED |
LOST | Poslední datum změny objednávky na stav LOST. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
RETURNED | Poslední datum změny objednávky na stav RETURNED. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
CANCELLED | Poslední datum změny objednávky na stav CANCELLED. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
DELIVERED | Poslední datum změny objednávky na stav DELIVERED. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
SHIPPING | Poslední datum změny objednávky na stav SHIPPING. Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element vždy prázdný. |
ULOZENKA_STATUS_HISTORY | Vzhledem ke konstrukci MALL Feedu (pouze OPEN objednávky) bude element pro vás irelevantní. |
V případě, že budete mít nějaké další dotazy, můžete se na nás obrátit skrze Centrum nápovědy.