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. Ajá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 szakértőjé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 platform a következő módon működik MALL sebességkorlátozó, 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.

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.


Tartalomjegyzék


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 webhorog 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 megtudhatja, hogyan kell megfelelően kötni a metódusokat és váltani az egyes állapotokat az API-n belül, javasoljuk továbbá, hogy olvassa el a cikket, amely részletesen elmagyarázza, hogy egyes államok, amelyet a rend átvehet é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 komissiózás és az állapotfrissítés lépéseit illetően.

FontosV: 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 címet. Megrendelés részleteinek lekérdezése a státuszban lévő rendelések esetében ZÁROLT á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 NYISD KI. Az áruk lefoglalása nem kötelező, de erősen ajánlott a nagy forgalmú áruk esetében, amelyeknél fennáll az elfogyás kockázata.

3. Webhook értesítést kap a státuszra módosított megrendelésekről. NYISD KI vagy TÖRÖLVE.

4. Kérjük, hívja fel a Megrendelés frissítése megerősítve = true a NYITOTT vagy MARADÓ megrendelések esetében, 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-ra vagy MEGSZŰNT-ra (ez a végleges státusz, és a megrendelés nem nyitható meg újra).

5. Hívja a címet. Megrendelés részleteinek lekérdezése a lépcsőről érkező parancsokért 4., u TÖRÖLVE lemondja a foglalását. U NYISD KI 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 semmilyen oldalról beavatkozni a megrendelésbe, minden információ, például a cím és az utánvét összege ezen a ponton végleges.

6. Hívja a címet. Megrendelés frissítése megrendelések a státuszból NYISD KI nak nek SZÁLLÍTÁS 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 TÖRÖLVE.

7a. Ha a MALL Delivery szolgáltatást használja, kérjük, hívja a Címkék generálása a kiválasztott MDP megbízásokhoz a MALL Delivery 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 Megrendelés frissítése a rendelés státuszának megváltoztatásához SZÁLLÍTÁS tovább KISZÁLLÍTOTT (a státusz SZÁLLÍTOTT-ra 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 Megrendelés frissítése megrendelések a SZÁLLÍTÁS tovább KISZÁLLÍTOTTbeleértve a nyomon követési URL-t és a fuvarozó nyomon követési számát. 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.

Választható: A MALL Delivery használata esetén felhívhatja a megrendelés részleteinek lekérdezése a Átadott/visszaadott/visszavett/elhagyott státuszú megrendelések esetében, hogy véglegesítse a megrendelés 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 Megrendelés frissítése z KISZÁLLÍTOTT tovább SZÁLLÍTOTT a pontos szállítási dátummal a fuvarozótól kapott információk alapján. Ha rendelkezik a fuvarozótól származó információval az első kézbesítési kísérletről, akkor azt is hozzáadhatja, 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 KISZÁLLÍTOTT tovább VISSZATÉRT.


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 a címet. 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. Az óránkénti 1x-es gyakoriságot csak akkor szabad túllépni, 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 Meg nem erősített megrendelések listája hívja a Megrendelés részleteinek lekérdezése a státuszban lévő rendelések esetében ZÁROLT á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 NYISD KI. Az áruk lefoglalása nem kötelező, de erősen ajánlott a nagy forgalmú áruk esetében, amelyeknél fennáll az elfogyás kockázata.

3. Hívja fel a Megrendelés frissítése megerősítve = true a rendszer által a hívásban regisztrált NYITOTT//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 nincs lehetőség arra, hogy bármelyik oldalról beavatkozzon 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 a címet. Megrendelés frissítése megrendelések a státuszból NYISD KI nak nek SZÁLLÍTÁS 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 TÖRÖLVE.

6a. Ha a MALL Delivery szolgáltatást használja, kérjük, hívja a Címkék generálása a kiválasztott MDP megbízásokhoz a MALL Delivery 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 Megrendelés frissítése a rendelés státuszának megváltoztatásához SZÁLLÍTÁS tovább KISZÁLLÍTOTT (a státusz SZÁLLÍTOTT-ra 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 Megrendelés frissítése megrendelések a SZÁLLÍTÁS tovább KISZÁLLÍTOTTbeleértve a nyomon követési URL-t és a fuvarozó nyomon követési számát. 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álata esetén használhatja a A megrendelések státusz szerinti listájának lekérdezése hívást, amely az Átadott/visszaadott/elhagyott megrendelések időszűrőjét használja a végleges megrendelés státuszának rendszerbe való 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 rendelkezik a fuvarozótól származó információval az első kézbesítési kísérletről, ez is hozzáadható, ez az információ nem kötelező. A frissítést egy hívásban kell elküldeni. Ha a megrendelést nem sikerült kézbesíteni, és visszaküldték a szállítmányozónak, módosítsa a megrendelés státuszát SZÁLLÍTOTT helyett RETURNÁLT-ra.

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. Az önszámlázási szolgáltatás használata esetén számlázási és számlázási célokra használja a következőt releváns végpontok.

Vissza a tetejére


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 címen. termék létrehozása 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ételek 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ő elküldése nem kívánatos, és az ajánlat visszavonásához vezethet az oldalról.

Termékváltozatok nélküli termékek létrehozni egy hívással Ú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é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 mind a két esetben változatlan termékígy a változatok. 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 egységekben 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ék akinek változatok.

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-lal való kapcsolatának korlátozásához vezethet.

Vissza a tetejére

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:

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 feltöltenek. - 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 kenése - ha tudja, hogy egy termék vagy variáns több mint 2 hónapig nem lesz raktáron, javasoljuk, hogy termék akinek Opció törlés a megfelelő végponton keresztül. A MALL karbantartja a termékek historizált értékesítési adatait, 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.

Vissza a tetejére


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á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óriafáiról is kaphat információt.

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 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.
  • 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, 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 Menü korlátozások, hibaüzenetet jeleníthet meg, és az ügyfelek nem tudják majd megszerezni.

API-hívásokon keresztül 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 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.

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.

  • 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 paraméter nevét 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 használja a "egység". Ha a paraméter nem tartalmazza a szükséges értékeket, küldjön egy kérést a következő címre onboarding@mallgroup.com.

Vissza a tetejére


Márkák

A hívás használata 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 oldalon. márka hozzáadása használja a partnerportál megfelelő fülét az utasításoknak megfelelően itt.


Címkék

A hívás használata 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

Vissza a tetejére

Mennyire volt hasznos ez a bejegyzés?

Kattintson a csillagra a bejegyzés értékeléséhez!

Átlagos értékelés: / 5. Szavazatok száma:

Még nincs szavazat! Értékelje elsőként ezt a bejegyzést.