Magyar Posta API
A Globe Pickup Points integrálódik a Magyar Postával (MPL), a magyar nemzeti postai szolgáltatóval, lehetővé téve a rendelések zökkenőmentes exportálását és a szállítási címkék nyomtatását közvetlenül a Shopify-ból. Ezzel az integrációval a következőket teheti:
- Rendeléseit exportálhatja a Magyar Postához az MPL API v2 felületen
- Szállítási címkéket nyomtathat közvetlenül a Shopify-ban, ugyanabban a PDF-ben a kötelező EFJ feladójegyzékkel együtt
- Szállíthat PostaPontokra, postákra, csomagautomatákba vagy az ügyfél címére
- Támogatja az utánvétet (COD) és a csomag értékbiztosítását
- Kézbesíthet Magyarországra és további 24 európai országba
A Magyar Posta API integráció aktiválása
Szekció neve “A Magyar Posta API integráció aktiválása”- A Shopify adminisztrációjában nyissa meg a Globe Pickup Points alkalmazást, és lépjen a Szállítási címkék szekcióba. Adjon hozzá új futárszolgálatot, és válassza a Magyar Posta lehetőséget.
- Adja meg az API kulcs és az API titok értékét — mindkettőt a Magyar Posta fiókjában találja. Mentés előtt a Kapcsolat tesztelése gombbal ellenőrizze őket; a Globe OAuth2 tokent kér, és azonnal jelzi, hogy a hitelesítő adatok érvényesek-e.
- Adja meg a Szerződés értékét — a Magyar Posta szerződésszámát.
- Adja meg a Számlaszám értékét — a Magyar Posta ügyfél-számlaszámát. Az export visszautasításra kerül, ha a szerződésszám vagy a számlaszám hiányzik.
- Adja meg a Bankszámlaszám értékét — a Magyar Posta erre továbbítja a beszedett utánvét összegeket. Adja meg mind a 24 számjegyet, kötőjel és szóköz nélkül; ha a számlaszáma 16 számjegyű (2×8), írjon a végére
00000000értéket (pl.11733003-27329661helyett117330032732966100000000). - Válassza ki a Csomag megőrzési idő (nap) értékét — hány napig őrzi a Magyar Posta a csomagot: 0, 5 vagy 10.
- Töltse ki a feladó adatait: Feladó neve, Feladó utca, Feladó irányítószám, Feladó város, Feladó telefonszám (nemzetközi formátumban, pl.
+36123456789) és Feladó e-mail. - Igény szerint konfigurálja a Rendelések automatikus teljesítése és a Rendelések automatikus megcímkézése nyomkövetési számmal lehetőségeket.
- Rendelje hozzá a Shopify szállítási módszereit a megfelelő Magyar Posta termékhez.
Export és címkenyomtatás
Szekció neve “Export és címkenyomtatás”A rendelések exportálhatók a Magyar Postához és a szállítási címkék nyomtathatók közvetlenül a Shopify-ból, akár tömegesen, akár egyenként. A teljes folyamatról lásd a Szállítási címkék létrehozása oldalt.
Minden exportált csomag kap egy nyomkövetési számot, amelyet a teljesítés nyomon követéséhez használnak, és amely megkereshető a Magyar Posta nyomkövetési oldalán. Ha a rendelésnek nincs súlya, a Globe alapértelmezetten 100 g értéket küld.
Feladójegyzék (EFJ) és napi zárás
Szekció neve “Feladójegyzék (EFJ) és napi zárás”A Magyar Posta futárai megkövetelik, hogy a csomagokkal együtt átadja az EFJ feladójegyzéket (Elektronikus Feladójegyzék) — enélkül előfordulhat, hogy nem veszik át a küldeményt. A Globe ezt elintézi Ön helyett: amikor címkéket nyomtat, lezárja a küldeményeket a Magyar Postánál, és a feladójegyzéket ugyanahhoz a PDF-hez fűzi. A kinyomtatott fájl a következőket tartalmazza, ebben a sorrendben:
- A szállítási címkék
- A szállítólevél — a papíralapú átvételi elismervény, amelyet a futár aláír
- A feladójegyzék összesítő (valamint egy raklapos feladójegyzék, ha a köteg raklapokat is tartalmaz)
A létrehozott PDF eltárolódik, így az újranyomtatás azonnali, és soha nem hiúsul meg „már lezárva” hibaüzenettel. Ha a feladójegyzéket nem sikerül létrehozni, a Globe akkor is visszaadja a címkéket, és figyelmezteti, hogy a feladójegyzéket a futár érkezése előtt külön kell elkészíteni.
Termékek
Szekció neve “Termékek”Rendelje hozzá minden Shopify szállítási módot ahhoz a Magyar Posta termékhez, amelyben a szerződése szerint megállapodott:
| Termék | MPL szolgáltatáskód | Leírás |
|---|---|---|
| Business Parcel | A_175_UZL | Szerződéses üzleti csomagszolgáltatás |
| Postal Parcel | A_177_MPC | Standard postai csomagszolgáltatás |
Csomagátvételi pontok vs. házhozszállítás
Szekció neve “Csomagátvételi pontok vs. házhozszállítás”A kézbesítési módot a Globe automatikusan abból a csomagátvételi pontból vezeti le, amelyet az ügyfél a pénztárban kiválasztott:
| Az ügyfél választása | MPL kézbesítési mód |
|---|---|
| PostaPont | PP |
| Posta | PM |
| Csomagautomata | CS |
| Nincs csomagátvételi pont — szállítási cím | HA (házhozszállítás) |
A csomagautomatás küldemények mindig L csomagmérettel kerülnek feladásra, mert a Magyar Posta a csomagautomatás kézbesítéshez méretet ír elő.
Utánvét (COD)
Szekció neve “Utánvét (COD)”A Magyar Posta támogatja az utánvétet. Ha a rendelés utánvétes fizetési módot használ, a Globe hozzáadja az utánvét külön szolgáltatást, és a rendelés utánvét összegét elküldi a küldeménnyel. A beszedett összegeket banki átutalással rendezik a futárszolgálaton beállított bankszámlaszámra — ügyeljen arra, hogy azt 24 számjegyként adja meg.
A HUF pénznemben leadott rendelések ezen felül a rendelési értékükre biztosítottak (a Magyar Posta 2 000 000 HUF maximumáig). A más pénznemben leadott rendelések értékbiztosítás nélkül kerülnek exportálásra.
Kézbesítési állapot
Szekció neve “Kézbesítési állapot”A kézbesítési állapot szinkronizálása a Magyar Postánál nem érhető el — a csomagállapotok nem íródnak vissza a rendelésre. A Shopify teljesítések továbbra is tartalmazzák az MPL nyomkövetési számot és a Magyar Posta nyomkövetési oldalára mutató hivatkozást. A visszáru-címkék szintén nem támogatottak.
Címkenyomtatás
Szekció neve “Címkenyomtatás”A Magyar Posta kínálja a legtöbb címkeformátumot a Globe futárszolgálatai közül. Válassza azt, amelyik megfelel a nyomtatójának és a papírjának:
| Formátum | Leírás |
|---|---|
A4 | Teljes méretű A4 címzési címke, 210 × 297 mm |
A5 | A5 címke egy A4-es ív tetején |
A5inA4 | Két fekvő A5 címke egy A4-es íven |
A5E | Fekvő A5 címke a két kiegészítő fül nélkül |
A5E_EXTRA | Fekvő A5 címke a két kiegészítő füllel |
A5E_STAND | Álló A5 címke a két kiegészítő fül nélkül |
A6 | A6 címke, 148,5 × 105 mm |
A6inA4 | Négy A6 címke egy A4-es íven |
A4ONE | Egyetlen csomag címkéje és feladójegyzéke egy A4-es íven |
A címkék mindig PDF formátumban készülnek, és a nyomtatás mindig az első pozíciónál kezdődik — a Magyar Postánál nincs eltolás a részben használt ívekhez. A címzett telefonszáma és e-mail-címe rákerül a címkére.
Hibaelhárítás
Szekció neve “Hibaelhárítás”| Probléma | Megoldás |
|---|---|
| Hitelesítési hiba | Az API kulcs vagy az API titok hibás. Adja meg őket újra, és nyomja meg a Kapcsolat tesztelése gombot — sikeres kapcsolatot kell jeleznie. |
| Konfigurációs hiba — hiányzó szerződés- vagy számlaszám | A Szerződés és a Számlaszám egyaránt kötelező. Töltse ki őket, és exportáljon újra. |
| Hiányzó címzetti város / irányítószám / cím / név | A Shopify szállítási cím hiányos. Egészítse ki a címet a rendelésen az exportálás előtt. |
| Ellenőrzési hiba paraméterrel és kóddal | A Magyar Posta visszautasította a küldemény adatait. Az üzenet megnevezi a hibás mezőt — javítsa a rendelésen vagy a futárszolgálat beállításaiban, és exportáljon újra. |
| Nem található nyomkövetési szám — a címkék nem nyomtathatók | A rendelés exportja soha nem sikerült. Előbb exportálja, utána nyomtasson. |
| Figyelmeztetés: a feladójegyzék létrehozása sikertelen | A címkék kinyomtatódtak, de az EFJ feladójegyzék hiányzik. Nyomtasson újra, vagy készítse el a feladójegyzéket a futár érkezése előtt — a Magyar Posta enélkül visszautasíthatja a csomagokat. |
| Az utánvét összege nem került kifizetésre | Ellenőrizze a Bankszámlaszám mezőt — pontosan 24 számjegyből kell állnia, kötőjelek és szóközök nélkül. |