Csomagpontválasztó a webshop pénztárába

Ágyazd be a térképes csomagpontválasztót a webshopod pénztárába iframe-mel, és fogadd a kiválasztott pontot postMessage-üzenetben.

6 min readUpdated: 03/11/2026

This article is currently available in Hungarian only.

A csomagpontválasztó egy beágyazható, térképes felület, amelyet a webshopod pénztárában jeleníthetsz meg. A vásárló településre vagy irányítószámra keres, kiválasztja a csomagpontot vagy az automatát, és a webshopod azonnal megkapja a választását. A választó a saját márkád színeivel jelenik meg.

A beágyazható csomagpontválasztó telefonon
A beágyazható csomagpontválasztó telefonon

Hol találod a beágyazókódot?

  1. Nyisd meg a Csomagok menüpontot, és válts a Csomagpontok fülre.
  2. Görgess a Csomagpontválasztó az ügyfeleidnek szakaszhoz.
  3. A Megjelenő szolgáltatók résznél jelöld ki, mely szolgáltatók pontjai jelenjenek meg. Csak a bekötött szolgáltatóid közül választhatsz.
  4. Kattints a Kód másolása gombra, és illeszd be a kódot a pénztároldal sablonjába.

Az Előnézet új lapon gombbal kipróbálhatod a választót.

Megjegyzés: A csomagpontok listáját a szolgáltatóktól szinkronizáljuk. Ha a választó üres, a Csomagpontok oldalon ellenőrizd, hogy van-e szinkronizált pont.

A beágyazókód

HTML
<iframe
    src="https://{partner}.elkuldom.hu/widget/pickup-points?carriers=gls,foxpost"
    width="100%"
    height="560"
    style="border:0;border-radius:8px"
    allow="geolocation"
    loading="lazy"
    title="Csomagpont választása"
></iframe>
<script>
    window.addEventListener('message', function (e) {
        if (
            e.origin !== 'https://{partner}.elkuldom.hu' ||
            !e.data ||
            e.data.source !== 'rackoon'
        )
            return;
        if (e.data.type === 'pickup-point:selected') {
            // e.data.point: { carrier, id, type, name, postal_code, city, street, lat, lng }
            console.log(e.data.point);
        }
    });
</script>

A panelből másolt kódban már a saját aldomained szerepel, a {partner} helyére nem kell semmit írnod.

Az iframe attribútumai

Attribútum Szerepe
src A választó címe a partneraldomaineden, opcionális paraméterekkel
width, height Méret. Kiindulásnak 100% szélességet és 560 képpont magasságot javaslunk
allow="geolocation" Engedélyezi a Saját helyzetem gombot, amellyel a vásárló a közelében lévő pontokat keresheti
loading="lazy" A választó csak akkor töltődik be, amikor láthatóvá válik
title Akadálymentes felirat a képernyőolvasóknak

Fontos: Az allow="geolocation" nélkül a böngésző nem engedi a helymeghatározást az iframe-ben. Ilyenkor a vásárló keresővel továbbra is választhat pontot.

URL-paraméterek

Paraméter Érték Hatás
carriers Vesszővel elválasztott szolgáltatókódok, például gls,foxpost Csak ezeknek a szolgáltatóknak a pontjai jelennek meg. Ha elhagyod, minden bekötött szolgáltatódé megjelenik.
type locker vagy shop Előre beállított szűrő: csak automaták (locker) vagy csak személyzettel működő átvevőhelyek (shop).

A szolgáltatókódok: mpl, gls, dpd, expressone, fama, packeta, foxpost, furgefutar, transpack. A carriers lista csak a bekötött szolgáltatóid közül szűkít, be nem kötött szolgáltató pontjai nem jelennek meg.

Tipp: Ha a webshopodban szolgáltatónként külön szállítási mód van (például „GLS automata”, „FoxPost automata”), szállítási módonként külön iframe-et ágyazz be a megfelelő carriers és type paraméterrel.

A kiválasztott pont fogadása

Amikor a vásárló az Ezt választom gombra kattint, a választó üzenetet küld a befogadó oldalnak:

JSON
{
    "source": "rackoon",
    "type": "pickup-point:selected",
    "point": {
        "carrier": "foxpost",
        "id": "…",
        "type": "locker",
        "name": "…",
        "postal_code": "1052",
        "city": "Budapest",
        "street": "…",
        "lat": 47.49,
        "lng": 19.05
    }
}
Mező Jelentés
carrier A szolgáltató kódja
id A csomagpont szolgáltatói azonosítója
type locker (csomagautomata) vagy shop (átvevőhely)
name, postal_code, city, street A pont neve és címe
lat, lng Földrajzi koordináták

Biztonsági ellenőrzés

Fontos: Mindig ellenőrizd az üzenet forrását (e.origin), és csak a saját partneraldomainedről érkező üzenetet fogadd el. Ellenőrizd a source és a type mezőt is. Ellenőrzés nélkül egy idegen oldal hamis pontadatot küldhetne a pénztáradnak.

A pont átadása csomagfeladáskor

A kiválasztott pont id és carrier értékét mentsd el a rendeléssel együtt. Csomagfeladáskor ebből lesz az átvételi pont:

  • a REST API-n a pickup_point mezőben add át az id értéket (a carrier mezőben a szolgáltató kódjával),
  • a panelben az új csomag űrlapján ugyanezt a pontot választod ki.

A REST API használatáról a REST API – gyors kezdés cikkben olvashatsz.

Mit lát a vásárló?

  • Kereső: település, irányítószám vagy pont neve alapján.
  • Saját helyzetem: a böngésző helymeghatározásával a közeli pontokra ugrik.
  • Szűrők: Minden szolgáltató vagy egy-egy szolgáltató, valamint Automata és Átvevőhely.
  • Térkép és lista: ha sok a pont, a térkép csoportosítja őket, és közelítéskor jelennek meg egyenként.
  • Pontadatok: név, cím, szolgáltató, típus, azonosító és Nyitvatartás.

A vásárló át tudja váltani a választó nyelvét.

A márka megjelenése

A választó a fő fiók alapértelmezett márkáját használja. A Saját márka modullal a saját logód és elsődleges színed jelenik meg, a modul nélkül semleges sötét szín, logó nélkül. A márka beállításáról a Márkaprofilok cikk szól.

Technikai tudnivalók

  • A választó nyilvános, belépés nélkül elérhető, és bármely webshopba beágyazhatod iframe-mel.
  • Percenként legfeljebb 120 lekérdezést engedünk.
  • A választót iframe nélkül, közvetlenül is megnyithatod. Ilyenkor a kiválasztás után ezt az üzenetet mutatja: „Kiválasztva. Ezt a pontot add meg a rendelésnél.”

Kapcsolódó cikkek