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

API – interfész az adatfájlok (letöltések) letöltéséhez:

    1. Előfeltételek – a CERVA B2B bejelentkezési folyamatot be kell fejezni. Legalább egy felhasználó (e-mail cím) hozzá van rendelve egy CERVA B2B felhasználóhoz. Kommunikációs célból javasolt egy meghatározott CERVA B2B felhasználó létrehozása korlátozott jogosultsággal (a rendelések létrehozásának lehetősége nélkül).
    2. API leírása – a CERVA B2B API-hoz való csatlakozás minden részlete megtalálható a csatolt CERVA_XML_API.PDF fájlban. Cserélje ki a „PartnerID”-t a CERVA ügyfél SAP azonosítójával (az ügyfélszámlán az „Ügyfél:” szöveg mellett, az ügyfél címe alatt található). Kérjük, kövesse az API dokumentumban leírt lépéseket. A legfontosabb az engedélyezési token beszerzése. A tokent minden letöltési kérelemben alkalmazzák. 

 

 

Kérdés: Nem tudjuk beszerezni a tokent, „Hiba: Érvénytelen karakter a fejléctartalomban ["pm-o0"]” vagy más hibaüzenetet kapunk: „Cloud Agent hiba: Nem érhető el a Cloud Agent. Próbálkozzon később, vagy válasszon másik ügynököt.”

Válasz: Ez ismert viselkedés. Kérjük, hívja többször a kérést, ha a rendszer foglalt, körülbelül 3 hívásra van szükségünk a token megszerzéséhez.

 

Kérdés: Miért olyan bonyolult az adatok beszerzésének eljárása? A régi B2B rendszerben minden fájlhoz egy hivatkozás volt és nagyon egyszerű engedélyezés.

Válasz: Az új CERVA B2B rendszerben az adatok ügyfélspecifikusak és az adatjogosultság is kifinomultabb. A cikkek helyes listájának hozzárendeléséhez fel kell ismernünk az adatokat kérő vásárlót/felhasználót.

 

Kérdés: A letöltött fájlok hatalmasak, csak új cikkeket vagy módosításokat kaphatunk?

Válasz: Ez idő alatt csak teljes adatkészletet tudunk kínálni.

 

Kérdés: Mikor jönnek létre a letöltések? Napközben is megkaphatjuk a friss adatokat?

Válasz: Az adatok naponta csak egyszer jönnek létre. Az adatfájlok minden reggel 05:00 körül készen állnak a betöltésre. Nincs értelme többször betölteni az adatokat a nap folyamán.

Nincs mivel összehasonlítani.