Specifikace podkladů pro import dat na
Import letáků
verze: 1.00
<p>
Pro ideální prezentaci na Kupi.cz a její automatizaci slouží takzvaný <strong>feed importu letáků předávající data od partnera směrem na Kupi.cz</strong>.
Obsahem základního feedu je aktuální nabídka letáků či katalogů partnera, které si přeje komunikovat na Kupi.cz.
</p>
<p>
<strong>Prezentovaný leták je možné rozšířit o přímé prokliky</strong> na internetové stránky partnera doplněním odkazů na detaily produktů.
Přidáním odkazů na produkty do automatizovaných dat vznikne takzvaný klikací leták, do kterého si partner může generovat
vlastní analytické měřící kódy.
</p>
<p>
Základní feed letáků je možné provázat s <a href="/import/import-pobocek">feedem poboček</a> pro určení platnosti letáků pouze ve vybraných prodejnách
i s <a href="/import/import-akcniho-zbozi">feedem akčního zboží</a> za účelem provázání akčního zboží v letácích ("interní" image mapy).
</p>
<p>
Leták v grafické podobě je nutné poskytnout ve formátu PDF odkazem uvedeným ve feedu.
</p>
Popis atributů feedu:
LEAFLETS -
Povinná položka
| Typ hodnoty: | complex |
| Násobnost: | 1 |
| Popis: | Uvedení celého XML feedu (datového souboru obsahujícího všechny letáky) a jeho uzavření na konci souboru předávajícího informace. |
LEAFLET -
Povinná položka
| Typ hodnoty: | complex |
| Násobnost: | 1 až ∞ |
| Popis: | Uvedení a uzavření každého jednotlivého letáku v rámci jednoho datového souboru. |
LEAFLET_ID -
Povinná položka
| Typ hodnoty: | string |
| Násobnost: | 1 |
| Popis: | Unikátní identifikátor konkrétního daného letáku v rámci sítě prodejen klienta, který je definován stranou klienta. Musí zůstat vždy unikátní, protože ID náleží vždy jen jednomu konkrétnímu letáku. |
Ukázkové hodnoty:
<LEAFLET_ID>2015-0011</LEAFLET_ID>
<LEAFLET_ID>LET007</LEAFLET_ID>
<LEAFLET_ID>526</LEAFLET_ID>
NAME -
Povinná položka
| Typ hodnoty: | string |
| Násobnost: | 1 |
| Omezení: | Samostatný název letáku s maximem 25 znaků, název letáku by neměl obsahovat slova "leták" ani "název prodejce", které se generují ze systému automaticky. |
| Popis: | Jméno konkrétního letáku ve výstižné a stručné podobě přibližně odpovídající názvu letáku v jeho tištěné podobě s maximálním počtem 25 znaků. |
Ukázkové hodnoty:
<NAME>Akční leták Planeo</NAME>
START -
Povinná položka
| Typ hodnoty: | date |
| Násobnost: | 1 |
| Omezení: | formát RRRR-MM-DD |
| Popis: | Počáteční datum platnosti konkrétního letáku v datovém souboru ve tvaru RRRR-MM-DD. |
Ukázkové hodnoty:
<START>2015-08-01</START>
END -
Povinná položka
| Typ hodnoty: | date |
| Násobnost: | 1 |
| Omezení: | formát RRRR-MM-DD |
| Popis: | Konečné datum platnosti konkrétního letáku v datovém souboru ve tvaru RRRR-MM-DD. |
Ukázkové hodnoty:
<END>2015-08-28</END>
PUBLISH_DATE -
Povinná položka
| Typ hodnoty: | date |
| Násobnost: | 1 |
| Omezení: | datum ve formátu YYYY-MM-DD |
| Popis: | Datum, od kterého si klient přeje zobrazovat svůj leták na Kupi.cz. Jedná se o povinnou položku, dle které bude zahájena požadovaná komunikace letákových akcí. |
Ukázkové hodnoty:
<PUBLISH_DATE>2015-11-30</PUBLISH_DATE>
FILE -
Povinná položka
| Typ hodnoty: | string |
| Násobnost: | 1 |
| Popis: | URL adresa odkazu na PDF dokument letáku jehož data se v daném předávaném souboru dat nacházejí. |
Ukázkové hodnoty:
<FILE>http://www.domenapartnera.cz/115.pdf</FILE>
ESHOP_URL -
Nepovinná položka
| Typ hodnoty: | string |
| Násobnost: | 0 až 1 |
| Popis: | Adresa prokliku na stránky e-shopu partnera. Je možné dodávat s měřícími UTM parametry partnera. |
Ukázkové hodnoty:
<ESHOP_URL>http://vas-obchod.cz</ESHOP_URL>
NEXT -
Nepovinná položka
| Typ hodnoty: | date |
| Násobnost: | 0 až 1 |
| Omezení: | datum ve formátu RRRR-MM-DD |
| Popis: | Datum, od kterého vejde v platnost nový leták, následující po aktuálně prezentovaném. Zadávání ve formátu RRRR-MM-DD |
Ukázkové hodnoty:
<NEXT>2015-09-20</NEXT>
PAGES -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Uvádí a uzavírá stránkovaný obsah letáku v případě, že si klient přeje zohlednit stránkování. |
PAGE -
Povinná položka při zadání PAGES
| Typ hodnoty: | complex |
| Násobnost: | 1 až ∞ |
| Popis: | Uvádí a uzavírá konkrétní stránky letáku. |
PAGE_NUMBER -
Povinná položka při zadání PAGES
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Popis: | Udává hodnotu čísla strany letáku. Uvádí se nepárově pro každou jednotlivou stranu letáku. |
Ukázkové hodnoty:
<PAGE_NUMBER>5</PAGE_NUMBER>
WIDTH -
Povinná položka při zadání PAGES
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Popis: | Udává šířku letáku v pixelech. |
Ukázkové hodnoty:
<WIDTH>1000</WIDTH>
HEIGHT -
Povinná položka při zadání PAGES
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Popis: | Udává výšku jedné strany letáku v pixelech. |
Ukázkové hodnoty:
<HEIGHT>1800</HEIGHT>
MAPS -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Uvádí a uzavírá všechny mapy (grafické výseče) v rámci 1 stránky letáku. |
MAP -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 |
| Popis: | Mapa v rámci stránky letáku. Mapa je určená pozicí (souřadnicemi) levého horního rohu a její velikostí (výška a šířka). Obsahem mapy může být buďto odkaz na dodávané akční zboží (odkaz v rámci webu Kupi.cz) anebo odkaz na "externí" produkty na stránkách klienta. |
ITEM_ID -
Nepovinná položka
| Typ hodnoty: | string |
| Násobnost: | 0 až 1 |
| Popis: | Provázání s datovým souborem akčního zboží. Určení výskytu akce v letáku (včetně strany, případně i souřadnic pozice v rámci strany). |
Ukázkové hodnoty:
<ITEM_ID>SLEVA-6653</ITEM_ID>
<ITEM_ID>6658</ITEM_ID>
EXTERNAL_PRODUCT -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Uvádí a uzavírá informace o produktu s externím odkazem mířícím mimo web Kupi.cz. |
PRODUCT_NAME -
Povinná položka při zadání EXTERNAL_PRODUCT
| Typ hodnoty: | string |
| Násobnost: | 1 |
| Popis: | Originální název konkrétního produktu uvedeného v letáku. |
Ukázkové hodnoty:
<PRODUCT_NAME>LED40D2080 LED FULL HD TV</PRODUCT_NAME>
MANUFACTURER -
Nepovinná položka
| Typ hodnoty: | string |
| Násobnost: | 0 až 1 |
| Popis: | Označení výrobce daného produktu uvedeného v letáku. |
Ukázkové hodnoty:
<MANUFACTURER>Philips</MANUFACTURER>
URL -
Povinná položka při zadání EXTERNAL_PRODUCT
| Typ hodnoty: | string |
| Násobnost: | 1 |
| Popis: | Adresa prokliku na detail produktu na stránkách partnera. Je možné dodávat s měřícími UTM parametry partnera. URL odkaz je třeba uvádět v nezakódované podobě (dle specifikace RFC 3986). |
Ukázkové hodnoty:
<URL>http://vas-obchod.cz/talevize-led40d2080.html</URL>
IMGURL -
Povinná položka při zadání EXTERNAL_PRODUCT
| Typ hodnoty: | string |
| Násobnost: | 1 |
| Popis: | Odkaz na obrázek produktu ve formátu JPG, případně PNG. Pokud lze vybírat, vždy je vhodnější odkazovat na obrázek s bílým pozadím. URL odkaz je třeba uvádět v nezakódované podobě (dle specifikace RFC 3986). |
Ukázkové hodnoty:
<IMGURL>http://vas-obchod.cz/images/LED40D2080.jpg</IMGURL>
PRICE_VAT -
Nepovinná položka
| Typ hodnoty: | real |
| Násobnost: | 0 až 1 |
| Popis: | Aktuální cena produktu včetně DPH. Částka musí být uvedena v Kč. Musí obsahovat pouze číslo (bez udání měny). V případě desetinných míst použijte oddělovač ".". Číslo nesmí obsahovat mezery. |
Ukázkové hodnoty:
<PRICE_VAT>6999</PRICE_VAT>
PRICE_BEFORE -
Nepovinná položka
| Typ hodnoty: | real |
| Násobnost: | 0 až 1 |
| Popis: | Původní cena produktu před zlevněním. Částka musí být uvedena v Kč. Musí obsahovat pouze číslo (bez udání měny) V případě desetinných míst použijte oddělovač ".". Číslo nesmí obsahovat mezery. |
Ukázkové hodnoty:
<PRICE_BEFORE>3000</PRICE_BEFORE>
VAT -
Nepovinná položka
| Typ hodnoty: | int |
| Násobnost: | 0 až 1 |
| Popis: | Výše sazby DPH. Položka musí obsahovat pouze číslo bez znaku procent. |
Ukázkové hodnoty:
<VAT>21</VAT>
SALE -
Nepovinná položka
| Typ hodnoty: | int |
| Násobnost: | 0 až 1 |
| Popis: | Výše slevy v procentech. Obsahuje pouze celá čísla bez znaku procenta. Hodnota by měla být zaokrouhlována od 0,5 včetně nahoru. |
Ukázkové hodnoty:
<SALE>30</SALE>
VALIDITY -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Pokud některá položka v letáku má jiné datum platnosti, než je celková platnost letáku, pak je nutné tuto položku vyplnit. Jedná se o párový element uvozující a ukončující informace o začátku a konci konkrétní položky v letáku, která dobou platnosti vybočuje od ostatních položek téhož letáku. |
PRODUCT_VALIDITY_START -
Nepovinná položka
| Typ hodnoty: | date |
| Násobnost: | 0 až 1 |
| Omezení: | Datum ve formátu RRRR-MM-RR |
| Popis: | Počáteční datum platnosti ceny produktu. Nutno vyplnit ve formátu RRRR-MM-DD. |
Ukázkové hodnoty:
<PRODUCT_VALIDITY_START>2015-08-15</PRODUCT_VALIDITY_START>
PRODUCT_VALIDITY_END -
Nepovinná položka
| Typ hodnoty: | date |
| Násobnost: | 0 |
| Omezení: | Datum ve formátu RRRR-MM-DD |
| Popis: | Konečné datum platnosti ceny produktu. Nutno vyplnit ve formátu RRRR-MM-DD. |
Ukázkové hodnoty:
<PRODUCT_VALIDITY_END>2015-09-03</PRODUCT_VALIDITY_END>
EAN_LIST -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Uvozuje a uzavírá výčet čárových kódů variant konkrétního produktu. |
EAN -
Nepovinná položka
| Typ hodnoty: | string |
| Násobnost: | 0 |
| Popis: | Čárový kód produktu, nepovinná, nicméně doporučená položka v datovém souboru. |
Ukázkové hodnoty:
<EAN>0987654321</EAN>
POSITION -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Uvádí a uzavírá informace umístění pozic každé jednotlivé mapy v px (prokliknutelné datové výseče letáku). |
POSITION_TOP -
Povinná položka při zadání POSITION
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Omezení: | Nutno vyplnit v případě zadání <POSITION> |
| Popis: | Poloha umístění levého horního rohu klikací mapy na stránce shora. |
Ukázkové hodnoty:
<POSITION_TOP>15</POSITION_TOP>
POSITION_LEFT -
Povinná položka při zadání POSITION
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Omezení: | Nutno vyplnit v případě zadání <POSITION> |
| Popis: | Poloha umístění levého horního rohu klikací mapy na stránce zleva. |
Ukázkové hodnoty:
<POSITION_LEFT>150</POSITION_LEFT>
POSITION_WIDTH -
Povinná položka při zadání POSITION
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Omezení: | Nutno vyplnit v případě zadání <POSITION> |
| Popis: | Šířka jedné konkrétní klikací mapy. |
Ukázkové hodnoty:
<POSITION_WIDTH>250</POSITION_WIDTH>
POSITION_HEIGHT -
Povinná položka při zadání POSITION
| Typ hodnoty: | int |
| Násobnost: | 1 |
| Omezení: | Nutno vyplnit v případě zadání <POSITION> |
| Popis: | Výška jedné konkrétní klikací mapy. |
Ukázkové hodnoty:
<POSITION_HEIGHT>165</POSITION_HEIGHT>
MARKETS -
Nepovinná položka
| Typ hodnoty: | complex |
| Násobnost: | 0 až 1 |
| Popis: | Uvádí a uzavírá informace o pobočkách, pro které je daný leták platný. |
MARKET_ID -
Nepovinná položka
| Typ hodnoty: | string |
| Násobnost: | 0 |
| Popis: | Definice platnosti letáku v pobočkách - id z <a href="/import/import-pobocek">feedu poboček</a>, možno uvést vícekrát (pokud je leták platný ve více pobočkách). Pokud bude využito, leták bude přiřazen pouze vybraným pobočkám. |
Ukázkové hodnoty:
<MARKET_ID>6653</MARKET_ID>