Az MPL alkalmazás összeköti az áruházat az MPL-lel, a Magyar Posta csomagszolgáltatásával. A vásárló Magyarországon belül házhozszállítást, PostaPontot vagy csomagautomatát választ, külföldre pedig nemzetközi csomagot. Amikor teljesíted a rendelést, az alkalmazás lefoglalja a küldeményt, és a címkét a rendelésen tárolja. A feladójegyzéket naponta egyszer lezárja helyetted, a csomag állapotát pedig magától követi. Azoknak való, akik Magyarországról küldenek, MPL-szerződéssel.
Az alkalmazáshoz a csomagodnak tartalmaznia kell a „Futáralkalmazások” funkciót, amit a Plus és a Pro csomag tartalmaz. Erről a Csomag és számlázás oldalon olvashatsz.

Mielőtt elkezdenéd
- MPL-szerződés kell. Ezzel a Magyar Posta megadja a vevőkódját és legalább egy megállapodáskódot.
- Az MPL fejlesztői portálján (
https://devportal.posta.hu) létre kell hoznod egy alkalmazást. Ettől kapsz egy API-kulcsot és egy titkos kulcsot. A tesztrendszernek (sandbox) és az éles rendszernek külön kulcspárja van. - Ha utánvétet is elfogadsz, kell az a bankszámla, amelyre az MPL a beszedett összegeket utalja.
- Ha az EU-n kívülre is értékesítesz, minden termékváltozathoz kell vámtarifaszám (HS-kód), származási ország és súly.
Az MPL beállítása
Nyisd meg az Alkalmazásbolt oldalt, válaszd az MPL alkalmazást, és kattints a Telepítés gombra. A telepítés minden alkalmazásnál ugyanúgy megy, lásd: Alkalmazásbolt.
A Beállítások szakaszban add meg az API-kulcsot, a titkos kulcsot, a vevőkódot és a megállapodáskódot, az Environment mezőt pedig hagyd
sandboxértéken.Töltsd ki a feladó adatait, utánvét esetén pedig a COD bank account mezőt is. A mezők leírását a Beállítások részben találod.
A mentési sávban kattints a Mentés gombra.
Kattints a Hitelesítő adatok ellenőrzése gombra. A hitelesítő adatok működnek. üzenet jelzi, hogy az MPL elfogadta a kulcspárt.
Kattints a Bekapcsolás gombra. Az alkalmazás állapota Aktív lesz.
Nyisd meg a Beállítások → Kézbesítés oldalt, és lépj annak a telephelynek a szállítási beállításaihoz, ahonnan a csomagokat küldöd. Kattints a Futár csatlakoztatása gombra, és kösd az MPL-t a telephelyhez.
A Magyarországot lefedő szállítási zónában kattints a Díj hozzáadása gombra, írd be a Díj neve mezőbe, amit a vásárló a pénztárban lát, a Futár mezőben válaszd az MPL-t, add meg az árat, és ments. A pénztár ettől kezdve kínálja a díjat.
Az így felvett díj MPL házhozszállítás. Ha PostaPontos és automatás átvételt is kínálnál, vagy nemzetközi csomagot a Magyarországon kívüli zónákban, kapcsold be a fejlesztői módot, vegyél fel a zónába egy szállítási opciót, és a Provider and delivery mezőben válaszd az „MPL PostaPont / parcel locker”, illetve az „MPL international parcel” végű sort. Lásd: Helyszínek és szállítás.
Az árakat te adod meg. Az alkalmazás nem kér élő díjat az MPL-től.
Beállítások
- Environment:
sandboxvagyproduction. A sandbox semmit nem továbbít a postai rendszereknek. Új telepítésnélsandboxaz érték. - API key (client id) (kötelező): az alkalmazás kulcsa az MPL fejlesztői portáljáról.
- API secret (kötelező): a kulcshoz tartozó titkos kulcs. Titkosítva tároljuk.
- Vevőkód (accounting code) (kötelező): a vevőkódod az MPL-szerződésből.
- Megállapodáskód (agreement code) (kötelező): az a szerződéskód, amelyre a csomagokat könyveljük. Áruházanként egy megállapodás adható meg.
- COD bank account: az a bankszámla, amelyre az MPL a beszedett utánvétet utalja. Kötelező, ha utánvétet is elfogadsz.
- Sender name (kötelező): a cég vagy személy, akit az MPL feladóként tüntet fel.
- Sender email (kötelező): erre a címre küldi az MPL a neked szóló küldeményértesítéseket.
- Sender phone (kötelező): az a telefonszám, amelyen a futár a felvételkor eléri.
- Sender postcode (kötelező), Sender city (kötelező) és Sender street address (kötelező): a felvételi cím. Az irányítószám négyjegyű magyar irányítószám, az utca és a házszám egy sorba kerül.
- Default parcel size:
S,MvagyL. Minden csomag ezt a méretet kapja. Csomagonként külön méret egyelőre nem adható meg. - Pickup retention (days):
5vagy10. Ennyi napig őrzi a csomagot a PostaPont vagy az automata, mielőtt visszaküldi neked. - Daily close time: az az időpont
ÓÓ:ppformában, amikor az alkalmazás lezárja az aznapi feladójegyzéket. Mindig magyar idő szerint értendő, bármilyen időzónát használ az áruház. Az alapérték17:00.
Amit a vásárló lát a pénztárban
- Házhozszállítás és átvételi pont csak magyarországi címre választható.
- Átvételi pontos díjnál a vásárló az Átvételi pont kiválasztása gombra kattint, és név, település vagy irányítószám alapján keres. A listát PostaPont vagy Csomagautomata szerint szűrheti. Amíg nem választ, nem léphet tovább a fizetéshez.
- A nemzetközi díj a Magyarországon kívüli címekre szól.
Napi használat
- Nyisd meg a rendelést, és kattints a Tételek teljesítése gombra. A teljesítés létrehozása lefoglalja a küldeményt az MPL-nél, és eltárolja a címkét. Lásd: Teljesítés és szállítás.
- Ha a rendelést utánvéttel adták le, a végösszeg utánvétként megy az MPL-nek. Az MPL csak forintban szedi be, és a COD bank account mezőben megadott számlára utalja.
- A csomagokat csak a feladójegyzék lezárása után lehet átadni. Az alkalmazás naponta egyszer, a Daily close time időpontjában zárja le. Ezután a csomagnál megjelenik a Lezárva jelzés és a Fuvarlevél hivatkozás, amely a feladójegyzéket nyitja meg.
- A rendelés oldalán az MPL csomagok panel minden csomagnál mutatja a Címke, a Fuvarlevél és a Követés hivatkozást, a szolgáltatást és az átvételi pontot. Lásd: csomagok.
- A csomag állapotát 4 óránként lekérdezzük. A kézbesített csomag kézbesítettre állítja a teljesítést. A Beavatkozást igényel jelzés és a kézbesítési problémát leíró sor azokat a csomagokat emeli ki, amelyekre rá kell nézned.
- A teljesítés lemondása törli a küldeményt az MPL-nél. Ez csak a napi zárás előtt működik. Lásd: teljesítés lemondása.
- Visszaküldési címkét az alkalmazás nem készít. A visszaküldést az MPL felületén hozd létre.
Nemzetközi csomagok: az MPL Európa Standard Ausztriába, Belgiumba, Csehországba, Németországba, Luxemburgba, Hollandiába, Lengyelországba, Szlovéniába és Szlovákiába megy. Az EU-n kívüli célországoknál az alkalmazás vámadatokat is küld, és a teljesítést nem engedi, ha valamelyik változatnál hiányzik a vámtarifaszám, a származási ország vagy a súly.
Ha valami nem működik
- Az ellenőrzés szerint az MPL elutasította a hitelesítő adatokat. Ellenőrizd a kulcsot és a titkos kulcsot. A sandboxnak és az éles rendszernek külön kulcspárja van, ezért az Environment mezőhöz kell illeniük.
- A teljesítés azzal áll meg, hogy az MPL feladói adatok hiányosak. Az üzenet megnevezi a hiányzó feladói mezőket. Töltsd ki őket, és ments.
- Az utánvéthez hiányzik a bankszámla. Töltsd ki a COD bank account mezőt, majd teljesítsd újra.
- Az utánvét nem forintban van. Az MPL csak forintban szed be utánvétet. A vásárlónak más módon kell fizetnie.
- A küldemény már nem törölhető. Lefutott a napi zárás. Egyeztess az MPL-lel.
- A vásárló azt látja, hogy az MPL házhozszállítás és a PostaPont csak Magyarországon belül érhető el. A Magyarországon kívüli zónákban a nemzetközi díjat kínálja.
- Az EU-n kívüli teljesítést nem engedi a rendszer. Töltsd ki a rendelés minden változatánál a vámtarifaszámot, a származási országot és a súlyt.