Provera dostupnosti i poštarine usluge

Praćenje pošiljaka

Slanje podataka za prijem pošiljaka

Adresni podaci

Provera dostupnosti usluge (Id = 9)

Opis

Transakcija se koristi za proveru ispravnosti prosleđene adrese i mogućnosti realizacije usluge na istoj. StrIn je serijalizovani objekat klase ProveraDostupnostiIn, a StrOut je serijalizovani objekat klase ProveraDostupnostiOut.

Ulazni podaci

        
        public class  ProveraDostupnostiIn
        {
            public int TipAdrese;
            public int IdRukovanje;
            public AdresaUPS Adresa;
            public string Datum
        }

Opis ulaznih podataka

Naziv Tip Opis
TipAdrese int U polju TipAdrese šalje se jedna od sledećih vrednosti: 0 (nula) - adresa preuzimanja, 1 (jedan) - adresa pošiljaoca ili 2 (dva) - adresa primaoca.
IdRukovanje int Šalje se jedna od vrednosti iz enumeracije rukovanja IdRukovanje, za korisnike B2B su dostupna B2B rukovanja.
Adresa AdresaUPS Šalju se podaci opisani u delu AdresaUPS.
Datum string Šalje se datum predaje pošiljke, odnosno datum preuzimanja od strane kurira. Ukoliko se ne unese vrednost, podrazumeva se da je datum za tekući dan. Koristi se kod adresa primaoca za proveru očekivanog datuma dostave pošiljke.

Izlazni podaci

        
        
        public class  ProveraDostupnostiOut
        {
            public AdresaUPS Adresa;
            public string Poruke;
        }

Opis izlaznih podataka

Naziv Tip Opis
Adresa AdresaUPS Adresa predstavlja ulazne adresne podatke dopunjene tehničkim podacima, ukoliko nisu postojali (IdUlica, IdNaselje, Posta, Pak, Reon). Ukoliko je adresa ispravno uneta, ali se na istoj ne može realizovati izabrana usluga (IdRukovanje), metoda će javiti grešku, a izlazni objekat sa poljem Adresa će biti popunjen.
Poruke string Polje sadrži poruke upozorenja, a najčešće se odnose na uručenje Post express pošiljaka ukoliko nije moguće isto izvršiti u odgovarajućem roku.

klasa: AdresaUPS

    
        public class Adresa
        {
            public int IdNaselje; 
            public string Naselje;
            public int IdUlica;
            public string Ulica;
            public string Broj;
            public stringPodbroj;
            public string Sprat;
            public string Stan;
            public string Pak;
            public string Reon;
            public string Posta;
            public string BrojFaha;
            public string Opstina;
            public string Napomena;
            public string Vrsta;
            
        }

Opis klase Adresa

Naziv Tip Opis
IdNaselje int Šalje se Id iz šifarnika naselja JP "Pošta Srbije". Ukoliko korisnik ne koristi šifarnik, proslediti vrednost 0 (nula).
Naselje string Šalje se naziv naselja (max 50 karaktera).
IdUlica int Šalje se Id iz šifarnika ulica JP "Pošta Srbije". Ukoliko korisnik ne koristi šifarnik, proslediti vrednost 0 (nula).
Ulica string Šalje se naziv ulice (max 100 karaktera).
Broj int Šalje se broj iz adrese. Ukoliko je adresa bez broja (BB) šalje se vrednost -1 (minus jedan), a ukoliko postoji samo podbroj šalje se vrednost -2 (minus dva).
Podbroj string Ovaj podatak nije obavezan, vrednost se šalje samo ukoliko postoji u adresi.
Sprat string Ovaj podatak nije obavezan, vrednost se šalje samo ukoliko postoji u adresi.
Stan string Ovaj podatak nije obavezan, vrednost se šalje samo ukoliko postoji u adresi.
Posta string Šalje se poštanski broj (5 karaktera).
BrojFaha string Šalje se broj poštanskog pregratka, ukoliko se u polju Vrsta šalje vrednost F.
Opstina string Ova vrednost se ne šalje.
Napomena string Ova vrednost se ne šalje.
Vrsta string Šalje se jedna od sledećih vrednosti: S - standardna adresa, F - Fah, odnosno Poštanski pregradak ili P - Post restant . Način slanja svih adresnih podataka u zavisnosti od izabrane vrste dat je u nastavku.

Vrste adrese - način slanja podataka

Standardna adresa - S, podrazumeva 3 načina, i to:

  1. IdNaselje, IdUlica, Broj, Podbroj - Ovaj način se koristi ukoliko korisnik koristi šifarnik naselja i ulica JP "Pošta Srbije". U ovom slučaju podaci Naselje, Ulica, Pak i Posta treba da budu prazni.
  2. Pak, Broj, Podbroj - Ovaj način se koristi ukoliko korisnik ima uparene podatke sa podacima JP "Pošta Srbije". U ovom slučaju IdNaselje i IdUlica trebalo bi da imaju vrednost 0 (nula). Polja Naselje, Ulica i Posta ostaju prazna.
  3. Naselje, Ulica, Broj, Podbroj, Posta - Ovaj način se koristi ukoliko korisnik ne koristi adresne podatke JP "Pošta Srbije". U ovom slučaju IdNaselje i IdUlica imaju vrednost 0 (nula), a polje Pak je prazno. Na osnovu podataka o naselju, ulici i broju, vrši se pretraga tačnih podataka adrese i ukoliko se ispostavi da je adresa ispravna ali se ne slaže sa podatkom iz polja Posta, isto će se menjati, odnosno upisaće se ispravna vrednost. Ukoliko se adresa na osnovu navedenih podataka ne pronađe, vrši se preusmeravanje na poštu navedenu u polju Posta, s tim da to polje mora sadržati jedan od postojećih podataka iz šifarnika pošta. U suprtonom će metoda javiti grešku.

Adresa Poštanski pregradak - F: Ovaj način se koristi ukoliko korisnik ima otvoren poštanski pregradak u određenoj pošti, a potrebno je da se pošalju samo podaci Posta i Fah. Ostala polja imaju vrednost 0 (nula) ili se šalju prazna, u zavisnosti od tipa podataka.

Adresa Post restant - P: Ovaj način se koristi ukoliko je adresa Post restant i potrebno je da se pošalje samo podatak Posta. Ostala polja imaju vrednost 0 (nula) ili se šalju prazna, u zavisnosti od tipa podataka.

Enum: IdRukovanje

        
            public enum IdRukovanje
            {           
                PismoUPS = 1,
                PismoMPS = 2,
                DopisnicaUPS = 3,
                DopisnicaMPS = 4,
                PismoUpsR = 5,
                PismoMpsR = 6,
                VPismoUPS = 7,
                VPismoMPS = 8,
                SekogramUps = 9,
                TiskovinaUps = 10,
                DopisnicaUpsR = 12,
                SekogramUpsR = 13,
                TiskovinaUpsR = 14,
                PaketUPS = 15,
                SudskoPismo = 17,
                SekogramMps = 18,
                TiskovinaMPS = 19,
                SekogramMpsR = 20,
                TiskovinaMpsR = 21,
                PaketMPS = 22,
                DopisnicaMpsR = 23,            
                MVreca = 27,
                PE_Danas_za_sutra 12 = 29,
                PE_Danas_za_danas = 30, 
                Aerogram = 36,
                AerogramR = 37,
                RMVreca = 38,
                EMS_u_polazu = 45,
                PE_Međunarodne = 46,
                PostExportPismo = 49,
                PostExport = 53,               
                PE_Danas_za_odmah = 55,
                PE_Danas_za_sutra_19 = 58,
                PE_Danas_za_odmah_Bg = 59,
                PE_Danas_za_sutra_isporuka = 71,        
                PismoRMPS = 64,
                DopisnikaRMPS = 65,
                SekogramRMPS = 66,
                TiskovinaRMPS = 67,        
                SudskoEPK = 72,
                AvonPaket = 73,
                PoklonPaket = 74,
                PostPak = 75,        
                RMaliPaket = 79,  
             }

B2B rukovanja

                         
                PE_Danas_za_sutra 12 = 29,
                PE_Danas_za_danas = 30,                          
                PE_Danas_za_odmah = 55,
                PE_Danas_za_sutra_19 = 58,
                PE_Danas_za_odmah_Bg = 59,
                PE_Danas_za_sutra_isporuka = 71,

Primeri

Primer 1 - Provera dostupnosti usluge Danas za sutra 19 (vrsta adrese S - standardna)

JSON string za serijalizovani objekat klase ProveraDostupnostiIn
           
{
"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": 9,
"TipSerijalizacije": 2,
"IdTransakcija": "e64b381e-7b32-4629-b227-bfaa88b8660e",
"StrIn": "{\"TipAdrese\":\"2\",\"IdRukovanje\":\"58\",\"Adresa\":{\"IdNaselje\":\"0\",\"Naselje\":\"Novi Beograd\",\"IdUlica\":\"0\",\"Ulica\":\"Devetog maja\",\"Broj\":\"9\",\"Posta\":\"11070\",\"Pak\":\"\",\"Vrsta\":\"S\"},\"Datum\":\"\"}"
}
JSON string za serijalizovani objekat klase ProveraDostupnostiOut
           
{
"Rezultat": 0,
"StrOut": "{\"Adresa\":{\"IdNaselje\":0,\"Naselje\":\"Novi Beograd\",\"IdUlica\":0,\"Ulica\":\"Devetog maja\",\"Broj\":9,\"Podbroj\":null,\"Sprat\":null,\"Stan\":null,\"Pak\":\"X11070\",\"Reon\":null,\"Posta\":\"11070\",\"BrojFaha\":null,\"Opstina\":null,\"Napomena\":null,\"Vrsta\":\"S\",\"Nadredjena\":null,\"AdresaTXT\":null,\"IsporukaPosta\":null},\"Poruke\":\"Nije garantovan rok uručenja.\\r\\n\\r\\n\"}",
"StrRezultat": "{\"Poruka\":null,\"PorukaKorisnik\":null,\"Info\":null}"
}

Primer 2 - Provera dostupnosti usluge Danas za sutra 19 (vrsta adrese F - poštanski pregradak)

JSON string za serijalizovani objekat klase ProveraDostupnostiIn
           
{
"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": 9,
"TipSerijalizacije": 2,
"IdTransakcija": "e64b381e-7b32-4629-b227-bfaa88b8660e",
"StrIn": "{\"TipAdrese\":\"2\",\"IdRukovanje\":\"58\",\"Adresa\":{\"IdNaselje\":\"0\",\"IdUlica\":\"0\",\"BrojFaha\":\"15\",\"Posta\":\"11070\",\"Vrsta\":\"F\"},\"Datum\":\"\"}"
}
JSON string za serijalizovani objekat klase ProveraDostupnostiOut
           
{
"Rezultat": 0,
"StrOut": "{\"Adresa\":{\"IdNaselje\":0,\"Naselje\":\"BEOGRAD\",\"IdUlica\":0,\"Ulica\":\"GENERALA ŽDANOVA\",\"Broj\":-2,\"Podbroj\":null,\"Sprat\":null,\"Stan\":null,\"Pak\":\"F11070\",\"Reon\":\"\",\"Posta\":\"11070 BEOGRAD 27\",\"BrojFaha\":\"15\",\"Opstina\":\"BEOGRAD\",\"Napomena\":null,\"Vrsta\":\"F\",\"Nadredjena\":null,\"AdresaTXT\":null,\"IsporukaPosta\":null},\"Poruke\":\"\"}",
"StrRezultat": "{\"Poruka\":null,\"PorukaKorisnik\":null,\"Info\":null}"
}

Primer 3 - Provera dostupnosti usluge Danas za sutra 19 (vrsta adrese P - post restant)

JSON string za serijalizovani objekat klase ProveraDostupnostiIn
           
{
"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": 9,
"TipSerijalizacije": 2,
"IdTransakcija": "e64b381e-7b32-4629-b227-bfaa88b8660e",
"StrIn": "{\"TipAdrese\":\"2\",\"IdRukovanje\":\"58\",\"Adresa\":{\"IdNaselje\":\"0\",\"IdUlica\":\"0\",\"Posta\":\"11101\",\"Vrsta\":\"P\"},\"Datum\":\"\"}"
}
JSON string za serijalizovani objekat klase ProveraDostupnostiOut
           
{
"Rezultat": 0,
"StrOut": "{\"Adresa\":{\"IdNaselje\":0,\"Naselje\":\"BEOGRAD\",\"IdUlica\":0,\"Ulica\":\"TAKOVSKA\",\"Broj\":-2,\"Podbroj\":null,\"Sprat\":null,\"Stan\":null,\"Pak\":\"P11101\",\"Reon\":\"\",\"Posta\":\"11101 BEOGRAD 1\",\"BrojFaha\":null,\"Opstina\":\"BEOGRAD\",\"Napomena\":null,\"Vrsta\":\"P\",\"Nadredjena\":null,\"AdresaTXT\":null,\"IsporukaPosta\":null},\"Poruke\":\"\"}",
"StrRezultat": "{\"Poruka\":null,\"PorukaKorisnik\":null,\"Info\":null}"
}