logo
Poštni servisiPošta Slovenije

Pošta Slovenije in kreiranje nalepk (eSpremnica)

Ustvarjajte Pošta Slovenije nalepke neposredno iz naročil v eHero prek integracije eSpremnica ter nastavite račune, storitve in sledenje pošiljk.

Pregled integracije eSpremnica in Pošta Slovenije

eHero omogoča ustvarjanje Pošta Slovenije nalepk neposredno iz naročil prek uradne integracije eSpremnica. Ustvarjene nalepke se povežejo z naročilom in izbranim eSpremnica računom, statusi pošiljk pa se lahko samodejno preslikajo v statuse naročil v eHero.

Za ustvarjanje nalepk morate imeti povezan eSpremnica račun. Na brezplačnem paketu so na voljo do 3 nalepke na mesec, na plačljivih paketih pa je število nalepk neomejeno.

Povezava in nastavitev eSpremnica računa

eSpremnica račune upravljate v levi stranski navigaciji pod eSpremnica → Upravljaj račune. Tukaj lahko dodajate nove račune, urejate obstoječe nastavitve in po potrebi prekinete povezavo.

Če imate povezanih več računov, vas eHero pri ustvarjanju nalepke vpraša, prek katerega računa želite ustvariti pošiljko.

Ko izpolnite obrazec in nastavite vse potrebne možnosti, eHero ob potrditvi preveri podatke in shrani račun.

Izpolnite podatke in shranite povezavo

  • Na strani eSpremnica → Upravljaj račune kliknite Dodaj povezavo.

  • Vnesite vse zahtevane podatke:

    • način(Test ali Produkcija).

    • uporabniško ime,

    • geslo,

    • ID stranke (Client ID),

    • ID pogodbe (Contract ID),

    • ID podružnice (Branch ID) in

    • ID pošte (Post ID).

  • Po potrebi dodajte še sledilne podatke (trackingUsername, trackingPassword) ter nastavite privzete vrednosti in preslikave v zavihkih Splošne nastavitve, Vidne storitve in Preslikava stanja.

  • Nato pošljite obrazec za povezavo. Če so vneseni podatki pravilni, eHero račun uspešno shrani in ga doda na seznam povezanih računov, kjer je na voljo za ustvarjanje nalepk.

  • Če pride do napake, eHero prikaže obvestilo o napaki in vas vrne na obrazec, da lahko popravite podatke. V tem primeru se račun ne shrani.

Več računov in prekinitev povezave

  • V eHero lahko povežete več eSpremnica računov. Če jih je več, eHero pri ustvarjanju nalepke prikaže možnost izbire računa.

  • Če računa ne uporabljate več, pri njem kliknite Prekini povezavo. Že ustvarjene nalepke pri tem ostanejo shranjene, novih nalepk prek tega računa pa ni več mogoče ustvarjati.

Obrazec za vnos poverilnic in način delovanja

Osnovni del obrazca vsebuje obvezna polja za povezavo z eSpremnica API-jem ter možnost nastavitve sledenja.

body
modeenum
Required

Način delovanja povezave. Izbirate med testnim načinom (Test) in produkcijskim načinom (Produkcija). Izbrani način določa, ali eHero uporablja testno ali produkcijsko okolje eSpremnica API-ja.

body
usernamestring
Required

Uporabniško ime eSpremnica računa za prijavo v API.

body
passwordstring
Required

Geslo eSpremnica računa za prijavo v API.

body
clientIdstring
Required

Identifikator komitenta (KomitentId oziroma Client ID), ki ga prejmete od Pošte Slovenije. Uporablja se za identifikacijo pogodbenega partnerja v eSpremnici.

body
contractIdstring
Required

Identifikator pogodbe (PogodbaId oziroma Contract ID), v okviru katere imate dogovorjene storitve s Pošto Slovenije.

body
branchIdstring
Required

Identifikator poslovalnice (PodruznicaId oziroma Branch ID), prek katere oddajate pošiljke.

body
postIdstring
Required

Identifikator pošte (PostaId oziroma Post ID), ki določa poštno enoto v sistemu Pošte Slovenije.

body
trackingUsernamestring

Uporabniško ime za sledenje pošiljk, če uporabljate ločene sledilne poverilnice. To je potrebno za samodejno sinhronizacijo statusov pošiljk iz eSpremnice v eHero.

body
trackingPasswordstring

Geslo za sledenje pošiljk, povezano z vrednostjo trackingUsername. Uporablja se pri klicih sledilnih API-jev Pošte Slovenije.

Če ne vnesete sledilnih poverilnic (trackingUsername in trackingPassword), boste nalepke še vedno lahko ustvarjali, statusi pošiljk pa se ne bodo samodejno sinhronizirali v eHero.

Zavihki v modalu

Modal za dodajanje ali urejanje računa vsebuje tri zavihke, kjer nastavite dodatne podrobnosti delovanja povezave.

Splošne nastavitve

  • V tem zavihku nastavite privzete podatke, ki se samodejno uporabijo pri izpolnjevanju obrazca Ustvari nalepko.

  • Tukaj lahko določite privzeto vrsto pošiljke oziroma paketa, izvorno državo pošiljanja, privzeto težo ter privzeto prostornino.

  • Te nastavitve zmanjšajo potrebo po ročnem vnosu in poskrbijo za bolj enoten postopek priprave pošiljk.

Zavihek Splošne nastavitve v nastavitvah eSpremnica v eHero, kjer uporabnik nastavi privzeto vrsto pošiljke, državo izvora, težo in prostornino pošiljke.
V zavihku Splošne nastavitve nastavite privzete podatke za pošiljko, ki se samodejno uporabijo pri ustvarjanju nalepke.

Vidne storitve

  • V tem zavihku določite, katere storitve Pošta Slovenije bodo prikazane v obrazcu Ustvari nalepko.

  • Izberete lahko dodatne storitve, kot so na primer odkupnina, podpis dokumentov in druge možnosti, ki so prikazane spodaj.

Zavihek Vidne storitve v nastavitvah eSpremnica v eHero, kjer uporabnik izbere, katere storitve Pošte Slovenije bodo prikazane pri ustvarjanju nalepke.
V zavihku Vidne storitve določite, katere storitve Pošte Slovenije bodo na voljo pri ustvarjanju nalepke.

Preslikava statusov

  • V tem zavihku določite, kako se statusi Pošta Slovenije preslikajo v statuse naročil v eHero.

  • Za vsako statusno kodo Pošte Slovenije izberete ustrezen status naročila v eHero, na primer oddano, na poti, dostavljeno ali neuspešna dostava.

  • Pred shranjevanjem morajo biti preslikane vse statusne kode.

  • Pri eni ali več preslikavah lahko označite tudi končni status, kar pomeni, da je pošiljka zaključena in se lahko zaključi tudi naročilo v eHero.

Zavihek Preslikava stanja v nastavitvah eSpremnica v eHero, kjer uporabnik za posamezne kode stanja Pošte Slovenije izbere ustrezno preslikano stanje in po potrebi označi zadnje stanje.
V zavihku Preslikava stanja nastavite, kako se posamezne kode stanja Pošte Slovenije preslikajo v statuse naročil v eHero, ter po potrebi označite končno stanje pošiljke.

Preden lahko shranite nastavitve v zavihku Preslikava stanja, morate povezati vse statusne kode Pošte Slovenije z ustreznimi eHero statusi. Če katera koda ostane nepovezana, eHero sprememb ne bo dovolil shraniti. Če pri posamezni kodi stanja niste prepričani, kateri status izbrati, lahko začasno izberete poljubnega in ga kasneje po potrebi popravite.

Ustvarjanje Pošta Slovenije nalepk iz naročil

Nalepko za Pošta Slovenije lahko ustvarite neposredno v seznamu naročil ali znotraj posameznega naročila. Gumb je prikazan le, če imate povezan vsaj en eSpremnica račun, status naročila omogoča ustvarjanje nalepke in še niste dosegli omejitve brezplačnega paketa.

Kje najdete možnost za ustvarjanje nalepke

  • V seznamu naročil ima vsako naročilo ikono Ustvari nalepko.

  • Znotraj posameznega naročila je možnost Ustvari nalepko na voljo v spustnem meniju.

  • Ko je nalepka uspešno ustvarjena, je to vidno neposredno pri naročilu v eHero.

Če ste na brezplačnem paketu in presežete dovoljeno število nalepk, se gumb Ustvari nalepko skrije oziroma se prikaže obvestilo, da ste dosegli omejitev. Za nadaljnje ustvarjanje nalepk preklopite na plačljiv paket.

Postopek ustvarjanja nalepke

Ustvarjanje nalepke iz naročila

  • V stranskem meniju izberite Naročila.

  • Pri izbranem naročilu kliknite ikono Ustvari nalepko ali izberite isto možnost v meniju dejanj naročila.

  • Prva možnost:

    Seznam naročil v eHero z namigom »Ustvari nalepko« pri izbranem naročilu v stolpcu Status.
    Pri izbranem naročilu lahko prek ikone v stolpcu Status ustvarite nalepko za pošiljanje.

  • Druga možnost:

    Seznam naročil v eHero z odprtim menijem dodatnih možnosti, kjer je označena možnost »Ustvari nalepko«.
    V meniju dodatnih možnosti pri naročilu izberite možnost »Ustvari nalepko«, če želite pripraviti nalepko za pošiljanje.

  • Če nimate povezanega nobenega eSpremnica računa, se prikaže obvestilo, da morate najprej povezati eSpremnica račun. S klikom na gumb Poveži boste preusmerjeni na eSpremnica → Upravljaj račune, kjer lahko dodate račun.

Izberite eSpremnica račun

  • Če imate povezanih več eSpremnica računov, se prikaže okno za izbiro računa.

  • Izberite račun, prek katerega želite poslati pošiljko.

  • Po potrditvi se odpre obrazec Ustvari nalepko, vezan na izbrani račun.

Preglejte in dopolnite podatke v obrazcu Ustvari nalepko

  • Obrazec Ustvari nalepko je predizpolnjen s podatki iz naročila, kot so:

    • naslov prejemnika,

    • podatki o paketu (teža, volumen in dimenzije glede na osnovne nastavitve računa),

    • dodatne storitve, ki ste jih označili kot vidne v nastavitvah računa,

    • pri mednarodnih pošiljkah pa tudi obvezna polja za carinske in druge mednarodne podatke.

  • Po potrebi podatke popravite ali dopolnite, preden nadaljujete.

Potrdite obrazec in počakajte na ustvarjanje nalepke

  • Pošljite obrazec Ustvari nalepko.

  • eHero pošlje zahtevek na eSpremnica API za ustvarjanje nalepke.

  • Ob uspešnem odzivu eHero prejme številko paketa, ustvari povezavo do nalepke ter jo shrani in poveže z naročilom in izbranim eSpremnica računom.

  • Na brezplačnem paketu se števec nalepk poveča za eno. Posamezno naročilo se šteje samo enkrat, tudi če nalepko kasneje ponovno prenesete.

Preverite nalepke in sledenje

  • Po ustvarjanju nalepke vas eHero preusmeri v razdelek Nalepke, kjer je prikazan seznam ustvarjenih pošiljk.

  • V eSpremnici v meniju Nalepke lahko pregledate vse ustvarjene nalepke, jih prenesete kot PDF, preverite podatke o paketu in dostopate do povezav za sledenje.

  • Če imate nastavljene sledilne podatke, se statusi pošiljk samodejno sinhronizirajo in preslikajo v statuse naročil v eHero.

Pomembne validacije in posebnosti

Pri vnosu naslovov eHero preverja veljavnost slovenskih poštnih številk. Če vnesete napačno poštno številko, se prikaže napaka o neveljavnem ZIP-u, nalepke pa ne morete ustvariti, dokler podatka ne popravite.

  • Za namen omejitve brezplačnega paketa se pri posameznem naročilu upošteva največ ena ustvarjena nalepka, tudi če jo kasneje ponovno prenesete.

  • Če nastavite sledilne poverilnice, eHero redno pridobiva statuse pošiljk iz Pošte Slovenije in jih glede na nastavitve v zavihku Preslikava stanja preslika v interne statuse naročil.

  • Status, ki ga označite kot končnega, eHero uporabi za zaključevanje naročil, ko Pošta Slovenije sporoči, da je pošiljka dostavljena ali zaključena.

Tehnične opombe o okoljih

Nastavitev Način na eSpremnica računu (Test ali Produkcija) določa, katero okolje Pošte Slovenije bo eHero uporabljal za vse klice, povezane s tem računom:

  • isti način se nato uporablja tudi pri vseh nadaljnjih klicih, vključno z ustvarjanjem nalepk in sledenjem pošiljk,

  • za posamezen račun ni mogoče kombinirati različnih okolij.

Če želite uporabljati tako testno kot produkcijsko okolje, v razdelku Upravljaj račune ustvarite dva ločena računa: enega v načinu Test in drugega v načinu Produkcija.

Povzetek

Integracija z eSpremnico vam omogoča, da Pošta Slovenije nalepke ustvarjate neposredno iz eHero naročil, z že predizpolnjenimi podatki, nadzorom nad dodatnimi storitvami in možnostjo samodejnega sledenja pošiljk. Z ustrezno nastavitvijo računov v eSpremnica → Upravljaj račune, pravilno preslikavo statusov in upoštevanjem omejitev paketa si zagotovite pregleden in zanesljiv proces pošiljanja — od ustvarjanja nalepke do zaključka dostave.

Was this page helpful?

Last updated 4 weeks ago

Built with Documentation.AI