V následujícím článku si podrobně ukážeme doporučený způsob, jak napojit jednotlivé toky dat v rámci API napojení Vaší společnosti.
Tesztkörnyezet: A teszteléshez és a valós értékesítéshez csak egy környezet van, a termelési környezet. A regisztráció után kapott API-kulcs ezért megváltoztathatatlan és végleges. Ennek ellenére a kapcsolat először tesztelhető. A fiókja csak tesztüzemmódban van, amíg nem aktiválódik. Ajánlatának végleges megjelenítése a weboldalon azonban csak az onboarding részleg jóváhagyása után történik meg, további információkért forduljon az onboarding szakemberéhez.
Nagyon fontos, hogy kövesse az alábbi ajánlásokat. Az ajánlott gyakorlatok be nem tartásának hatása a MALL rendszer terhelését tekintve korlátozó lehet a vállalat API-hívásainak működésére. Ezt szem előtt tartva a MALL sebességkorlátozó működik a platformon belül, tudjon meg többet róla a itt cikkben. A hibás API-implementációból és a sebességhatár túllépéséből eredő SLA-túllépésekért a partner a felelős.
Berte prosím v potaz, že API MALL má povahu zdroje informací v moment jejich potřeby, nejedná se o databázi, která by sloužila k uchovávání historizovaných dat. API volání této povahy mohou být omezena.
Pro autorizaci všech API volání v rámci napojení na MALL využíváte client ID, neboli „API klíč“. API klíč má kombinaci znaků, které jsou unikátní pro každý účet a je potřeba jej přiložit ke každému jednotlivému API volání. Pokud máte na MALL více účtů, pro každý účet bude klíč unikátní. API klíč naleznete v MALL Partner portálu v sekci „Firemní profil“ na kartě „Informace“.
Tartalomjegyzék
Megrendelések
A sorrendi végpontokkal összefüggésben fontos, hogy különös figyelmet fordítsunk a lépések sorrendjére. Ez két alapvető lehetőségre bomlik attól függően, hogy a webhook segítségével kapunk-e információt a megbízások változásáról. A webhookról itt olvashat bővebben.
Ebben a cikkben megtanulhatja, hogyan kell megfelelően kötni az egyes módszereket és váltani az egyes állapotokat az API-n belül.Javasoljuk továbbá, hogy olvassa el azt a cikket, amely részletesen elmagyarázza az egyedi állapotokat, amelyeket egy megrendelés felvehet és mit jelentenek honnan.
Berte prosím zároveň v potaz, že pokud využíváte služeb MALL Delivery, proces se v rámci vychystávání zásilky a aktualizace stavů v pozdějších krocích odlišuje.
Fontos: A rendelési státuszok frissítését csak a rendelések változása esetén kell elküldeni. Ugyanazon információk ismételt elküldése rendkívül nem kívánatos és megterhelő a platform számára.
Posloupnost objednávkových volání s využitím webhooku
Nejprve je třeba zapnout webhook a vložit vámi připravenou URL do příslušné záložky v partnerském portálu v nabídce Partner, v logu pak vidíte jednotlivé odchozí notifikace.
1. A webhook értesítést fog kapni a megváltozott rendelésszámmal.
2. Kérjük, hívja a Megrendelés részletei a Blokkolt státuszú megrendelések esetében, hogy lefoglalhassa a tételeket. Ezek olyan megrendelések, amelyekről az első értesítést kapta. Csak az áruról kap információt. Csak a NYITVA státuszú megrendelésekhez kap pénzügyi információkat. A foglalás nem kötelező, de erősen ajánlott a nagy forgalmú és a kifogyás kockázatával járó tételek esetében.
3. Ön webhook értesítést kap azokról a megrendelésekről, amelyek NYITVA vagy FÜGGETLEN vagy FÜGGETLEN állapotba kerültek.
4. Hívja fel a Update order a confirmed=true kapcsolóval a OPEN vagy CANCELLED megrendelésekhez, amelyek a webhook információi szerint megváltoztak. Lehetőség van a státusz megváltoztatására BEZÁRVA-ról NYITVA vagy FELSZÁLLÍTVA-ra (ez a végleges státusz, és a megbízás nem nyitható meg újra).
5. Hívja fel a Megrendelés részletei a 4. lépésből származó megrendelésekre, Megszüntetett megrendelések esetén törölje a foglalást. NYILVÁNT megrendelések esetén használja a visszaigazolt megrendelésekre vonatkozó hívást a végleges adatok rendszerbe történő importálásához. Ezen a ponton már nem lehet semmilyen oldalról beavatkozni a megrendelésbe, így minden információ, például a cím és az utánvét összege ezen a ponton végleges.
6. Hívja Megrendelés frissítése a megrendelések NYITVA státuszból SZÁLLÍTÁS státuszba minden olyan megrendelés esetében, amelynek szállítási folyamatát elindította. Ha megállapította, hogy a megrendelés nem lesz szállítható, akkor ezen a ponton módosíthatja a megrendelést Megszüntetett státuszra.
7a. A MALL Delivery használata esetén hívja fel a A kijelölt MDP-megrendelésekhez tartozó címkék generálása a MALL Delivery-megrendelésekhez tartozó címkék nyomtatásához.
7b. Ha nem használja a MALL Delivery szolgáltatást, akkor meg kell felelnie a fuvarozó által meghatározott szállítási követelményeknek.
8. A szállítmány átadása a szállítmányozó cégnek.
9a. A MALL Delivery használata esetén hívja Megrendelés frissítése a megrendelés státuszának SZÁLLÍTÁS-ról SZÁLLÍTOTT-ra történő módosításához (a SZÁLLÍTOTT-ra történő módosításnak mindig a küldeménynek a szállító cégnek történő átadása után kell megtörténnie).
9b. Ha nem használja a MALL Delivery szolgáltatást, kérjük, hívja fel a Megrendelés frissítése megrendeléseket SZÁLLÍTÁS-ról SZÁLLÍTÁS-ra, a nyomon követési URL és a fuvarozó szállítási száma feltüntetésével. Minden információt egy hívásban kell elküldeni, hogy megfeleljen a szolgáltatásminőség - nyomon követési arány kritériumainak.
Választható: A MALL Delivery használata esetén a RENDELÉS ADATAI a ÁLLÍTOTT/visszavett/elhagyott státuszú megrendelések esetében a megrendelés változásáról szóló webhook értesítés alapján hívhatja meg a RENDELÉS ADATAI, hogy véglegesítse a végleges megrendelési státuszt a rendszerében.
10. Ha nem használja a MALL DELIVERERY-t, kérjük, hívja fel a Megrendelés frissítése-t SZÁLLÍTOTTÁ-ról SZÁLLÍTOTTÁ-ra, a pontos szállítási dátummal a fuvarozótól kapott információk alapján. Ha van információja a fuvarozójától az első kézbesítési kísérletről, ezt is hozzáadhatja, ez az információ nem kötelező. A frissítést egy hívással kell elküldeni. Ha a rendelés nem sikerült kézbesíteni, és visszaküldték a szállítmányozónak, módosítsa a rendelés státuszát SZÁLLÍTOTT helyett RETURNÁLT-ra.
SLA és ügyfélélmény: A megrendelések összekapcsolásának mindkét formája esetében kívánatos és egyben végső SLA az ügyfél felé, hogy a megrendelés állapotának elküldése a valóságon alapuljon és a lehető legfrissebb legyen. A státuszüzenetek helytelen végrehajtása negatív ügyfélélményhez és rendeléslemondásokhoz vezethet.
Posloupnost objednávkových volání bez využití webhooku
1. Kérjük, hívja fel a A meg nem erősített megrendelések listájának lekérdezése rendszeres gyakorisággal, javasoljuk, hogy a gyakoriságot az átlagos megrendelések számához igazítsa. Csak akkor lépje túl az óránkénti 1x gyakoriságot, ha naponta több mint 100 megrendelés érkezik. Híváskor használja a filter=basic beállítást.
2. A A meg nem erősített rendelések listája alapon válassza a Beszerezd a rendelés részleteit a BEZÁRVA státuszú rendelések esetében a tétel lefoglalásához. Csak termékinformációkat kaphat. Csak a NYITVA státuszban lévő megrendelések esetében kapjon pénzügyi információkat. A foglalás nem kötelező, de erősen ajánlott a nagy forgalmú és a kifogyás kockázatával járó tételek esetében.
3. Hívja meg a Megrendelés frissítése hívást megerősítve = true a rendszer által a hívásban regisztrált NYITOTT/strong>/MARADÓ megrendelések esetében.
4. Hívja fel a Megrendelés részleteinek lekérdezése a NYITVA megerősített megrendeléseknél a végleges adatok rendszerbe történő importálásához. Ezen a ponton már nem lehet semmilyen oldalról beavatkozni a megrendelésbe, így minden információ, például a cím és az utánvét összege ezen a ponton végleges.
5. Hívja fel a Megrendelés frissítése megrendeléseket a NYITVA státuszból SZÁLLÍTÁS státuszba minden olyan megrendelés esetében, amelynek szállítási folyamatát elindította. Ha megállapította, hogy a megrendelés nem lesz szállítható, akkor ezen a ponton módosíthatja a megrendelést Megszüntetett státuszra.
6a. A MALL Delivery használata esetén hívja fel a A kiválasztott MDP-megrendelésekhez tartozó címkék generálása a MALL Delivery-megrendelésekhez tartozó címkék nyomtatásához.
6b. Ha nem használja a MALL Delivery szolgáltatást, akkor meg kell felelnie a fuvarozó által meghatározott szállítási követelményeknek.
Javaslat: Javasoljuk, hogy ellenőrizze a rendelés státuszát, mielőtt elküldi azt. SZÁLLÍTÁS státuszban a megrendelést a megrendelő lemondhatja. Az ilyen megrendelést ekkor a rendszer Megszüntetett státuszra módosítja. Ez a változás ezután szintén megjelenik a A vissza nem erősített rendelések listájának lekérdezése listában, és a 3. lépésen keresztül kell megerősíteni.
7. A szállítmány átadása a szállítmányozó cégnek.
8a. MALL Delivery használata esetén kérjük, hívja fel a Beszerzés frissítése, hogy a megrendelés státuszát SZÁLLÍTÁS-ról SZÁLLÍTOTT-ra változtassa (a SZÁLLÍTOTT-ra történő változtatást mindig a küldeménynek a szállító cégnek történő átadása után kell elvégezni).
8b. Ha nem használja a MALL Delivery szolgáltatást, kérjük, hívja fel a Megrendelés frissítése a SZÁLLÍTÁS-tól SZÁLLÍTÁS-ig terjedő megrendelések esetében, beleértve a nyomon követési URL-t és a fuvarozó szállítási számát. Minden információt egy hívásban kell elküldeni, hogy megfeleljen a Szolgáltatásminőség - Nyomonkövetési arány kritériumainak.
Választható: A MALL Delivery használata esetén használhatja a Beállítások listája státusz szerint hívást a Átadott/visszaadott/elhagyott megrendelések időszűrőjének használatával a végleges megrendelés státuszának rendszerbe történő behívásához.
9. Ha nem használja a MALL Delivery szolgáltatást, kérjük, hívja fel a Megrendelés frissítése-t SZÁLLÍTOTTÁ-ról SZÁLLÍTOTTÁ-ra SZÁLLÍTOTTÁ a pontos szállítási dátummal a szállítótól kapott információk alapján. Ha van információja a fuvarozójától az első kézbesítési kísérletről, ezt is hozzáadhatja, ez az információ nem kötelező. A frissítést egy hívással kell elküldeni. Ha a rendelés nem sikerült kézbesíteni, és visszaküldték a szállítmányozónak, módosítsa a rendelés státuszát SZÁLLÍTOTT helyett RETURNÁLT-ra.
Háttéradatok érvényesítés: Ha van olyan eset, amikor vissza kell szereznie a rendelési adatokat, mindig hívja meg az egyes rendeléseket, amelyek adataira szüksége van. Ha mégis vissza kell hívnia a rendeléslistát, használjon időszak-szűrőket, és kerülje a teljes rendeléstörténet egyszerre történő meghívását. A MALL önszámlázás használata esetén számlázási és elszámolási célokra használja a megfelelő végpontokat.
Termékek
A termékek esetében kétféle hívástípusra kell összpontosítani, a termékek beállítására és frissítésére.
Termékek és változatok beállítása
A termékek bevezetésekor kérjük, mindig vegye figyelembe a termék tartalmára vonatkozó feltételeket, a részletekért kérjük, tekintse meg a itt. Ezután gondosan tanulmányozza át az itt cikkben az egyes kategóriák termékmegjelenítési feltételeit, hogy elkerülje a későbbi termékkorrekciók szükségességét egy újabb híváson keresztül.
Fontos: Ha a termékeknek vannak variánsai, mindig hozzon létre variáns termékeket a kategóriában rendelkezésre álló paraméterek alapján. A variáns termékek egyedi listázásokként történő beküldése nem kívánatos, és az ajánlat eltávolításához vezethet az oldalról.
Új termékek létrehozása változat nélkül a Új termék létrehozása hívással, ha ez a hívás sikertelen, készítettünk egy cikket, amelyben elmagyarázzuk a hibákat, valamint azt, hogyan lehet megelőzni és kijavítani azokat. A cikket a itt linken találja. A hívásszerkezet kötelező, kivéve azokat az elemeket, ahol a dokumentáció kifejezetten ezt mondja. Az így létrehozott termék ezután megtalálható a portál terméklistájában és a weben is a terméklistában, a sandbox fiók segítségével megtekinthető.
A változatos termékek esetében először a Új termék létrehozása módszerrel hozzon létre egy törzsterméket. Ezután a Új változat létrehozása módszerrel hozzáadhat változatokat ehhez a termékhez. A variánsokat a variáns paraméterek segítségével kell megkülönböztetni. Az adott kategóriában rendelkezésre álló paraméterek közül legfeljebb kettőt használhat. A fő termékhez rendelt változatok ezután mindig a termék részletezésében jelennek meg, a megfelelő paraméterrel együtt, amelyet a vásárló választható változóként használhat.
Az termékek esetében a prioritásnál írja be az 1 értéket. A rendszer automatikusan rangsorolja a termékeket egy algoritmus segítségével, amely a termék kattintásainak száma, forgalma és eladásai alapján működik.
Ez egy elavult elem, amelyet még mindig ki kell tölteni, de egyáltalán nem veszi figyelembe. Jelenleg azon dolgozunk, hogy eltávolítsuk.
A termékek esetében fontos a EAN (GTIN) feltüntetése, ennek pontosan meghatározott formája van - 13 numerikus karakter. Az EAN-nek döntő befolyása van a Google Ads, a Heureka és a Zboží.cz oldalakon történő termékmegfeleltetésre, és ezáltal arra, hogy sokkal több vásárlót érjen el termékeivel.
Ha az EAN 14 numerikus karakterből áll, akkor 13 számjegyként adja meg, 0 nélkül az elején. Ha rövidebb, 8 számjegyű EAN-je van, akkor annyi 0-t adjon az elejére, ahány hiányzó 13 karakter van (5).
Termékfrissítések
A termékek esetében a frissítést több típusra osztjuk.
- Termékadatok frissítése (leírások, képek, paraméterek,...)
- Árfrissítés
- Elérhetőségi frissítések
Fontos: A termékfrissítéseket csak akkor küldje el, ha változások történtek. Ugyanazon információk ismételt elküldése rendkívül nem kívánatos és megterhelő a platform számára.
Termékadatok frissítése
A termékadatok frissítésekor használja a megfelelő UPDATE módszert a invariáns termék vagy a variáns esetében. Csak akkor változtassa meg az adatokat, ha megváltoztatja azokat, vagy ha hozzá kell adnia. Bármilyen termékfrissítéskor mindig az összes elemet küldje el, ne csak azokat, amelyek megváltoztak.
Árfrissítés
Az ár frissítéséhez ne használja a fent leírt termék- vagy változatfrissítési módszert. Az ár módosításához külön hívás áll rendelkezésre a módosítás elküldéséhez mind a nemváltozatos termék, mind a változatok esetében. Az ár 30%-nél nagyobb mértékű frissítése esetén az árváltozást force tokennel kell megerősíteni. További információkat erről a funkcióról a dokumentációnkban itt talál.
Elérhetőségi frissítések
A rendelkezésre állás frissítéséhez ne használja a fent leírt termék- vagy változatfrissítési módszert. A rendelkezésre állás módosításához használja a termék/variáns rendelkezésre állás tömeges módosításának módszerét a Batchfrissítés a termék/variáns rendelkezésre állás segítségével. Kérjük, használja ezt a frissítési lehetőséget, amennyire csak lehetséges, egyszerre akár 1000 termék/variáns frissítése is lehetséges tömeges frissítéssel.
Végül, ha az egységnyi darabszámban van szükség változtatásra, a módszer segítségével frissíthető a termék vagy változatok készletelérhetősége.
Adatok visszahitelesítése: Ha van olyan eset, amikor a termékadatok visszahitelesítésére van szükség, csak akkor hívja meg őket, ha szükséges, és csak a megfelelő végponton keresztül az ár vagy a rendelkezésre állás tekintetében. A termékadatok rendszeres tömeges vagy egyedi hívása rendkívül nem kívánatos és megterhelő a rendszerünk számára, és a MALL-lal való kapcsolatának korlátozásához vezethet.
Batch (ömlesztett) végpontok
V rámci API MALL je možné některé akce provádět hromadnými změnami. Využitím batch endpointů výrazně snížíte využívání vašeho limitu API volání v rámci rate limiteru a tak je doporučeno využívat tyto v maximální možné míře.
A rendelkezésre álló kötegelt végpontok a következők:
- Batch availability update - A fentiekben a rendelkezésre állás frissítésénél leírtak szerint ez a termék- és variáns rendelkezésre állás tömeges frissítése. Ez a módszer lehetővé teszi, hogy egyetlen hívással akár 1000 módosítást is frissítsen.
- aktív kiválasztott termékek - A kiválasztott termékek tömeges módosítása tervezetből élőre.
- Termékek aktiválása - Az összes termék tömeges módosítása a tervezetből élőre.
A termékek deaktiválása és törlése
Pro stažení produktu z webu je možné využít několik metod, které závisí na důvodu potřeby stažení produktu.
- Készleten nem lévő termék, amelyet újra feltöltenek - ebben az esetben a termék elérhetőségének frissítésekor elegendő a termék készleten lévő mennyiségét "0"-ra csökkenteni, ezután nem lehet megvásárolni az oldalon, a vásárlók még láthatják, hogy a termék egy ideig újra megjelenik-e a kínálatban.
- A termék weboldalról való letöltésének ideiglenes szükségessége - a termék elérhetőségének frissítésén keresztül ismét lehetőség van a státusz mező használatára, ahol az "N" érték beállításával a termék vagy változat "inaktívvá" válik.
- Termék törlése - ha tudja, hogy egy termék vagy variáns több mint 2 hónapig nem lesz készleten, javasoljuk, hogy törölje a terméket vagy variánst a megfelelő végponton keresztül. A MALL historizált értékesítési adatokat tart fenn a termékeihez, ha ezután feltölt egy terméket ugyanazon azonosító alatt, az értékesítési adatok ismét párosításra kerülnek.
Fontos: Ne frissítsen semmilyen inaktív terméket. Az inaktív termékekhez történő ismételt frissítések küldése rendkívül nem kívánatos és megterhelő a platform számára. A határérték túllépésekor a rendszer túlterhelté válhat a csak részleges adatátvétel miatt, ami negatív ügyfélélményt és potenciális veszteséget is eredményezhet a partner oldalán.
Kategória
Az API-n belül két alapvető végpontot használhat a kategóriaadatok lekérdezéséhez. Az elsőben Kategóriafa ország szerint megkapja az adott országhoz rendelkezésre álló kategóriafát. Ha a hívás URL-címében megváltoztatja az országkódot, akkor ugyanazzal az API-kulccsal más országok kategóriafa-információit is lekérheti.
Az API-hívás eredménye mindig néhány olyan adat, amely az integrációhoz elengedhetetlen.
- menüpont azonosítója (=“menuItemId“) – unikátní kód kategorie jehož použitím můžete voláním Kategória részletezése az összes paraméter és értékek listáját, a hívás az alábbiakban ismertetésre kerül.
- Terméktípus azonosító (=“productTypeId“) – technický kód kategorie potřebný pro zařazení produktu, tento kód se může shodovat napříč více menuitemID.
- Menü korlátozások (=“menuCosntraints“) – povinné parametry s hodnotami potřebné k zařazení produktů do dané menuitemID, pro detail o podmínkách kategoriích prosím pročtěte detailní článek itt.
Webmegjelenítés érvényesítés: A rendszerbe feltöltött olyan termék, amely nem felel meg a Menü korlátozásoknak, megjelenítési hibát mutathat, és a vásárlók nem tudják megvásárolni.
A Kategóriák részletei API-híváson keresztül ezután megkapja az adatok listáját. Az első rész a kategória megjelenítési feltételei.
- SAP ID (=“sapId“) – technický kód kategorie, jedná se o tentýž kód, který byl v předchozím volání uveden jako Terméktípus azonosító, ez a termék besorolásához szükséges műszaki kategóriakód.
- Kategória Feltételek (=“categoryConditions“) – zde najdete tytéž údaje jako v Menü korlátozások v předchozím volání. Pro zařazení produktu do jakékoliv kategorie je vždy třeba tyto podmínky bezchybně zadat.
Webes megjelenítés érvényesítés: A rendszerbe feltöltött olyan termék, amely nem felel meg a Kategóriafeltételeknek, megjelenítési hibát mutathat, és a vásárlók nem tudják megvásárolni.
- Egyéb paraméterek (=“otherParameters“): Zde najdete všechny další parametry s hodnotami, které je možné využít a přidat k vašim produktům. U parametrů je vždy třeba využívat seznamu hodnot, který zde naleznete, zadávání vlastních hodnot do parametrů není možné. Název parametrů vždy přidávejte k produktu v technických názvech, pole "érték". Hodnoty vždy uvádějte v názvu cílové země prodeje, tj. hodnoty z pole "text". V případě numerických hodnot vždy vycházejte z jednotky uvedené v poli "egység". Pokud daný parametr neobsahuje hodnoty, které potřebujete, zašlete nám žádost skrze Súgóközpontban (Help Center).
Címkék
A Minden márka hívással az összes országban elérhető márkák teljes listáját kaphatja meg. A lista nem országspecifikus, így a MALL Partner bármelyik piacához csatlakozhat vele. A termékekhez mindig adja hozzá a "brand_id" mezőt, 100% megfeleltetésben, a nagybetűket is beleértve.
A címke hozzáadásához használja a partnerportál megfelelő fülét az utasításoknak megfelelően hol.
Címkék
A Minden címke hívás használatával mindig megkapja az adatbázisunkban található címkék teljes listáját. A címkéket marketingkampányokhoz és egyéb belső folyamatokhoz használjuk. Ezeket a címkéket a MALL értékesítési képviselőjének előzetes jóváhagyása nélkül használhatja.
- FDEL - ingyenes szállítás
- SALE - eladás
- NEW - új