Datové feedy | Egibi.cz

Co jsou XML feedy?

XML feed je datový formát, který slouží pro uchovávání, zpracování nebo předávání strukturovaných informací mezi systémy. Na jedné straně je poskytovatel datového feedu (v našem případě EGIBI) a na straně druhé systém, nebo e-shop (případně více systémů, nebo e-shopu) zpracovávající data.

V našem případě využíváme formát .xml feedů pro distribuci námi nabízených produktových dat našim klientům. Touto metodou distribuce dat se vám snažíme co nejvíce usnadnit hromadné nahrání produktových dat do vašeho systému, nebo e-shopu.

Charakteristika XML feedu

Nabízíme vám datové feedy v odlišných formátech tak, abychom zajistitli kompabilitu mezi vašim systémem a obsahem XML feedu. Volba správného formátu závisí na tom, zda použiváte vlastní systém (systém na míru), řešení Shoptet, nebo jiné řešení.

Můžete zvolit datový feed ve formátu Shoptet, Heureka, nebo naše vlastní řešení. Všechny dostupné feedy jsou přitom ve formátu XML. Jednotlivé informace v datových feedech jsou zapsány ve formě tagů. Tag je párová značka která otevírá a uzavírá blok s informacemi. Obsažené tagy tvoří stromovou strukturu XML souboru.

Obsah XML feedu

Jednotlivé datové feedy se liší použitými tagy. Všechny feedy však nesou podobné informace o produktech. Jednotlivé produktové bloky ve feedech mohou obsahovat následující informace:

ID produktu (globální id produktu)
ID varianty (id jednotlivých produktových variant)
Číslo varianty produktu
Název produktu
Kód produktu
Referenční kód produktu EGIBI
EAN produktu
Popis produktu
Doporučená kategorie produktu
Jednu nebo více produktových fotografií
Produktová videa
Technické listy a dokumenty
Odkaz na stranu v katalogu
Výrobce produktu
Technické parametry produktu zapsané do jednotlivých tagů (mohou se lišit pro jednotlivé skupiny produktů)
Katalogová, doporučená prodejní a nákupní cena
Informace o skladové dostupnosti a termínu doručení
Speciální produktové značky (best seller, top product, top price, doporučený produkt, novinka)
Informaci o produktu zda je v současné době nabízen k prodeji

Jak nahrát XML feed?

Pro zpracování a nahrání produktových dat z XML feedu do vašeho systému, nebo e-shopu můžete použít váš systémový importér. Důležité je vybrat správný formát feedu. V případě zvolení nesprávného formátu se data nahrají buď chybně, nebo se nenahrají vůbec.

V případě, že váš systém datovým importérem nedisponuje požádejte vaše webmastery / vývojáře o jeho vytvoření, nebo nahrání dat do vašeho systému, nebo e-shopu. V této situaci doporučujeme použit feed v základním formátu EGIBI, neboť nese ze všech XML formátů nejvíce dat.

Všechny datové feedy jsou průběžně aktualizovány. Doplňujeme produktová data, aktualizujeme ceny, skladovou dostupnost a udržujeme aktuální nabídku sortimentu. Doporučujeme nastavit automatické zpracování datového feedu v určitém časovém intervalu pro zachování vždy aktuálních produktů a jejich parametrů.

Pro každý formát XML feedu existuje i čistě dostupností feed, který nese pouze hodnotu o skladové dostupnosti. Doporučujeme právě tyto soubory pravidelně zpracovávat. Neboť jejich zpracování je rychlejší a méně náročné oproti kompletním feedům z důvodu mnohem nižšího počtu tagů.

Přístupy k datovým feedům přidělujeme na vyžádání, nebo po předchozí domluvě. V případě zájmu ohledně využití datových feedů nás kontaktujte na mailovou adresu obchod@egibi.cz, nebo telefonicky na číslo +420 603 192 945.

Dostupné XML feedy

Níže v levém menu naleznete popis jednotlivých datových feedů a jejich variant. Přístupy k datovým feedům přidělujeme na vyžádání, nebo po předchozí domluvě.

V případě zájmu ohledně využití datových feedů nás kontaktujte na mailovou adresu obchod@egibi.cz, nebo telefonicky na číslo +420 603 192 945.

V případě technických dotazů nás kontaktujte telefonicky na mailovou adresu peter@egibi.cz, nebo telefonicky na číslo +420 736 756 860.

Kompletní sortiment EGIBI

Tento datový XML feed dodržuje základní námi stanovený formát. Obsahuje kompletní velkoobchodně nabízený sortiment (kromě položek obsažených v samostatném feedu Home Deco) a velké množství parametrů k jednotlivým položkám.

Pokud to lze, doporučujeme používat tento datový feed, neboť se jedná o primární datový feed společnosti EGIBI s.r.o.

Obsažený sortiment:

Střešní okna Keylite a příslušenství
Půdní, mlynářské, interiérové a modulární schody Minka
Půdní schody, půdní výlezy a půdní dvířka Oman
Obkladové kameny Steinblau
Střešní a stavební fólie
Ocelové zárubně, stavební pouzdra a doplňkový stavební sortiment
Podlahy, podložky pod podlahy a podlahové příslušenství
Rolety
Čistící prostředky Sann Profi a Fini
Bezpečnostní dětské zábranky

Kompletní sortiment EGIBI - Shoptet

Tento datový XML feed dodržuje standardní formát Shoptet. Obsahuje kompletní velkoobchodně nabízený sortiment (kromě položek obsažených v samostatném feedu Home Deco) a velké množství parametrů k jednotlivým položkám.

Obsažený sortiment:

Střešní okna Keylite a příslušenství
Půdní, mlynářské, interiérové a modulární schody Minka
Půdní schody, půdní výlezy a půdní dvířka Oman
Obkladové kameny Steinblau
Střešní a stavební fólie
Ocelové zárubně, stavební pouzdra a doplňkový stavební sortiment
Podlahy, podložky pod podlahy a podlahové příslušenství
Rolety
Čistící prostředky Sann Profi a Fini
Bezpečnostní dětské zábranky

Kompletní sortiment EGIBI - Heureka

Tento datový XML feed dodržuje standardní formát Heureka. Obsahuje kompletní velkoobchodně nabízený sortiment (kromě položek obsažených v samostatném feedu Home Deco) a velké množství parametrů k jednotlivým položkám.

Obsažený sortiment:

Střešní okna Keylite a příslušenství
Půdní, mlynářské, interiérové a modulární schody Minka
Půdní schody, půdní výlezy a půdní dvířka Oman
Obkladové kameny Steinblau
Střešní a stavební fólie
Ocelové zárubně, stavební pouzdra a doplňkový stavební sortiment
Podlahy, podložky pod podlahy a podlahové příslušenství
Rolety
Čistící prostředky Sann Profi a Fini
Bezpečnostní dětské zábranky

Kompletní sortiment EGIBI - Dostupnost

Tento dostupnostní datový XML feed dodržuje základní námi stanovený formát skladové dostupnosti. Feed obsahuje referenční hodnoty ID, počet kusů skladem a informace o doručení. Je plně kompatibilní s kompletním feedem EGIBI i s feedem pro e-shopy.

Sortiment EGIBI pro e-shopy

Tento datový XML feed dodržuje základní námi stanovený formát. Feed obsahuje standardně nabízený sortiment pro e-shopy.

Sortiment EGIBI pro e-shopy - Shoptet

Tento datový XML feed dodržuje standardní formát Shoptet. Feed obsahuje standardně nabízený sortiment pro e-shopy.

Sortiment EGIBI pro e-shopy - Heureka

Tento datový XML feed dodržuje standardní formát Heureka. Feed obsahuje standardně nabízený sortiment pro e-shopy.

Sortiment EGIBI Home Deco

Tento datový XML feed dodržuje základní námi stanovený formát. Home Deco je doplňkovým sortimentem k hlavnímu feedu. Obsahuje derkotaivní prvky jako jsou například polštáře, rozety a polystyrenové stropní desky.

Sortiment EGIBI Home Deco - Shoptet

Tento datový XML feed dodržuje standardní formát Shoptet. Home Deco je doplňkovým sortimentem k hlavnímu feedu. Obsahuje derkotaivní prvky jako jsou například polštáře, rozety a polystyrenové stropní desky.

Sortiment EGIBI Home Deco - Heureka

Tento datový XML feed dodržuje standardní formát Heureka. Home Deco je doplňkovým sortimentem k hlavnímu feedu. Obsahuje derkotaivní prvky jako jsou například polštáře, rozety a polystyrenové stropní desky.

Sortiment EGIBI Home Deco - Dostupnost

Specifikace XML feedů

Jste vývojář, nebo správce datových feedů? Seznamte se s tagy jednotlivých feedů. Specifikace vám usnadní zorientovat se v obsažených datech a usnadní vám import produktů.

Specifikaci k jednotlivým formátům XML feedů naleznete v levém menu.

Specifikace feedu ve formátu EGIBI

Příklad feedu s vysvětlením jednotlivých tagů:

<PRODUCTS>
- <PRODUCT>
  - <GROUP_ID>26000</GROUP_ID>
  - <ITEM_ID>26000</ITEM_ID>
  - <VARIANT>1</VARIANT>
  - <SHORT_PRODUCTNAME>Střešní okno Keylite EASY BW kyvné, 2-sklo (Ug = 1W/m²K)</SHORT_PRODUCTNAME>
  - <SHORT_PRODUCTNAME_SK>Strešné okno Keylite EASY BW, 2-sklo (Ug = 1W/m²K)</SHORT_PRODUCTNAME_SK>
  - <EXTENDED_PRODUCTNAME>Keylite EASY BW T 01 kyvné 55x78 cm dřevo lak 2-sklo Thermal</EXTENDED_PRODUCTNAME>
  - <FULL_PRODUCTNAME>Střešní okno KEYLITE EASY BW T 01 kyvné 55x78 cm dřevo lak 2-sklo Thermal</FULL_PRODUCTNAME>
  - <FULL_PRODUCTNAME_SK>Strešné okno KEYLITE EASY BW T 01 výkyvné 55x78 cm drevený lak 2-sklo</FULL_PRODUCTNAME_SK>
  - <EGIBI_CODE>EG8594187739546</EGIBI_CODE>
  - <EAN>8594187739546</EAN>
  - <CODE>BWT01</CODE>
  - <DESCRIPTION>... Popis ...</DESCRIPTION>
  - <DESCRIPTION_SK>... Popis Sk ...</DESCRIPTION_SK>
  - <CATEGORY>Střešní okna | Keylite Easy</CATEGORY>
  - <DEFAULT_IMAGE>https://egibi.cz/feed/image/g2/keylite/bw/1.jpg</DEFAULT_IMAGE>
  - <IMAGES>
    - <IMAGE>https://egibi.cz/feed/image/keylite/bw-cut.jpg</IMAGE>
  - </IMAGES>
  - <MANUFACTURER>Keylite</MANUFACTURER>
  - <PARAMETERS>
    - <SIZE>55x78 cm</SIZE>
    - <WIDTH>55 cm</WIDTH>
    - <HEIGHT>78 cm</HEIGHT>
    - <MATERIAL>dřevo</MATERIAL>
    - <GLASSES>2-sklo</GLASSES>
    - <UG>1W/m2K</UG>
    - <COLOR>přírodní</COLOR>
    - <WEIGHT>15 kg</WEIGHT>
    - <-- ZDE MOHOU BÝT RŮZNÉ PARAMETRY (kompletní seznam pod příkladem) -->
  - </PARAMETERS>
  - <DOCUMENTS>
    - <DOCUMENT>
      - <DOCUMENT_NAME>Ilustrační montážní návod</DOCUMENT_NAME>
      - <DOCUMENT_URL>https://egibi.cz/documents/keylite/keylite-instalace.PDF</DOCUMENT_URL>
    - </DOCUMENT>
    - <DOCUMENT>
      - <DOCUMENT_NAME>Foto montážní návod</DOCUMENT_NAME>
      - <DOCUMENT_URL>https://egibi.cz/documents/keylite/keylite-montazni-navod.PDF</DOCUMENT_URL>
    - </DOCUMENT>
    - <DOCUMENT>
      - <DOCUMENT_NAME>Porovnání střešních oken (ENG)</DOCUMENT_NAME>
      - <DOCUMENT_URL>https://egibi.cz/documents/keylite/keylite-porovnani-oken.pdf</DOCUMENT_URL>
    - </DOCUMENT>
  - </DOCUMENTS>
  - <VIDEOS>
    - <VIDEO>
      - <VIDEO_NAME>Instalace střešního okna Keylite</VIDEO_NAME>
      - <VIDEO_URL>https://www.youtube.com/embed/QCR56e9JXc4</VIDEO_URL>
    - </VIDEO>
    - <VIDEO>
      - <VIDEO_NAME>Praktická ukázka instalace střešního okna Keylite</VIDEO_NAME>
      - <VIDEO_URL>https://www.youtube.com/embed/0nXJevaNYYw</VIDEO_URL>
    - </VIDEO>
  - </VIDEOS>
  - <CATALOG>https://egibi.cz/documents/katalogy/katalog.pdf#page=51</CATALOG>
  - <SPECIAL>
    - <BEST_QUALITY>true</BEST_QUALITY>
    - <BEST_SELLER>true</BEST_SELLER>
    - <RECOMMENDED>true</RECOMMENDED>
    - <TOP_PRICE>true</TOP_PRICE>
    - <NEW>false</NEW>
  - </SPECIAL>
  - <SUSPENDED>false</SUSPENDED>
  - <MEASURE>
    - <UNIT>ks</UNIT>
    - <UNIT_VALUE>1</UNIT_VALUE>
    - <PACKAGE_TYPE>kus</PACKAGE_TYPE>
    - <MIN_QUANTITY>1</MIN_QUANTITY>
  - </MEASURE>
  - <PRICE>
    - <SALE_PRICE_CZK>4341</SALE_PRICE_CZK>
    - <SALE_PRICE_EUR>168.26</SALE_PRICE_EUR>
    - <PURCHASE_PRICE_CZK>2387</PURCHASE_PRICE_CZK>
    - <PURCHASE_PRICE_EUR>92.52</PURCHASE_PRICE_EUR>
    - <CATALOG_PRICE_CZK>5000</CATALOG_PRICE_CZK>
  - </PRICE>
  - <DELIVERY>
    - <DELIVERY_DAYS>7</DELIVERY_DAYS>
    - <DELIVERY_TEXT>do týdne</DELIVERY_TEXT>
    - <FREE_DELIVERY_LIMIT>20000</FREE_DELIVERY_LIMIT>
    - <AMOUNT1/>
    - <AMOUNT2-AMOUNT5/>
    - <AMOUNT6-AMOUNTN/>
  - </DELIVERY>
  - <STOCK>
    - <AVAILABLE>true</AVAILABLE>
    - <AMOUNT>10</AMOUNT>
    - <STORAGE_DAYS>0</STORAGE_DAYS>
    - <STORAGE_TEXT>skladem</STORAGE_DAYS>
  - </STOCK>
- </PRODUCT>
</PRODUCTS>

Tag

Význam tagu

Datový typ

Kořenový element

Element obsahující informace o produktu

<GROUP_ID>

ID produktu (shodné pro všechny produktové varianty, unikátní pro produkt)

integer

<ITEM_ID>

ID produktové varianty (unikátní pro variantu produktu)

integer

Pořadové číslo varianty produktu

integer

<SHORT_PRODUCTNAME>

Základní název produktu

string

<SHORT_PRODUCTNAME_SK>

Základní název produktu ve slovenčtině

string

<EXTENDED_PRODUCTNAME>

Rozšířený název produktu

string

<FULL_PRODUCTNAME>

Kompletní název produktu

string

<FULL_PRODUCTNAME_SK>

Kompletní název produktu ve slovenštině

string

<EGIBI_CODE>

EGIBI kód produktu (druhořadý kód)

string

<EAN>

Produktový ean

string

<CODE>

Produktový kód

string

Popis produktu

string

<DESCRIPTION_SK>

Popis produktu ve slovenštině

string

Doporučená kategorie k zařazení

string

<DEFAULT_IMAGE>

Hlavní produktová fotografie

string

Element obsahující další obrázky

<IMAGE>

Další obrázek

string

Výrobce produktu

string

Element obsahující technické parametry

Jednotlivé vnořené tagy <PARAMETERS> mohou, ale nemusí být následující: (dostupnost tagů se liší pro jednotlivé skupiny sortimentu)

Tag	Význam tagu
<SIZE>	Velikost
<WIDTH>	Šířka
<HEIGHT>	Výška
<LENGTH>	Délka
<WEIGHT>	Hmotnost
<COLOR>	Barva
<MOTIVE>	Motiv
<PROPERTIES>	Vlastnosti
<MATERIAL>	Materiál
<STANDARD>	Bezpečnostní norma
<GUARANTEE>	Záruka
<PACKAGING>	Počet kusů v balení
<PACKAGING_METERS>	Počet metrů v balení
<FORMAT>	Formát
<CLASS>	Třída produktu
<USAGE>	Vhodné pro použití
<GLASSES>	Počet zasklení
<UG>	Hodnota tepelné izolace
<WINDOW_SPECIFICATION>	Specifikace okna
<WINDOW_OPEN>	Otevírání okna
<FIREPROOF>	Ohnivzdorné
<LID_THICKNESS>	Šířka víka
<INSULATION_THICKNESS>	Tloušťka tepelné izolace
<LID_COLOR>	Barva víka
<LADDER_PARTS>	Počet dílů žebříku
<SIZE>	Velikost
<FRAME_HEIGHT>	Výška rámu
<LADDER_WIDTH>	Šířka žebříku
<STEP_WIDTH>	Šířka stupně
<STEP_DEPTH>	Hloubka stupně
<OPENING_RADIUS>	Radius otevření
<MAX_LADDER_HEIGHT>	Maximální výška žebříku
<LADDER_MATERIAL>	Materiál žebříku
<BOX_HEIGHT>	Výška rámu
<BOX_WIDTH>	Šířka rámu
<SEAL>	Těsnění
<LAYER_WIDTH>	Šířka vrstvy
<LOCK>	Informace o zámku
<USAGE_CLASS>	Třída užití
<ACOUSTIC_INSULATION>	Akustická izolace
<THERMAL_RESISTANCE>	Tepelná odolnost
<VOLUME>	Objem
<CUSTOMS_NUMBER>	Číslo celního sazebníku
<INNER_WIDTH>	Vnitřní šířka
<INNER_HEIGHT>	Vnitřní výška
<OUTER_WIDTH>	Vnější šířka
<OUTER_HEIGHT>	Vnější výška
<BED_HEADBOARD_HEIGHT>	Výška čela u hlavy
<BED_FOOTBOARD_HEIGHT>	Výška čela u nohou
<PLANK_WIDTH>	Tloušťka fošen
<FOOT_SIZE>	Rozměr nohou
<STATE>	Stav produktu
<NUMBER_OF_PARTS>	Počet částí
<PACKAGE_SIZE>	Rozměr balení
<FABRIC_WEIGHT>	Gramáž tkaniny

string

Element obsahující dokumenty

Blok pro jednotlivé dokumenty

<DOCUMENT_NAME>

Název dokumentu

string

<DOCUMENT_URL>

URL adresa dokumentu

string

Element obsahující videa

<VIDEO>

Blok pro jednotlivá videa

<VIDEO_NAME>

Název videa

<VIDEO_URL>

URL adresa videa

URL adresa katalogu

string

Element obsahující speciální označení produktu

<BEST_QUALITY>

Produkt je označen jak produkt nejlepší kvality (true / false)

boolean

<BEST_SELLER>

Produkt je označen jako nejprodávanější produkt (true / false)

boolean

Produkt je označen jako doporučený (true / false)

boolean

<TOP_PRICE>

Produkt je označen jako nejlepší v poměru cena / výkon (true / false)

boolean

<NEW>

Produkt je označen jako novinka (true / false)

boolean

Produkt je vyřazený z prodeje (true / false)

boolean

Element obsahující nastavení měrné jednotky

<UNIT>

Měrná jednotka

string

<UNIT_VALUE>

Násobek prodávaných kusů

float

<PACKAGE_TYPE>

Typ balení

string

<MIN_QUANTITY>

Minimální objednací množství

float

<PRICE>

Element obsahující informace o cenách

<SALE_PRICE_CZK>

Katalogová cena bez DPH v CZK

float

<SALE_PRICE_EUR>

Katalogová cena bez DPH v EUR

float

<PURCHASE_PRICE_CZK>

Vaše nákupní cena bez DPH v CZK

float

<PURCHASE_PRICE_EUR>

Vaše prodejní cena bez DPH v EUR

float

<INTERNET_PRICE_CZK>

Doporučená prodejní cena bez DPH v CZK

float

<INTERNET_PRICE_EUR>

Doporučená prodejní cena bez DPH v EUR

float

<CATALOG_PRICE_CZK>

Katalogová cena bez DPH

float

Element obsahující spediční informace

<DELIVERY_DAYS>

Počet dní od expedice do doručení

integer

<DELIVERY_TEXT>

Informativní text o době doručení

string

<FREE_DELIVERY_LIMIT>

Hodnota objednávky včetně DPH v CZK nad kterou je stanovená doprava zdarma

float

Hodnota dopravy včetně DPH za jeden kus

float

<AMOUNT2-AMOUNT5>

Hodnota dopravy včetně DPH za 2 až 5 kusů

float

<AMOUNT6-AMOUNTN>

Hodnota dopravy včetně DPH za 6 a více kusů

float

<STOCK>

Element obsahující dostupností informace

Je produkt dostupný skladem? (true / false)

boolean

Počet kusů dostupných skladem

integer

<STORAGE_DAYS>

Počet dní do naskladnění

integer

<STORAGE_TEXT>

Informativní text o době naskladnění

string

Specifikace feedu ve formátu Shoptet

Datové feedy EGIBI ve formátu Shoptet dodržují základní specifikaci Shoptet. Více o validaci Shoptet feedů, možnosti využití feedu i vzorový soubor naleznete zde https://podpora.shoptet.cz/hc/cs/articles/360003161191-XML-validace

Specifikace feedu ve formátu Heureka

Datové feedy EGIBI ve formátu Heureka dodržují základní specifikaci dostupnou zde https://sluzby.heureka.cz/napoveda/xml-feed/

Specifikace dostupnostního feedu

Příklad dostupnostního feedu s vysvětlením jednotlivých tagů:

<PRODUCTS>
- <PRODUCT>
  - <GROUP_ID>1</GROUP_ID>
  - <ITEM_ID>1</ITEM_ID>
  - <DELIVERY>
    - <DELIVERY_DAYS>3</DELIVERY_DAYS>
    - <DELIVERY_TEXT>do 3 dnů</DELIVERY_TEXT>
  - </DELIVERY>
  - <STOCK>
    - <AVAILABLE>true</AVAILABLE>
    - <AMOUNT>10</AMOUNT>
    - <STORAGE_DAYS>0</STORAGE_DAYS>
    - <STORAGE_TEXT>skladem</STORAGE_TEXT>
  - </STOCK>
- </PRODUCT>
</PRODUCTS>

Tag	Význam tagu	Datový typ
<PRODUCTS>	Kořenový element
<PRODUCT>	Element obsahující informace o konkrétním produktu
<GROUP_ID>	ID produktu (shodné pro všechny produktové varianty, unikátní pro produkt)	integer
<ITEM_ID>	ID produktové varianty (unikátní pro variantu produktu)	integer
<DELIVERY>	Element obsahující spediční informace konkrétního produktu
<DELIVERY_DAYS>	Počet dní od expedice do doručení	integer
<DELIVERY_TEXT>	Informativní text o době doručení	string
<STOCK>	Element obsahující dostupnostní informace o konkrétním produktu
<AVAILABLE>	Je produkt dostupný skladem? (true / false)	boolean
<AMOUNT>	Počet kusů dostupných skladem	integer
<STORAGE_DAYS>	Počet dní do naskladnění zboží	integer
<STORAGE_TEXT>	Informativní text o době naskladnění	string

Výsledky hledání

1Co jsou to XML feedy?

2Dostupné XML feedy

3Specifikace XML feedů

Mám zájem o:







Odesláním formuláře souhlasím se zpracováním osobních údajů.