Bevezetés
Ez a leírás részletesen bemutatja, hogy a Webshippy különböző API végpontjait felhasználva, hogyan kommunikálhatsz külső rendszerekből a Webshippy rendszerével.
Használható API végpontok
Order API: Rendelések szinkronizálása (létrehozás, módosítás, törlés, lekérdezés).
Product API: Termékek szinkronizálása (létrehozás, módosítás, törlés, lekérdezés, készletinfó).
Inventory Transfer API: Áruszállítások kezelése (létrehozás, módosítás, törlés, lekérdezés).
External Inventory API: Külső raktárról elérhető készlet mennyiség beállítása.
GetStock API: Termék-készlet adatok tömeges lekérdezése.
Get Brack History API: Selejt előzmény(ek) lekérdezése.
Create Bundle API: Termékcsomag létrehozása.
Marketplace Price Change API: Marketplace nagyker árak módosítása.
Marketplace Transaction API: Ezzel a funkcióval lekérdezhetőek a Marketplace tranzakciók részletes adatai.
Shipping Mode API: Szállítási mód kiválasztása.
Push API: Értesítés a megrendelés és szállítás státuszváltozásáról.
Track Info API: A megrendelések szállításának státuszát lehet lekérdezni.
Használandó API URL -ek
API XML url:
https://app.webshippy.com/wspyapi/{ACTION}/xml
API JSON url:
https://app.webshippy.com/wspyapi/{ACTION}/json
Autentikáció - API kulcs generálása
A Webshippy API minden esetben egy külön értékesítési csatornaként jelenik meg a Webshippy Admin rendszerében. Ahhoz, hogy sikeres adatkommunikáció jöjjön létre, rendelkeznünk kell egy saját API kulcssal. Ennek létrehozásához navigálj a Beállítások / Webáruházak kezelése oldalra, majd a Webshippy.API gombra kattinva hozz létre egy új értékesítési csatornát. Az alapadatok kitöltése után a rendszer legenerálja az API kulcsot, ami innentől kezdve készen áll a kommunikációra.
Az API hívások működése
A WSAPI a biztonság érdekében HTTPS csatornát használ, az UTF-8 karakterkódolást támogatja, valamint képes kommunikálni XML és JSON formátumban is.
API XML url:
https://app.webshippy.com/wspyapi/{ACTION}/xml
API JSON url:
https://app.webshippy.com/wspyapi/{ACTION}/json
Ahol az {ACTION} helyőrző a kért funkciót/akciót jelenti.
Az API minden esetben POST metódust használ, és az átadott adatokat a request
mező tartalmazza JSON vagy XML String-ként.
Példa a PHP alapú API hívásra:
Példa: Áruszállítás létrehozása
Ezzel a funkcióval áruszállítások hozhatóak létre.
Mező | Kötelező? | Leírás |
| Igen | Az API kulcs. |
| Igen | A létrehozandó áruszállítás iránya (in/out). |
| Nem | Megjegyzés az áruszállításhoz. |
| Igen | Az áruszállítás várható dátuma. |
| Igen | Szállított termék mennyisége (pozitív egész). |
| Igen | Szállított termék SKU-ja (cikkszáma). |
XML esetén:
Url: https://app.webshippy.com/wspyapi/CreateTransfer/xml
Kérés:
Válasz (példa):
JSON esetén:
Url: https://app.webshippy.com/wspyapi/CreateTransfer/json
Kérés:
Válasz (példa):
Last updated