DostavaPošta Slovenije

Pošta Slovenije i izrada naljepnica (eSpremnica)

Izrađujte naljepnice Pošte Slovenije izravno iz narudžbi u eHero putem integracije eSpremnica te postavite račune, usluge i praćenje pošiljki.

Pregled integracije eSpremnica i Pošte Slovenije

Važno: web prijava u eSpremnicu nije isto što i API prijava. Korisničko ime i lozinka kojima se prijavljujete u web eSpremnicu ne rade za povezivanje s eHero — Pošta Slovenije za API izdaje zasebne prijavne podatke s drukčijom lozinkom. Kako ih dobiti, opisano je u nastavku.

eHero omogućuje izradu naljepnica Pošte Slovenije izravno iz narudžbi putem službene integracije eSpremnica. Izrađene se naljepnice povezuju s narudžbom i odabranim eSpremnica računom, a statusi pošiljki prikazuju se na stranici Naljepnice za dostavu.

Za izradu naljepnica morate imati povezan eSpremnica račun. Na besplatnom paketu dostupne su do 3 naljepnice mjesečno, a na plaćenim paketima broj naljepnica je neograničen.

Kako dobiti API prijavne podatke

Za povezivanje trebate API podatke web servisa (ne web lozinku eSpremnice): ID klijenta (KomID), ID ugovora (PogID), ID podružnice (PodID), ID pošte (PostID) te API korisničko ime i lozinku.

Postupak dobivanja API podataka

  • Kontaktirajte svog upravitelja ugovora u Pošti Slovenije.
  • Javite da želite API pristup web servisu.
  • Navedite da je vaš razvojni partner eHero, odnosno tvrtka INSIDIO d.o.o. (koja već ima uspostavljenu vezu web servisa s Poštom Slovenije).
  • Zatražite produkcijske API podatke: KomID, PogID, PodID, PostID + API korisničko ime i lozinku.
  • Primljene podatke unesite u obrazac u sljedećem koraku.

Povezivanje i postavljanje eSpremnica računa

eSpremnica računima upravljate u lijevoj bočnoj navigaciji pod Slanje → Dostavne službe. Ovdje možete dodavati nove račune, uređivati postojeće postavke i po potrebi prekinuti vezu.

Ako imate povezano više računa, eHero vas pri izradi naljepnice pita putem kojeg računa želite izraditi pošiljku.

Kad ispunite obrazac i postavite sve potrebne mogućnosti, eHero pri potvrdi provjerava podatke i sprema račun.

Ispunite podatke i spremite vezu

  • Na stranici Slanje → Dostavne službe kliknite Dodaj vezu.
  • Unesite sve tražene podatke:
    • način (Test ili Produkcija).
    • API korisničko ime (ne web korisničko ime eSpremnice),
    • API lozinka (ne web lozinka eSpremnice),
    • ID klijenta (Client ID),
    • ID ugovora (Contract ID),
    • ID podružnice (Branch ID) i
    • ID pošte (Post ID).
  • Po potrebi dodajte i podatke za praćenje (trackingUsername, trackingPassword) te postavite zadane vrijednosti i preslikavanja u karticama Opće postavke i Vidljive usluge.
  • Zatim pošaljite obrazac za povezivanje. Ako su uneseni podaci ispravni, eHero uspješno sprema račun i dodaje ga na popis povezanih računa, gdje je dostupan za izradu naljepnica.
  • Ako dođe do pogreške, eHero prikazuje obavijest o pogrešci i vraća vas na obrazac kako biste mogli ispraviti podatke. U tom se slučaju račun ne sprema.

Više računa i prekid veze

  • U eHero možete povezati više eSpremnica računa. Ako ih je više, eHero pri izradi naljepnice prikazuje mogućnost odabira računa.
  • Ako račun više ne koristite, kod njega kliknite Prekini vezu. Već izrađene naljepnice pritom ostaju spremljene, ali novih naljepnica putem tog računa više nije moguće izrađivati.

Obrazac za unos vjerodajnica i način rada

Osnovni dio obrasca sadrži obvezna polja za povezivanje s eSpremnica API-jem te mogućnost postavljanja praćenja.

body
modeenum
Required

Način rada veze. Birate između testnog načina (Test) i produkcijskog načina (Produkcija). Odabrani način određuje koristi li eHero testno ili produkcijsko okruženje eSpremnica API-ja.

body
usernamestring
Required

Korisničko ime eSpremnica računa za prijavu u API.

body
passwordstring
Required

Lozinka eSpremnica računa za prijavu u API.

body
clientIdstring
Required

Identifikator klijenta (KomitentId odnosno Client ID) koji dobivate od Pošte Slovenije. Koristi se za identifikaciju ugovornog partnera u eSpremnici.

body
contractIdstring
Required

Identifikator ugovora (PogodbaId odnosno Contract ID) u okviru kojeg imate ugovorene usluge s Poštom Slovenije.

body
branchIdstring
Required

Identifikator poslovnice (PodruznicaId odnosno Branch ID) putem koje predajete pošiljke.

body
postIdstring
Required

Identifikator pošte (PostaId odnosno Post ID) koji određuje poštansku jedinicu u sustavu Pošte Slovenije.

body
trackingUsernamestring

Korisničko ime za praćenje pošiljki, ako koristite zasebne vjerodajnice za praćenje. To je potrebno za automatsku sinkronizaciju statusa pošiljki iz eSpremnice u eHero.

body
trackingPasswordstring

Lozinka za praćenje pošiljki, povezana s vrijednošću trackingUsername. Koristi se pri pozivima API-ja za praćenje Pošte Slovenije.

Ako ne unesete vjerodajnice za praćenje (trackingUsername i trackingPassword), naljepnice ćete i dalje moći izrađivati, ali se statusi pošiljki neće automatski sinkronizirati u eHero.

Kartice u modalnom prozoru

Modalni prozor za dodavanje ili uređivanje računa sadrži dvije kartice u kojima postavljate dodatne pojedinosti rada veze.

Opće postavke

  • U ovoj kartici postavite zadane podatke koji se automatski koriste pri ispunjavanju obrasca Kreiraj naljepnicu.
  • Ovdje možete odrediti zadanu vrstu pošiljke odnosno paketa, izvornu državu slanja, zadanu težinu te zadani volumen.
  • Te postavke smanjuju potrebu za ručnim unosom i osiguravaju ujednačeniji postupak pripreme pošiljki.
Kartica Opće postavke u postavkama eSpremnica u eHero, gdje korisnik postavlja zadanu vrstu pošiljke, državu podrijetla, težinu i volumen pošiljke.
U kartici Opće postavke postavite zadane podatke za pošiljku koji se automatski koriste pri izradi naljepnice.

Vidljive usluge

  • U ovoj kartici odredite koje će usluge Pošte Slovenije biti prikazane u obrascu Kreiraj naljepnicu.
  • Možete odabrati dodatne usluge, kao što su, na primjer, otkupnina (pouzeće), potpis dokumenata i druge mogućnosti prikazane u nastavku.
Kartica Vidljive usluge u postavkama eSpremnica u eHero, gdje korisnik odabire koje će usluge Pošte Slovenije biti prikazane pri izradi naljepnice.
U kartici Vidljive usluge odredite koje će usluge Pošte Slovenije biti dostupne pri izradi naljepnice.

Mapiranje statusa

Nakon uspješnog povezivanja otvara se stranica na kojoj za svaku statusnu šifru Pošte Slovenije odabirete odgovarajući status u eHero (npr. predano, na putu, dostavljeno).

Kod pojedinog statusa možete označiti završni status: kad pošiljka dosegne takav status, eHero prestaje tražiti nova stanja te pošiljke.

Izrada naljepnica Pošte Slovenije iz narudžbi

Naljepnicu za Poštu Slovenije možete izraditi izravno na popisu narudžbi ili unutar pojedine narudžbe. Za izradu morate imati povezan računovodstveni program.

Gdje pronaći mogućnost izrade naljepnice

  • Na popisu narudžbi svaka narudžba ima ikonu Kreiraj naljepnicu.
  • Unutar pojedine narudžbe mogućnost Kreiraj naljepnicu dostupna je u padajućem izborniku.
  • Kad je naljepnica uspješno izrađena, to je vidljivo izravno kod narudžbe u eHero.

Postupak izrade naljepnice

Izrada naljepnice iz narudžbe

  • U bočnom izborniku odaberite Narudžbe.
  • Kod odabrane narudžbe kliknite ikonu Kreiraj naljepnicu ili odaberite istu mogućnost u izborniku radnji narudžbe.
  • Prva mogućnost:
Popis narudžbi u eHero s naznakom »Kreiraj naljepnicu« kod odabrane narudžbe u stupcu Status.
Kod odabrane narudžbe putem ikone u stupcu Status možete izraditi naljepnicu za slanje.
  • Druga mogućnost:
Popis narudžbi u eHero s otvorenim izbornikom dodatnih mogućnosti, gdje je označena mogućnost »Kreiraj naljepnicu«.
U izborniku dodatnih mogućnosti kod narudžbe odaberite mogućnost »Kreiraj naljepnicu« ako želite pripremiti naljepnicu za slanje.
  • Ako nemate povezan nijedan eSpremnica račun, prikazuje se obavijest da prvo morate povezati eSpremnica račun. Klikom na gumb Poveži preusmjerit ćemo vas na Slanje → Dostavne službe, gdje možete dodati račun.

Odaberite eSpremnica račun

  • Ako imate povezano više eSpremnica računa, prikazuje se prozor za odabir računa.
  • Odaberite račun putem kojeg želite poslati pošiljku.
  • Nakon potvrde otvara se obrazac Kreiraj naljepnicu, vezan uz odabrani račun.

Pregledajte i dopunite podatke u obrascu Kreiraj naljepnicu

  • Obrazac Kreiraj naljepnicu unaprijed je ispunjen podacima iz narudžbe, kao što su:
    • adresa primatelja,
    • podaci o paketu (težina, volumen i dimenzije prema osnovnim postavkama računa),
    • dodatne usluge koje ste označili kao vidljive u postavkama računa,
    • a kod međunarodnih pošiljki i obvezna polja za carinske i druge međunarodne podatke.
  • Po potrebi ispravite ili dopunite podatke prije nego što nastavite.

Potvrdite obrazac i pričekajte izradu naljepnice

  • Pošaljite obrazac Kreiraj naljepnicu.
  • eHero šalje zahtjev eSpremnica API-ju za izradu naljepnice.
  • Pri uspješnom odgovoru eHero prima broj paketa, izrađuje poveznicu na naljepnicu te je sprema i povezuje s narudžbom i odabranim eSpremnica računom.

Provjerite naljepnice i praćenje

  • Idite na Slanje → Naljepnice za dostavu. Tamo su kartice Sve oznake, Poslano, Završeno, Otkazano, Problemi i Povrati; naljepnice možete pregledati, preuzeti kao PDF i otvoriti poveznicu za praćenje.
  • Ako imate postavljene podatke za praćenje, statusi pošiljki automatski se sinkroniziraju.

Važne provjere i posebnosti

Adresa primatelja mora imati valjan poštanski broj. Pri pogrešci prikazuje se obavijest; naljepnicu izradite nakon ispravka adrese.

  • Ako postavite vjerodajnice za praćenje, eHero redovito dohvaća statuse pošiljki iz Pošte Slovenije i prema postavkama mapiranja statusa prikazuje ih kod naljepnice.

Storno naljepnice

Naljepnicu možete otkazati gumbom Otkazati. Naljepnica se označava kao stornirana kad to potvrdi Pošta Slovenije. Nakon završnog statusa pošiljke storno više nije moguć.

Primopredajni popis

Na stranici Otprema možete ispisati primopredajni popis (oddajni popis) za dan za koji ste izradili naljepnice.

Stanje Nepotvrđena

Ako Pošta Slovenije ne potvrdi je li pošiljka nastala, naljepnica dobiva stanje Nepotvrđena (Nepotrjeno). Pošiljka možda postoji, pa naljepnicu nemojte izrađivati ponovno, nego provjerite u eSpremnici.

Tehničke napomene o okruženjima

Postavka Način na eSpremnica računu (Test ili Produkcija) određuje koje će okruženje Pošte Slovenije eHero koristiti za sve pozive povezane s tim računom:

  • isti se način zatim koristi i pri svim daljnjim pozivima, uključujući izradu naljepnica i praćenje pošiljki,
  • za pojedini račun nije moguće kombinirati različita okruženja.

Ako želite koristiti i testno i produkcijsko okruženje, u odjeljku Dostavne službe izradite dva zasebna računa: jedan u načinu Test i drugi u načinu Produkcija.

Sažetak

Integracija s eSpremnicom omogućuje vam da naljepnice Pošte Slovenije izrađujete izravno iz eHero narudžbi, s već unaprijed ispunjenim podacima, nadzorom nad dodatnim uslugama i mogućnošću automatskog praćenja pošiljki. Odgovarajućim postavljanjem računa u Slanje → Dostavne službe, ispravnim preslikavanjem statusa i poštivanjem ograničenja paketa osiguravate pregledan i pouzdan proces slanja — od izrade naljepnice do završetka dostave.

Was this page helpful?