Export vypočtených prodejních z Cenového automatu do E-shop/IS.
Kromě XML feedu (popsaného v tomto článku) lze export realizovat ještě pomocí API e-shopu nebo našeho Univerzální PHP skriptu. Pro více informací o těchto možnostech nás prosím kontaktujte.

XML feed

E-shop/IS si v pravidelných intervalech stahuje tento exportní feed a aktualizuje podle něj prodejní ceny produktů. Doporučená frekvence stahování je 1h.

Specifikace exportního XML feedu

SHOP
‍Kořenový element, v souboru je obsažen pouze jednou.

‍SHOPITEM
‍Element obsahuje informace o konkrétním produktu, v souboru je obsažen vícekrát.

‍ITEM_ID
‍Jednoznačný primární identifikátor produktu, který využíváte pro jeho identifikaci v Heureka produktovém feedu (v tagu ITEM_ID).
Formát: text

‍PRICE_VAT
‍Prodejní cena produktu s DPH.
Formát: číslo ve float formátu s desetinnou tečkou

‍PRODUCTNO
‍Produktové číslo (volitelný tag).
Můžete použít k alternativní identifikaci produktů místo ITEM_ID.
Formát: text

‍EAN
‍EAN kód (volitelný tag).
Můžete použít k alternativní identifikaci produktů místo ITEM_ID.
Formát: ean

Příklad exportního XML feedu

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <ITEM_ID>1</ITEM_ID>
    <PRICE_VAT>15990</PRICE_VAT>
  </SHOPITEM>
  <SHOPITEM>
    <ITEM_ID>12</ITEM_ID>
    <PRICE_VAT>12.90</PRICE_VAT>
  </SHOPITEM>
</SHOP>

Url adresa exportního XML feedu

Url adresu feedu pro váš e-shop najdete v aplikaci v Konfigurace - Export prodejních cen.

‍

Export jen produktů přeceněných po zadaném čase

Exportní soubor standardně obsahuje všechny produkty, které mají vypočtenou prodejní cenu. Pro snížení zátěže vašich serverů je (od 12. 7. 2023) možno exportovat jen produkty, u kterých došlo ke změně prodejních cen po zadaném čase. Můžete tak vždy importovat je změny ceny provedené po posledním exportu. Požadovaný čas se zadává přidáním parametru "from" do url aresy feedu. Např. https://api.cenovyautomat.cz/v1/shop/123456/app/123456/export/prices/AwSqTrXGgiSd250CFa1WDwGlM99ZSpGx/xml?from=2023-07-12%2015%3A30%3A00.

Čas se zadává ve formátu "YYYY-MM-DD hh:mm:ss" (odpovídá formátu MySQL DATETIME), tedy např. "2023-07-12 15:30:00" a následným použitím urlencode, kdy výsledný string je "2023-07-12%2015%3A30%3A00".

Při použití parametru "from" obsahuje feed také produkty, které po zadaném čase přestaly být přeceňované (nemají už vypočtenou prodejní cenu). Tyto produkty mají element PRICE_VAT prázný.
Příklad exportního XML feedu s produktem bez vypočtené ceny:

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <ITEM_ID>1</ITEM_ID>
    <PRICE_VAT>15990</PRICE_VAT>
  </SHOPITEM>
  <SHOPITEM>
    <ITEM_ID>12</ITEM_ID>
    <PRICE_VAT></PRICE_VAT>
  </SHOPITEM>
</SHOP>

‍

‍

Identifikace produktů pomocí PRODUCTNO, EAN nebo jiného identifikátoru

Pokud nemůžete pro identifikaci produktů použít ITEM_ID (uváděné v produktovém feedu do Heureky), například při napojení na informační systém, který ITEM_ID nezná, lze pro identifikaci produktů využít jejich produktová čísla, EAN kódy nebo jiné identifikátory. Přidání těchto identifikátorů do exportního feedu lze nastavit v aplikaci v Konfigurace - Export prodejních cen.

Příklad exportního XML feedu s použitím EAN pro identifikaci produktů:

<?xml version="1.0" encoding="utf-8"?>
<SHOP>
  <SHOPITEM>
    <ITEM_ID>1</ITEM_ID>
    <PRICE_VAT>15990</PRICE_VAT>
    <ean>190198783035</ean>
  </SHOPITEM>
  <SHOPITEM>
    <ITEM_ID>12</ITEM_ID>
    <PRICE_VAT>12.90</PRICE_VAT>
    <ean>190199113329</ean>
  </SHOPITEM>
</SHOP>