Provera dostupnosti i poštarine usluge

Praćenje pošiljaka

Slanje podataka za prijem pošiljaka

Adresni podaci

Pojedinačno praćenje (Id = 63)

Opis

Transakcija se koristi za pregled kretanja jedne pošiljke/usluge. StrIn je serijalizovani objekat klase TTKretanjeIn, a StrOut je serijalizovani objekat klase TTKretanjeOut.

Ulazni podaci

        
        public class  TTKretanjeIn
        {
            public int VrstaUsluge;
            public string EksterniBroj;
            public string PrijemniBroj
        }

Opis ulaznih podataka

Naziv Tip Opis
VrstaUsluge int Za praćenje kretanja pošiljke kao VrstaUsluge šalje se vrednost 1 (jedan).
EksterniBroj string Polje EksterniBroj je standardno prazno polje. Vrednost D šalje se samo za pošiljku poslatu kroz EPK/B2B, s tim da se u polje PrijemniBroj upiše Id korisnika EPK/B2B.
PrijemniBroj string Šalje se prijemni broj pošiljke, a za pošiljku za koju se pretraga vrši po eksternom broju šalje se Id korisnika EPK/B2B i eksterni broj (/35293:7902813018).

Izlazni podaci

        
        
        public class  TTKretanjeOut
        {
            public List<OtkupniDokument> OtkupniDokumenti;
            public List<TTKretanje> Kretanja;
            public string BrojPosiljkeOTK;
            public string BrojPosiljkePDK
        }

Opis izlaznih podataka

Naziv Tip Opis
OtkupniDokumenti List<OtkupniDokument> Polje Otkupni dokumenti vraća informacije o vrsti i broju otkupnog dokumenta u slučaju da je pošiljka otkupna i uručena primaocu.
Kretanja List<TTKretanje> Polje Kretanja sadrži sva kretanja izabrane pošiljke.
BrojPosiljkeOTK string Polje je prazno kod praćenja pošiljaka (koristi se za praćenje statusa elektronskih saopštenja).
BrojPosiljkePDK string Šalje se prijemni broj pošiljke u kojoj se vraća povratna dokumentacija, ukoliko je uručena pošiljka sa uslugom PDK. U ostalim slučajevima, polje je prazno.

Klasa: OtkupniDokument

        
        public class OtkupniDokument
        {
            public string Vrsta;
            public string Broj
        }

Opis klase OtkupniDokument

Naziv Tip Opis
Vrsta string Šalje se oznaka vrste otkupnog dokumenta i može imati jednu od sledećih vrednosti: N - Nalog za uplatu, E - PosTneT uputnica i U - Poštanska uputnica.
Broj string Šalje se broj otupnog dokumenta.

Klasa: TTKretanje

        
            public class TTKretanje
        {
            public string Status;
            public string Mesto;
            public string Datum;
            public string StatusSifra;
            public string Potpisnik;
            public string Faza;
            public string VrstaTransakcije;
            public string MestoDo;
            public string Retur;
            public string Privremen;
            public string PrijemniBroj;
            public int? Masa;
            
            public int? IdCpmDan;
            public int? IdPosiljka;

            public string BrojPosiljkeOTK;
            public string BrojPosiljkePDK; 
            public bool ImaOtkupninu;
            public DateTime DatumKretanja;
            public bool Konacno
        }

Opis klase TTKretanje

Naziv Tip Opis
Status string Šalje se tekstualni status pošiljke.
Mesto string Šalje se mesto gde je evidentiran status.
Datum string Šalju se datum i vreme evidentiranog statusa.
StatusSifra string Šalje se šifra statusa iz šifarnika statusa (npr. PR - primljena).
Potpisnik string Ovaj podatak se šalje samo ukoliko je pošiljka uručena. Šalje se naziv primaoca, odnosno pošiljaoca (za pošiljku koja je vraćena i uručena pošiljaocu).
Faza string Podatak za interne potrebe.
MestoDo string Šalje se mesto u koje je pošiljka otpremljena/preusmerena.
Retur string Šalje se vrednost D ukoliko se pošiljka vraća pošiljaocu. U ostalim slučajevima, polje je prazno.
Privremen string Šalje se prazno polje ili oznaka * (ukoliko je reč o privremenom statusu).
PrijemniBroj string Šalje se prijemni broj pošiljke.
Masa int Šalje se masa pošiljke (u gramima).
IdCpmDan int Podatak za interne potrebe.
IdPosiljka int Podatak za interne potrebe.
BrojPosiljkeOTK string Polje je prazno kod praćenja pošiljaka (koristi se za praćenje statusa elektronskih saopštenja).
BrojPosiljkePDK string Šalje se prijemni broj pošiljke u kojoj se vraća povratna dokumentacija, ukoliko je uručena pošiljka sa uslugom PDK. U ostalim slučajevima, polje je prazno.
ImaOtkupninu bool Daje rezultat "true" ili "false".
DatumKretanja DateTime Šalje se datum i vreme kretanja.
Konacno bool Polje Konacno se odnosi na konačni status pošiljke. Ukoliko je pošiljka uručena primaocu, šalje "true".

Šifarnik statusa

Statusi pošiljaka

Šifra Naziv PR Primljena OT Otpremljena UR Uručena - šifra statusa je ista i za uručenje primaocu i za uručenje pošiljaocu. Polje Retur označava kome je pošiljka uručena (konačan status). IZ Izveštena - korisniku ostavljeno obaveštenje da je pošiljka stigla i da je može podići u pošti VR Vraćena. IG Izgubljena (konačan status) NI Neisporučiva (konačan status) PU Preusmerena ND Naredna dostava (po zahtevu pošiljaoca)

Dopuna statusa

Šifra Naziv
AD Adresa nedovoljna
AP Adresa nepoznata
NE Nepoznat
NP Ne prima
OT Otputovao
PR Preseljen
UM Umro
NT Nije tražio
ZP Na zahtev korisnika (vraćeno sa isporuke zato što su pošiljalac/primalac tako tražili)
IR Istekao rok čuvanja na isporuci
OZ Opoziv (na zahtev pošiljaoca u toku istog dana) - predstavlja dopunu statusa Uručena

Napomena: U slučaju međunarodnih pošiljaka i sudskih pisama mogu se javiti još neki statusi i dopune.

Polje StatusSifra može imati jednu od sledećih struktura (sa primerima):

  1. Status - PR ili OT
  2. Status; - UR; ili IZ;
  3. Status; Dopuna - VR;PR ili UR;OZ

Primeri

Primer 1 - Pregled kretanja za PE pošiljku koja još uvek nije uručena primaocu

JSON string za serijalizovani objekat klase TTKretanjeIn
           
{
"StrKlijent":"{\"Username\":\"TEST\",\"Password\":\"t3st\",\"Jezik\":\"LAT\",\"IdTipUredjaja\":11,\"NazivUredjaja\":\"BG01022W030\",\"ModelUredjaja\":\"ASUS_M11\",\"VerzijaOS\":\"Microsoft Windows NT 6.2.9200.0\",\"VerzijaAplikacije\":\"1.0.0.0\",\"IPAdresa\":\"10.200.17.21\",\"Geolokacija\":null,\"Referenca\":\"1\"}",
"Servis": 101,
"IdVrstaTranskacije": 63,
"TipSerijalizacije": 2,
"IdTransakcija": "e64b381e-7b32-4629-b227-bfaa88b8660e",
"StrIn": "{\"VrstaUsluge\":\"1\", \"EksterniBroj\":\"\",\"PrijemniBroj\":\"PE746090324RS\"}"
}
JSON string za serijalizovani objekat klase TTKretanjeOut
           
{
"Rezultat": 0,
"StrOut": "{\"OtkupniDokumenti\":null,\"Kretanja\":[{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-04-21T15:30:25\",\"Konacno\":false,\"Status\":\"Naredna dostava\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"21.04.2021 15:30:25\",\"StatusSifra\":\"ND;\",\"Potpisnik\":\"\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE746090324RS\",\"Masa\":300,\"IdCpmDan\":8183,\"IdPosiljka\":127562},{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":true,\"DatumKretanja\":\"2021-04-21T07:36:30\",\"Konacno\":true,\"Status\":\"Uručena (primaocu)\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"21.04.2021 07:36:30\",\"StatusSifra\":\"UR;\",\"Potpisnik\":\"ZZ ZZZZ\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"*\",\"PrijemniBroj\":\"PE746090324RS\",\"Masa\":null,\"IdCpmDan\":null,\"IdPosiljka\":null},{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":true,\"DatumKretanja\":\"2021-04-21T07:33:25\",\"Konacno\":false,\"Status\":\"Prijem\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"21.04.2021 07:33:25\",\"StatusSifra\":\"PR\",\"Potpisnik\":\"\",\"Faza\":\"P\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE746090324RS\",\"Masa\":300,\"IdCpmDan\":8183,\"IdPosiljka\":380628}],\"BrojPosiljkeOTK\":null,\"BrojPosiljkePDK\":null}",
"StrRezultat": "{\"Poruka\":null,\"PorukaKorisnik\":null,\"Info\":null}"
}

Primer 2 - Pregled kretanja za PE pošiljku koja je uručena primaocu

JSON string za serijalizovani objekat klase TTKretanjeIn
           
{
"StrKlijent":"{\"Username\":\"TEST\",\"Password\":\"t3st\",\"Jezik\":\"LAT\",\"IdTipUredjaja\":11,\"NazivUredjaja\":\"BG01022W030\",\"ModelUredjaja\":\"ASUS_M11\",\"VerzijaOS\":\"Microsoft Windows NT 6.2.9200.0\",\"VerzijaAplikacije\":\"1.0.0.0\",\"IPAdresa\":\"10.200.17.21\",\"Geolokacija\":null,\"Referenca\":\"1\"}",
"Servis": 101,
"IdVrstaTranskacije": 63,
"TipSerijalizacije": 2,
"IdTransakcija": "e64b381e-7b32-4629-b227-bfaa88b8620e",
"StrIn": "{\"VrstaUsluge\":\"1\", \"EksterniBroj\":\"\",\"PrijemniBroj\":\"PE750151869RS\"}"
}
JSON string za serijalizovani objekat klase TTKretanjeOut
           
{
"Rezultat": 0,
"StrOut": "{\"OtkupniDokumenti\":null,\"Kretanja\":[{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T11:00:00\",\"Konacno\":true,\"Status\":\"Uručena (primaocu)\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 11:00:00\",\"StatusSifra\":\"UR;\",\"Potpisnik\":\"PETAR PETROVIĆ\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151869RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":126604},{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T10:15:34\",\"Konacno\":false,\"Status\":\"Prijem\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 10:15:34\",\"StatusSifra\":\"PR\",\"Potpisnik\":\"\",\"Faza\":\"P\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151869RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":379640}],\"BrojPosiljkeOTK\":null,\"BrojPosiljkePDK\":null}",
"StrRezultat": "{\"Poruka\":null,\"PorukaKorisnik\":null,\"Info\":null}"
}