Magyar Posta – MPL

Az MPL bekötése a Devportal-kulcsokkal, vevőkód és megállapodáskód, szolgáltatások, PostaPont-lista, kötelező napzárás és kárigény.

7 min readUpdated: 03/11/2026

This article is currently available in Hungarian only.

Szerződés és API-hozzáférés igénylése

Az MPL API csak szerződött üzleti ügyfeleknek érhető el. Az API-t a Posta díjmentesen adja, a szállítási díjakat a szerződésed szerint számlázza.

1. Szerződéskötés

  1. Töltsd ki a Magyar Posta webáruházi ajánlatigénylő űrlapját (posta.hu/webaruhazi_szerzodeskotes): cégadatok, adószám, webcím, kapcsolattartó, átlagos havi csomagszám és jellemző csomagsúly.
  2. A Posta üzletkötője e-mailben vagy telefonon egyedi ajánlattal keres meg.
  3. A szerződés aláírása után megkapod a vevőkódot és a megállapodáskódot.

Szerződéses kérdésekben a Posta üzleti ügyfélszolgálata segít: +36 1 767 8272.

2. API-kulcsok igénylése a Devportalon

A kulcsokat egy természetes személy kezeli: az, akit a céged erre kijelöl. Ő regisztrál, magánszemélyként (nem a cég nevében).

  1. Regisztrálj magánszemélyként az ÉnPostám felületen (posta.hu, Regisztráció gomb). Ha már van ÉnPostám-fiókod, ezt a lépést kihagyhatod.
  2. Az MPL API információs oldalán (posta.hu/mplapi) kattints a jobb oldali Regisztráció menüpontra, majd a zöld Regisztráció gombra.
  3. A letöltött Excel-adatlapot töltsd ki hiánytalanul az 1. lépésben regisztrált személy adataival, és küldd el a [email protected] címre.
  4. A Posta beállítja, hogy a megjelölt személy hozzáférjen a cég API-kulcsaihoz, és e-mailben visszaigazolja. Pontos átfutási időt a Posta nem tesz közzé.
  5. A visszaigazolás után az MPL API oldal Fejlesztői portál menüpontjából lépj be a Devportalra (devportal.posta.hu) az ÉnPostám-felhasználóneveddel és jelszavaddal.
  6. Belépés után válaszd a céges felhasználási módot.
  7. Az Alkalmazások menüpont alatt, az oldal alján találod a kulcspárokat: a prod jelölésű az éles, mellette a sandbox kulcspár. Mindkettő egy API Key és egy API Secret értékből áll.

3. Amit kapsz

A Postától kapott adat Rackoon-mező
API Key (Devportal, a környezetnek megfelelő kulcspárból) API-kulcs (client_id)
API Secret (ugyanabból a kulcspárból) API-titok (client_secret)
Vevőkód (a szerződésből) Vevőkód
Megállapodáskód (a szerződésből) Megállapodáskód

Tipp: Ha egy telephelyhez vagy alfiókhoz más vevőkód vagy megállapodáskód tartozik, add meg külön hozzáférésként. Részletek: Szolgáltató bekötése.

4. Tesztkörnyezet

A sandbox kulcspárt a Devportalon az éles mellett találod, külön igényelned nem kell. Tesztkörnyezetben a sandbox-kulcsokat, éles környezetben a prod kulcsokat add meg.

Fontos: A sandbox- és az éles kulcspárt ne keverd.

Megadás a Rackoonban

  1. Nyisd meg a Szolgáltatók menüt, és válaszd a Magyar Posta – MPL szolgáltatót.
  2. A Kapcsolat fülön a Környezet résznél válaszd a Teszt (sandbox) vagy az Éles lehetőséget.
  3. Töltsd ki az API-kulcs (client_id), API-titok (client_secret), Vevőkód és Megállapodáskód mezőt. A kulcspár a kiválasztott környezethez tartozzon.
  4. Kattints a Mentés, majd a Kapcsolat tesztelése gombra. Ha az ellenőrzés sikeres, a kapcsolat állapota Csatlakoztatva lesz.

Részletek: Szolgáltató bekötése, összehasonlítás: Szolgáltatói szerződés és API-kulcsok.

Teszt és éles környezet

Az MPL-nek van sandbox környezete. Ugyanaz az alkalmazás, mint az éles, de az adatai nem feltétlenül naprakészek, és nem jutnak el más rendszerekbe. A Környezet mezőben válaszd a Teszt (sandbox) vagy az Éles lehetőséget.

Szolgáltatások

Szolgáltatás Típus Súlyhatár
MPL Üzleti csomag – házhoz Házhozszállítás 40 kg
MPL Üzleti csomag – PostaPont Csomagpont 20 kg
MPL Üzleti csomag – csomagautomata Csomagautomata 20 kg
MPL Üzleti csomag – postán maradó Csomagpont (posta) 40 kg
MPL Üzleti csomag – raklapos Raklap –
MPL Postacsomag – házhoz Házhozszállítás 20 kg
Inverz csomag (visszáru) Visszáru –
Cserecsomag Csere –
MPL Europe Standard; Európa+ csomag Nemzetközi (EU) 30 kg
Nemzetközi csomag; Nemzetközi elsőbbségi csomag Nemzetközi (világ) 30 kg
EMS gyorsposta Expressz (világ) 30 kg
Inverz MPL Europe Standard (nemzetközi visszáru) Visszáru (EU) –

Kiegészítő szolgáltatások: Árufizetés (utánvét), Értéknyilvánítás, Törékeny, Terjedelmes, 1 munkanapos időgarancia, Időablak, Fix napos kézbesítés, Szombati kézbesítés, Tértivevény, Saját kézbe, Őrzési idő (0/5/10 munkanap), Címzett fizet, Dokumentumkezelés, Felvétel háznál.

Az MPL kezeli a vámadatokat: EU-n kívüli célországnál az Új csomag űrlapján megjelenik a Vámadatok lépés. Részletek: Nemzetközi csomag.

Címkeformátumok: A4, A5, A5inverz, A5E, A6, A6inverz, ZPL.

Csomagpontok

A pontlista a Magyar Posta nyilvános PostaPont-térképének adataiból készül, és naponta frissül. Benne vannak a posták, a Posta Partner pontok (kistelepülési, partner által működtetett postai szolgáltatóhelyek), a PostaPontok és a csomagautomaták. Részletek: Csomagpontok és automaták.

Különleges szabályok

  • A napzárás kötelező. Zárás nélkül a csomag nem indul el. A napot a Napzárás oldalon zárhatod le, vagy a Kapcsolat fülön beállított Automatikus napzárás időpontjában automatikusan lezárul. Részletek: Címke, napzárás és futárrendelés.
  • Törlés csak zárás előtt. A lezárt csomagot már nem törölheted a panelről.
  • Futárrendelés. Az MPL a futárrendelést nem API-n keresztül fogadja.
  • Státuszszinkron: push stream (folyamatos kapcsolat), 60 percenként.

Kárigény és reklamáció

Bejelentés Szerződött partnerként webes űrlapon: https://www.posta.hu/ugyfelszolgalat/szerzodott_partnerek/webform/serules, e-mailben: [email protected]. Kárigényt bármely postán is bejelenthetsz.
Telefon +36 1 767 8272 – ellenőrizd a szolgáltató aktuális ÁSZF-jében
Nyomtatvány Adatlap – sérült küldemény kártérítési igény elektronikus bejelentéséhez
Sérülés Látható sérülésnél azonnal, a kézbesítéskor, rejtett sérülésnél a kézbesítéstől számított 3 munkanapon belül
Elveszés A feladástól számított 15. naptól kezdődően, 6 hónapon belül (jogvesztő)
Válaszadás 30 napon belül

Felelősség: értéknyilvánítás nélkül kártérítési átalány jár, a szolgáltatási díj tizenötszöröse (részleges kárnál arányosan). Az MPL Üzleti csomag díjmentesen tartalmazza a legfeljebb 50 000 Ft-os értéknyilvánítást, ha az összeget a címiraton feltüntették. Külön díjért 50 001 Ft-tól 2 000 000 Ft-ig nyilváníthatsz értéket (csomagautomatás feladásnál vagy címzésnél legfeljebb 500 000 Ft-ig). Értéknyilvánításnál a kártérítés legfeljebb a tényleges kereskedelmi érték.

Szükséges dokumentumok: látható sérülésnél a Postával közösen felvett kármegállapítási jegyzőkönyv, a teljes csomag a belső és külső csomagolással, a tartalom értékét igazoló számlák, a csomag azonosítója, webes bejelentésnél a kitöltött adatlap és fényképek (összesen legfeljebb 10 MB).

Megjegyzés: Az MPL Üzleti csomag fuvarozási szolgáltatására (külön szerződés) eltérő szabályok vonatkoznak. Az egyedi szerződés minden esetben felülírhatja a fenti általános feltételeket.

A panelen a csomag oldalán a Műveletek → Reklamáció, kárigény ponttal indíthatsz reklamációt.