Octopus import beállítása
Mi az az Octopus import?
Az Octopus egy magyar nagykereskedők körében elterjedt termékkezelő rendszer. A ShopLinker közvetlen API-kapcsolaton keresztül kommunikál az Octopus rendszerrel: termékeket, készleteket tölt le, és rendeléseket küld vissza.
Milyen adatokat és szolgáltatásokat használ a kapcsolat?
Az alábbi táblázatok azt mutatják be, hogy a kapcsolat pontosan milyen adatokat kérdez le az Octopus rendszerből, és milyen esetekben küld oda adatot vissza. Az egyes lekérdezések gyakorisága a választott előfizetési csomagtól függ.
Termékadatok
| Végpont | Mit csinál |
|---|---|
GetCikkekAuth |
Terméktörzs lekérdezése – a termékek alapadatai (cikkszám, név, leírás, méretek, súly stb.) |
GetCikkekNyelvAuth |
Terméknév és leírás fordítások lekérdezése, többnyelvű webshopokhoz |
GetArlistaAuth |
Árak lekérdezése – listás, akciós és vevőcsoport árak (beállított PID szerint) |
GetVonalkodokAuth |
Vonalkódok (EAN) lekérdezése |
GetCikkekKeszletValtozasAuth |
Készletadatok lekérdezése – raktárankénti készlet és elérhetőségi dátum |
GetBeerkezesekAuth |
Várható beérkezések lekérdezése, ha a várható beérkezési dátum forrása erre van állítva |
GetCikkcsoportokAuth |
Kategóriák lekérdezése |
GetCikkcsoportokNyelvAuth |
Kategórianév fordítások lekérdezése |
GetMatmodellAuth |
Terméktulajdonságok / paraméterek lekérdezése |
GetCikkKepekAuth |
Termékképek lekérdezése |
GetHelycikkAuth |
Kapcsolódó (helyettesítő) termékek lekérdezése |
GetAkciosCikkekAuth |
Akciók és kedvezmények lekérdezése, ha akciós kategória van beállítva |
Rendelések
| Végpont | Mit csinál |
|---|---|
RendelesFeladasAuth |
Rendelés feladása – a webshopban leadott rendelés beküldése az Octopusba (adatot küld) |
GetRendelesekAuth |
Rendelés státusz lekérdezése, a rendelés státusz szinkronhoz |
GetPickPackPontokAuth |
Csomagpontok lekérdezése, személyes átvételi / csomagpontos szállításhoz |
Partneradatok
| Végpont | Mit csinál |
|---|---|
GetPartnerekAuth |
Partnerek lekérdezése |
PartnerInsAuth |
Új partner létrehozása, ha a vevő még nem szerepel az Octopus rendszerben (adatot küld) |
GetPartnercimekAuth |
Partnercímek lekérdezése |
PartnercimInsUpdAuth |
Partnercím létrehozása / frissítése (adatot küld) |
GetUgyintezokAuth |
Ügyintézők lekérdezése |
Szükséges adatok
Az Octopus kapcsolat beállításához az Octopus rendszerben létre kell hozni egy webszolgáltatás partnert, és az ehhez tartozó alábbi adatokat kell megadnod:
- WSDL URL – az API végpont URL-je
- Authcode – hitelesítési kód az API eléréséhez
További beállítások
- PID – háromszereplős rendelés esetén erre a PID-re küldi be a rendszer a rendeléseket.
- Fiktív PID – új partner létrehozásokar az Octopus az alapvető partnerrel kapcsolatos mezők értékeit erről a partnerről másolja (pl. partnertípus, fizetési osztály)
- PID az árakhoz – az árinformációkat ehhez a partnerhez kérdezi le a rendszer
- Cikkcsoport kód elválasztás hossza – meghatározza, hogyan bontja a rendszer a cikkcsoport kódot. Például ha a kód "AABBCC" formátumú, akkor az érték 2; ha "AAABBBCCC", akkor 3.
Rendelési szinkron beállítások
Az Octopus import nemcsak termékeket, hanem rendeléseket is tud szinkronizálni. Ehhez be kell állítani a rendelési módot:
- Kétszereplős (2_PARTICIPANT) – a webáruház és az Octopus között közvetlen kapcsolat; a rendelés közvetlenül a nagykereskedőhöz kerül
- Háromszereplős (3_PARTICIPANT) – egy közvetítő (pl. viszonteladó) is részt vesz a folyamatban
Engedélyezési státusz – meghatározza, hogy az Octopus rendszerben milyen státuszú rendeléseket vegyen figyelembe a szinkron:
- 1 – Rögzítés alatti
- 2 – Lezárásra vár
- 3 – Engedélyezésre vár
- 4 – Engedélyezett
Rendelés státusz szinkron feltételek
Meghatározhatod, hogy az Octopusból érkező rendelés státuszadatok alapján a webáruházban melyik rendelési státusz kerüljön beállításra. Minden feltétel sorrendben kerül kiértékelésre, és az első illeszkedő feltétel érvényes.
Minden feltételnél megadható:
- Törölt tételek – nincs törölt / van törölt / mindegyik törölt
- Berendstatus kódok – vesszővel elválasztott kódlista (pl.
1, 64); üres mező esetén bármely kódra illeszkedik - Szállítási mód kódok – vesszővel elválasztott kódlista; üres = bármely szállítási módra illeszkedik
- Shop státusz – a webáruházban beállítandó rendelési státusz
Szállítási és fizetési mód párosítások
A szerkesztő alján lehetőséged van párosítani az Octopus szállítási és fizetési mód kódjait a webáruház megfelelő módjaival. Ez biztosítja, hogy az átküldött rendelések a helyes szállítási és fizetési adatokkal kerüljenek a webshopba.