API információk XML letöltéshez

Kedves Partnerünk!

ez az e-mail nagyon fontos információk gyűjteménye olyan ügyfelek e-mailjeiből (és hívásaiból), akik elkezdték a letöltéseket az új CERVA B2B rendszerből.

Először is az API-kommunikációhoz szükséges legfontosabb tudnivalók: PartnerID, ez egy hatjegyű szám, megtalálható a számlán vagy az ügyfélszolgálatunk segítségével.

A „DISPO”, „EAN”, „CATALOG” letöltések nagyon hasonlóak a régi verziókhoz.

A „HEUREKA”, „PRICES” letöltések az új B2B rendszerünkben készültek. Minden letöltés strukturált XML szövegfájl.

CATALOG

CATALOG” – elavult, és teljes egészében az új letöltésünk „HEUREKA” váltotta fel. A „KATALÓGUS” letöltést csak akkor érdemes tovább használni, ha a cég már dolgozik a régi CERVA B2B rendszerből származó letöltésekkel. A letöltés általános cikkeket tartalmaz a méretváltozatok és színváltozatok kódjaival, valamint számos anyagjellemzővel.

EAN

EAN” – akkor kell elfogadni, ha használod az EAN kódjainkat – a cikk mértékegységeinek listája az alapmértékegységhez (ME) és az EAN-hoz ME-hez viszonyított újraszámítási aránnyal. A részletek-attribútumok a cikk-mérési egység általános cikkváltozata szerint vannak rendezve:

<productcode="01010004"title="JAYglovescombined">“genericarticle”

<variant code="0101000499090"title="JAYglovescombinedyellow/blue-9">“variantofthegenericarticle”

<unitbaseUnit="PR"code="PR"denominator="1"eanCode="8591806196964"numerator="1"/>“basemeasurementunit”

<unitbaseUnit="PR"code="DZ"denominator="1"eanCode="8591806066137"numerator="12"/>“alternativemeasurementunit”

<unitbaseUnit="PR"code="CTN"denominator="1"eanCode="8591806688162"numerator="120"/>“alternativemeasurementunit”

</variant>

<variant code="0101000499100"title="JAYglovescombinedyellowwhite10">“variantofthegenericarticle”

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

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

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

</variant>

 

Kérdés: Az ME közül melyik az értékesítési egység?

Válasz: Az értékesítési egység megtalálható a Heureka letöltésében MOQ paraméter néven – minimális rendelési mennyiség:

<PARAM>

<PARAM_NAME>MOQ</PARAM_NAME>

<VAL>1 BOX</VAL>

</PARAM>

 

 

Kérdés: Hol kaphatunk Cerva rendelési mennyiséget?

Válasz: Minimális rendelési mennyiség megtalálható a Heureka letöltésében MOQ paraméter néven – az elemen belül a minimális rendelési érték és az értékesítési egység található:

<PARAM>

<PARAM_NAME>MOQ</PARAM_NAME>

<VAL>1BOX</VAL>

</PARAM>

 

Kérdés: Miért hiányzik az EAN-kód a cikk egyes részeiről?

Válasz: A legtöbb esetben a CERVA csak az EAN kódot használja a raktárunkban kezelt csomagoláson, mint a KA1 - karton, BOX - doboz, PAK - csomag. A kartonból kivetteket többnyire nem jelöljük meg.

DISPO

DISPO” - akkor kell letölteni, amikor a készlet mennyiségét ellenőrzöd a CERVA-nál. A rendelkezésre állást a cikk változata strukturálja. A „product” elem a „code” alelemeket tartalmazza – a cikkváltozat kódja (szín + méret), „generic” – általános cikkkód (a változatok alapja), „title” – cikkleírás, „totalDispo” - elérhető mennyiség helyi készlet a számítás pillanatáig, „egység” – a mennyiség mértékegysége. A „detail” alelem további részleteket tartalmaz a készletről, pl. elérhetőség a központi raktárban és ismét a helyi raktárban a leírással. „dátum” alelem – az áru következő elérhető szállításának hozzávetőleges dátuma, „dispo” – elérhető mennyiség, „telephely” – a raktár leírása.

 

Kérdés: Milyen gyakran számítják ki a készletértéket?

Válasz: A készlet mennyiségét naponta egyszer számítjuk ki, és hajnali 5:00 körül készen áll a letöltésre.

 

Kérdés: Kaphatna-e a CERVA online raktárkészlet-ellenőrzést? Kapja meg az állomány naponta egyszer nem elég.

Válasz: Sajnos az online ellenőrzés technikai okok miatt nem lehetséges. A mennyiség másodpercről másodpercre változik a rendszerben. Terveink szerint délután elkezdjük a második rendelkezésre állás számítást.

 

 

Kérdés: Tudna-e a Cerva javasolni a szállítás dátumát, ha az áru nincs raktáron?

Válasz: A DISPO letöltés a „detail” elemben a „dátum” alelemet tartalmazza, amely a következő csehországi központi raktárba történő szállítás hozzávetőleges dátumát jelenti. Fontos: ha a „dispo” alelem 0 (nulla) értéket tartalmaz, akkor fizikailag nincs raktáron semmi, és az áru még szállítás alatt áll. Lásd az alábbi kódot:

<product code="0101001399100"generic="01010013"title="TERNglovescombined-10"totalDispo="53647"unit="PR">

<detaildispo="0"site="regularwarehouse"/>

<detaildate="2023-02-22"dispo="53647"site="customswarehouse"/>

</product>

 

Kérdés: Van-e lehetőség ellenőrizni, ha olyan vásárolt árut kapunk, amely nincs raktáron?

Válasz: Igen, a CERVA B2B adott képernyőjén minden visszamenőleges rendelésre vonatkozó információ megtekinthető, a tételek szállításának hozzávetőleges dátumai is.

 

Kérdés: Mikor tudjuk átvenni az árut, ha az áru nem elérhető a helyi raktárban, de a központi raktárban még elérhető?

Válasz: Erre általánosságban nem lehet válaszolni. Valóban a helyi raktártól függ. Ha az áru pillanatnyilag nem áll rendelkezésre, azt a vevő utólagos rendelésként megvásárolhatja.

 

Kérdés: 3 db terméket rendeltünk raktárról, de a rendelést 12 db-ra kerekítették, mi ennek az oka?

Válasz: A rendelkezésre álló készletmennyiség a letöltés létrehozásakor számított mennyiségre vonatkozó információ. Egyes cikkeket a CERVA belső szabályzata alapján kerekített mennyiségben értékesítenek. A minimális rendelési mennyiség (kerekítési tényező) megtalálható a letöltés Heureka, MOQ elem és értékesítési mértékegységben.

HEUREKA

Új letöltés „HEUREKA” – előnyben részesített letöltés, a fő érték az általános cikk változata. A letöltés sok cikkváltozat attribútumot tartalmaz. Az XML szerkezet és elemleírás alapja a Relax NG formátum. A HEUREKA letöltés felépítése egyszerűbb, mint a Relax NG formátum. A Heureka letöltési elemeinek összes adata látható volt a B2B cikkek képernyőjén. Ha kérdése van a „HEUREKA” letöltési szerkezettel és tartalommal kapcsolatban, kérjük, írjon az xmlfeeds@cerva.com címre. Ezzel az e-mail címmel a kommunikáció csak angol nyelven lehetséges.

 

Kérdés: Hogyan szerezhetünk képeket a CERVA cikkeiről?

Válasz: A Heureka letöltésen belül képekkel kapcsolatos elemeket találsz <IMGURL> and <IMGURL_ALTERNATIVE>. Az elemek tartalmaznak egy hivatkozást a CERVA médiaszerverre, ahonnan a rendszer lekéri a képadatokat.

PRICES

Új letöltés „PRICES” – a letöltés a cikkváltozat kódját tartalmazza a <variant… alelem “code”, az ajánlott végső eladási árat a „price” alelemben és a „valuta” az „egység” ár mellett.

<product code="01010004"title="JAYglovescombined">

<variantcode="0101000499090"tiitle="JAYglovescombinedyellow/blue-9"price="1.567"currency="EUR"unit="PR"/>

<variantcode="0101000499100"tiitle="JAYglovescombinedyellowwhite10"price="1.548"currency="EUR"unit="PR"/>

<variantcode="0101000499110"tiitle="JAYglovescombinedyellowred-11"price="1.649"currency="EUR"unit="PR"/>

</product>

 

Kérdés: Hogyan kaphatjuk meg a beszerzési-forgalmazói árunkat?

Válasz: Jelenleg csak ajánlott végső eladási árat tudsz letölteni. Lehetőség szerint a rendszeren belüli letöltési adatfeldolgozás során alkalmazd a forgalmazói kedvezményed! Beszerzési árakért hívd az ügyfélszolgálatunkat!

Hogyan kapcsoljuk össze a letöltéseket

Hogyan kapcsoljuk össze a letöltéseket? - A fő letöltés a „HEUREKA” (cikk alapadatok és attribútumok) letöltése, vezető és egyedi érték elem <Item_ID> CERVA cikkváltozat kóddal. Ugyanez a kód egyedi értékként szerepel az elemben <product…>  sub element  code = … a “DISPO” letöltésben.  Mindkettő azonos az elem értékével <variant..> alelem kód = az „EAN” és az „ÁRAK” alatt. A cikkváltozat kódjával az adatok összekapcsolhatók.

 

Kérdés: Használhatjuk a letöltési katalógust a cikkadatok fő forrásaként?

Válasz: Nem javasoljuk az elavult „KATALÓGUS” letöltés használatát a jövőben, mivel azt az új „HEUREKA” letöltés váltja fel, amely több információt tartalmaz, és a jövőben új attribútumokkal bővíthető.

 

Kérdés: Számunkra csak a „DISPO” letöltés a fontos, a többi letöltés feldolgozása szükséges?

Válasz: Ha a rendszere más módon (például manuálisan) van feltöltve cikkadatokkal, nem szükséges a „DISPO”-n kívül más letöltéseket elfogadni.

API

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.

Nincs mivel összehasonlítani.