Blog

FOXPOST automata és API a PrestaShop-pénztárban: mi kell hozzá?

Több mint 120 000 rekesz, öt napos tárolási idő, bankkártyás utánvét az automatánál. Mi kell ahhoz, hogy a vásárló a pénztárban válasszon FOXPOST átvevőhelyet, és a címke kézi gépelés nélkül készüljön el?

FOXPOST automata és API a PrestaShop-pénztárban: mi kell hozzá?

Az átvevőhely a pénztár egyik legérzékenyebb pontja. Ha a vásárló megszokta, hogy a csomagot az utcasarki automatából veszi ki, a házhozszállítás nem kényelmesebb változat, hanem akadály. A webshopnak viszont nem elég felvenni egy „FOXPOST" nevű szállítási módot: ha nem derül ki, melyik automatát választotta a vásárló, a feladás kézi munka marad.

Ez a cikk azt járja körül, mi kell ahhoz, hogy a FOXPOST automata és házhozszállítás választható legyen a PrestaShop pénztárában, és hogy a választott átvevőhely adata gépelés nélkül érkezzen meg a szállító rendszerébe. A hálózati számok a FOXPOST saját tájékoztatóiból valók, a PrestaShopról szóló állítások a kódból mért adatok.

Nem értek a technikáhozMagyarán mondva: mit kell ebből elintézni?

Két dolog kell hozzá, és a kettő független. Az egyik a FOXPOST üzleti fiók: ez egy online regisztráció, nincs mögötte hosszas szerződéskötés. A másik a webshop felkészítése, hogy a vásárló a pénztárban ki tudja választani az átvevőhelyet.

A felkészítés lényege: a pénztárban megjelenik egy térkép, a vásárló rábök az automatára, és ez a választás a rendeléshez tapad. Innentől a feladáskor nem kell semmit átgépelni, a rendelés adataiból lesz csomag a szállító rendszerében, és onnan jön vissza a kinyomtatható címke.

Amit érdemes előre összeszedni: megvan-e az üzleti fiók, és megvan-e hozzá a gépi hozzáférés. Ez utóbbi nem azonos azzal a belépéssel, amivel a kollégák kézzel kezelik a csomagokat: a fiók Beállítások menüpontjában külön adatok tartoznak hozzá.

Kérés a FOXPOST-fiókot kezelő kollégának

A webáruházunkat össze szeretnénk kötni a FOXPOST rendszerével. Kérem, a foxpost.hu üzleti fiókunkban a Beállítások menüpont alatt található gépi hozzáférés adatait (Basic auth felhasználónév, jelszó, API kulcs) és az ügyfélkódunkat juttassa el hozzánk. A jelszót kérem ne e-mailben küldje.

Mennyi FOXPOST átvevőhely van, és mennyi ideig őrzik a csomagot?

A hálózat FOXPOST – Packeta Group néven működik, és két formában érhető el. Az egyik az automata: a FOXPOST szerint több mint 120 000 rekesz áll a vásárlók rendelkezésére, közel 500 településen. Kétféle automata van, az A-BOX és a Z-BOX, és a kettő között a vásárló szempontjából az utánvét fizetése a különbség. A másik forma a Z-Pont, ami üzletben működő átvevőhely: ebből több mint ezer van.

  • 120 000+ rekesz az automatákban
  • ~500 település a hálózatban
  • 1000+ Z-Pont átvevőhely
  • 5 nap tárolás az automatában

A tárolási idő a webshopnak is számít, mert az át nem vett csomag visszáru lesz. Az automatában a FOXPOST öt naptári napig őrzi a küldeményt, a hétvégét és a munkaszüneti napot is beleszámítva, és hosszabbítást 2024 decembere óta nem teljesítenek. A Z-Pont átvevőhelyen hét nap az átvételi idő, ott a tárolás meghosszabbítható. A határidő után a csomag automatikusan visszamegy a feladóhoz, újbóli kiszállítás nincs.

A FOXPOST magyarországi átvevőhely-hálózata számokban: több mint 120 000 rekesz közel 500 településen, több mint ezer Z-Pont átvevőhely, öt naptári nap tárolás az automatában, hét nap a Z-Pont átvevőhelyen
A FOXPOST átvevőhely-hálózata és az átvételi határidők, a szállító saját tájékoztatói alapján.

Az utánvét fizetése automata-típustól függ. Az A-BOX automatánál kizárólag bankkártyával lehet fizetni, a gépen lévő terminálon. A Z-BOX automatánál fizetési linken, és a nyitókód csak sikeres fizetés után megy ki. Házhozszállításnál a futárnál készpénz és bankkártya is jó.

A kézbesítési idő a feladás után indul: a futár átvétele után a címzett 1-3 munkanapon belül veheti át a csomagot a választott automatából, házhozszállításnál 2-3 munkanap az általános kiszállítási idő, időgarancia nélkül. A szállítási tájékoztatóban ezt a saját csomagolási idővel együtt érdemes megadni.

Mit tud a gyári PrestaShop az átvevőhelyekről, és mit nem?

A PrestaShop szállítási módja egy fuvarozó-rekord, hozzá súly- vagy ársávok és zónák. Ez elég ahhoz, hogy a pénztárban megjelenjen a „FOXPOST" sor a díjával, és itt véget is ér. A fuvarozó adatmodelljében nincs mező az átvevőhelyre: a 8.1.7-es kódfán a Carrier osztályban egyetlen ilyen mező sincs, és az egész classes könyvtárban sincs rá hivatkozás (mérve 2026-11-05).

Ennek három következménye van a napi munkában. A vásárló választása nem tárolódik, tehát a rendelés mellett nem lesz ott, melyik automatába kell vinni a csomagot. A feladás nem indul el magától, mert a gyári rendszer nem ismeri a szállító felületét. A csomag útjáról pedig nem érkezik vissza semmi, tehát a rendelés állapotát kézzel kell követni.

A gyári modul-csomag sem segít ezen: nincs benne fuvarozó-integráció, átvevőhely-választó, címkekészítés és állapot-visszajelzés. Ezt a gyári modul-csomagról szóló bejegyzésben tételesen mértük.

Honnan jön az automaták listája a pénztárba?

Az átvevőhelyek listája a FOXPOST-tól származik, és naprakésznek kell lennie, mert automatát telepítenek, Z-Pont pedig nyílik és zár. A szállító két módon adja ki: egy folyamatosan frissülő JSON fájlban a csomagautomatákkal, és egy térképes JavaScript elemmel, amit kifejezetten egyedi programozású webshopokhoz kínál.

A különbség nem megjelenés kérdése. A választás eredményét el kell menteni a rendeléshez, különben a vásárló rábök a térképen az automatára, de a kollégának a rendelés mellett nem lesz ott, melyikre. A térkép önmagában kevés: az az átvevőhely-azonosító számít, ami a rendeléssel együtt megmarad.

A FOXPOST a saját integrációs segédletében letölthető PrestaShop-plugint és útmutatót is ad, külön telepítő csomaggal a PrestaShop 9-hez (a szakasz frissítése 2026. január 8.). Ha a webshop csak annyit szeretne, hogy a FOXPOST megjelenjen a pénztárban, van ingyenes út is. A kérdés inkább az, mi történik a rendelés után: ki adja fel a csomagot, honnan jön a címke, és mi frissíti a rendelés állapotát.

Hogyan kerül a csomag a FOXPOST rendszerébe, és honnan jön a címke?

A FOXPOST gépi felületén a webshop lekérdezheti a kiszállítási pontokat, feladhatja, módosíthatja és törölheti a csomagot, lekérdezheti egy rendelés állapotát, és címkét nyomtathat; a címke vonalkódja code 128 formátumú, az API leírása nyilvános Swagger-felületen érhető el. Ez a lényeges különbség a kézi munkához képest: nem a kollégának kell átgépelnie a címet és az átvevőhelyet egy másik felületre, hanem a rendelés adataiból lesz címke.

A címke nem elhagyható: a FOXPOST szerint kötelező kinyomtatni és felragasztani, nélküle nem szállítják el a küldeményt. Tömeges feladásnál a szállító felületén XLS fájlban kell feltölteni a küldemények adatait, utána csoportos művelettel nyomtathatók a címkék: működő út, csak a webshop adatait még egyszer elő kell állítani hozzá.

A FOXPOST modulunk ezt a láncot az adminon belül tartja. A csomagadatok a beállított rendelés-státuszra magától mennek be, és beállítható az a státusz is, amelyre a csomag törlődik. A rendelés oldalán megjelenik a csomag azonosítója, onnan letölthető a címke, akár tömegesen. A megjelölt utánvétes fizetési módokkal leadott rendelés utánvétesként megy be. A vásárló a sikeres beküldés után nyomonkövetési URL-t tartalmazó levelet kaphat, a fiókjában pedig a csomag állapota és az átvételi pont címe is megjelenik.

Egy buktató előre: a modul telepítéskor maga hozza létre a két szállítási módot, az automatás átvételt és a házhozszállítást. Ha valaki ezeket törli, majd kézzel vesz fel ugyanolyan nevűt, a modul nem fogja felismerni; újragenerálni csak a modul alaphelyzetbe állításával lehet. A nevek szabadon átírhatók, tehát a pénztárban nem kell angol feliratnak maradnia.

Mi kell a FOXPOST-hoz: regisztráció, ügyfélkód, API-adatok

A sorrend itt rövidebb, mint a hagyományos futárszolgálatoknál: a FOXPOST szerint nincs bonyolult szerződési folyamat, egy online regisztráció után használható az országos hálózat, és a regisztrációval jár az ügyfélkód is. Az elszámolás utólagos: feladáskor az automatánál nincs fizetés, a szállító hetente egyszer, csütörtökön állítja ki az elszámolást és a számlát, az elszámolási időszak keddtől hétfőig tart. Az utánvételi összeg ugyanezen az elszámoláson jön vissza.

A gépi összekötéshez három adat kell a fiókból: a Basic auth felhasználónév, a jelszó és az API kulcs. A modulunk ezekkel kapcsolódik a FOXPOST WEBAPI-hoz, a tárhelytől PHP 7.2 vagy újabb változatot kér, és PrestaShop 1.7, 8 és 9 fő verzióra telepíthető.

A termékkínálat is döntés. A FOXPOST ár-táblája öt rekeszmérethez ad adatot, a méret automata-típustól függ, a legnagyobb rekeszbe 60x36x61 centiméteres, legfeljebb 25 kilogrammos csomag kerül. Nagyobb áru esetén az automatás átvételt termékenként vagy kosárméret szerint korlátozni kell.

Mit érdemes most tenni?

  1. Próbálj végig egy valódi rendelést a pénztárban. Ha a FOXPOST szállítási mód megjelenik, de átvevőhelyet nem lehet választani, a rendeléshez nem kerül azonosító, és a feladás kézi marad.
  2. Szedd össze a gépi hozzáférés adatait. Az üzleti belépés nem elég: a Basic auth felhasználónév, a jelszó és az API kulcs a fiók Beállítások menüpontjában van. A fenti másolható szöveg ezt kéri.
  3. Döntsd el, mekkora csomag mehet automatába. A legnagyobb rekesz 60x36x61 centiméteres, a súlyhatár 25 kilogramm. A fölött az automatás átvételt ki kell zárni.
  4. Írd le a szállítási tájékoztatóban az öt napos tárolási időt. Hosszabbítás nincs, az át nem vett csomag visszamegy a feladóhoz.
  5. Ha utánvétet kínálsz, nevezd meg a fizetés módját. Az A-BOX automatánál csak bankkártyával lehet fizetni, a Z-BOX automatánál fizetési linken, előre. A készpénzre számító vásárlót erről a pénztárban érdemes tájékoztatni.

FOXPOST a pénztárban, kézi adatbevitel nélkül

A FOXPOST modulunk a térképes átvevőhely-választót a pénztárba teszi, a csomagot az adminból adja fel a FOXPOST gépi felületén, címkét nyomtat, akár tömegesen, és a vásárló fiókjában is mutatja a csomag állapotát.

A FOXPOST modul adatlapja

Kell szerződést kötni a FOXPOST-tal, hogy a webshop használhassa?

A szállító szerint nincs bonyolult szerződési folyamat: egy online üzleti regisztráció után rendelkezésre áll az országos hálózat, és a regisztrációval jár az ügyfélkód is.

Mennyi ideig őrzik a csomagot, és mi lesz vele utána?

Az automatában öt naptári napig, a hétvégét és a munkaszüneti napot is beleszámítva, hosszabbítás nélkül. A Z-Pont átvevőhelyen hét nap az átvételi idő, és az meghosszabbítható. Utána a csomag visszamegy a feladóhoz.

Elég a FOXPOST térképes eleme a webáruházban?

A térkép megmutatja a pontokat, de a választást a rendeléshez kell kötni. Ha az átvevőhely azonosítója nem kerül a rendelés mellé, a feladásnál újra elő kell keresni, melyik automatáról volt szó.

Mekkora csomag fér egy FOXPOST automatába?

A rekesz mérete automata-típustól függ. A legnagyobb rekeszbe 60x36x61 centiméteres csomag kerül, a súlyhatár 25 kilogramm.

Hogyan fizet a vásárló utánvétnél?

Az A-BOX automatánál kizárólag bankkártyával, a gépen lévő terminálon. A Z-BOX automatánál fizetési linken, és a nyitókód csak sikeres fizetés után megy ki. Házhozszállításnál a futárnál készpénz és bankkártya is jó.

Források: FOXPOST, Belföldi üzleti csomagfeladás, FOXPOST, Csomagátvétel, FOXPOST, Üzleti csomagfeladás, FOXPOST, Integrációs segédlet, FOXPOST, Áraink üzleti partnereknek

Megosztás

Értesülj időben a PrestaShoppal kapcsolatos hírekről és újdonságokról, valamint akcióinkról!

Feliratkozással hozzájárulok, hogy a PrestaHU hírlevelet küldjön, és e-mail címemet kódolt formában hirdetési célközönségek kialakítására használja a Google Ads és a Meta rendszerében. A hozzájárulás bármikor visszavonható.

Adatkezelési tájékoztató

Két ujjal vagy dupla koppintással nagyítható

Moduljaim