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

Rendelések

Partneradatok

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ásakor 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

Bankkártyás fizetések beküldése

A ShopLinker a webáruházban bankkártyával fizetett rendeléseknél a fizetés adatait is át tudja adni az Octopusnak. Így az Octopusban a rendelés mellett az is látszik, hogy a vásárló fizetett-e, és mennyit.

Ezeket az adatokat küldjük be:

• a bankkártyás tranzakció azonosítóját,
• a fizetés eredményét (sikeres vagy sikertelen),
• sikeres fizetésnél a kártyáról levont összeget.

Hogyan kapcsolom be?

1. Nyisd meg a Külső kapcsolatok között az Octopus kapcsolatodat.
2. Az Octopus rendelés beállítások résznél kapcsold be a Bankkártyás tranzakciók beküldése beállítást.
3. Mentsd el a kapcsolatot.

A beállítás alapból ki van kapcsolva. Bekapcsolás után a következő rendelésszinkrontól működik.

Mikor kerül be a fizetés?

• A fizetés azután kerül be az Octopusba, hogy a rendelés már bekerült, a rendelésszinkron következő futásakor.
• A rendelés után érkező fizetés is bekerül. Ha a vásárló először sikertelenül fizetett, és később újra próbálkozott, a sikeres fizetés is bemegy, és az Octopusban ez lesz érvényes.
• Ha egy rendelésnek már van sikeres fizetése, egy későbbi sikertelen próbálkozás nem írja felül.

Jó tudni

• Csak azoknál a rendeléseknél küldünk fizetést, amelyek a beállítás bevezetése után kerültek be az Octopusba. A korábbi rendelések kártyás fizetését az Octopusban kézzel kell rögzíteni.
• A ShopLinkerben a rendelés adatlapján, a Tranzakciók táblázatban látod a rendeléshez tartozó fizetéseket.

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 Fizetési és szállítási párosítások lépésben párosíthatod 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 az Octopusba.

Telephelyek

Ha a vásárlók a webáruházban személyes átvételt választhatnak valamelyik üzletedben, beállíthatod, hogy ezek a rendelések az Octopusban az adott üzlet telephelyére kerüljenek.

Hogyan állítom be?

1. Nyisd meg a Külső kapcsolatok között az Octopus kapcsolatodat.
2. Lépj a Telephelyek lépésre (a Fizetési és szállítási párosítások után).
3. Kattints a Párosítás hozzáadása gombra, és add meg:
   • Átvételi pont azonosító – az átvételi pont, ahogy a webáruház a rendelésben átadja (pl. Budapest - Telek utca),
   • Octopus telephely ID – annak az Octopus telephelynek az azonosítója, ahová a rendelést rögzíteni szeretnéd.
4. Minden üzlethez vegyél fel egy párosítást, majd mentsd el a kapcsolatot.

Az átvételi pont mezőbe kattintva a korábbi rendeléseidben előforduló átvételi pontok közül is választhatsz. Mindegyik mellett látod a szállítási mód nevét és azt, hogy hány rendelésben szerepelt. Így nem kell kézzel begépelned, és biztosan pontos lesz.

Hogyan működik?

• Ha egy rendelés átvételi pontja szerepel a párosítások között, a rendelést a megadott Octopus telephelyre küldjük be.
• Ha az átvételi pont nem szerepel a listában (például csomagautomata), a rendelés a szokásos módon megy be az Octopusba.
• A kis- és nagybetűk nem számítanak, de minden más igen: például az „utca” és az „u.” két különböző átvételi pontnak számít.
• A beállítás a mentés után beküldött rendelésekre érvényes. A már beküldött rendeléseket nem küldjük be újra.

Jó tudni

• Ha a rendelés telephelyet kap, az Octopus csak az adott telephely raktáraiból foglal készletet. Ha ott nincs elég készlet, a tétel nem kerül foglalásra, akkor sem, ha máshol van belőle.
• Az Octopus telephely azonosítóját az Octopus rendszeredben tudod kikeresni.