Ugrás a tartalomra

3525 Miskolc, Bodótetői út 1. 3. em. 9.

2021 Lorz Kft.

Szállítás és fizetés

Futárszolgálat-integráció: GLS, MPL, Foxpost és Packeta automatikusan

A hazai futárszolgálatok — GLS, MPL (Magyar Posta), Foxpost és Packeta — mind kínálnak gépi kapcsolatot. Ezzel a rendelésből kézi gépelés nélkül lesz csomag és címke, a nyomkövetési szám visszakerül a rendeléshez, a vevő pedig a pénztárban választhat csomagpontot vagy automatát.

Platformok szerint egy táblában: melyik CRM és webshopmotor mivel köthető össze, hivatalos forrásokkal.

Automatizálás

Mit lehet automatizálni egy futárszolgálat-integrációval?

  • Rendelés → csomag és címke (PDF vagy hőnyomtatós címke), egy kattintással vagy teljesen automatikusan.
  • A nyomkövetési szám visszaírása a rendelésbe és kiküldése a vevőnek.
  • Csomagpont- és automataválasztó a pénztárban, a futárszolgálat hivatalos listájából.
  • Kézbesítési állapot követése: a kézbesített csomag lezárja a rendelést.
  • Az utánvétes összegek egyeztetése a könyveléssel.
  • Az MPL-nél a napi jegyzékzárás automatizálása.
Hogyan működik?

Így működik a futárszolgálat-integráció

01Mi kell az induláshoz?

Mind a négy szolgáltatónál szerződés vagy üzleti partneri regisztráció az első lépés: az API-hozzáférés ehhez kötődik, és a szerződés határozza meg, mely szolgáltatások érhetők el.

A tesztelés módja szolgáltatónként eltér. A GLS-nek, az MPL-nek és a Foxpostnak van tesztkörnyezete (a Foxpostnál kérésre), a Packetánál viszont éles fiókban tesztelünk — díj csak akkor keletkezik, ha a csomag ténylegesen bekerül a hálózatba.

02A négy szolgáltató röviden

Mindegyik hivatalos, dokumentált API-t ad, de a működésük eltér:

  • GLS (MyGLS API): SOAP- vagy REST-felület; címkekészítés, csomaglista és -állapot, csomagpontok. Állapotváltozásról nem küld értesítést, ezért lekérdezéssel követjük.
  • MPL (Magyar Posta, MPL API v2): REST, OAuth2-azonosítás a Posta fejlesztői portálján kapott kulccsal; címke, jegyzékzárás, kézbesítési helyek, nyomkövetés lekérdezéssel vagy feliratkozással.
  • Foxpost (FoxWeb API): REST; csomag- és címkekezelés, nyomkövetés, akár 1000 csomag egyetlen fájlfeltöltéssel. Az automaták listája óránként frissülő, nyilvános fájlból érhető el.
  • Packeta: SOAP- vagy REST-felület; címke, nyomkövetés és aláírt értesítés az állapotváltozásokról. Magyarországon a Packeta-pontok mellett Foxpost-automatákba és postai pontokra is kézbesít, ha ezt az ügyfélfiókban engedélyezed.

03Csomagpontválasztó a pénztárban

A vevő a webshop pénztárában térképen vagy listában választ csomagpontot. Az adatok a futárszolgálat hivatalos listájából vagy widgetjéből jönnek, és rendszeresen frissülnek. A kiválasztott pont azonosítója a rendeléssel együtt kerül a csomagadatok közé — így senkinek sem kell kézzel kikeresnie.

04Fejlesztőknek: futárcég API-k gyorsreferenciája

A négy szolgáltató fejlesztői felülete röviden, a hivatalos dokumentációk alapján (ellenőrizve: 2026. november 4.). Mindegyikhez szerződés és üzleti fiók kell; a részleteket a lenti forrásokban találod.

  • GLS (MyGLS API): SOAP vagy REST (JSON/XML); éles cím az api.mygls.hu, teszt az api.test.mygls.hu. Az azonosítás minden kérés törzsében megy: MyGLS felhasználónév és SHA512-vel hash-elt jelszó. A PrintLabels egy hívásban csomagot és címkét ad, a GetParcelStatuses és a GetParcelList a nyomkövetésé. Hívásonként legfeljebb 99 címke kérhető le és 50 törölhető; ugyanaz a kérés 5 percen belül ötödszörre hibát ad, ezt az újrapróbálkozásnál figyelni kell.
  • MPL (Magyar Posta, MPL API v2): REST/JSON; éles core.api.posta.hu és külön sandbox, saját kulcspárral. OAuth2 client credentials: a token egy óráig él, és minden híváshoz X-Accounting-Code (ügyfélkód) és egyedi X-Request-ID is kell. A POST /shipments akár a címkét is visszaadja; feladás előtt jegyzékzárás kell, utána a csomag az API-n már nem módosítható. Nyomkövetés egyenként, 500-as kötegben (aszinkron) vagy push-előfizetéssel.
  • Packeta: SOAP vagy REST/XML, azonos funkciókkal; minden metódus első paramétere az API-jelszó. Külön sandbox nincs: éles fiókon, külön teszt-feladóval lehet próbálni, díj csak akkor keletkezik, ha a csomag fizikailag bekerül a hálózatba. A csomagazonosítót szövegként kell kezelni (64 bites). A push nyomkövetés HMAC-SHA256-tal aláírt JSON-t küld.
  • Foxpost (FoxWeb API): REST/JSON, OpenAPI 3 leírással; éles webapi.foxpost.hu, teszt webapi-test.foxpost.hu. HTTP Basic azonosítás és api-key fejléc minden hívásnál. A csomagok tömbben hozhatók létre (POST /api/parcel), a címke A5, A6, A7 vagy 85×85 mm-es PDF, illetve ZPL; nyomkövetés vonalkódonként vagy tömbösen.
Tipikus megoldások

Amit leggyakrabban építünk

  1. 01

    Webshop → címke → nyomkövetés

    WooCommerce, Shoprenter, UNAS vagy Shopify rendelésből automatikusan csomag és címke lesz, a nyomkövetési szám pedig visszakerül a rendeléshez.

  2. 02

    Több futár egy felületen

    Ha több szolgáltatót használsz, a raktár egy helyen látja és nyomtatja az összes címkét; a futár a szállítási mód alapján automatikusan választódik ki.

  3. 03

    Kézbesítés → a rendelés lezárása

    A kézbesítési állapot lezárja a rendelést, az utánvétes összeg pedig egyeztethető a könyveléssel vagy az ügyviteli rendszerrel.

Buktatók

Amire egy futárszolgálat-integrációnál figyelünk

  1. 01

    Ismételt kérések

    A GLS hibát ad, ha ugyanazt a kérést 5 percen belül ötször elküldik. Az újrapróbálkozást ezért korlátozzuk és naplózzuk.

  2. 02

    Azonosítók a csomagpontlistában

    A Foxpost listájában a Foxpost-automaták és a Packeta-pontok más azonosítómezőt használnak; ezt a pénztár és a csomagfeladás között pontosan kell kezelni.

  3. 03

    Teszt- és éles környezet

    Az MPL-nél a teszt- és az éles környezet külön hozzáférést kér, és a tesztkörnyezet törzsadatai nem mindig naprakészek; a Packetánál pedig nincs tesztkörnyezet. Az átadás előtt ezért éles próbacsomaggal is ellenőrzünk.

  4. 04

    Értesítés helyett lekérdezés

    Nem minden szolgáltató küld állapotértesítést — a GLS-nél például lekérdezéssel követjük a csomagokat, a lekérdezések ütemezését pedig a forgalomhoz igazítjuk.

Gyakori kérdések

Melyik futárszolgálathoz tudtok integrációt készíteni?
A hazai piacon legelterjedtebb négyhez — GLS, MPL, Foxpost, Packeta — van hivatalos API, amelyre építeni tudunk. Más szolgáltatónál a dokumentációja alapján mérjük fel a lehetőségeket.
Kell szerződés a futárszolgálattal?
Igen: az API-hozzáférés a szolgáltatóval kötött szerződéshez vagy üzleti partneri regisztrációhoz kötődik, és a szerződés határozza meg az elérhető szolgáltatásokat.
Tudunk hőnyomtatóra címkét nyomtatni?
A GLS és a Packeta a PDF mellett hőnyomtatós (ZPL) címkét is ad; a nyomtatótípust az integráció beállításakor egyeztetjük.

Futárszolgálat-integráció: kérj ajánlatot

Írd meg, milyen rendszereket használsz és mit szeretnél automatizálni — egy rövid, ingyenes egyeztetés után írásos, tételes ajánlatot adunk.

Ajánlatot kérek