Slovenská pošta API
A Globe Pickup Points integrálódik a Slovenská poštával, a szlovák postai szolgáltatóval a WebEPH API-n keresztül, lehetővé téve a rendelések 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 Slovenská pošta (Moje zásielky) fiókjába
- Szállítási címkéket nyomtathat közvetlenül a Shopify-ban A6 vagy A4 formátumban
- Szállíthat postákra, BalíkoBOX csomagautomatákba vagy az ügyfél címére
- Támogatja az utánvétet, amelyet az Ön IBAN számlájára fizetnek ki
Az integráció Szlovákia területére érhető el, és a feladó címe mindig szlovák cím.
A Slovenská pošta API integráció aktiválása
Szekció neve “A Slovenská pošta 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 Slovenská pošta lehetőséget.
- Adja meg a Felhasználói azonosító és az API kulcs értékét — ezek a Slovenská pošta fiókjához tartozó WebEPH API hitelesítő adatok. A WebEPH API-t aktiválni kell a fiókhoz, különben a hitelesítés nem sikerül.
- Töltse ki a feladó adatait: a Feladó neve, Feladó utca, Feladó város és Feladó irányítószám kötelező. A Feladó szervezet, Feladó telefonszám és Feladó e-mail opcionális.
- Válassza ki az Átvételi mód értékét — Feladás postán vagy Feladás futárnak — attól függően, hogyan adja át a csomagokat.
- Válassza ki a postaköltség Fizetési típus értékét: Postaköltség hitel, Fizetési gép, Postai bélyegek, Átutalással fizetve, Készpénzzel fizetve, Postai szolgáltatás tétel, Számla vagy Online.
- Jelölje be a Szerződés lehetőséget, ha szerződése van a Slovenská poštával.
- Ha utánvéttel szállít, töltse ki az Utánvét IBAN mezőt.
- Igény szerint konfigurálja a Szállítmánybiztosítás, Alapértelmezett biztosítási érték, Alapértelmezett súly (kg), Rendelések automatikus teljesítése, Rendelések automatikus megcímkézése nyomkövetési számmal és Egyéni címke az export után lehetőségeket.
- Rendelje hozzá a Shopify szállítási módszereit azokhoz a Slovenská pošta termékekhez, amelyekben a futárszolgálattal megállapodott.
Export és címkenyomtatás
Szekció neve “Export és címkenyomtatás”A rendelések exportálhatók a Slovenská poštá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 — lásd a Szállítási címkék létrehozása oldalt.
Minden export terméktípusonként egy hárok (feladójegyzék) dokumentumot hoz létre: a rendelések a kiválasztott termék szerint csoportosulnak, minden csoporthoz megnyílik egy hárok, a csomagok bekerülnek abba, majd a hárok automatikusan regisztrálásra kerül. Ha a regisztráció nem sikerül, a csomagok akkor is létrejönnek, a hárok pedig később regisztrálható a Moje zásielky felületén.
A rendelés súlya grammból kilogrammba konvertálódik, legalább 0,1 kg értékre. Ha a rendeléseinek nincs súlya, állítson be Alapértelmezett súly (kg) értéket a futárszolgálat beállításaiban.
Minden csomag kap egy Slovenská pošta csomagszámot (például EB534780848SK). Ha a Rendelések automatikus teljesítése be van kapcsolva, a rendelés ezzel a számmal és a Slovenská pošta nyomkövetési oldalára mutató hivatkozással teljesül.
A Slovenská poštának van WebEPH tesztrendszere, de az szerverszinten kapcsolható be, nem futárszolgálati fiókonként — az éles áruházak mindig az éles Moje zásielky API-val kommunikálnak, és a futárszolgálat beállításaiban nincs sandbox kapcsoló.
Termékek
Szekció neve “Termékek”Válassza ki azt a terméket, amely megfelel a Slovenská poštával kötött megállapodásának. Az azonos termékkel exportált rendelések mind ugyanarra a hárokra kerülnek.
| Termék | Leírás |
|---|---|
| Doporučený list | Ajánlott levél |
| Poistený list | Biztosított levél |
| Úradná zásielka | Hivatalos (hatósági) küldemény |
| Balík | Standard csomag |
| Expres kuriér | Expressz futár |
| EMS zásielka | EMS expressz küldemény |
| EPG – obchodný balík | EPG üzleti csomag |
| Balík – zmluvní zákazníci | Csomag szerződéses ügyfeleknek |
| Balík – zmluvní zákazníci – Consignment | Szerződéses ügyfél csomagja, konszignációval |
| Balíček | Kis csomag |
| Easy Expres 1 | Easy Expres, 1 napos kézbesítés |
| Easy Expres 10 | Easy Expres, 10 napos kézbesítés |
| Prime zásielka | Prime küldemény |
| List | Közönséges levél |
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és típusát az ügyfél szállítási módszere határozza meg:
- Csomagátvételi pont — ha az ügyfél a pénztárban Slovenská pošta csomagátvételi pontot választ (postát vagy BalíkoBOX csomagautomatát), a csomagon szereplő címzetti cím a csomagátvételi pont címére cserélődik, és a csomag az átvételi pontos szolgáltatással kerül feladásra. A pont neve a város mögé kerül, hogy látható legyen a címkén.
- Házhozszállítás — a csomag az ügyfél szállítási címére kerül címzésre. A második címsor az utca végéhez fűződik.
A címzett neve, utcája, városa és irányítószáma kötelező. Az ezek bármelyikét nélkülöző rendeléseket az export visszautasítja.
Csomagszám-tartományok (szerződéses ügyfelek)
Szekció neve “Csomagszám-tartományok (szerződéses ügyfelek)”Ha a Slovenská pošta saját csomagszám-tartományt rendelt Önhöz, töltse ki a Csomagszám-tartomány – -tól és Csomagszám-tartomány – -ig speciális mezőket (például EB534780848SK). A Globe ezután ebből a tartományból oszt ki számokat, és minden export után a Következő csomagszám mezőben tárolja a soron következőt, amelyet manuálisan is javíthat.
A számok formátuma PPNNNNNNNN[C]SS — kétbetűs előtag, nyolc számjegy, opcionális ellenőrzőszám és kétbetűs utótag. Az ellenőrzőszámot a Globe számítja ki Ön helyett. Ha a tartomány kifogy, az exportok mindaddig sikertelenek lesznek, amíg új tartományt nem ad meg. Hagyja üresen ezeket a mezőket, ha a számokat a Slovenská pošta osztja ki.
Utánvét (COD)
Szekció neve “Utánvét (COD)”Az utánvét támogatott. Az utánvét összege a rendelés fennmaradó összegéből származik a rendelés pénznemében, és banki jóváírásként kerül elküldésre a futárszolgálati fiókon beállított Utánvét IBAN számlára, a rendelésszám számjegyeiből képzett változó szimbólummal. Érvényes IBAN nélkül az API visszautasítja a csomagot.
Biztosítás
Szekció neve “Biztosítás”A biztosítás akkor kerül hozzáadásra, ha a rendelés értéke nullánál nagyobb, és vagy a termék Poistený list, vagy a Szállítmánybiztosítás be van kapcsolva a futárszolgálat beállításaiban. A biztosított összeg a rendelés értéke a rendelés pénznemében, vagy az Alapértelmezett biztosítási érték, ha beállított ilyet.
Kézbesítési állapot
Szekció neve “Kézbesítési állapot”A kézbesítési állapot szinkronizálása a Slovenská poštánál nem érhető el — a csomagállapotok nem íródnak vissza a Shopify-ba, és az utánvétes fizetések sem lesznek automatikusan fizetettként megjelölve. A csomagszám és a Slovenská pošta nyomkövetési oldalára mutató hivatkozás továbbra is a teljesítéshez kerül. A visszáru-címkék és a már exportált csomagok Globe-ból történő törlése szintén nem támogatott; a csomagokat a Moje zásielky felületén törölje.
Címkenyomtatás
Szekció neve “Címkenyomtatás”A Slovenská pošta címkéit PDF formátumban adja vissza, és az alábbi formátumokban nyomtathatók:
| Formátum | Címkék száma ívenként | Kezdőpozíció |
|---|---|---|
| A6 | 1 (egy címke oldalanként) | – |
| A4 | 4 (2×2 rács) | 1–4 |
A4-es ívek nyomtatásakor válassza ki a kezdőpozíciót a részben használt címkeívek újrafelhasználásához. Az alapértelmezetten használt formátumot az Alapértelmezett nyomtatási beállítás mezőben állíthatja be a futárszolgálat beállításaiban.
Hibaelhárítás
Szekció neve “Hibaelhárítás”| Probléma | Megoldás |
|---|---|
| Sikertelen hitelesítés | Ellenőrizze a Felhasználói azonosító és API kulcs értékét, és győződjön meg arról, hogy a WebEPH API aktiválva van a Slovenská pošta fiókjában. |
| Hiányzó kötelező feladómezők | A Feladó neve, Feladó utca, Feladó város és Feladó irányítószám mindegyikét ki kell tölteni. |
| Hiányzó címzettnév, cím, város vagy irányítószám | A Shopify szállítási cím hiányos. Csomagátvételi pontos rendeléseknél ellenőrizze, hogy az ügyfél valóban kiválasztott-e pontot a pénztárban. |
| Érvénytelen csomagszám-formátum | A csomagszám-tartomány mezőiben a PPNNNNNNNN[C]SS formátumot használja, például EB534780848SK. |
| A csomagszám-tartomány kimerült | Az összes hozzárendelt szám elfogyott. Kérjen új tartományt a Slovenská poštától, és frissítse a Csomagszám-tartomány – -tól/-ig és Következő csomagszám mezőket. |
| Ellenőrzési hiba az exportnál | Az API visszautasított egy értéket a csomagon — leggyakrabban hiányzó Utánvét IBAN, vagy olyan biztosítási vagy utánvét összeg, amelyet a termék nem enged meg. |
| Nem található csomagazonosító a rendelésekben | A rendelés exportja nem sikerült, így nincs mit nyomtatni. Nyomtatás előtt exportálja újra. |
| A címketípus nem érhető el | A címke még nem áll készen ahhoz a csomaghoz. Várjon egy pillanatot, és nyomtasson újra. |
| Nem sikerült csatlakozni az SK Posta API-hoz | A WebEPH API átmenetileg nem érhető el. Próbálja meg később az exportot vagy a nyomtatást. |