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ésre és a valós értékesítésre 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. Még így is tesztelheti a kapcsolatot először. A fiókja csak tesztüzemmódban van, amíg nem aktiválják. Termékajánlatának végleges megjelenítésére a weboldalon azonban csak az Onboarding részleg jóváhagyása után kerül sor, kérjük, további információkért forduljon az Onboarding specialistájához.
Nagyon fontos, hogy kövesse az alábbi ajánlásokat. Az ajánlott gyakorlatok be nem tartásának hatása korlátozó lehet a vállalat API-hívásainak működésére, tekintettel a MALL rendszerre nehezedő terhelésekre. Ezt szem előtt tartva a platform a MALL sebességkorlátozóáltal működik, olvassa el a cikket itt. 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 a partner felelőssége alá esnek.
Felhívjuk figyelmét, 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álna. 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
Orders (Rendelések)
A megrendelések végpontjaival összefüggésben különös figyelmet kell fordítani a lépések sorrendjére. Ez két alapvető lehetőségre oszlik, attól függően, hogy a következőket használja-e webhook a megrendelésekben bekövetkezett változásokról való tájékozódás érdekében. További információ a webhookról itt.
Ebben a cikkben megtanulhatja, hogyan kell megfelelően csatolni 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 itt.
Kérjük, vegye figyelembe, hogy ha a MALL Delivery szolgáltatást veszi igénybe, a folyamat eltér a jutalékszámítás és az állapotfrissítés lépéseit illetően. (Magyarországon a Mall Szállítás nem alkalmazandó)
Fontos: Kérjük, hogy a rendelési státuszok frissítéseit csak a rendelések változása esetén küldje el. 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. Hívja a Get Order Detail - Megrendelés részleteinek lekérdezése a státuszban lévő rendelések esetében BLOCKED árufoglaláshoz. Ezek azok a megrendelések, amelyekről az első értesítést kapta. Kérjük, hogy csak az árukról kapjon tájékoztatást. Csak a státuszban lévő megrendelések pénzügyi információit kapja meg OPEN. Az áruk lefoglalása nem kötelező, de erősen ajánlott a nagy forgalmú áruk esetében, amelyeknél fennáll az kifogyás kockázata.
3. Webhook értesítést kap a státuszra módosított megrendelésekről. OPEN vagy CANCELLED.
4. Hívja a Update Order - Megrendelés frissítése címet a confirmed = true A oldalon. OPEN vagy CANCELLED a webhookból származó információk alapján megváltozott megrendelések. Lehetséges státuszváltás a következőkből BLOCKED státuszból OPEN vagy CANCELLED (ez a végleges állapot, és a megrendelés nem nyitható meg újra).
5. Hívja a Get Order Detail - Megrendelés részleteinek lekérdezése a lépcsőről érkező parancsokért 4., a CANCELLED lemondja a foglalását. Az OPEN megrendelések, 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 beavatkozni a megrendelésbe egyik oldalról sem, így minden információ, mint például a cím és az utánvét összege, ezen a ponton végleges.
6. Hívja a Update Order - Megrendelés frissítése megrendelések az OPEN státuszból SHIPPING státuszba minden olyan megrendeléshez, 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 lehetőség van a megrendelés módosítására a CANCELLED.
7a. Ha a MALL Delivery szolgáltatást használja, kérjük, hívja a Generate labels for selected MDP orders - Címkék generálása a kiválasztott MDP megbízásokhoz a MALL Delivery (MALL Szállítás) megrendelésekhez szükséges címkék nyomtatásához.
7b. Ha nem használja a MALL Delivery szolgáltatást, akkor a fuvarozó által meghatározott szállítási követelményeknek kell megfelelnie.
8. A szállítmány átadása a szállítmányozó cégnek.
9a. Ha a MALL Delivery szolgáltatást használja, kérjük, hívja a Update Order - Megrendelés frissítése a rendelés státuszának megváltoztatásához SHIPPING a következő státuszba: SHIPPED (a státusz SHIPPED-re történő módosításának mindig a küldeménynek a szállítmányozó 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 a következő telefonszámot Update Order - Megrendelés frissítése megrendelések a SHIPPING a következő státuszba: SHIPPEDváltása, beleértve a tracking URL-t és a fuvarozó nyomon követési számát (tracking szám). Minden információt egy hívásban kell elküldenia szolgáltatásminőségi kritériumoknak való megfelelés érdekében - Nyomon követési arány (Tracking Rate).
Opcionális: A MALL Delivery használata esetén a rendelés változásáról szóló webhook értesítés alapján hívhatja fel a rendelést GET rendelés részletei a státuszban lévő rendelések esetében DELIVERED/RETURNED/LOSThogy véglegesítse a megrendelések végleges státuszát a rendszerében.
10. Ha nem használja a MALL DELIVERY-t, kérjük, hívja a következő telefonszámot Update Order - Megrendelés frissítése a SHIPPED a következő státuszba: DELIVERED ra állításhoz a pontos szállítási dátummal a fuvarozótól kapott információk alapján. Ha a fuvarozótól rendelkezik információval az első kézbesítési kísérletről, ez is megadható, de ez az információ nem kötelező. A frissítést egy hívásban kell elküldeni. Ha a megrendelés nem került kézbesítésre, és visszaküldték a feladónak, változtassa meg a megrendelés státuszát a következőre SHIPPED a következő státuszba: RETURNED státuszba.
SLA és ügyfélélmény: A megrendelések összekapcsolásának mindkét formája esetében kívánatos az ügyfél felé, és ez egyben a végső SLA is, hogy a megrendelések á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áshoz vezethet.
Hívássorozat rendelése webhook használata nélkül
1. Hívja fel a Get list of unconfirmed orders - A meg nem erősített megrendelések listájának lekérdezése rendszeres gyakorisággal, javasoljuk, hogy a gyakoriságot a megrendelések átlagos számához igazítsa. Csak akkor lépje túl az óránkénti 1x-es gyakoriságot, ha naponta több mint 100 megrendelés érkezik. Híváskor használja a filter=basic értéket.
2. A következők alapján Get list of unconfirmed orders - Meg nem erősített megrendelések listája hívja a Get Order Detail - Megrendelés részleteinek lekérdezése a státuszban lévő rendelések esetében BLOCKED árufoglaláshoz. Csak az árukról kapjon tájékoztatást. Csak a státuszban lévő megrendelések pénzügyi információit kapja meg OPEN. Az áruk lefoglalása nem kötelező, de erősen ajánlott a nagy forgalmú áruk esetében, amelyeknél fennáll az kifogyás kockázata.
3. Hívja a Update Order - Megrendelés frissítése címet a confirmed = true A oldalon. OPEN/CANCELLED a rendszer által a hívásban regisztrált megbízások.
4. Hívja a Get Order Detail - Megrendelés részleteinek lekérdezése a következő státuszba: OPEN visszaigazolt megrendelések, hogy a végleges adatokat importálhassa a rendszerébe. Ezen a ponton már nem lehet semmilyen oldalról beavatkozni a megrendelésbe, minden információ, mint például a cím és az utánvét összege, ezen a ponton végleges.
5. Hívja a Update Order - Megrendelés frissítése megrendelések az OPEN státuszból SHIPPING státuszba minden olyan megrendeléshez, 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 lehetőség van a megrendelés módosítására a CANCELLED.
6a. Ha a MALL Delivery szolgáltatást használja, kérjük, hívja a Generate labels for selected MDP orders - Címkék generálása a kiválasztott MDP megbízásokhoz a MALL Delivery (MALL Szállítás) megrendelésekhez szükséges címkék nyomtatásához.
6b. Ha nem használja a MALL Delivery szolgáltatást, akkor a fuvarozó által meghatározott szállítási követelményeknek kell megfelelnie.
Javaslat: Javasoljuk, hogy ellenőrizze a rendelés státuszát, mielőtt elküldi azt. Az SHIPPING státuszban a megrendelést a vásárló törölheti. Az ilyen megrendelést a rendszer Megszüntetett státuszra módosítja. Ez a módosítás ezután szintén megjelenik a A meg nem erősített megrendelések listájának lekérdezése listában, és a 3. lépéssel kell megerősíteni.
7. A szállítmány átadása a szállítmányozó cégnek.
8a. Ha a MALL Delivery szolgáltatást használja, kérjük, hívja a Update Order - Megrendelés frissítése a rendelés státuszának megváltoztatásához SHIPPING a következő státuszba: SHIPPED (a státusz SHIPPED-re történő módosításának mindig a küldeménynek a szállítmányozó cégnek történő átadása után kell megtörténnie).
8b. Ha nem használja a MALL Delivery szolgáltatást, kérjük, hívja a következő telefonszámot Update Order - Megrendelés frissítése megrendelések a SHIPPING a következő státuszba: SHIPPEDváltása, beleértve a tracking URL-t és a fuvarozó nyomon követési számát (tracking szám). Minden információt egy hívással kell elküldeni, a szolgáltatásminőségi kritériumoknak való megfelelés érdekében - Nyomon követési arány.
Választható: A MALL Delivery használatakor a hívás a következő funkciót használhatja Get list of orders by status - A megrendelések listájának lekérdezése státusz szerint az időszűrő használatával a DELIVERED/RETURNED/LOST megrendelések véglegesítése érdekében a megrendelések végleges státuszát a rendszerben.
9. Ha nem használja a MALL Delivery szolgáltatást, kérjük, hívja a következő telefonszámot Update Order - Megrendelés frissítése a SHIPPED a következő státuszba: DELIVERED ra állításhoz a pontos szállítási dátummal a fuvarozótól kapott információk alapján. Ha a fuvarozótól rendelkezik információval az első kézbesítési kísérletről, ez is megadható, de ez az információ nem kötelező. A frissítést egy hívásban kell elküldeni. Ha a megrendelés nem került kézbesítésre, és visszaküldték a feladónak, változtassa meg a megrendelés státuszát a következőre SHIPPED a következő státuszba: RETURNED státuszba.
Visszamenőleges adatérvényesítés: Ha olyan eset áll fenn, amikor le kell kérnie a megrendelések adatait, mindig hívja meg az egyes megrendeléseket, amelyek adataira szüksége van. Ha még mindig szüksége van a rendelési lista előhívására, használja a időszaki szűrők és elkerülheti, hogy egyszerre hívja le a teljes rendelési előzményeket. A MALL Self-Billing használatakor számlázási és számlázási célokra használja a következőt releváns végpontok.
Products (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ék létrehozásakor kérjük, mindig figyeljen a termék tartalmi feltételeinkre, a részletekért kérjük, tekintse meg a következőt itt. Akkor tanulmányozza alaposan termékmegjelenítési feltételeket a cikk egyes kategóriáiban itt hogy megelőzze a későbbi termékjavítás szükségességét további hívások révén.
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 termékváltozatok egyedi listaként történő benyújtása nem kívánatos, és az ajánlatot az oldalról való eltávolításához vezethet.
Termékváltozatok nélküli termékek létrehozni egy hívással Create new product - Új termék létrehozásaHa hibát észlel a hívásnál, egy cikkben elmagyarázzuk az egyes hibákat, valamint azt, hogy hogyan előzheti meg és javíthatja ki őket. A cikk a következő linken található itt. A hívásszerkezet kötelező, kivéve azokat az elemeket, ahol a dokumentációban kifejezetten szerepel. 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, használhatja a sandbox fiók.
Az változatos termékek esetében először használja a Új termék létrehozása egy főtermék létrehozásához. Ezután a Új változat létrehozása módszerrel adjon hozzá változatokat a termékhez. A változatokat változatparaméterek segítségével kell megkülönböztetni. Egy adott kategóriában legfeljebb két paramétert használhat. A fő termékhez rendelt változatok ezután mindig megjelennek a termék részletezésében, a megfelelő paraméterrel együtt, mint az ügyfél által választható változó.
Termékek esetében prioritás kitöltése 1. A rendszer automatikusan rangsorolja a termékeket egy algoritmus segítségével, amely az adott termék kattintásainak, forgalmának és eladásainak száma alapján működik.
Ez egy elavult elem, amelyet még mindig ki kell tölteni, de egyáltalán nem veszik figyelembe. Jelenleg azon dolgozunk, hogy eltávolítsuk.
A termékek esetében fontos feltüntetni EAN (GTIN), pontosan meghatározott alakú - 13 numerikus karakter. Az EAN nagyban befolyásolja a termékek Google Ads, Heureka és Zboží.cz oldalakon való megfeleltetését, és ezáltal azt, hogy sokkal több vásárlót tud elérni termékeivel.
Ha az EAN 14 numerikus karakterből áll, akkor 13 számjegyként adja meg, az elején lévő 0 nélkül. Ha rövidebb, 8 számjegyű EAN-kódja van, adjon hozzá annyi 0-t 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: Kérjük, csak akkor küldjön termékfrissítéseket, 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 invariáns termék vagy variáns. Csak akkor változtassa meg az adatokat, ha azok megváltoznak, vagy ha hozzá kell adnia. Bármilyen termékfrissítéskor mindig az összes elemet el kell küldenie, nem csak azokat, amelyek megváltoztak.
Árfrissítés
Ne használja a fent leírt termék- vagy változatfrissítési módszert az ár frissítésére.. Az ár módosítására és a módosítás elküldésére külön hívás áll rendelkezésre a két esetben változatlan terméknélígy a változatoknál. Ha az ár 30%-nél nagyobb mértékben frissül, az árváltozást egy force tokennel kell megerősíteni. A funkcióval kapcsolatos további információkért kérjük, olvassa el a dokumentációnkat. itt.
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. Az elérhetőség módosításához használja a termék elérhetőségének tömeges módosítására szolgáló módszert a Batchupdate of product/variant availability. Kérjük, használja ezt a frissítési lehetőséget, amennyire csak lehetséges, egyszerre legfeljebb 1000 termék/variáns frissíthető tömeges frissítéssel.
Végül, ha az egységnyi változásokra van szükség, akkor a készlet rendelkezésre állásának aktualizálására szolgáló módszert lehet alkalmazni termékeknél vagy változatoknál.
Visszamenőleges adatérvényesítés: Ha van olyan eset, amikor vissza kell kapnia a termékadatokat, csak akkor hívja fel ő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 lekérdezése rendkívül nem kívánatos és megterhelő a rendszerünk számára, és a MALL-hoz való kapcsolódás korlátozását eredményezheti.
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 - A tételek rendelkezésre állása frissítés - 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.
- Active selected products - Aktív kiválasztott termékek - Kiválasztott termékek tömeges módosítása tervezetből élőre.
- Activate products - Aktiválja a termékeket - Az összes termék tömeges módosítása 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ódszerrel is történhet, attól függően, hogy miért van szükség a termék letöltésére.
- Átmenetileg kifogyott termék, amelyet újra fel fognak tölteni a raktárban - ebben az esetben a termék elérhetőségének frissítésekor elegendő a termék készleten lévő elérhetőségét "0"-ra csökkenteni, ezután nem lehet megvásárolni a weboldalon, a vásárlók még mindig láthatják, hogy a termék egy ideig újra megjelenik-e a kínálatban.
- Átmenetileg vissza kell vonni a terméket a weboldalról - a termék elérhetőségének frissítésével 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 raktáron, javasoljuk, hogy termék vagy variáns törlését a megfelelő végponton keresztül. A MALL historizált értékesítési adatokat tart fenn a termékeihez, ha ugyanazon azonosító alatt tölt fel egy terméket, az értékesítési adatok újra párosításra kerülnek.
Fontos: Ne frissítsen semmilyen inaktív terméket. Az inaktív termékeknek való 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ése esetén a rendszer túlterhelté válhat, és csak részleges adatátvételre kerülhet sor, ami negatív ügyfélélményt és potenciális veszteséget eredményezhet a partner részéről.
Categories (Kategóriák)
Az API-n belül két alapvető végpontot használhat a kategóriaadatok lekérdezéséhez. Az elsőben Category tree by country - Kategóriafa országonként megkapja az adott országhoz rendelkezésre álló kategóriafát. Ha megváltoztatja az országkódot a hívás URL-címében, 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üelem azonosítója (="menuItemId") - egy egyedi kategóriakód, amelyet a Category Detail - Kategória részlet híváshoz használhat, hogy megkapja az összes paraméter és érték listáját, a hívást az alábbiakban ismertetjük.
- Product Type ID - 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.
- Menu Constraints - Menü korlátozások (="menuCosntraints") - Kötelező paraméterek, amelyek értékei szükségesek a termékek adott menuitemID-hez rendeléséhez, a kategóriafeltételek részleteiért kérjük, olvassa el a részletes cikket itt.
A webes megjelenítés validálása: A rendszerbe feltöltött termék, amely nem felel meg a következőknek Menu Constraints - Menü korlátozások, hibaüzenetet jeleníthet meg, és az ügyfelek nem tudják majd megszerezni.
A Category Detail - Kategória részlet akkor egy adatlistát kapunk. Az első rész tartalmazza a kategória megjelenítési feltételeit.
- 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 Product Type ID - 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 Menu Constraints - 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.
A webes megjelenítés validálása: A rendszerbe feltöltött olyan termék, amely nem felel meg a kategóriafeltételeknek, hibát jeleníthet meg a megjelenítéskor, és nem lesz elérhető a vásárlók számára.
- Other parameters - 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éklistát kell használni, saját értékek bevitele a paraméterekbe nem lehetséges. Mindig adja hozzá a termékhez a paraméterek nevét a műszaki nevek, mezőben. "value" - "é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 használja a „unit“ - "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).
Márkák
A Get all brands - Minden márka beszerzése Az összes országban elérhető márkák teljes listáját kapja meg. A lista nem egyedi az egyes országokra, így bármelyik MALL Partner piacra csatlakozhat vele. Az 100% párosításban mindig adja hozzá a "brand_id" mezőt a termékekhez, beleértve a nagybetűket is.
A márka hozzáadásához használja a partnerportál megfelelő fülét az utasításoknak megfelelően itt.
Címkék
A Get all labels - Az összes címke lekérése mindig megkapja az adatbázisunkban lévő címkék teljes listáját. A címkéket marketingkampányokhoz és egyéb belső folyamatokhoz használják. E címkék használata csak a MALL értékesítési képviselőjének előzetes jóváhagyásával engedélyezett.
- FDEL - ingyenes szállítás
- SALE - eladás
- NEW - új