MPL integráció¶

Az MPL a Magyar Posta, a magyar postai szolgáltató csomagszolgáltatása. Az eyssen_delivery_mpl modul közvetlenül összeköti az Odoo webáruházat és a raktárat az MPL API v2-vel: a vevők a fizetés során választhatnak a házhoz szállítás és az MPL csomagponton (Csomagautomata, PostaPont vagy Postán maradó) történő átvétel között, a raktár közvetlenül a szállítólevélről nyomtatja az A6-os PDF szállítási címkéket, a követési státuszok automatikusan szinkronizálódnak az MPL követésiesemény-katalógusával, egy dedikált MPL COD utánvétes (COD) fizetési mód pedig minden címkével együtt továbbítja a beszedendő összeget.

Lásd még

Fiókbeállítás¶

Az MPL-szállításhoz üzleti szerződés szükséges a Magyar Postával, valamint hozzáférés az MPL API v2-höz. Az integráció OAuth2 klienshitelesítő adatokkal (client credentials) hitelesít, ezért az alábbi értékeket az Odoo beállítása előtt be kell szerezni a Magyar Postától:

egy Client ID / Client Secret pár a teszt (sandbox) környezethez;
egy Client ID / Client Secret pár az éles környezethez;
a vevői könyvelési kód (Vevőkód), amely a szállítmány- és csomagpont-API-kérésekkel együtt kerül elküldésre;
a Magyar Posta-szerződés nyolc karakteres megállapodásszáma (Megállapodásszám).

Javaslat

Kezdje a tesztadatokkal, a Környezet kapcsolót Teszt állásban hagyva. A modul ilyenkor a Magyar Posta sandbox környezetével kommunikál, így a tesztelés közben létrehozott címkék és szállítmányok soha nem kerülnek be a valódi MPL-hálózatba. Csak akkor állítsa a fuvarozót Éles állásba, ha a folyamat elejétől a végéig ellenőrzésre került.

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

A modul két előre beállított szállítási móddal települ: MPL Parcel Shop (csomagponti átvétel) és MPL Home delivery. Ezek megtekintéséhez vagy új létrehozásához lépjen a Készlet alkalmazás ‣ Konfiguráció ‣ Szállítás módja menüpontba, és állítsa a Szolgáltató mezőt MPL értékre. Ekkor két további fül jelenik meg az űrlapon: az MPL Configuration és a Pricing fül.

A minden fuvarozónál közös általános mezőkkel kapcsolatban — mint a Szállítási termék, az Országok elérhetőség vagy az ingyenes szállítási értékhatár — lásd: Harmadik fél szállítói szolgáltatók.

Megjegyzés

Ahhoz, hogy a szállítólevél jóváhagyásakor MPL szállítási címke készüljön, állítsa az Integrációs szint opciót Érték igénylése és szállítás létrehozása értékre. Címke bármikor kézzel is létrehozható a szállítólevélen található Print MPL Label gombbal.

Hitelesítő adatok¶

Az MPL Configuration fül mezői csak az Adminisztráció: Beállítások jogosultsággal rendelkező felhasználók számára láthatók:

Test Client ID / Test Client Secret: a sandbox hitelesítő adatpár, amely addig használatos, amíg a fuvarozó Környezet mezője Teszt álláson van.
Production Client ID / Production Client Secret: az éles hitelesítő adatpár, amely Éles környezetben használatos. A titkos kulcsok a képernyőn maszkolva jelennek meg.
Accounting Code (Vevőkód): a Magyar Posta vevői könyvelési kódja, amely fejlécként kerül továbbításra a szállítmányregisztrációkkal és a csomagpont-katalógus lekérdezéseivel.
Agreement Number (Megállapodásszám): a nyolc karakteres szerződésszám, amely minden szállítmányon a feladó megállapodásaként kerül továbbításra.

Ha úgy készül címke, vagy úgy indul kézi szinkronizálás, hogy az aktív környezethez nincsenek megadva hitelesítő adatok, a művelet egyértelmű hibaüzenettel leáll. Az ütemezett katalógus-szinkronizálás naplózza a hibát, és a következő futásakor újra próbálkozik.

Kézbesítési módok¶

Az MPL Configuration fülön található Delivery type mező határozza meg a fuvarozó viselkedését:

	Házhozszállítás	Csomagpont
Célállomás	A vevő szállítási címe.	A vevő által kiválasztott MPL csomagpont.
Fizetés	Ugyanúgy viselkedik, mint bármely más fuvarozó.	Megnyitja a csomagpont-választót; a rendelés addig nem véglegesíthető, amíg nincs csomagpont kiválasztva.
Címke	Házhoz szállítási szállítmányként kerül regisztrálásra.	A kiválasztott ponton történő átvételre kerül regisztrálásra, a pont szolgáltatástípusát használva.

A csomagpont az MPL három szolgáltatásipont-típusának egyike; a választó mindhármat együtt kínálja fel:

Csomagautomata — automata csomagszekrény, jellemzően a nap 24 órájában elérhető;
Postán maradó — a csomagot egy postán őrzik az átvételig;
PostaPont — személyzettel működő átvételi hely, jellemzően a Magyar Posta kiskereskedelmi partnereinél.

A vevő által választott pont típusa a pont azonosítójával és nevével együtt az értékesítési rendelésen tárolódik, és a címke létrehozásakor kerül továbbításra az MPL felé.

A Create Delivery Address for PS opció (alapértelmezés szerint kikapcsolva, csak csomagpontos fuvarozóknál) hatására a webáruház a kiválasztott csomagponthoz külön szállítási címet hoz létre a vevő alatt, és azt állítja be a rendelés szállítási címeként. Ha a vevő később másik szállítási módra vált, a szállítási cím visszaáll a vevőre, és az ideiglenes csomagponti cím automatikusan törlődik.

Árképzés¶

A modul által hozzáadott Pricing fül két árazási módot támogat:

Sávos árazás: adjon hozzá egy vagy több Árszabályok tételt (súly, térfogat, ár vagy mennyiség szerint). A szabályok sorrendben kerülnek kiértékelésre, és az első illeszkedő szabály határozza meg a szállítási árat; ha egyik szabály sem illeszkedik, a mód továbbra is megjelenik a fizetéskor, de nem választható ki — az Odoo a Not available for current order üzenetet mutatja.
Fix tartalékár: ha nincs árszabá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éken lévő árlistaszabályok pedig árlistánként felülbírálják azt.

A szabványos fuvarozói mechanizmusok — az ingyenes szállítási értékhatár, az árrések és az adók — mindkét mód tetején érvényesülnek, pontosan úgy, mint bármely más szállítási módnál.

Megjegyzés

Bármely MPL-mód fizetéskori kiválasztása egy Handling service terméksort is hozzáad a rendeléshez (alapértelmezett eladási ár: 2 000 a vállalat pénznemében — azaz 2 000 HUF egy magyar adatbázison —, a rendelés árlistáján keresztül árazva). A sor automatikusan törlődik, ha a vevő nem MPL-módra vált. A felár kikapcsolásához állítsa a Handling service termék eladási árát 0 értékre.

Utánvét¶

A modul egy MPL COD, with credit card at parcelshop or at delivery nevű fizetési szolgáltatót is telepít. Mint minden szolgáltatót, ezt is engedélyezni és közzé kell tenni, mielőtt megjelenne a fizetéskor, és csak akkor kerül felajánlásra, ha a weboldalon van közzétett MPL szállítási mód, és a kosárban fizikai termék található.

A beszedendő összeg kimenő szállításonként (szállítólevelenként) kerül kiszámításra — a részleges szállítmányokat, a szolgáltatássorokat és a számlázott előlegeket egyaránt a Utánvét (COD) oldalon leírt közös számítás kezeli, az eredmény pedig a szállítólevél COD Amount mezőjében tárolódik.
Az összeg egész számként kerül továbbításra: a HUF-ban lévő rendelések változatlanul kerülnek elküldésre; a más pénznemű rendelések a címke létrehozásakor aktuális árfolyamon HUF-ra váltódnak, és a rendelés pénznemkódja az összeg mellett kerül továbbításra. Mielőtt erre támaszkodna, egyeztesse a devizás utánvétes rendeléseket a Magyar Postával.
Az MPL Configuration fülön található COD Bank Account mező a beszedett összegek kifizetési számlájaként kerül elküldésre.
Azt, hogy az egyes MPL szállítási módok mellé mely fizetési módok kerülnek felajánlásra — és az utánvét-specifikus fizetési élményt — a Szállítási módhoz kötött fizetési módok oldalon leírt fuvarozónkénti fizetésszűrés vezérli. Alapállapotban a telepített MPL-fuvarozók csak a saját utánvétes szolgáltatójukat engedik — mindaddig, amíg más fuvarozó utánvétes szolgáltatója nincs engedélyezve, mivel az utánvétes szolgáltatók külön ágon kerülnek ellenőrzésre (lásd: Szállítási módhoz kötött fizetési módok) —, ezért a választék érdekében adja hozzá a bolt kártyás vagy átutalásos szolgáltatóit a fuvarozókhoz.

Fontos

Ha egy utánvétes szállítmány több csomagra oszlik, a jelenlegi integráció minden csomaggal a teljes utánvét-összeget továbbítja. Az utánvétes rendeléseket egyetlen csomagként adja fel, vagy egyeztesse a Magyar Postával, hogyan történik a többcsomagos utánvétes küldemények beszedése, hogy elkerülje a vevő túlterhelését.

Telefonszám-ellenőrzés¶

Az MPL minden szállítmányhoz érvényes magyar mobil- vagy vezetékes telefonszámot követel meg. A címke létrehozásakor a modul a szállítási cím Mobil számát veszi, majd a Telefon számát, végül a szülő kapcsolatra vált vissza, és az eredményt a nemzetközi +36 formátumra normalizálja (a belföldi 06 előtaggal megadott számok automatikusan átalakításra kerülnek). Ha nem található szám, vagy a szám nem magyar, a címke létrehozása blokkoló hibával leáll — az integráció ebben a tekintetben csak belföldi.

Csomagpont-katalógus¶

A webáruházi választó nem kérdezi le a Magyar Postát minden oldalmegtekintéskor. Ehelyett a modul helyi katalógust tart fenn az összes MPL csomagpontról (név, cím, koordináták és szolgáltatásipont-típus), amelyet a napi MPL: Sync Delivery Places ütemezett művelet tart naprakészen:

a Csomagautomata, Postán maradó és PostaPont helyszínek teljes listája letöltésre kerül az MPL API-ból, egy beállított MPL szállítási mód hitelesítő adataival;
a meglévő bejegyzések helyben frissülnek, az újak hozzáadódnak, a Magyar Postánál már nem létező pontok pedig törlődnek;
minden bejegyzés rögzíti, hogy mikor volt utoljára szinkronizálva.

Az a rendelés, amely már tárol egy kiválasztott pontot, akkor is működőképes marad, ha a pont később eltűnik a katalógusból — a pont azonosítója és neve a kiválasztás pillanatában átmásolódik a rendelésre.

Javaslat

Közvetlenül a telepítés után a katalógus üres, amíg az ütemezett művelet először le nem fut. Ebben az állapotban a backend választó segít: irányítószámra vagy városra keresve az illeszkedő pontok élőben kerülnek lekérésre az MPL API-ból, és helyben tárolódnak.

Webáruházi fizetés: csomagpont kiválasztása¶

Amikor a vevő a fizetéskor MPL csomagpontos szállítási módot választ, azonnal megnyílik egy teljes képernyős választó, és a fizetés addig nem folytatható, amíg nincs csomagpont kiválasztva — addig figyelmeztetés jelenik meg a szállítási mód alatt. A kiválasztott pont a mód alatt jelenik meg, a rendelésen tárolódik, és automatikusan visszaáll, amikor a vevő később visszatér a fizetéshez.

A választónak két módja van, amelyet a weboldal beállítása dönt el:

	Térképes widget	Kereshető lista
Előfeltétel	A weboldal beállításaiban megadott Google Maps API Key	nincs (alapértelmezett)
Felület	A Magyar Posta hivatalos PostaPont térkép-widgetje Google-térképen	Beépített lista típusszűrőkkel (Csomagautomata / Postán maradó / PostaPont), szöveges kereséssel és lapozással
Adatforrás	Élőben töltődik be a Magyar Postától	A helyi csomagpont-katalógus
Szolgáltatási pont típusa	A widget nem adja meg — a szállítmányok az általános PostaPont kézbesítési móddal kerülnek regisztrálásra	A kiválasztással együtt tárolódik, és továbbításra kerül az MPL felé

A térképes mód engedélyezéséhez lépjen a Weboldal ‣ Konfiguráció ‣ Beállítások menüpontba, keresse meg az MPL blokkot, és adjon meg egy Google Maps API Key értéket. Hagyja üresen a kulcsot a kereshető lista használatához, amelynek a napi katalógus-szinkronizáláson kívül nincs szüksége külső szolgáltatásra.

A háttérirodai felhasználók a webáruház nélkül is kiválaszthatják vagy módosíthatják a pontot: az értékesítési rendelésen és a szállítólevélen egyaránt megjelenik egy MPL csomagpont mező a Térképen kiválasztás gombbal, amely megnyitja az MPL csomagpont kiválasztása párbeszédablakot — egy kereshető listát Csomagautomata, Postán maradó és PostaPont szűrőkkel. A mező zárolódik, amint a szállítmány regisztrálásra került az MPL-nél, vagy a rendelés kész, illetve törölt állapotba került.

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

A címkék A6-os PDF formátumban készülnek, címkenyomtatókra készen:

Ha az Integrációs szint Érték igénylése és szállítás létrehozása értékre van állítva, a szállítólevél jóváhagyása automatikusan regisztrálja a szállítmányt az MPL-nél.
A szállítólevélen található Print MPL Label gomb bármikor kézzel létrehozza a szállítmányt; a gomb eltűnik, amint már létezik címke.
Siker esetén a szállítólevél eltárolja az MPL parcel ID, az MPL parcel number (ha a szállítmány a szállítólevél jóváhagyásával kerül regisztrálásra, a szám a szabványos követési hivatkozásba is átmásolódik; a kézi Print MPL Label gomb csak az MPL-mezőket tölti ki) és a letölthető MPL label mezőt, a címke PDF pedig a követési számmal együtt a szállítólevél chatterébe kerül csatolásra.

Ha a termékek több csomagba kerülnek csomagolásra, csomagonként egy-egy küldemény kerül regisztrálásra, és minden csomag szállítási súlya egyedileg kerül továbbításra (a súlyok grammban kerülnek elküldésre, legalább 100 g értékkel, illetve 1 kg alapértelmezéssel, ha nincs súly megadva). Ha az MPL csomagonkénti követési számokat ad vissza, minden csomagrekord a saját számát tárolja, így a küldemények egyenként követhetők; ellenkező esetben a csomagok a szállítmány követési számán osztoznak.

Fontos

A Print MPL Label nem újranyomtató gomb. Megnyomása törli a tárolt csomagadatokat, és új szállítmányt regisztrál az MPL-nél. Ezért a gomb elrejtésre kerül, amint már létezik címke; a szállítmány újraregisztrálása csak fejlesztői móddal rendelkező felhasználóknak érhető el. Egy meglévő címke újranyomtatásához ehelyett töltse le a tárolt MPL label fájlt vagy a chatter-mellékletet.

Megjegyzés

Az MPL felé továbbított feladói cím mindig a vállalat címe, nem a raktár címe. A több raktárból szállító kereskedők az MPL felé a vállalat székhelycímén jelennek meg.

Nyomkövetés és állapotok¶

A modul telepíti az MPL követésiesemény-katalógusát — 46 állapotot a felvételi, feldolgozási, szállítási és kézbesítési fázisokban — szerkeszthető rekordokként a Készlet alkalmazás ‣ Konfiguráció ‣ MPL Delivery States menüpont alatt; mindegyik rekordhoz tartozik egy State Code, egy State Category, egy MPL State Name és egy Delivered State jelölőnégyzet.

A státuszokat két ütemezett művelet frissíti automatikusan, mindkettő háromóránként fut:

A Picking: Update MPL tracking information minden olyan szállítólevelet lekérdez, amelynek van MPL csomagszáma, és még nem kész vagy törölt;
A Package: Update MPL tracking information az egyes csomagokat kérdezi le, futásonként legfeljebb 50-et, és ugyanazon csomag ismételt ellenőrzései között a beállított Tracking Check Interval időt tartja (alapértelmezés: 60 perc).

A legutóbbi állapot, annak kódja és időbélyege a szállítólevélen (Parcel state, Parcel state code, Parcel state date) és minden csomagon megjelenik; a szállítólevélen ezenfelül egy Update MPL Status gomb is található az igény szerinti frissítéshez.

Az állapotkatalógusra két automatizmus épül:

Kézbesítési dátum: ha egy követési esemény olyan állapotra képződik le, amelynek Delivered State négyzete be van jelölve, a szállítólevélre rábélyegzésre kerül az a dátum, amikor a vevő ténylegesen átvette az árut (a tényleges ügyfél-átvételi dátum), az MPL által jelentett kézbesítési időbélyeg alapján. Ez táplálja a Szállítási státusz és dátumok oldalon leírt rendelésszintű szállítási előrehaladást.
Automatikus jóváhagyás: a művelettípuson (Készlet alkalmazás ‣ Konfiguráció ‣ Műveletek típusai) a Validation on MPL Delivery csoport a Validate Picking on Delivery opciót kínálja egy Validate on MPL States listával együtt. Amint a szállítólevél minden csomagja eléri valamelyik kiválasztott állapotot, a szállítólevél automatikusan jóváhagyásra kerül. Ez halasztott jóváhagyási folyamatot tesz lehetővé: hagyja nyitva a szállítólevelet a címke nyomtatása után, hagyja, hogy az ütemezett műveletek kövessék a csomagot, és az Odoo zárja le a szállítólevelet, amikor az MPL kézbesítést jelent.

Figyelem

A halasztott jóváhagyási folyamat használatakor állítsa a szállítási mód Integrációs szint mezőjét Érték igénylés értékre (vagy vegye ki a Generate Shipping Labels pipát a művelettípuson). Érték igénylése és szállítás létrehozása beállítással az automatikus jóváhagyás másodszor is regisztrálja a szállítmányt az MPL-nél, mert a Print MPL Label gomb nem tölti ki azt a szabványos követési hivatkozást, amely elnyomná a jóváhagyáskori regisztrációt.

Fontos

A 46 telepített állapot egyike sincs előre kézbesítettként megjelölve. Telepítés után jelölje be a Delivered State négyzetet a végállapotot jelentő Kézbesített sorokon — különben sem a kézbesítési dátum bélyegzése, sem a kézbesítésalapú automatikus jóváhagyás nem lép működésbe.

Megjegyzés

A szállítólevél-szintű ütemezett művelet szándékosan kihagyja a már kész szállítóleveleket. Ha a szállítások már a feladáskor azonnal jóváhagyásra kerülnek, a követés csak a csomagszintű műveleten és a kézi Update MPL Status gombon keresztül frissül tovább.

Konfiguráció¶

Ellenőrzőlista az MPL éles indításához:

Telepítse az eyssen_delivery_mpl modult.
Minden MPL szállítási módon (Készlet alkalmazás ‣ Konfiguráció ‣ Szállítás módja) töltse ki az MPL Configuration fület: a választott Környezet hitelesítő adatait, az Accounting Code (Vevőkód) és az Agreement Number (Megállapodásszám) mezőt, valamint — utánvéthez — a COD Bank Account mezőt.
Válassza ki módonként a Delivery type értékét, állítsa be a Pricing fület, és tegye közzé a módokat a weboldalon.
Engedélyezze és tegye közzé az MPL COD, with credit card at parcelshop or at delivery fizetési szolgáltatót, és tekintse át az egyes fuvarozóknál engedélyezett fizetési szolgáltatókat (lásd: Szállítási módhoz kötött fizetési módok).
A Weboldal ‣ Konfiguráció ‣ Beállítások menüpont MPL blokkjában: igény szerint adjon meg egy Google Maps API Key értéket a térképes választóhoz, és szükség esetén módosítsa a Tracking Check Interval értékét.
A Készlet alkalmazás ‣ Konfiguráció ‣ MPL Delivery States menüpont alatt jelölje be a Delivered State négyzetet a kézbesítést jelentő sorokon.
Igény szerint állítsa be az automatikus jóváhagyást a kimenő művelettípuson (Validate Picking on Delivery + Validate on MPL States).
Állítsa be a Handling service termék eladási árát (a 0 érték kikapcsolja a fizetéskori felárat).
Hagyja, hogy a napi MPL: Sync Delivery Places ütemezett művelet feltöltse a csomagpont-katalógust, vagy indítson egy kezdeti irányítószámos keresést a backend választóból.

Használat¶

A vevő fizet a weboldalon, és MPL szállítási módot választ. Csomagpontos mód esetén megnyílik a választó, és a vevő kiválaszt egy Csomagautomata, Postán maradó vagy PostaPont helyszínt; a fizetés blokkolva van, amíg nincs pont kiválasztva.
A vevő fizet — az MPL COD móddal vagy a fuvarozóhoz engedélyezett bármely más szolgáltatóval —, és a kiválasztott csomagpont az értékesítési rendelésen tárolódik.
A raktár feldolgozza a szállítólevelet. A jóváhagyása (vagy a Print MPL Label gomb megnyomása) regisztrálja a szállítmányt az MPL-nél, adott esetben kiszámítja az utánvét összegét, és csatolja az A6-os PDF címkét — csomagonkénti követési számokkal, ha az MPL megadja azokat.
Az ütemezett műveletek végigkövetik a csomagot az MPL követési állapotain. Amikor a csomag egy Delivered State jelölésű állapotot ér el, rábélyegzésre kerül az ügyfél-átvételi dátum, és — ha a művelettípuson be van állítva — a szállítólevél automatikusan jóváhagyásra kerül.

Hatókör és modulok¶

eyssen_delivery_mpl — az MPL fuvarozó-összekötő: az MPL szállításimód-típus házhoz szállítási és csomagpontos változatokkal, a csomagpont-katalógus és a választók, az A6-os PDF címkegenerálás, a követés-szinkronizálás automatikus jóváhagyással, valamint az MPL COD fizetési szolgáltató.

Az utánvét-összeg számítása, a fuvarozónkénti fizetésszűrés és a szállításistátusz-mezők, amelyekhez az összekötő kapcsolódik, közös építőelemek, amelyeket a Utánvét (COD), a Szállítási módhoz kötött fizetési módok és a Szállítási státusz és dátumok oldal dokumentál.