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

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. Hívja a címet. Megrendelés frissítése s confirmed = true A oldalon. NYISD KI vagy TÖRÖLVE 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 ZÁROLT nak nek NYISD KI vagy TÖRÖLVE (ez a végleges állapot, é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 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 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.

OpcionálisV: 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 LESZÁLLÍTOTT/VISSZASZOLGÁLTATOTT/ELVESZETThogy 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 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 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 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 fel a 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 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 a címet. Megrendelés frissítése s confirmed = true A oldalon. NYISD KI/TÖRÖLVE a rendszer által a hívásban regisztrált megbízások.

4. Hívja a címet. Megrendelés részleteinek lekérdezése tovább NYISD KI 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 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álatakor a hívás a következő funkciót használhatja A megrendelések listájának lekérdezése státusz szerint az időszűrő használatával a LESZÁLLÍTOTT/VISSZASZOLGÁLTATOTT/ELVESZETT 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 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 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 KISZÁLLÍTOTT tovább VISSZATÉRT.

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.

Vissza a tetejére


Products

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ő 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 Ú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 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-hoz való kapcsolódás korlátozását eredményezheti.

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

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 termékhez a paraméterek nevét 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 nekünk egy kérést a következő e-mail címen Segítség Központ.

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.

Nem találta, amit keresett, írjon nekünk...