PneuB2B XML komunikační protokol PneuB2B Easy shop. Revize 12

Transkript

1 PneuB2B XML komunikační protokol PneuB2B Easy shop Revize 2

2 REVIZE DOKUMENTU Číslo rev. Datum Popis revize První revize dokumentu Do exportu sortimentu přidány informace o štítkování pneumatik, maloobchodní ceně a popisu dezénů Přidána kapitola Získání kompletního sortimentu pneumatik i položky bez skladové dostupnosti. Do kapitoly Obecná pravidla komunikace přidána informace o nutnosti nastavení IP adresy serveru využívajícího komunikaci V kapitole Podporované operace byly změněny minimální počty kusů jednotlivých kategorií produktů nutné pro zařazení do exportu V kapitole Získání kompletního sortimentu pneumatik a v kapitole Získání kompletního sortimentu pneumatik i položky bez skladové dostupnosti přibyly atributy specifikující podskupinu pneumatiky (Subgroup) V kapitole Číselník typů vozů přibyly dva nové typy vozů Průmyslové a Zemědělské V kapitole Číselník typů vozů byly osobní vozy přejmenovány na Osobní + SUV Přidána kapitola Aplikace pro manuální stažení dat popisující aplikaci pro manuální stažení dat z EasyShop Přidán výrobce do exportu skladu a cen (kapitola Získání stavu skladu a cen sortimentu ) Přidán export skladu a cen s dostupností do 24 hodin Přidán popis exportu ocelových disků Přidána kapitola Obrázky vodoznaky. 2

3 OBSAH Revize dokumentu... 2 PneuB2B XML komunikace Pneumatiky a ocelové disky... 4 Základní informace o komunikaci... 4 Obecná pravidla komunikace... 4 Seznam příkazů... 5 Struktura XML - výsledek provedení operace... 5 Podporované operace... 6 Získání kompletního sortimentu pneumatik a ocelových disků... 6 Získání kompletního sortimentu pneumatik i položky bez skladové dostupnosti... 6 Obrázky - vodoznaky... 2 Získání stavu skladu a cen sortimentu... 2 Získání aktuálního stavu skladu a cen jedné pneumatiky nebo ocelového disku Číselníky Číselník měn Číselník sezón pneumatik Číselník typů vozů... 3 Aplikace pro manuální stažení dat... 3 Testovací prostředí

4 PNEUB2B XML KOMUNIKACE PNEUMATIKY A OCELOVÉ DISKY ZÁKLADNÍ INFORMACE O KOMUNIKACI Komunikace se serverem probíhá pomocí protokolu HTTP. V rámci aplikace PneuB2B je poskytnut handler na který je umožněno zasílat požadavky na získání dat ohledně sortimentu, cen a skladové dostupnosti pneumatik. Celý komunikační protokol je postaven nad souborovým formátem XML. Dále v tomto souboru jsou popsány struktury všech možných typů serverem zasílaných souborů. Každá operace navrací na výstup požadovaná data nebo XML soubor reprezentující jednoduchý výsledek operace. Kterákoliv operace může navrátit tento jednoduchý výsledek namísto předpokládaných dat (např. v případě chyby). Struktura tohoto souboru je popsána v kapitole Struktura XML - výsledek provedení operace. OBECNÁ PRAVIDLA KOMUNIKACE Při jakékoliv komunikaci (při všech dotazech na server) s handlerem je nutné se při každém požadavku autentifikovat pomocí standardní HTTP Basic access authentication. Pro tuto XML komunikaci je nutná speciální licence, která Vám bude přidělena. Komunikace v základu pracuje na systému http požadavků, na které server odpovídá XML odpovědí: Požadavek s HTTP autentifikací a parametry pro výpis XML odpověď s požadovanými daty Váš server PartnerCommunication.ashx Obrázek - Základní komunikační schéma V XML odpovědi naleznete požadovaná data. V případě chyby, nebo operace, jejímž výsledkem je jen informace o výsledku operace, může být na výstup zapsán jednoduchý XML soubor s touto informací. Struktura tohoto souboru je uvedena v kapitole Struktura XML - výsledek provedení operace. Komunikace se službou je vždy omezena na jeden konkrétní server tzv. ostrá data můžete importovat pouze z jedné předem dané IP adresy. Tuto IP adresu můžete nastavit buď po přihlášení 4

5 na portál v sekci Licence (stisknutím tlačítka Konfigurovat u Vaší XML licence), případně můžete kontaktovat technickou podporu portálu PneuB2B. SEZNAM PŘÍKAZŮ Na komunikačním rozhraní lze provádět následující operace: cmd=products_list - získání plného sortimentu všech dostupných pneumatik a ocelových disků se všemi technickými informacemi o těchto pneumatikách. Tento soubor je aktualizován jednou denně. cmd=products_list_full získání kompletního sortimentu pneumatik a ocelových disků tedy i těch, které nejsou ze systému dostupné. Vhodné pro naimportování kompletního seznamu sortimentu do Vašeho systému. Tento soubor je aktualizován jednou denně. cmd=stock_price_list získání aktuálních informací o skladových stavech a cenách všech dostupných pneumatik a ocelových disků. Tento soubor je aktualizován každou celou hodinu. cmd= product_state získání informace o aktuálním stavu skladu a ceně jednoho konkrétního produktu Operace jsou podrobně popsány v dalších kapitolách. STRUKTURA XML - VÝSLEDEK PROVEDENÍ OPERACE <?xml version=".0" encoding="utf-8"?> <Response> <State>Error</State> <Message>Batch was not found in database.</message> </Response> Element Popis Kardinalita Response Root element obsahující odpověď. State Message Stav operace může nabývat dvou hodnot Ok v případě úspěchu, Error v případě chyby. Bližší textový popis výsledku operace. 5

6 PODPOROVANÉ OPERACE U všech operací je v rámci výsledku vrácena informace o stavu skladu a cenách u jednotlivých položek. Tato informace je uvedena následující formou: v elementu StockPriceInfo jsou informace ohledně nejlepší ceny ze všech dodavatelů, v elementu StockPriceInfo_48 jsou informace ohledně nejlepší ceny ze všech dodavatelů, kteří Vám garantují doručení zboží do 48 hodin. Do výběru nabídek dodavatelů, ze kterých určujeme nejlepší cenu položky, zahrnujeme pouze dodavatele, které u té dané položky mají určité minimální dostupné skladové množství. Toto minimální skladové množství je určeno kategorií pneumatiky. Kategorie pneumatiky Minimální skladové množství Pneumatika pro osobní vozy, velikost 7 a méně 4 Pneumatika pro osobní vozy, velikost 8 a více 4 Pneumatika pro nákladní vozy 2 Pneumatika pro SUV a dodávkové vozy 4 Pneumatika pro motorky Ocelový disk ZÍSKÁNÍ KOMPLETNÍHO SORTIMENTU PNEUMATIK A OCELOVÝCH DISKŮ Základní operací pro práci se systémem je získání kompletního sortimentu pneumatik a ocelových disků. Toto je možné provést pomocí http požadavku s parametrem cmd nastaveným na hodnotu products_list. Systém poté navrátí XML soubor obsahující seznam všech pneumatik a ocelových disků s jejich technickými parametry, které si potom naimportujete do Vašeho systému. Tento soubor je aktualizován jednou denně ve 4:00 AM GMT. PŘÍKLAD XML ODPOVĚDI SE SORTIMENTEM PNEUMATIK <?xml version=".0" encoding="utf-8"?> <Response> <State>Ok</State> <Message>Operation completed successfully.</message> <Tyres> <Tyre> <ID>3097</ID> <PartNo>55867</PartNo> <EAN> </EAN> <DisplayName>235/70R6 06H, Goodyear, WRLHPAW, TL</DisplayName> <ManufacturerID>68</ManufacturerID> <Manufacturer>Goodyear Dunlop Tires Czech s.r.o.</manufacturer> <PatternID>477</PatternID> <Pattern>WRLHPAW</Pattern> <Width>235.00</Width> <Separator>/</Separator> <Profile>70.00</Profile> 6

7 <ConstructionType>R</ConstructionType> <Diameter>6.00</Diameter> <LoadIndexFrom>06</LoadIndexFrom> <SpeedIndex>H</SpeedIndex> <Usage>Summer</Usage> <VehicleType>Offroad</VehicleType> <VehicleTypeCode>2</VehicleTypeCode> <CT>TL</CT> <ROF>false</ROF> <TagConsumption>A</TagConsumption> <TagAdhesion>D</TagAdhesion> <TagNoiseLevel>2</TagNoiseLevel> <TagNoiseLevel_dB>70</TagNoiseLevel_dB> <RetailPrice_CZ> </RetailPrice_CZ> <RetailPriceCurrency_CZ>CZK</RetailPriceCurrency_CZ> <StockPriceInfo> <TotalPrice> </TotalPrice> <TotalPriceCZK> </TotalPriceCZK> <TotalPriceIncDelivery> </TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK> </TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>72</DeliveryTime> <DeliveryTimeTerm>7</DeliveryTimeTerm> </StockPriceInfo> <StockPriceInfo_24> <TotalPrice>2800</TotalPrice> <TotalPriceCZK>2800</TotalPriceCZK> <TotalPriceIncDelivery>2800</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>2800</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>4.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>7</DeliveryTimeTerm> </StockPriceInfo_24> <StockPriceInfo_48> <TotalPrice>2800</TotalPrice> <TotalPriceCZK>2800</TotalPriceCZK> <TotalPriceIncDelivery>2800</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>2800</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>4.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>7</DeliveryTimeTerm> </StockPriceInfo_48> </Tyre> </Tyres> <Patterns> <Pattern> <ID>273</ID> <Name>AH</Name> <Description_CZ>Textový popis dezénu v češtině.</description_cz> </Pattern> </Patterns> <SteelRims> <SteelRim> <ID>6789</ID> <PartNo>2220</PartNo> <EAN> </EAN> <DisplayName>4.00B x 3 4x5 CB78 ET23.5</DisplayName> <ManufacturerID>3</ManufacturerID> <Manufacturer>KFZ</Manufacturer> <Dimension>4.00B x 3</Dimension> 7

8 <BoltPattern>4</BoltPattern> <BoltCircle_mm>5.00</BoltCircle_mm> <CentreBore_mm>78.00</CentreBore_mm> <Offset_mm>23.50</Offset_mm> <ABE>false</ABE> <ImageUrl> <RetailPrice_CZ> </RetailPrice_CZ> <RetailPriceCurrency_CZ>CZK</RetailPriceCurrency_CZ> <StockPriceInfo> <TotalPrice> </TotalPrice> <TotalPriceCZK>65.372</TotalPriceCZK> <TotalPriceIncDelivery>65.372</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>65.372</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>5</DeliveryTimeTerm> </StockPriceInfo> <StockPriceInfo_24> <TotalPrice> </TotalPrice> <TotalPriceCZK>65.372</TotalPriceCZK> <TotalPriceIncDelivery>65.372</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>65.372</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>5</DeliveryTimeTerm> </StockPriceInfo_24> <StockPriceInfo_48> <TotalPrice> </TotalPrice> <TotalPriceCZK>65.372</TotalPriceCZK> <TotalPriceIncDelivery>65.372</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>65.372</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>5</DeliveryTimeTerm> </StockPriceInfo_48> </SteelRim> </SteelRims> </Response> 8

9 POPIS XML ODPOVĚDI SE SORTIMENTEM PNEUMATIK A OCELOVÝCH DISKŮ Název elementu Popis Kardinalita Response -State -Message Hlavní element celé dávky obsahující informaci o výsledku operace a cenu a stav skladu pneumatiky. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. -Tyres Seznam pneumatik k importu Tyre Jedna pneumatika určená k importu 0 * ---ID Unikátní identifikátor pneumatiky. ---PartNo Kód výrobce pneumatiky. ---EAN EAN pneumatiky DisplayName Sestavený zobrazovaný název pneumatiky. ---ManufacturerID Unikátní ID výrobce pneumatiky. ---Manufacturer Název výrobce pneumatiky. ---PatternID Unikátní ID dezénu pneumatiky. ---Pattern Název dezénu pneumatiky. ---WidthPrefix Textový prefix uváděný před šíří pneumatiky Width Šířka pneumatiky. ---WidthSuffix Textový sufix uváděný za šíří pneumatiky. 0 9

10 ---Separator Oddělovač šířky pneumatiky a profilu pneumatiky (pro složení textového rozměru pneumatiky) Profile Profil pneumatiky ConstructionType Typ konstrukce pneumatiky (R - radiální) Diameter Průměr pneumatiky. ---LoadIndexFrom Index nosnosti LoadIndexTo Index nosnosti SpeedIndex Rychlostní index pneumatiky Usage ---VehicleType ---VehicleTypeCode --CT ---ROF Sezóna, pro kterou je pneumatika určena. Více viz kapitola Číselník sezón pneumatik. Textový popis typu vozů, na které je pneumatika určena. K automatickému zpracování je vhodnější pole VehicleTypeCode. Kód typu vozu, pro který je pneumatika určena. Více viz Číselník typů vozů. Doplňující technické údaje pneumatiky (TL, XL ). Specifikuje, zda se jedná o tzv. Run Flat Tyre Homologation Údaje o homologaci pneumatiky ImageUrl URL obrázku pneumatiky TagConsumption ---TagAdhesion Informace o spotřebě pneumatiky povolené hodnoty = A - G Informace o přilnavosti pneumatiky povolené hodnoty = A - G TagNoiseLevel Úroveň hluku pneumatiky TagNoiseLevel_dB Úroveň hluku pneumatiky v decibelech. 0 0

11 ---RetailPrice_CZ Maloobchodní cena platná pro ČR RetailPriceCurrency_CZ Měna, ve které je maloobchodní cena pro ČR uvedena SubgroupID ID podskupiny pneumatiky SubgroupName Název podskupiny pneumatiky (například implement, HSU, ) ---StockPriceInfo Údaje o nejlepší ceně a skladovém množství TotalPrice Cena za kus bez daně v měně dodavatele (specifikována elementem Currency). ----TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 24 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency). 0 0

12 ----TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 48 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. 2

13 ----StockAmount ----DeliveryTime ----DeliveryTimeTerm Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. 0 -Patterns Informace o dezénech pneumatik. 0 --Pattern Informace o jednom dezénu pneumatiky. ---ID ID dezénu koresponduje s PatternID v Tyre. ---Name Název dezénu. ---Description_CZ Textový popis dezénu v češtině. 0 * -SteelRims Seznam ocelových disků k importu SteelRim Jeden ocelový disk určen k importu 0 * ---ID Unikátní identifikátor disku. ---PartNo Kód výrobce disku. ---EAN EAN disku DisplayName Sestavený zobrazovaný název disku. ---ManufacturerID Unikátní ID výrobce disku. ---Manufacturer Název výrobce disku. ---Dimension Rozměr disku. ---BoltPattern Počet šroubů. ---BoltCircle_mm Rozteč šroubů v mm. ---CentreBore_mm Středová díra v mm. ---Offset_mm ET v mm. ---ABE ABE 3

14 ---ImageUrl URL obrázku disku StockPriceInfo Údaje o nejlepší ceně a skladovém množství. ----TotalPrice Cena za kus bez daně v měně dodavatele (specifikována elementem Currency). ----TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 24 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery dopravy v měně dodavatele 4

15 ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 48 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. 5

16 ----DeliveryTime ----DeliveryTimeTerm Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. 0 ZÍSKÁNÍ KOMPLETNÍHO SORTIMENTU PNEUMATIK I POLOŽKY BEZ SKLADOVÉ DOSTUPNOSTI Pro případ kompletního importu všech položek sortimentu, i těch, které nejsou na skladě, je možné využít příkaz cmd=products_list_full. Struktura celé operace a všech XML souborů je velmi podobná jako při operaci products_list, XML odpověď pouze neobsahuje informaci o skladové dostupnosti a aktuálních cenách. Informace o nákupní ceně je stále přítomna. Kompletní popis celé komunikace následuje níže. Tento soubor je aktualizován jednou denně ve 4:00 AM GMT. PŘÍKLAD XML ODPOVĚDI SE SORTIMENTEM PNEUMATIK A OCELOVÝCH DISKŮ I POLOŽKY BEZ SKLADOVÉ DOSTUPNOSTI <?xml version=".0" encoding="utf-8"?> <Response> <State>Ok</State> <Message>Operation completed successfully.</message> <Tyres> <Tyre> <ID>3097</ID> <PartNo>55867</PartNo> <EAN> </EAN> <DisplayName>235/70R6 06H, Goodyear, WRLHPAW, TL</DisplayName> <ManufacturerID>68</ManufacturerID> <Manufacturer>Goodyear Dunlop Tires Czech s.r.o.</manufacturer> <PatternID>477</PatternID> <Pattern>WRLHPAW</Pattern> <Width>235.00</Width> <Separator>/</Separator> <Profile>70.00</Profile> <ConstructionType>R</ConstructionType> <Diameter>6.00</Diameter> <LoadIndexFrom>06</LoadIndexFrom> <SpeedIndex>H</SpeedIndex> <Usage>Summer</Usage> <VehicleType>Offroad</VehicleType> <VehicleTypeCode>2</VehicleTypeCode> <CT>TL</CT> <ROF>false</ROF> <TagConsumption>A</TagConsumption> <TagAdhesion>D</TagAdhesion> <TagNoiseLevel>2</TagNoiseLevel> <TagNoiseLevel_dB>70</TagNoiseLevel_dB> 6

17 <RetailPrice_CZ> </RetailPrice_CZ> <RetailPriceCurrency_CZ>CZK</RetailPriceCurrency_CZ> </Tyre> </Tyres> <Patterns> <Pattern> <ID>273</ID> <Name>AH</Name> <Description_CZ>Textový popis dezénu v češtině.</description_cz> </Pattern> </Patterns> <SteelRims> <SteelRim> <ID>6789</ID> <PartNo>2220</PartNo> <EAN> </EAN> <DisplayName>4.00B x 3 4x5 CB78 ET23.5</DisplayName> <ManufacturerID>3</ManufacturerID> <Manufacturer>KFZ</Manufacturer> <Dimension>4.00B x 3</Dimension> <BoltPattern>4</BoltPattern> <BoltCircle_mm>5.00</BoltCircle_mm> <CentreBore_mm>78.00</CentreBore_mm> <Offset_mm>23.50</Offset_mm> <ABE>false</ABE> <ImageUrl> </SteelRim> </SteelRims> </Response> 7

18 POPIS XML ODPOVĚDI SE SORTIMENTEM PNEUMATIK I POLOŽKY BEZ SKLADOVÉ DOSTUPNOSTI Název elementu Popis Kardinalita Response -State -Message Hlavní element celé dávky obsahující informaci o výsledku operace a cenu a stav skladu pneumatiky. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. -Tyres Seznam pneumatik k importu Tyre Jedna pneumatika určená k importu 0 * ---ID Unikátní identifikátor pneumatiky. ---PartNo Kód výrobce pneumatiky. ---EAN EAN pneumatiky DisplayName Sestavený zobrazovaný název pneumatiky. ---ManufacturerID Unikátní ID výrobce pneumatiky. ---Manufacturer Název výrobce pneumatiky. ---PatternID Unikátní ID dezénu pneumatiky. ---Pattern Název dezénu pneumatiky. ---WidthPrefix Textový prefix uváděný před šíří pneumatiky Width Šířka pneumatiky. ---WidthSuffix Textový sufix uváděný za šíří pneumatiky. 0 8

19 ---Separator Oddělovač šířky pneumatiky a profilu pneumatiky (pro složení textového rozměru pneumatiky) Profile Profil pneumatiky ConstructionType Typ konstrukce pneumatiky (R - radiální) Diameter Průměr pneumatiky. ---LoadIndexFrom Index nosnosti LoadIndexTo Index nosnosti SpeedIndex Rychlostní index pneumatiky Usage ---VehicleType ---VehicleTypeCode --CT ---ROF Sezóna, pro kterou je pneumatika určena. Více viz kapitola Číselník sezón pneumatik. Textový popis typu vozů, na které je pneumatika určena. K automatickému zpracování je vhodnější pole VehicleTypeCode. Kód typu vozu, pro který je pneumatika určena. Více viz Číselník typů vozů. Doplňující technické údaje pneumatiky (TL, XL ). Specifikuje, zda se jedná o tzv. Run Flat Tyre Homologation Údaje o homologaci pneumatiky ImageUrl URL obrázku pneumatiky TagConsumption ---TagAdhesion Informace o spotřebě pneumatiky povolené hodnoty = A - G Informace o přilnavosti pneumatiky povolené hodnoty = A - G TagNoiseLevel Úroveň hluku pneumatiky TagNoiseLevel_dB Úroveň hluku pneumatiky v decibelech. 0 9

20 ---RetailPrice_CZ Maloobchodní cena platná pro ČR RetailPriceCurrency_CZ Měna, ve které je maloobchodní cena pro ČR uvedena SubgroupID ID podskupiny pneumatiky SubgroupName Název podskupiny pneumatiky (například implement, HSU, ) --Pattern Informace o jednom dezénu pneumatiky. ---ID ID dezénu koresponduje s PatternID v Tyre. ---Name Název dezénu. ---Description_CZ Textový popis dezénu v češtině. 0 0 * -SteelRims Seznam ocelových disků k importu SteelRim Jeden ocelový disk určen k importu 0 * ---ID Unikátní identifikátor ocelového disku. ---PartNo Kód výrobce disku. ---EAN EAN disku DisplayName Sestavený zobrazovaný název disku. ---ManufacturerID Unikátní ID výrobce disku. ---Manufacturer Název výrobce disku. ---Dimension Rozměr disku. ---BoltPattern Počet šroubů. ---BoltCircle_mm Rozteč šroubů v mm. ---CentreBore_mm Středová díra v mm. ---Offset_mm ET v mm. ---ABE ABE ---ImageUrl URL obrázku disku. 0 20

21 OBRÁZKY VODOZNAKY Všechy obrázky v EasyShop jsou vždy překryty vodoznakem. Systém umožňuje pro Vaše obrázky využívat Vašich vlastních vodoznaků. Pokud chcete v obrázcích uvádět místo vodoznaku PneuB2B Váš vodoznak, pak prosím kontaktujte podporu PneuB2B. Budete požádání o dodání obrázku vodoznaku s následujícími parametry: Formát: png Rozlišení: 500x500 pixelů Samozřejmostí je průhledné pozadí Vodoznak bude vždy čtvercový a bude zabírat celou šíři obrázku. V případě, že bude obrázek vyšší než širší, bude tento vodoznak opakován. Poté bude třeba, abyste při importu obrázků z EasyShop přidali do URL obrázku ID vaší licence pomocí parametru b2buserid. Pokud je původní URL obrázku: pak bude nově modifikované URL vypadat následovně: Od této doby budou všechny obrázky dodávány s Vaším vodoznakem. ZÍSKÁNÍ STAVU SKLADU A CEN SORTIMENTU Pro periodickou aktualizaci cen a stavu skladů slouží tato operace. Provádí se http požadavkem s parametrem cmd nastaveným na hodnotu stock_price_list. Výsledkem je XML soubor obsahující ceny a skladové dostupnosti všech aktuálně dostupných pneumatik a ocelových disků. Tyto si můžete do Vašeho systému naimportovat dle ID, kódu výrobce anebo EAN kódu. Import tohoto souboru provádějte každou celou hodinu. Poznámka: Položky, které budou vyskladněny a nebudou v tomto souboru uvedeny, nejsou již nadále dostupné a je nutné je jako nedostupné označit i ve Vašem systému. PŘÍKLAD XML ODPOVĚDI SE STAVY SKLADU A CEN PNEUMATIK <?xml version=".0" encoding="utf-8"?> <Response> <State>Ok</State> <Message>Operation completed successfully.</message> <Tyres> <Tyre> <ID>3097</ID> <PartNo>55867</PartNo> <EAN> </EAN> <ManufacturerID>4</ManufacturerID> <Manufacturer>Goodyear</Manufacturer> <StockPriceInfo> <TotalPrice> </TotalPrice> 2

22 <TotalPriceCZK> </TotalPriceCZK> <TotalPriceIncDelivery> </TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK> </TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>72</DeliveryTime> <DeliveryTimeTerm>7</DeliveryTimeTerm> </StockPriceInfo> </Tyre> </Tyres> <SteelRims> <SteelRim> <ID>6789</ID> <PartNo>2220</PartNo> <EAN> </EAN> <ManufacturerID>3</ManufacturerID> <Manufacturer>KFZ</Manufacturer> <StockPriceInfo> <TotalPrice> </TotalPrice> <TotalPriceCZK>65.372</TotalPriceCZK> <TotalPriceIncDelivery>65.372</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>65.372</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>5</DeliveryTimeTerm> </StockPriceInfo> </SteelRim> </SteelRims> </Response> 22

23 POPIS XML ODPOVĚDI SE STAVY SKLADU A CEN PNEUMATIK A OCELOVÝCH DISKŮ Název elementu Popis Kardinalita Response -State -Message -Tyres Hlavní element celé dávky obsahující informaci o výsledku operace a cenu a stav skladu pneumatiky. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. Seznam cen a skladových dostupností jednotlivých pneumatik. 0 --Tyre Informace o jedné pneumatice. 0 * ---ID Unikátní identifikátor pneumatiky. ---PartNo ---EAN Kód výrobce produktu, ke kterému informace o stavu skladu a ceně náleží. EAN produktu, ke kterému informace o stavu skladu a ceně náleží. ---ManufacturerID ID výrobce pneumatiky. ---Manufacturer Název výrobce pneumatiky. ---StockPriceInfo Údaje o nejlepší ceně a skladovém množství. ----TotalPrice Cena za kus bez daně v měně dodavatele (specifikována elementem Currency). ----TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery dopravy v měně dodavatele (specifikována elementem Currency). 23

24 ---- TotalPriceIncDeliveryCZK ----Currency dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. ----StockAmount Skladová dostupnost tohoto produktu. ----DeliveryTime ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 24 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ---- TotalPriceIncDeliveryCZK ----Currency dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. ----StockAmount Skladová dostupnost tohoto produktu. ----DeliveryTime ----DeliveryTimeTerm Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. 0 24

25 ---StockPriceInfo_ TotalPrice Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 48 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ---- TotalPriceIncDeliveryCZK ----Currency dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. ----StockAmount Skladová dostupnost tohoto produktu. ----DeliveryTime ----DeliveryTimeTerm Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. 0 -SteelRims Seznam ocelových disků k importu SteelRim Jeden ocelový disk určen k importu 0 * ---ID Unikátní identifikátor disku. ---PartNo Kód výrobce disku. ---EAN EAN disku DisplayName Sestavený zobrazovaný název disku. ---ManufacturerID Unikátní ID výrobce disku. ---Manufacturer Název výrobce disku. ---Dimension Rozměr disku. ---BoltPattern Počet šroubů. 25

26 ---BoltCircle_mm Rozteč šroubů v mm. ---CentreBore_mm Středová díra v mm. ---Offset_mm ET v mm. ---ABE ABE ---ImageUrl URL obrázku disku StockPriceInfo Údaje o nejlepší ceně a skladovém množství. ----TotalPrice Cena za kus bez daně v měně dodavatele (specifikována elementem Currency). ----TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ---- TotalPriceIncDeliveryCZK ----Currency dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. ----StockAmount Skladová dostupnost tohoto produktu. ----DeliveryTime ----DeliveryTimeTerm Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. 0 26

27 ZÍSKÁNÍ AKTUÁLNÍHO STAVU SKLADU A CEN JEDNÉ PNEUMATIKY NEBO OCELOVÉHO DISKU Pro možnost rychlé kontroly ceny a skladu jedné položky (např. před provedením objednávky zákazníkem ve Vašem e-shopu) podporuje systém zaslání http požadavku s parametrem cmd nastaveným na hodnotu product_state a parametrem product_id nastaveným na ID produktu, jehož skladovou dostupnost hodláte ověřit. Níže je uveden příklad odpovědi pro dotaz ve formátu: PŘÍKLAD XML ODPOVĚDI SE STAVEM SKLADU A CENOU PNEUMATIKY <Response> <State>Ok</State> <Message>Operation completed successfully.</message> <ID>3097</ID> <PartNo>55867</PartNo> <EAN> </EAN> <StockPriceInfo> <TotalPrice> </TotalPrice> <TotalPriceCZK> </TotalPriceCZK> <TotalPriceIncDelivery> </TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK> </TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>8.0000</StockAmount> <DeliveryTime>72</DeliveryTime> <DeliveryTimeTerm>7</DeliveryTimeTerm> </StockPriceInfo> <StockPriceInfo_48> <TotalPrice>2800</TotalPrice> <TotalPriceCZK>2800</TotalPriceCZK> <TotalPriceIncDelivery>2800</TotalPriceIncDelivery> <TotalPriceIncDeliveryCZK>2800</TotalPriceIncDeliveryCZK> <Currency>CZK</Currency> <StockAmount>4.0000</StockAmount> <DeliveryTime>24</DeliveryTime> <DeliveryTimeTerm>7</DeliveryTimeTerm> </StockPriceInfo_48> </Response> POPIS XML ODPOVĚDI SE STAVEM SKLADU A CENOU PNEUMATIKY NEBO OCELOVÉHO DISKU Název elementu Popis Kardinalita Response Hlavní element celé dávky obsahující informaci o výsledku operace a cenu a stav skladu pneumatiky. 27

28 -State -Message -ID -PartNo -EAN ---StockPriceInfo Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. Informace o stavu provedení operace. Více viz kapitola Struktura XML - výsledek provedení operace. ID produktu, ke kterému informace o stavu skladu a ceně náleží. Kód výrobce produktu, ke kterému informace o stavu skladu a ceně náleží. EAN produktu, ke kterému informace o stavu skladu a ceně náleží. Údaje o nejlepší ceně a skladovém množství. ----TotalPrice Cena za kus bez daně v měně dodavatele (specifikována elementem Currency). ----TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. 28

29 ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 24 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime ----DeliveryTimeTerm ---StockPriceInfo_ TotalPrice dopravy v měně dodavatele (specifikována elementem Currency). dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. Údaje o nejlepší ceně a skladovém množství při maximální době dodání do 48 hodin. Cena za kus bez daně v měně dodavatele (specifikována elementem Currency) TotalPriceCZK Cena za kus bez daně v CZK. ----TotalPriceIncDelivery dopravy v měně dodavatele 29

30 (specifikována elementem Currency). ----TotalPriceIncDeliveryCZK ----Currency ----StockAmount ----DeliveryTime ----DeliveryTimeTerm dopravy v CZK. Měna dodavatele, více viz kapitola Číselník měn. Skladová dostupnost tohoto produktu. Doba dodání v hodinách garantovaná dodavatelem. Hodnota 44 znamená 6 a více dní. Označuje hodinu, do které je nutné objednání u dodavatele provést, aby tento dobu dodání mohl garantovat. 0 ČÍSELNÍKY ČÍSELNÍK MĚN Aktuální verzi číselníku lze stáhnout na adrese CZK EUR PLN Česká koruna Euro Polský zlotý. ČÍSELNÍK SEZÓN PNEUMATIK Číselník vyjadřuje sezónu, pro kterou je daná pneumatika určena. Každá pneumatika je určena pouze pro jednu z těchto sezón. Summer Letní Winter Zimní AllSeason Celoroční 30

31 ČÍSELNÍK TYPŮ VOZŮ Typů vozů, pro které je pneumatika určena může být uloženo k jedné pneumatice více. Toto je realizováno sčítanou enumerací (OR maskou). Např. typ vozu 3 znamená, že pneumatika je určena pro osobní vozy a pro vozy 4x4 offroad. Hodnota Typ vozu 0 Neznámý Osobní + SUV 2 4x4, Offroad 4 Dodávkové 8 Nákladní 6 Motorkové 32 Ostatní 64 Zemědělské 28 Průmyslové APLIKACE PRO MANUÁLNÍ STAŽENÍ DAT Pro ruční stažení dat z EasyShop a pro podporu implementace komunikace lze využít jednoúčelovou aplikaci Easy Shop Download Utility, kterou lze spolu s manuálem stáhnout z adresy: Download.zip. TESTOVACÍ PROSTŘEDÍ Pro otestování Vaší implementace je možné využít testovací prostředí. Fungování veškerých funkcí je naprosto shodné s ostrou verzí, pouze dotazy neprovádíte na server ale na server Pro přihlášení do testovacího prostředí pak používáte speciální testovací licenci: Login: 0 Heslo: PartnerPa$$w0Rd 3