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.
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
- 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.
- A Posta üzletkötője e-mailben vagy telefonon egyedi ajánlattal keres meg.
- 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).
- 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.
- 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.
- 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.
- 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é.
- 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.
- Belépés után válaszd a céges felhasználási módot.
- 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
- Nyisd meg a Szolgáltatók menüt, és válaszd a Magyar Posta – MPL szolgáltatót.
- A Kapcsolat fülön a Környezet résznél válaszd a Teszt (sandbox) vagy az Éles lehetőséget.
- 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.
- 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.