Foxpost integráció¶

A Foxpost egy magyar csomagszállító fuvarozó, amely leginkább az országos csomagautomata-hálózatáról ismert. A Delivery Foxpost modul (eyssen_delivery_foxpost) összeköti az Odoo-t a Foxpost webes API-jával: hozzáad egy Foxpost szállítási szolgáltatót csomagautomata (APM) és házhozszállítás üzemmóddal, a szállítási rendelés érvényesítésekor regisztrál minden csomagot és letölti annak PDF-címkéjét, szinkronban tartja a csomag állapotát a Foxposttal, valamint tartalmaz egy dedikált FoxPost COD utánvétes (COD) fizetési szolgáltatót 150 000 HUF felső korláttal. A webáruházban a vevők a hivatalos Foxpost térképen választják ki a csomagautomatájukat anélkül, hogy elhagynák a pénztárat.

Az integráció beállításához hajtsa végre az alábbi lépéseket:

Szerezze be a Foxpost API hitelesítő adatokat.
Állítsa be a szállítási mód(oka)t az Odoo-ban.
Igény szerint engedélyezze a FoxPost COD fizetési szolgáltatót.

Lásd még

Fiókbeállítás¶

Az összekötő a Foxpost webes API-jával kommunikál, amelyhez három, a Foxpost által a vállalat fuvarozói szerződése keretében kiadott hitelesítő adat szükséges: egy API-felhasználó, egy API-jelszó és egy API-kulcs. A Foxpost külön teszt- és éles rendszert üzemeltet, ezért mindkettőhöz kérjen hozzáférést a Foxposttól: a tesztrendszerben a teljes folyamat (csomagregisztráció, címkék, nyomon követés) begyakorolható anélkül, hogy valódi csomagok jönnének létre az éles hálózatban.

Fontos

A hitelesítő adatok környezetfüggők: mindegyik adatkészletet csak abban a környezetben használja, amelyhez kiadták. Azt, hogy az Odoo melyik környezetet hívja, szállítási módonként a Környezet gomb dönti el (lásd lejjebb) — mindig ellenőrizze, hogy a módon megadott hitelesítő adatok a kiválasztott környezethez tartoznak.

Szállítási módszer konfigurálása¶

A modul telepítése két előre elkészített szállítási módot hoz létre: a Foxpost Parcelmachine (csomagautomata üzemmód) és a Foxpost Home delivery (házhozszállítás üzemmód) módokat. Mindkettő nem közzétéve, nulla árral és üres hitelesítő adatokkal települ — kitöltendő sablonok, nem működésre kész módok.

A beállításukhoz (vagy továbbiak létrehozásához) lépjen a Készlet alkalmazás ‣ Konfiguráció ‣ Szállítás módja menüpontba, és nyissa meg a módot. A Szolgáltató mezőben a Foxpost kiválasztása két Foxpost-specifikus lapot jelenít meg az űrlapon: Foxpost beállítások és Árazás.

A minden külső fuvarozónál közös mezőkről, mint például a Szállítási termék vagy az Országok, a külső fuvarozó dokumentációban olvashat.

Megjegyzés

Ahhoz, hogy az Odoo regisztrálja a csomagokat és letöltse a címkéket, hagyja az Integrációs szint mezőt az Érték igénylése és szállítás létrehozása értéken. Az Érték igénylés beállítással a mód csak árakat számol a pénztárban, és szállításkor soha nem lép kapcsolatba a Foxposttal.

Hitelesítő adatok¶

A Foxpost beállítások lapon adja meg a fiókbeállítás során kapott három hitelesítő adatot:

API felhasználó és API jelszó: a Foxpost webes API HTTP-hitelesítési párosa.
API kulcs: a kiegészítő kulcs, amelyet a Foxpost minden API-hívásnál megkövetel.

Ezek a mezők — az alább ismertetett Szállítási mód mezővel együtt — csak az Adminisztráció / Beállítások csoport felhasználói számára láthatók; a többi felhasználó ezek nélkül látja a szállítási mód űrlapját.

Az űrlap jobb felső sarkában található Környezet okos gomb a Test Environment és a Production Environment állapot között vált. Teszt módban minden hívás a Foxpost teszt API-jára megy; állítsa a módot élesre, amint a folyamatot végponttól végpontig ellenőrizte.

Kézbesítési módok¶

A Foxpost beállítások lapon található Szállítási mód mező választja ki a két üzemmód egyikét. Egy szállítási mód mindig pontosan egy üzemmódban működik; mindkettő felkínálásához tegyen közzé két szállítási módot (pontosan ezt biztosítja a két előre telepített rekord).

Üzemmód	Csomagautomata (APM)	Házhozszállítás
Célállomás	A vevő által kiválasztott Foxpost csomagautomata.	A vevő szállítási címe.
Csomagautomata-kiválasztás	Térképes felugró ablak a webáruházi pénztárban; Térképen kiválasztás gomb a háttérrendszerben.	Nem alkalmazható.
A szállítás érvényesítése előtt kötelező	Csomagautomata-azonosító és a címzett telefonszáma.	Teljes szállítási cím és a címzett telefonszáma.
Előre telepített mód	Foxpost Parcelmachine	Foxpost Home delivery

A Megjelenik foxpost.hu oldalon mező (Megjelenik foxpost.hu oldalon vagy Nem jelenik meg foxpost.hu oldalon) rendeltetése annak szabályozása, hogy a csomag a regisztrálásakor láthatóként legyen-e megjelölve a foxpost.hu oldalon. A jelenlegi verzióban minden csomag láthatóként kerül regisztrálásra, e beállítástól függetlenül, ezért hagyja meg az alapértelmezett Megjelenik foxpost.hu oldalon értéket.

Megjegyzés

A címzett telefonszáma minden Foxpost-küldeménynél kötelező: ha meg van adva, a mobilszám kerül felhasználásra, egyébként a vezetékes szám; telefonszám nélküli kapcsolat esetén pedig a szállítás érvényesítése blokkoló üzenettel meghiúsul. A Foxpost ezen a számon értesíti a vevőt a csomagról.

Árképzés¶

Az Árazás lap két árazási stratégiát támogat:

Rögzített ár: ha nincs árazási szabály megadva, a szállítási ár a mód Szállítási termék termékének eladási ára, a rendelés árlistáján keresztül feloldva. A Rögzített ár mező ennek a terméknek az alap eladási árát szerkeszti, a szállítási termékre vonatkozó árlista-szabályok pedig árlistánként felülbírálják azt.
Sávos szabályok: egy vagy több Árazási szabályok bejegyzés hozzáadásával a mód súly, térfogat, súly × térfogat, ár vagy mennyiség szerinti sávos árazásra vált. A szabályok sorrendben értékelődnek ki, és az első illeszkedő szabály nyer. Ha egyik szabály sem illeszkedik (például a kosár nehezebb a legnagyobb súlysávnál), a mód látható marad a pénztárban, de kiszürkítve, és nem választható — az ár helyén a Not available for current order üzenet jelenik meg.

A vállalati pénznemben megadott árak automatikusan átváltásra kerülnek a rendelés árlistájának pénznemére, és a szabványos Ingyenes, ha a rendelés értéke nagyobb opció mindkét stratégia felett működik.

Example

Két szabály — súly ≤ 2 kg → 990 Ft és súly ≤ 5 kg → 1 990 Ft — 990 Ft-ot számít fel egy 1,5 kg-os kosárért, és 1 990 Ft-ot egy 4 kg-osért. Egy 10 kg-os kosár egyik sávba sem esik, így a Foxpost mód kiszürkítve jelenik meg, és nem választható ehhez a kosárhoz.

Utánvét¶

A modul tartalmaz egy FoxPost COD, with credit card at parcelmachine or at delivery nevű fizetési szolgáltatót, amellyel a vevő a csomag átvételekor készpénzben vagy kártyával fizethet. Mint minden fizetési szolgáltató, ez is letiltva települ: a pénztárban való felkínálásához engedélyezze és tegye közzé a Weboldal ‣ Konfiguráció ‣ E-kereskedelem: Fizetési szolgáltatók menüpont alatt.

A szolgáltató csak akkor jelenik meg a fizetési lépésben, ha a weboldalt közzétett Foxpost szállítási mód szolgálja ki, és a kosár fizikai terméket tartalmaz; a Maximum Amount értéke pedig előre 150000-re van állítva — az összekötő nem támogat 150 000 HUF feletti utánvétes csomagokat —, így a nagyobb rendelések soha nem látják ezt a lehetőséget. Ugyanez a felső korlát szállításkor másodszor is érvényesítésre kerül: a korlátot meghaladó utánvét-összegű címke generálása a „Utánvét maxmiális összege 150.000,- Ft” üzenettel blokkolódik.

Utánvétes rendelés leadása után a vevő a banki átutalási utasítások helyett a „Rendelésed visszaigazolásra került. Kérjük, fizess átvételkor.” visszaigazoló üzenetet látja. Ez kizárólag a vevőnek szóló szöveg: a függőben lévő utánvétes fizetés nem erősíti meg az értékesítési rendelést — annak megerősítése (és a szállítás létrehozása) továbbra is háttérirodai lépés marad. A beszedendő összeg kimenő szállításonként (szállítmányonként), dinamikusan kerül kiszámításra a szállítási címke generálásakor — egyetlen összeg fedi le a teljes szállítást, figyelembe véve a részszállításokat, a szolgáltatás sorokat és az előlegeket.

Lásd még

A szállításonkénti utánvét-összeg kiszámításának módja és az utánvétes vevők opcionális csalásszűrése: Utánvét (COD)
A fizetési módok szállítási módonkénti szűrése, valamint az utánvétes pénztári és visszaigazolási élmény: Szállítási módhoz kötött fizetési módok

Fontos

Mindkét előre telepített Foxpost mód kizárólag a FoxPost COD szolgáltatót sorolja fel az Enabled payment acquirers engedélyezőlistáján. Alapállapotban a Foxpostot választó vevő ezért csak utánvéttel fizethet — mindaddig, amíg más fuvarozó COD-szolgáltatója nincs engedélyezve, mivel a COD-szolgáltatók saját, külön pályán kerülnek ellenőrzésre (lásd Szállítási módhoz kötött fizetési módok). Vegye fel a bolt kártyás és átutalásos szolgáltatóit az egyes Foxpost módok Fizetési szolgáltatók lapjára, hogy azok is elérhetők legyenek.

Webáruházi pénztár: a csomagautomata kiválasztása¶

Amikor a vevő a webáruházi pénztár szállítási lépésében Foxpost csomagautomatás módot választ, egy Válasszon Foxpost csomagpontot című, teljes képernyős ablak nyílik meg a hivatalos Foxpost apt-finder térképpel — ugyanazzal a kereshető térképpel és listával, amelyet a vevők a foxpost.hu oldalról ismernek. Az automata kiválasztása bezárja az ablakot, elmenti az automatát a rendelésen, és a kiválasztott szállítási mód alatt Választott csomagpont: felirattal, az automata nevével együtt jeleníti meg a választást. A Foxpost módra ismét rákattintva a térkép újra megnyílik, így a vevő a rendelés leadása előtt bármikor módosíthatja a választását.

Ha a szállítási mód korlátozza az Országok listát, a kiválasztott automata ellenőrzésre kerül e lista alapján: a mód által nem kiszolgált országban található csomagautomata elutasításra kerül.

Megjegyzés

A térkép automata-választás nélküli bezárása nem akadályozza meg a pénztári folyamatot — a vevő így is leadhatja a rendelést. A hiányzó csomagautomata később, a szállítás raktári érvényesítésekor derül ki: az érvényesítés „A szállítás jóváhagyása előtt válasszon Foxpost csomagautomatát (APM azonosító) a rendelésen vagy a szállítólevélen.” üzenettel elutasításra kerül, és a munkatársak ekkor választhatják ki az automatát a rendelésen vagy a szállítmányon (lásd lejjebb).

Megjegyzés

A térképablak szövegei jelenleg a weboldal nyelvétől függetlenül magyarul jelennek meg.

Ha a kiválasztott fuvarozó Foxpost csomagautomatás mód, az értékesítési rendelés űrlapján és a szállítmány űrlapján egyaránt megjelenik egy Foxpost csomagautomata mező a Térképen kiválasztás gombbal. A gomb a pénztárban is használt Foxpost térképpel nyitja meg a Foxpost csomagautomata kiválasztása párbeszédablakot; alternatívaként az automata üzemeltetői azonosítója (pl. hu472) közvetlenül is beírható. A rendelés és annak összes szállítmánya egyetlen közös csomagautomatát használ — a szállítmányon történő módosítás frissíti a rendelést, és az automata csak értékesítési rendeléshez kapcsolt szállítmányokon állítható be.

Miután a rendeléshez az első szállítási címke elkészült, a mező és a gomb mindkét űrlapon csak olvashatóvá válik: a célautomata módosításához azután, hogy a csomag már létezik a Foxpost rendszerében, a Foxposttal kell kapcsolatba lépni.

Szállítási címkék¶

Amikor egy Foxpost szállítási móddal rendelkező kimenő szállítás érvényesítésre kerül, az Odoo regisztrálja a csomagot a Foxpostnál, és azonnal letölti annak címkéjét:

A visszakapott csomagazonosító a szállítmányon a Foxpost csomagszám mezőben tárolódik, és ez lesz a szállítmány Nyomon-követési hivatkozás értéke.
A PDF-címke a szállítmányhoz csatolódik, és LabelFoxpost-<parcel id>.pdf néven bekerül annak chatterébe, nyomtatásra készen.
Ha a Foxpost elutasítja a csomagot (érvénytelen automata-azonosító, hibás adatok stb.), az érvényesítés érthető hibaüzenettel leáll, és semmi nem kerül regisztrálásra.

Az érvényesítéskori csomagregisztrációhoz a mód Integrációs szint mezőjének Érték igénylése és szállítás létrehozása értékűnek kell lennie, és a művelettípuson engedélyezve kell lennie a Generate Shipping Labels opciónak (Készlet alkalmazás ‣ Konfiguráció ‣ Műveletek típusai); szállítási műveleteknél mindkettő az alapértelmezés.

Ha a címke letöltése meghiúsul (például hálózati hiba egy sikeres regisztráció után), a csomag regisztrált marad, és a címke bármikor újra letölthető a szállítmány fejlécében található Foxpost címke letöltése gombbal. A gomb akkor érhető el, ha a szállítmánynak már van csomagazonosítója; a címkék A6-os méretben nyomtatódnak.

Megjegyzés

Minden szállítmány egyetlen Foxpost-csomagként, rögzített, közepes csomagmérettel utazik — a csomagméretek és a súlyok nem kerülnek átadásra a Foxpostnak. Fizikai csomagonként egy Foxpost-szállítmányt adjon fel, és győződjön meg arról, hogy az áru ténylegesen elfér egy közepes automatarekeszben.

Nyomkövetés és állapotok¶

A csomag regisztrálása után a szállítmány megjeleníti annak élő Foxpost-állapotát: a Csomag állapota (ember által olvasható leírás) és a Csomag állapot kód (a Foxpost állapotkódja) mezőkben. Az utolsó állapotesemény dátuma szintén rögzítésre kerül a szállítmányon, és ez vezérli az alább ismertetett kézbesítésidátum-követést.

Egy ütemezett művelet, a Szállítás: Foxpost nyomonkövetés frissítése, 3 óránként lekérdezi a Foxpost követési API-ját minden olyan szállítmányra, amelynek csomagja még nem érte el a végállapotot (kézbesítve, visszaküldve vagy lejárt), így a nyitott csomagok kézi munka nélkül frissülnek. Az időköz a Beállítások ‣ Technikai ‣ Automatizálás: Ütemezett műveletek menüpontban módosítható, a szállítmány fejlécében található Foxpost állapot frissítése gomb pedig igény szerint frissít egyetlen csomagot.

Amikor a Foxpost azt jelenti, hogy a vevő átvette a csomagot — kivette az automatából, vagy átvette a házhozszállítást —, az esemény dátuma a szállítmányon a tényleges vevői átvételi dátumként kerül rögzítésre. Ez a dátum táplálja a rendelés szállítási státuszát és a Szállítási státusz és dátumok oldalon ismertetett szállításidátum-riportokat.

Konfiguráció¶

Összefoglaló ellenőrzőlista egy működő Foxpost-beállításhoz:

Telepítse a Delivery Foxpost modult (eyssen_delivery_foxpost); a közös szállítási, fizetési és szállításistátusz-rétegek függőségként automatikusan települnek.
Szerezzen be a Foxposttól teszt- és éles API hitelesítő adatokat.
A Készlet alkalmazás ‣ Konfiguráció ‣ Szállítás módja menüpontban nyissa meg a Foxpost Parcelmachine és/vagy a Foxpost Home delivery módot (vagy hozzon létre új módokat Foxpost értékre állított Szolgáltató mezővel), majd:
- adja meg az API felhasználó, API jelszó és API kulcs értékét;
- ellenőrizze a Szállítási mód mezőt és szükség esetén az Országok korlátozást;
- állítsa be az Árazás lapot (rögzített ár vagy sávos szabályok);
- tesztelje Test Environment módban, majd váltson Production Environment módra az éles hitelesítő adatokkal;
- tegye közzé a módot, hogy megjelenjen a weboldalon.
Az utánvét felkínálásához engedélyezze és tegye közzé a FoxPost COD, with credit card at parcelmachine or at delivery fizetési szolgáltatót a Weboldal ‣ Konfiguráció ‣ E-kereskedelem: Fizetési szolgáltatók menüpont alatt.
Vegye fel a bolt többi fizetési szolgáltatóját (kártya, banki átutalás) az egyes Foxpost módok Fizetési szolgáltatók lapjára, hogy ne az utánvét legyen az egyetlen választási lehetőség (lásd Szállítási módhoz kötött fizetési módok).
Ellenőrizze, hogy a kimenő művelettípuson engedélyezve van-e a Generate Shipping Labels opció.

Használat¶

A vevő a weboldalon leadja a rendelését, és egy Foxpost módot választ. Csomagautomatás mód esetén megnyílik a Foxpost térkép, és kiválasztja az automatáját; házhozszállítás esetén a csomag a szállítási címére megy.
A fizetési lépésben online fizet, vagy — legfeljebb 150 000 HUF összegű rendelésnél — a FoxPost COD lehetőséget választja, és átvételkor fizet.
Az értékesítési rendelés megerősítésre kerül — online fizetésnél automatikusan; utánvétes rendelésnél a megerősítés háttérirodai lépés marad —, és a raktár feldolgozza a szállítást. Ha a vevő kihagyta az automata kiválasztását, a munkatársak a Térképen kiválasztás gombbal (vagy az azonosító beírásával) választanak egyet a rendelésen vagy a szállítmányon.
A szállítmány érvényesítése regisztrálja a csomagot a Foxpostnál, eltárolja a Foxpost csomagszám értékét, és a nyomtatható címkét a chatterhez csatolja. Utánvétes rendelésnél az adott szállításra beszedendő összeg is kiszámításra kerül, és elküldésre kerül a Foxpostnak (lásd Utánvét (COD)).
A követési ütemezett művelet naprakészen tartja a Csomag állapota mezőt. Amikor a vevő átveszi a csomagot, az átvétel dátuma rögzítésre kerül, és a rendelés szállítási státusza ennek megfelelően frissül (lásd Szállítási státusz és dátumok).

Hatókör és modulok¶

eyssen_delivery_foxpost — a Foxpost fuvarozói összekötő: a Foxpost szállítási szolgáltató csomagautomata (APM) és házhozszállítás üzemmóddal, a térképalapú csomagautomata-választó (pénztárban és háttérrendszerben), sávos/rögzített árazás, csomagregisztráció és PDF-címkék, követés-szinkronizálás, valamint a FoxPost COD fizetési szolgáltató rekord.

Az összekötő a saját oldalukon dokumentált közös eYssen modulokra épül: a fuvarozónkénti fizetésszűrésre és az utánvétes pénztári élményre (Szállítási módhoz kötött fizetési módok), a dinamikus, szállításonkénti utánvét-összegre (Utánvét (COD)), valamint a kézbesítési dátum követésére (Szállítási státusz és dátumok).