A következő cikkben részletesen bemutatjuk, hogyan ajánlott összekapcsolni a különböző adatfolyamokat a vállalat API-kapcsolatán belül.
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.
Kérjük, vegye figyelembe, hogy a MALL API a szükség pillanatában információforrás, nem pedig adatbázis, amely historizált adatok tárolására szolgál. Az ilyen jellegű API-hívások korlátozottak lehetnek.
Az ügyfél-azonosítót vagy "API-kulcsot" a MALL-kapcsolaton belüli összes API-hívás engedélyezéséhez használja. Az API-kulcs egy olyan karakterkombinációból áll, amely minden egyes fiókhoz egyedi, és minden egyes API-híváshoz csatolni kell. Ha több fiókkal rendelkezik a MALL-on, a kulcs minden fiókhoz egyedi lesz. Az API-kulcs a MALL partnerportálon a "Cégprofil" részben, az "Információk" fül alatt található.
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.
Kérjük, vegye figyelembe, hogy ha a MALL Delivery szolgáltatást veszi igénybe, a folyamat eltér a komissiózás és az állapotfrissítés lépéseit illetően.
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.
A rendelési hívások sorrendje webhook használatával
Először is be kell kapcsolnia a webhookot, és be kell illesztenie az előkészített URL-t a partnerportál Partner menüjének megfelelő fülére, majd a naplóban láthatja az egyes kimenő értesítéseket.
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.
Hívássorozat rendelése webhook használata nélkül
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
A MALL API-n belül egyes műveletek tömeges módosításokkal végezhetők el. A kötegelt végpontok használata jelentősen csökkenti az API-hívási limit kihasználtságát a sebességkorlátozón belül, ezért ajánlott ezeket a lehető legtöbbször használni.
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
A termék letöltése a webhelyről többféle módon is történhet, attól függően, hogy miért van szükség a termék letöltésére.
- 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") - egy egyedi kategóriakódot, amellyel hívhatja a 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") - a termék osztályozásához szükséges technikai kategóriakód, ez a kód több menuitemID-ben is szerepelhet.
- Menü korlátozások (="menuCosntraints") - Kötelező paraméterek a termékek adott menuitemID-hez való besorolásához szükséges értékekkel, a kategóriafeltételekkel kapcsolatos részletekért kérjük, olvassa el a részletes cikket. 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") - a műszaki kategória kódja, ez ugyanaz a kód, amelyet az előző felhívás során adtak meg, mint 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") - itt ugyanazokat az adatokat találja, mint a Menü korlátozások az előző hívásban. Ahhoz, hogy egy terméket bármelyik kategóriába besoroljon, ezeket a feltételeket mindig helyesen kell megadni.
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"): Itt találja az összes többi paramétert, amelyek értékeit felhasználhatja és hozzáadhatja a termékeihez. A paraméterekhez mindig az itt található értékek listáját kell használnia, saját értékek bevitele a paraméterekbe nem lehetséges. A paraméterek nevét mindig adja hozzá a termékhez a műszaki nevek, mezőben. "érték". Az értékeket mindig az értékesítés célországának nevében adja meg, azaz az értékeket a mezőből "text". Numerikus értékek esetén mindig a "egység". Ha a paraméter nem tartalmazza a szükséges értékeket, küldjön nekünk egy kérést a következő e-mail címen 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
Magyar 
Čeština 
English 
Slovenščina