--- title: "MPL" description: "Szállíts az MPL-lel (Magyar Posta) házhoz, PostaPontra, csomagautomatába és külföldre úgy, hogy a címkét, a napi zárást és a követést az áruház intézi." url: "https://docs.poltura.com/hu/apps/mpl/" lang: hu alternates: en: "https://docs.poltura.com/en/apps/mpl/" hu: "https://docs.poltura.com/hu/apps/mpl/" --- # MPL Szállíts az MPL-lel (Magyar Posta) házhoz, PostaPontra, csomagautomatába és külföldre úgy, hogy a címkét, a napi zárást és a követést az áruház intézi. - Hol: Alkalmazásbolt → MPL - Csomagok: Plus, Pro 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](https://docs.poltura.com/hu/settings/plan/) oldalon olvashatsz. ![Az MPL oldala az Alkalmazásboltban, telepítve és aktívan, felül egy sávval, amely szerint a futáralkalmazások még nincsenek a csomagodban](https://docs.poltura.com/screenshots/hu/apps/mpl.webp) _Ha a csomagodban nincs Futáralkalmazások funkció, ezt a felső sáv jelzi._ ## 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 1. 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](https://docs.poltura.com/hu/apps/#install). 2. 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. 3. 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](https://docs.poltura.com/hu/apps/mpl/#settings) részben találod. 4. A mentési sávban kattints a **Mentés** gombra. 5. 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. 6. Kattints a **Bekapcsolás** gombra. Az alkalmazás állapota **Aktív** lesz. 7. 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. 8. 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](https://docs.poltura.com/hu/developer/), 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](https://docs.poltura.com/hu/developer/locations-and-shipping/#shipping-options). Az árakat te adod meg. Az alkalmazás nem kér élő díjat az MPL-től. ## Beállítások - **Environment**: `sandbox` vagy `production`. A sandbox semmit nem továbbít a postai rendszereknek. Új telepítésnél `sandbox` az é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`, `M` vagy `L`. Minden csomag ezt a méretet kapja. Csomagonként külön méret egyelőre nem adható meg. - **Pickup retention (days)**: `5` vagy `10`. Ennyi napig őrzi a csomagot a PostaPont vagy az automata, mielőtt visszaküldi neked. - **Daily close time**: az az időpont `ÓÓ:pp` formá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ék `17: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](https://docs.poltura.com/hu/orders/fulfilment/#create). - 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](https://docs.poltura.com/hu/orders/fulfilment/#parcels). - 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](https://docs.poltura.com/hu/orders/fulfilment/#cancel). - 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. ## Kapcsolódó oldalak - [Alkalmazásbolt](https://docs.poltura.com/hu/apps/) - [Kézbesítés](https://docs.poltura.com/hu/settings/delivery/) - [Teljesítés és szállítás](https://docs.poltura.com/hu/orders/fulfilment/) - [Helyszínek és szállítás](https://docs.poltura.com/hu/developer/locations-and-shipping/) - [GLS](https://docs.poltura.com/hu/apps/gls/) - [Foxpost](https://docs.poltura.com/hu/apps/foxpost/)