Appearance

Import dat - XML feed ​

Importní XML feed slouží jako primární zdroj produktů pro jejich import do Cenového automatu. Využívá se u e-shop systémů, ze kterých nelze tato data načítat s pomocí jejich API. Struktura a názvy tagů jsou velmi podobné s Heureka produktovým feedem.

aktualizováno 2.4.2026

Jaká data lze importovat ​

Do Cenového automatu lze k produktům importovat celou řadu informací, které je pak možno využít při zadávání přeceňovacích pravidel:

  • Identifikátory produktů
  • Jména produktů
  • Výrobce
  • Nákupní, doporučené, běžné a akční ceny
  • Minimální a maximální povolené ceny
  • Stavy skladu
  • Další doplňkové informace

Identifikace produktů ​

Produkty se při importu identifikují pomocí elementu PRODUCT_ID (Id produktu). Jde o jednoznačný identifikátor produktů v e-shopu. Ideálně jej také využíváte pro identifikaci produktů ve zbožových srovnávačích (vyjma Idealo).

Pokud pro identifikaci produktů ve zbožových srovnávačích (vyjma Idealo) používáte jiný identifikátor, uveďte jej do volitelného elementu MERCHANT_PRODUCT_ID.

INFO

Kvůli udržení kompatibility se staší specifikací tohoto feedu (před 2.4.2026) je možno pro identifikaci produktů uvést Id produktu také v elementu SHOP_PRODUCT_CODE nebo ITEM_ID. Pokud je ve feedu uvedeno více těchto elementů, použijí se dle této priority: PRODUCT_ID, SHOP_PRODUCT_CODE, ITEM_ID.

Popis XML elementů ​

SHOP ​

Kořenový element, v souboru je obsažen pouze jednou.
Element může mít volitelně uvedeny tyto atributy:

SHOPITEM ​

Element obsahuje informace o konkrétním produktu, v souboru je obsažen tolikrát, kolik máte produktů.

PRODUCT_ID ​

Jednoznačný primární identifikátor produktu v e-shopu.
Formát: text

MERCHANT_PRODUCT_ID ​

Jednoznačný identifikátor produktu ve zbožových srovnávačích (vyjma Idealo).
Pokud tento element není ve feedu uvedený, použije se pro identifikaci produktu ve zbožových srovnávačích identifikátor uvedený v elementu PRODUCT_ID. Tento element tedy ve feedu uvádějte jen v případě, když je identifikátor pro e-shop a zbožové srovnávače rozdílný.
Formát: text

PRODUCTNO ​

Produktové číslo (většinou identifikátor definovaný výrobcem).
Formát: text

EAN ​

EAN kód.
Formát: ean

PRODUCTNAME ​

Název produktu, jak jej odesíláte do Heureky.
Formát: text

SHOP_PRODUCT_NAME ​

Název produktu v e-shopu.
Formát: text

MANUFACTURER ​

Název výrobce.
Formát: text

SUPPLIER ​

Název dodavatele.
Formát: text

URL ​

Url produktu v e-shopu.
Formát: url

IMGURL ​

Url obrázku produktu.
Formát: url

DELIVERY_DATE ​

Dostupnost produktu.
Formát: dle Heureka specifikace

STOCK_QTY ​

Stav skladu, počet kusů skladem.
Formát: celé číslo

WEIGHT ​

Hmotnost produktu v kg.
Formát: číslo [1]

ACTIVE_IN_SHOP ​

Indikátor, jestli je produkt v e-shopu aktivní (není skrytý, deaktivovaný, smazaný, apod.).
Formát: 0|1

SHOP_DEFAULT_CATEGORY_UID ​

Jednoznačný identifikátor výchozí kategorie e-shopu, kde je produkt primárně zařazený. [2]
Formát: text

SHOP_CATEGORY_UID ​

Jednoznačný identifikátor kategorie e-shopu, kde je produkt zařazený.
Element je ve feedu obsažen tolikrát, v kolika kategorích je produkt zařazený. [2]
Formát: text

VAT ​

Sazba DPH.
Formát: s desetinou tečkou (0.21), jako celé číslo (21) nebo procenta (21%) [1]

CURRENT_PRICE ​

Aktuální cena v e-shopu.
Formát: cena [1]

MOC_PRICE ​

Doporučná koncová cena.
Formát: cena [1]

COMMON_PRICE ​

Běžná cena.
Formát: cena [1]

ACTION_PRICE ​

Akční cena.
Formát: cena [1]

PURCHASE_PRICE ​

Nákupní cena.
Formát: cena [1]

SALES_VOUCHER_VALUE ​

Hodnota slevového kupónu.
Hodnota uvedena včetně DPH.
Formát: číselný [3]

MIN_ALLOWED_PRICE ​

Minimální povolená cena.
Formát: cena [1]

MAX_ALLOWED_PRICE ​

Maximální povolená cena.
Formát: cena [1]

LABEL ​

Element obsahující informace o příznaku produktu.
Element je ve feedu obsažen tolikrát, kolik má produkt příznaků.

LABEL_NAME ​

Jméno příznaku.
Formát: text

LABEL_DATE_FROM ​

Datum, od kdy je příznak platný.
Volitelné. Pokud není uvedeno, je příznak aktuálně platný.
Formát: datum (YYYY-MM-DD)

LABEL_DATE_TO ​

Datum, od kdy je příznak platný.
Volitelné. Pokud není uvedeno, je příznak aktuálně platný.
Formát: datum (YYYY-MM-DD)

CUSTOM_LABEL_0, CUSTOM_LABEL_1, CUSTOM_LABEL_2...CUSTOM_LABEL_9 ​

Jména příznaků produktu.
Alternativní formát uvádění příznaků. Tento formát využívá zboží.cz nebo Google Merchant.text

CUSTOM_NUMERIC_1, CUSTOM_NUMERIC_2...CUSTOM_NUMERIC_5 NOVINKA ​

Uživatelská numerická pole. Formát: číslo [1]

CUSTOM_TEXT_1, CUSTOM_TEXT_2...CUSTOM_TEXT_5 NOVINKA ​

Uživatelská textová pole. Formát: číslo [1]

[1] Formát cena | číslo ​

Ceny a čísla uvádějte ve float formátu s desetinou tečkou a bez mezer, např. 1234.56. Podporována jsou čísla až s 10 číslicemi, přičemž nejvýše 2 z nich mohou být za desetinnou tečkou. Ceny uvádějte standardně s DPH, ale lze i bez DPH, viz sekce Ceny včetně nebo bez DPH.

[2] Zařazení v e-shop kategorii ​

Pokud chcete v aplikaci v podmínkách pravidel používat výběr produktů dle jejich zařazení v e-shop kategorii, je třeba do aplikace importovat seznam všech kategorií. Více v Import e-shop kategorií - XML feed.

[3] Flexibilní číselný formát ​

Flexibilní formát pro zadání čísel, cen a procent. Lze použít tyto varianty:

  • 1234.56 (s desetinou tečkou)
  • 1234,56 (s desetinou čárkou)
  • 1 234,56 (s mezerou jako oddělovačem tisíců)
  • 1234.56 Kč (s označním měny, např. Kč, CZK, EUR, €)
  • 2.5% (zadání procentuální hodnoty)
  • 2.5 % (zadání procentuální hodnoty, s mezerou)

Příklad importního XML feedu ​

xml
<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <PRODUCT_ID>K-KU2M07F</PRODUCT_ID>
    <PRODUCTNO>KU2M07F-001</PRODUCTNO>
    <EAN>8592220013714</EAN>
    <SHOP_PRODUCT_NAME><![CDATA[Apple iPhone 12 Pro (128GB, Gold)]]></SHOP_PRODUCT_NAME>
    <MANUFACTURER><![CDATA[Apple]]></MANUFACTURER>
    <SUPPLIER><![CDATA[Apcom Czech]]></SUPPLIER>
    <URL><![CDATA[https://www.shop.cz/mobilni-telefony/apple/iphone-12-pro]]></URL>
    <IMGURL><![CDATA[https://images.shop.cz/apple-iphone-12-pro.jpg]]></IMGURL>
    <DELIVERY_DATE>0</DELIVERY_DATE>
    <STOCK_QTY>55</STOCK_QTY>
    <WEIGHT>0.55</WEIGHT>
    <ACTIVE_IN_SHOP>1</ACTIVE_IN_SHOP>
    <SHOP_CATEGORY_UID>358</SHOP_CATEGORY_UID>
    <SHOP_CATEGORY_UID>132</SHOP_CATEGORY_UID>
    <SHOP_DEFAULT_CATEGORY_UID>358</SHOP_DEFAULT_CATEGORY_UID>
    <VAT>21</VAT>
    <CURRENT_PRICE>26660.00</CURRENT_PRICE>
    <MOC_PRICE>29990.00</MOC_PRICE>
    <COMMON_PRICE>27990.00</COMMON_PRICE>
    <PURCHASE_PRICE>24575.94</PURCHASE_PRICE>
    <SALES_VOUCHER_VALUE>1000</SALES_VOUCHER_VALUE>
    <MIN_ALLOWED_PRICE>25444.78</MIN_ALLOWED_PRICE>
    <MAX_ALLOWED_PRICE>29990.00</MAX_ALLOWED_PRICE>
    <LABEL>
       <LABEL_NAME><![CDATA[Novinka]]></LABEL_NAME>
       <LABEL_FROM>2020-04-15</LABEL_FROM>
       <LABEL_TO>2020-04-30</LABEL_TO>
     </LABEL>
     <LABEL>
         <LABEL_NAME><![CDATA[Akce]]></LABEL_NAME>
     </LABEL>
     <CUSTOM_NUMERIC_1>123.45</CUSTOM_NUMERIC_1>
     <CUSTOM_TEXT_1>V letáku do 15.3.</CUSTOM_TEXT_1>
  </SHOPITEM>
</SHOP>

Ceny včetně nebo bez DPH ​

Standardně se očekává zadání všech cen včetně DPH. Volitelně je možno zadat ceny i bez DPH.

Použití cen bez DPH se signalizuje atributem pricesIncludeVat="0" v elementu SHOPITEM. U každého produktu tak můžete specifikovat, jestli jsou ceny uvedeny bez nebo včetně DPH. Při použití cen bez DPH musí mít produkt uvedenou sazbu DPH (tag VAT), jinak dojde k chybě ceny se nenaimportují.

Pokud je atribut pricesIncludeVat=“1" nebo není uvedený, očekávají se ceny včetně DPH.

Příklad importního XML feedu s cenami bez DPH

xml
<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM pricesIncludeVat="0">
    <PRODUCT_ID>K-KU2M07F</PRODUCT_ID>
    <PURCHASE_PRICE>20310.69421</PURCHASE_PRICE>
    <VAT>0.21</VAT>
    ...
  </SHOPITEM>

Použití šifrování u nákupních cen ​

Pro zajištění maximální bezpečnosti dat je možno v importním feedu šifrovat nákupní ceny produktů, aby tak nemohlo dojít k nežádoucímu úniku těchto citlivých informací.

Použití šifrování se signalizuje atributem encryption="1" v kořenovém elementu SHOP.

Pro šifrování je třeba použít příkaz openssl_encrypt se šifrovací metodou aes-128-cbc, šifrovacím klíčem zadaným v konfiguraci API a inicializačním vektorem iv, který je poté uvedený jako atribut kořenového elementu SHOP. Inicializační vektor iv se používá stejný pro zašifrování všech nákupních cen ve feedu. Pro zvýšení bezpečnosti se ale doporučuje před každým vytvářením feedu vygenerovat nový náhodný inicializační vektor.

V PHP se zašifrování nákupní ceny provede tímto kódem:

php
$zasifrovane = openssl_encrypt($cena, 'aes-128-cbc', $cryptoKey, 0, $iv);

Cenový automat provádí dešifrování tímto kódem:

php
$cena = openssl_decrypt($zasifrovane, 'aes-128-cbc', $cryptoKey, 0, $iv);

Příklad importního XML feedu se šifrováním nákupních cen:

xml
<?xml version="1.0" encoding="utf-8"?>
<SHOP encryption="1" iv="1234567890123456">
  <SHOPITEM>
    <PRODUCT_ID>K-KU2M07F</PRODUCT_ID>
    <PURCHASE_PRICE>qIGYBlxEdDqEj5kskOX80g==</PURCHASE_PRICE>
    ...
  </SHOPITEM>
</SHOP>

Slučování hodnot u sekundárních importů ​

O produktového atributu, Příznaky produktu (LABEL) dochází při sekundárním importu automaticky ke sloučení s hodnotami načtenými z primárního importu. Pomocí sekundárního importu tak můžete k produktům dohrát pomocí tohoto feedu další příznaky (například z informačního systému), aniž by došlo k přepsání již existujících příznaků (načtených například ze Shoptetu).

Copyright © 2025 Cenový automat s.r.o.