“CATALOG” – je zastaraný a plne nahradený naším novým feedom “HEUREKA”. Feed “KATALÓG” by mal partner používať iba v prípade, že spoločnosť už pracuje s feedmi zo starého CERVA B2B systému. Informačný kanál obsahuje všeobecné články s kódmi veľkostných variantov, farebných variantov a niekoľko materiálových atribútov.

 „EAN“ – treba prijať, ak zákazník môže použiť naše EAN kódy – zoznam merných jednotiek tovaru s prepočítaným pomerom na základnú mernú jednotku (MU) a EAN na MU. Podrobnosti-atribúty sú zoradené podľa všeobecného výrobku-variantu mernej jednotky výrobku:

<product code="01010004" title="JAY gloves combined"> #generic article

<variant code="0101000499090" title="JAY gloves combined yellow/blue -9"> #variant of the generic article

<unit baseUnit="PR" code="PR" denominator="1" eanCode="8591806196964" numerator="1"/>  #base measurement unit

<unit baseUnit="PR" code="DZ" denominator="1" eanCode="8591806066137" numerator="12"/> #alternative measurement unit

<unit baseUnit="PR" code="CTN" denominator="1" eanCode="8591806688162" numerator="120"/> #alternative measurement unit

</variant>

<variant code="0101000499100" title="JAY gloves combined yellow white 10"> #variant of the generic article

<unit baseUnit="PR" code="PR" denominator="1" eanCode="8591806162280" numerator="1"/>

<unit baseUnit="PR" code="DZ" denominator="1" eanCode="8591806649033" numerator="12"/>

<unit baseUnit="PR" code="CTN" denominator="1" eanCode="8591806649057" numerator="120"/>

</variant>

Otázka: Ktorá z MU je predajnou jednotkou?

Odpoveď: Predajnú jednotku nájdete vo feede Heureka v názve parametra MOQ – minimálne množstvo objednávky:

<PARAM>

<PARAM_NAME>MOQ</PARAM_NAME>

<VAL>1 BOX</VAL>

</PARAM>

Otázka: Kde môžeme získať minimálne objednávkové množstvo CERVA?

Odpoveď: Minimálne objednávkové množstvo nájdete vo feede Heureka v názve parametra MOQ – v prvku nájdete minimálnu hodnotu objednávky a predajnú jednotku:

<PARAM>

<PARAM_NAME>MOQ</PARAM_NAME>

<VAL>1 BOX</VAL>

</PARAM>

Otázka: Prečo na jednotlivých častiach výrobkov chýba EAN kód?

Odpoveď: CERVA používa vo väčšine prípadov EAN kód len na obaloch ako KA1 - kartón, BOX - krabica, PAK - balík, s ktorými manipulujeme v našom sklade. Vytiahnuté výrobky z kartónu väčšinou neoznačujeme.

 „DISPO“ – malo by byť prijaté, kde si zákazník môže skontrolovať skladové množstvo v CERVA. Dostupnosť je štruktúrovaná podľa variantu výrobku. Element „product“ obsahuje podprvky „code“ – kód variantu tovaru (farba +veľkosť), „generic“ – všeobecný kód tovaru (základ pre varianty), „title“ – popis tovaru, „totalDispo“ – dostupné množstvo lokálna zásoba do momentu výpočtu, „jednotka“ – merná jednotka množstva. Podprvok „detail“ obsahuje viac podrobností o sklade, napr. dostupnosť v centrálnom sklade a opäť v miestnom sklade s popisom. Podprvok „dátum“ – približný dátum najbližšej dostupnej dodávky tovaru, „dispo“ – dostupné množstvo, „miesto“ – popis skladu.

Otázka: Ako často sa počíta skladové množstvo?

Odpoveď: Skladové množstvo sa počíta raz denne a je pripravené na stiahnutie okolo 5:00 ráno.

Otázka: Mohli by sme od CERVA získať online kontrolu množstva zásob? Príjem zásob raz denne nestačí.

Odpoveď: Žiaľ, on-line kontrola nie je z technických príčin možná. Množstvo sa v systéme mení zo sekundy na sekundu. Naším plánom je spustiť druhý výpočet dostupnosti popoludní.

Otázka: Mohla by Cerva navrhnúť termín dodania, ak tovar nie je skladom?

Odpoveď: DISPO feed obsahuje v elemente “detail” podprvok “date”, ktorý predstavuje približný dátum najbližšej dodávky do centrálneho skladu v ČR. Dôležité - ak podprvok „dispo“ obsahuje hodnotu 0 (nula), fyzicky nie je nič na sklade a tovar je stále v dodávke. Pozrite si kód nižšie:

<product code="0101001399100" generic="01010013" title="TERN rukavice kombinované - 10" totalDispo="53647" unit="PR">

<detail dispo="0" site="bežný sklad"/>

<detail date="2023-02-22" dispo="53647" site="colný sklad"/>

</product>

Otázka: Existuje nejaká možnosť skontrolovať, kedy dostaneme zakúpený tovar, ktorý nie je skladom?

Odpoveď: Áno, všetky informácie týkajúce sa spätných objednávok je možné skontrolovať v CERVA B2B na konkrétnej obrazovke, ako aj približné dátumy dodania položiek. 

Otázka: Kedy môžeme prijať tovar, ak tovar nie je k dispozícii v miestnom sklade, ale stále k dispozícii v centrálnom sklade?

Odpoveď: Na to sa nedá odpovedať všeobecne. Veľmi záleží na miestnom sklade. Aj keď tovar nie je momentálne dostupný, môže si ho zákazník zakúpiť ako doobjednávku.

Otázka: Kúpili sme 3 PCE tovaru zo skladu, ale objednávka bola zaokrúhlená na 12 PCE, kde nájdeme dôvod, prečo sa tak stalo?

Odpoveď: Dostupné skladové množstvo je informácia o množstve, ktoré bolo vypočítané pri vytváraní feedu. Niektoré výrobky sa predávajú zaokrúhlené na základe interných pravidiel CERVA. Minimálne množstvo objednávky (faktor zaokrúhľovania) nájdete v feede Heureka, prvku MOQ a mernej jednotke predaja.

Nový feed “HEUREKA” – preferovaný feed, hlavná hodnota je variant generického článku. Informačný kanál obsahuje veľa atribútov variantov článku. Základom pre popis XML štruktúry a prvkov je formát Relax NG. Štruktúra feedu HEUREKA je jednoduchšia ako formát Relax NG. Všetky údaje z prvkov feedu Heureky mohli byť viditeľné na obrazovkách článkov B2B. V prípade otázok ohľadom štruktúry a obsahu feedu “HEUREKA” kontaktujte xmlfeeds@cerva.com

Otázka: Ako môžeme získať obrázky k článkom CERVA?

Odpoveď: V rámci Heureka feedu môžete nájsť prvky súvisiace s obrázkami <IMGURL> a <IMGURL_ALTERNATIVE>. Prvky obsahujú prepojenie na mediálny server CERVA, odkiaľ systém získava obrazové údaje.

Nový feed “PRICES” – feed obsahuje kód variantu tovaru v elemente <variant… pod elementom “kód”, odporúčaná konečná predajná cena v podprvku “cena” a “mena” spolu s cenou “jednotka”.

<product code="01010004" title="JAY rukavice kombinované">

<variant code="0101000499090" tiitle="Rukavice JAY v kombinácii žltá/modrá - 9" price="1,567" currency="EUR" unit="PR"/>

<variant code="0101000499100" tiitle="Rukavice JAY v kombinácii žltá biela 10" price="1,548" currency="EUR" unit="PR"/>

<variant code="0101000499110" tiitle="Rukavice JAY v kombinácii žltá červená -11" price="1,649" currency="EUR" unit="PR"/>

</product>

Otázka: Ako môžeme získať našu nákupno-distribútorskú cenu?

Odpoveď: V súčasnosti vieme navrhnúť len odporúčanú konečnú predajnú cenu. Ak je to možné, uplatnite zľavu svojho distribútora počas spracovania údajov o feede vo vašom systéme. Ďalšou možnosťou je aplikovať do svojho systému cenník CERVA XLS, ale to už môže byť zložitejšia úloha. 

Ako spojiť feedy medzi sebou? - Hlavným feedom je feed “HEUREKA” ( základné údaje a atribúty článku ) vedúcou a jedinečnou hodnotou je element <Item_ID> s kódom variantu článku CERVA. Rovnaký kód je ako jedinečná hodnota v prvku <product…> kód podprvku = … v rámci feedu “DISPO”.

Oba sú totožné s hodnotou prvku <variant..> kód podprvku = … v rámci feedu “EAN” a “CENY”. Pomocou kódu variantu článku je možné dáta prepojiť.

Otázka: Môžeme použiť katalóg informačných kanálov ako hlavný zdroj údajov o článku?

Odpoveď: Neodporúčame v budúcnosti používať zastaraný feed “KATALÓG”, pretože je nahradený novým feedom “HEUREKA”, ktorý obsahuje viac informácií a môže byť v budúcnosti rozšírený o nové atribúty.

Otázka: Pre nás je dôležitý len feed “DISPO”, je potrebné spracovávať aj ostatné feedy?

Odpoveď: Ak je váš systém naplnený údajmi o tovare iným spôsobom (napr. manuálne), nie je potrebné preberať iné kanály ako „DISPO“.

Prerequisites -  the CERVA B2B  onboarding process  have  to be completed. At least one user (e-mail address) is assigned to a CERVA B2B user. For communication purposes it is recommended create a specific CERVA B2B user with limited authorization (w/o possibility create the orders).

API description – all details about connecting to the CERVA B2B  API are described in the attached file CERVA_XML_API.pdf .    Replace   “PartnerID”  with  the  CERVA customer  SAP  ID ( it can be found on the customer invoice under the customer address data nearby the text “Customer:” ). Please follow the steps described in the API document. The most important is to get authorization token. The token will be applied in all the request for the feeds.    

Question: We are not able to get the token, we receive an error “Error: Invalid character in header content ["pm-o0"]” or another error “Cloud Agent Error: Unable to reach the Cloud Agent. Try later or select a different agent.”.

Answer: This is  known behavior.  Please call the request repeatedly, if the system is busy, we need approximately 3 calls to get the token.

Question: Why is procedure to get the data so complex? In the old B2B system there was  one link to each file and very simple authorization. 

Answer: In the new CERVA B2B system are data customer specific and also the data authorization is more sophisticated. To assign  the correct list of the  articles  we need to recognize the  customer/user who is requesting the data.

Question: The feed files are huge, can we get only new articles or changes?  

Answer: In this time we can offer only full sets of data.

Question: When the feeds are created? Can we get the fresh data during the day?  

Answer:  Data are created only once a day. The data files are ready for loading  around 05:00  a.m. . It does not  make sense load the data more times during the day.