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:
-
- 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).
- 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.