One by Allegro API

A Globe Pickup Points integrálódik a One by Allegróval (korábban WEDO), azzal a cseh futárszolgálattal, amely csomagboxokba, Intime csomagátvételi pontokba és házhoz kézbesít az OneDelivery 3.0 API-n keresztül. Ezzel az integrációval a következőket teheti:

Rendeléseit exportálhatja a One by Allegróhoz közvetlenül a Shopify-ból
Szállítási címkéket nyomtathat közvetlenül a Shopify-ban
Szállíthat csomagboxba, csomagátvételi pontba vagy az ügyfél címére
Beszedheti az utánvétet

A One by Allegro 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 One by Allegro lehetőséget.
Adja meg a Token azonosító és az API jelszó értékét. Mindkettőt a One by Allegro ügyfélzónában, az API beállításoknál találja. Ha nincsenek meg, forduljon a One by Allegro ügyfélszolgálatához (eshop-onecz@allegro.com).
Mentés előtt kattintson a Kapcsolat tesztelése gombra, hogy megbizonyosodjon a hitelesítő adatok elfogadásáról.
Töltse ki a feladó címét — Feladó — cégnév, Feladó — utca, Feladó — házszám, Feladó — város és Feladó — irányítószám. A feladó címe minden címkére rákerül, a csomagfelvételhez használják, és minden küldeménnyel elküldésre kerül (a One by Allegro nem esik vissza a fiókjában tárolt alapértelmezett címre). Az integráció feladói országként mindig Csehországot küldi.
Töltse ki az Alapértelmezett hossz milliméterben, Alapértelmezett szélesség milliméterben és Alapértelmezett magasság milliméterben mezőket. Ezek kötelezők — a One by Allegro visszautasítja a csomagméretek nélküli küldeményeket.
Igény szerint állítson be egy Alapértelmezett súly (kg) értéket, amelyet a Globe akkor használ, ha egy terméknek nincs súlya a Shopify-ban.
Igény szerint konfigurálja a teljesítési és címkézési lehetőségeket.
Rendelje hozzá a Shopify szállítási módszereit a One by Allegróhoz.

Export és címkenyomtatás

A rendelések exportálhatók a One by Allegró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 rendelésből egy küldemény lesz egyetlen csomaggal. A visszaadott csomagszámot használjuk nyomkövetési számként, a nyomkövetési link pedig a One by Allegro nyomkövetési oldalára mutat. Ha az automatikus teljesítés be van kapcsolva, a Shopify teljesítés a nyomkövetési számmal és a One by Allegro futárszolgálat-névvel jön létre.

Az API a csomagleírás és a hivatkozási mezők esetében csak betűket, számjegyeket, szóközöket, vesszőket és pontokat fogad el. A Globe ezeket automatikusan megtisztítja — a leírás Order <rendelés neve>, a rendelés neve pedig 1. hivatkozási számként kerül felhasználásra, 20 karakterre rövidítve.

Kézbesítési módok

A One by Allegro a kézbesítési módot exportáláskor abból a Termék típusa értékből határozza meg, amelyet Ön kiválaszt. Az alapértelmezés az AUTO, és a legtöbb kereskedőnek érdemes ennél maradnia.

Termék típusa	Viselkedés
AUTO	A pénztárban kiválasztott One by Allegro csomagátvételi pontot használja — a csomagboxból BOX, a fiókból PUDO lesz. Ha a rendeléshez nem tartozik One by Allegro pont, a csomag a szállítási címre megy.
TO_DOOR	Kézbesítés az ügyfél címére. A kiválasztott csomagátvételi pontot figyelmen kívül hagyja.
BOX	Kézbesítés One Box csomagboxba. One by Allegro pontot igényel a rendelésen.
PUDO	Kézbesítés személyzettel működő csomagátvételi pontba (Intime fiók). One by Allegro pontot igényel a rendelésen.

Ha kifejezetten a BOX vagy a PUDO lehetőséget választja, és a rendeléshez nem tartozik One by Allegro csomagátvételi pont, az adott rendelés exportját visszautasítja a rendszer. A pontkódok abból a csomagátvételi pontból származnak, amelyet az ügyfél a Globe választójában kijelölt — lásd a Csomagátvételi pontos futárszolgálatok hozzáadása oldalt.

Minden küldemény a Standard szolgáltatással kerül exportálásra. A cseh és szlovák címzetti telefonszámok automatikusan nemzetközi formátumra (+420 / +421) alakulnak, hogy a futárszolgálat SMS-értesítései kiküldhetők legyenek.

Csomagsúly és -méretek

A One by Allegro visszautasítja a csomagméretek nélküli küldeményeket, ezért a futárszolgálat beállításaiban szereplő alapértékek kötelezők, nem opcionálisak.

Súly — a Shopify rendelésből származik. Ha a rendelésnek nincs súlya, a futárszolgálat beállításaiban szereplő Alapértelmezett súly (kg) kerül felhasználásra. Ha egyik sem áll rendelkezésre, az adott rendelés exportja meghiúsul.
Méretek — mindig az Alapértelmezett hossz / szélesség / magasság milliméterben mezőkből származnak. Ha ezek bármelyike üres vagy nulla, az export meghiúsul, és egy üzenet felszólítja azok kitöltésére.

Utánvét (COD)

A One by Allegro támogatja az utánvétet. Ha a rendelés utánvétes fizetési módot használ, az utánvét összege a rendelésből származik, és a rendelés pénznemében kerül elküldésre a küldeménnyel együtt. A futárszolgálat beállításaiban nincs külön bankszámla mező — a kifizetéseket a One by Allegro szerződése alapján rendezik.

Kézbesítési állapot

A kézbesítési állapot szinkronizálása nem érhető el. A One by Allegro nem része a Globe kézbesítési állapot-szinkronizációjának, így a csomagállapotok nem íródnak vissza a Shopify-ba. A nyomkövetési szám és a nyomkövetési link továbbra is a teljesítéshez kerül, így az ügyfelek követhetik a csomagot a futárszolgálat nyomkövetési oldalán.

Címkenyomtatás

A One by Allegro a címkéket egyetlen PDF-ként adja vissza, amely a teljes nyomtatott köteget lefedi, két formátum egyikében:

Formátum	Leírás
PDF_A6	Egy címke oldalanként (alapértelmezett)
PDF_A4	Egy címke A4-es oldalanként

Az OneDelivery API nem támogatja az íven kiválasztott pozíciótól induló nyomtatást, így a részben használt címkeívek ennél a futárszolgálatnál nem használhatók újra.

Visszáru és sztornózás

A visszáru-címkék nem támogatottak ezen az integráción keresztül.
A küldemények nem sztornózhatók. Az OneDelivery API-nak nincs sztornózó vagy törlő végpontja. Miután egy rendelést exportált, a küldemény a One by Allegro fiókjában marad — egyszerűen ne adja át a csomagot, vagy rendezze a One by Allegro portálján.

Hibaelhárítás

Probléma	Megoldás
`Failed to authenticate with One by Allegro`	Ellenőrizze a Token azonosítót és az API jelszót a futárszolgálat beállításaiban, és használja a Kapcsolat tesztelése gombot. A 401-es válasz azt jelenti, hogy a hitelesítő adatok érvénytelenek.
`Order requires a One by Allegro pickup point for BOX/PUDO delivery`	A termék típusa BOX vagy PUDO, de a rendeléshez nem tartozik One by Allegro csomagátvételi pont. Használjon AUTO vagy TO_DOOR értéket, vagy ellenőrizze, hogy az ügyfél kiválasztott-e One by Allegro pontot a pénztárban.
`Order … has no weight`	Állítsa be a termék súlyát a Shopify-ban, adja meg a súlyt manuálisan az export során, vagy töltse ki az Alapértelmezett súly (kg) mezőt.
`default package dimensions are not set`	Töltse ki az alapértelmezett hosszt, szélességet és magasságot (milliméterben) a One by Allegro beállításaiban — az API minden küldeménynél megköveteli őket.
A címzett nem kap futárszolgálati értesítéseket	Csak a cseh és szlovák számok kapnak automatikus országelőhívót. Más országok esetén a telefonszámot teljes nemzetközi formátumban tárolja a rendelésen.
`One by Allegro did not return a PDF label`	Az API a PDF helyett mást válaszolt. Próbálja meg újra a nyomtatást; ha továbbra sem sikerül, forduljon a One by Allegro ügyfélszolgálatához a küldeményszámmal.
A rendelést tévedésből exportálta	A küldemények nem törölhetők az API-n keresztül. Ne adja át a csomagot, és rendezze a küldeményt a One by Allegro portálján.

Add One by Allegro pickup points to your Shopify store — pricing, demo & setup →