Help za API

Grupno praćenje (Id = 64)

Opis

Transakcija se koristi za pregled kretanja liste pošiljaka. StrIn je serijalizovani objekat klase TTStatusiPosiljakaIn, a StrOut je serijalizovani objekat klase TTStatusiPosiljakaOut.

Ulazni podaci

        
        public class  TTStatusiPosiljakaIn
        {
            public string EksterniBroj;
            public string UkljucitiPrivremeneStatuse;
            public List<string> Posiljke
        }

Opis ulaznih podataka

Naziv	Tip	Opis
EksterniBroj	string	Polje EksterniBroj je standardno prazno polje. Vrednost D šalje se samo ukoliko se kretanje vrši za pošiljke poslate kroz EPK/B2B.
UkljucitiPrivremeneStatuse	string	Polje omogućava da se među statusima prikažu i privremeni statusi, koji su opisani u transakciji Pojedinačno praćenje. Šalje se vrednost D ili prazno polje.
Posiljke	string	Šalje se lista prijemnih brojeva pošiljaka za koje je potrebno vratiti statuse (max 1.000).

Izlazni podaci

        
        
        public class  TTStatusiPosiljakaOut
        {
            public List<PosiljkaKretanje> Posiljke;
        }
        public class  PosiljkaKretanje
        {    
            public string PrijemniBroj;
            public int? Masa;
            public List<OtkupniDokument> OtkupniDokumenti;
            public TTKretanje Prijem;
            public TTKretanje UrucenjePrimaocu;
            public TTKretanje Konacno;            
            public TTKretanje Otprema;
            public string BrojPosiljkePDK;
        }

Opis izlaznih podataka

Naziv	Tip	Opis
Posiljke	List<PosiljkaKretanje>	Šalje se lista pošiljaka sa podacima o kretanju svake pojedinačne pošiljke, sa podacima koji su opisani u nastavku tabele.
PrijemniBroj	string	Šalje se prijemni broj pošiljke.
Masa	int	Šalje se masa pošiljke (u gramima).
OtkupniDokumenti	List<OtkupniDokument>	Polje Otkupni dokumenti vraća informacije o vrsti OtkupniDokument i broju otkupnog dokumenta u slučaju da je pošiljka otkupna i uručena primaocu.
Prijem	TTKretanje	Polje Prijem je kretanje pošiljke sa prijema.
UrucenjePrimaocu	TTKretanje	Polje UrucenjePrimaocu je status pošiljke sa uručenja, i to: Uručena, Izveštena (ostavljeno obaveštenje primaocu) ili Vraćena sa različitim razlozima vraćanja.
Konacno	TTKretanje	Polje Konacno se odnosi na konačni status pošiljke. Ukoliko je pošiljka uručena primaocu, polje sadrži iste podatke kao i polje UrucenjePrimaocu. U slučaju vraćanja pošiljke pošiljaocu, u ovom polju se šalje informacija o vraćanju iste.
Otprema	TTKretanje	Polje Otprema se trenutno ne koristi.
BrojPosiljkePDK	string	Polje BrojPosiljkePDK vraća podatke o prijemnom broju pošiljke u kojoj se vraća dokumentacija ukoliko je pošiljka uručena.

Napomena: svako od polja može biti NULL, ukoliko odgovarajuće kretanje ne postoji (npr. pošiljka nije primljena, nije na dostavi...).

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):

Status - PR ili OT
Status; - UR; ili IZ;
Status; Dopuna - VR;PR ili UR;OZ

Primeri

Primer pregleda kretanja za 3 PE pošiljke

JSON string za serijalizovani objekat klase TTStatusiPosiljakaIn

           
{
"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": 64,
"TipSerijalizacije": 2,
"IdTransakcija": "e64b381e-7b32-4629-b227-bfaa88b8610e",
"StrIn": "{\"EksterniBroj\":\"\", \"UkljucitiPrivremeneStatuse\":\"\",\"Posiljke\":[\"PE750151869RS\",\"PE750151872RS\",\"PE750151886RS\"]}"
}

JSON string za serijalizovani objekat klase TTStatusiPosiljakaOut

           
{
"Rezultat": 0,
"StrOut":"{\"Posiljke\":[{\"PrijemniBroj\":\"PE750151869RS\",\"Masa\":256,\"OtkupniDokumenti\":null,\"Prijem\":{\"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},\"UrucenjePrimaocu\":{\"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\":\"MILAN BORKOVIĆ\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151869RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":126604},\"Konacno\":{\"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\":\"MILAN BORKOVIĆ\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151869RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":126604},\"Otprema\":null,\"BrojPosiljkePDK\":null},{\"PrijemniBroj\":\"PE750151872RS\",\"Masa\":256,\"OtkupniDokumenti\":null,\"Prijem\":{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T10:15:35\",\"Konacno\":false,\"Status\":\"Prijem\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 10:15:35\",\"StatusSifra\":\"PR\",\"Potpisnik\":\"\",\"Faza\":\"P\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151872RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":379641},\"UrucenjePrimaocu\":{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T10:19:10\",\"Konacno\":false,\"Status\":\"Zadužena za isporuku\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 10:19:10\",\"StatusSifra\":\"ZI;\",\"Potpisnik\":\"\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151872RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":126610},\"Konacno\":null,\"Otprema\":null,\"BrojPosiljkePDK\":null},{\"PrijemniBroj\":\"PE750151886RS\",\"Masa\":256,\"OtkupniDokumenti\":null,\"Prijem\":{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T10:15:35\",\"Konacno\":false,\"Status\":\"Prijem\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 10:15:35\",\"StatusSifra\":\"PR\",\"Potpisnik\":\"\",\"Faza\":\"P\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151886RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":379642},\"UrucenjePrimaocu\":{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T14:25:00\",\"Konacno\":true,\"Status\":\"Uručena (primaocu)\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 14:25:00\",\"StatusSifra\":\"UR;\",\"Potpisnik\":\"BOJANA\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151886RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":126606},\"Konacno\":{\"BrojPosiljkeOTK\":\"\",\"BrojPosiljkePDK\":null,\"ImaOtkupninu\":false,\"DatumKretanja\":\"2021-02-24T14:25:00\",\"Konacno\":true,\"Status\":\"Uručena (primaocu)\",\"Mesto\":\"11077 BEOGRAD 99\",\"Datum\":\"24.02.2021 14:25:00\",\"StatusSifra\":\"UR;\",\"Potpisnik\":\"BOJANA\",\"Faza\":\"U\",\"VrstaTransakcije\":null,\"MestoDo\":\"\",\"Retur\":\"N\",\"Privremen\":\"\",\"PrijemniBroj\":\"PE750151886RS\",\"Masa\":256,\"IdCpmDan\":7942,\"IdPosiljka\":126606},\"Otprema\":null,\"BrojPosiljkePDK\":null}]}",	
"StrRezultat": "{\"Poruka\":null,\"PorukaKorisnik\":null,\"Info\":null}"
}