API carinskih šifarnika

Baza podataka carinskih šifarnika sadrži podatke o svim šifarnicima i šiframa koje se koriste u Upravi Carina.

API nudi mogućnost pristupa svim ili pojedinačnim šifarnicima, na tekući dan ili bilo koji drugi datum. API podržava dva osnovna formata za razmenu podataka, JSON (Java Script Object Notation) i XML (Extensable Markup Language). Carinski šifarnici su projektovani kao klasični RESTfull API.

Pozivima u API-ju je moguće pristupiti pomoću posebne autentifikacije koja se na zahtev dobija od PKS-a, bilo kojim programskim jezikom ili alatom koji podržava HTTP pozive.

Šifarnici

Šifarnici su obeleženi oznakama od T1 do T29. Opisi šifarnika dati su u tabeli ispod.

Oznaka šifarnika Opis šifarnika

T1

CARINARNICE I NJIHOVE ORGANIZACIONE JEDINICE

T2

DRŽAVE

T3

VRSTA VALUTE

T4

LICA

T5

VRSTE PREVOZNOG, ODNOSNO PRENOSNOG SREDSTVA

T6

PARITET ISPORUKE

T7

MESTO PARITETA ISPORUKE

T8

VRSTA SPOLJNOTRGOVINSKOG POSLA

T9

ROBA POD CARINSKIM NADZOROM

T10

JEDINICE MERE

T11

OBLICI IZVOZA I UVOZA

T12

NAMENA UVOZA

T13

ZAKONSKI OSNOV ZA OSLOBOĐENJE OD PLAĆANJA AKCIZE

T14

ZAKONSKI OSNOV ZA PORESKA OSLOBOĐENJA I OSNOV NAPLATE POREZA NA DODATU VREDNOST

T15

ZAKONSKI OSNOV ZA OSLOBOĐENJE OD PLAĆANJA UVOZNIH DAŽBINA, NEPLAĆANJE CARINE, ODNOSNO POVEĆANJE ILI SNIŽENJE STOPE CARINE PO CARINSKOM I DRUGIM ZAKONIMA

T16

VRSTE POSTUPKA

T17

VRSTE NACIONALNOG POSTUPKA

T18

VRSTE PRETHODNIH ISPRAVA

T19

METOD VREDNOVANJA

T20

VRSTE DAŽBINA

T21

NAČIN PLAĆANJA/OBEZBEĐENJA CARINSKOG DUGA

T22

VRSTE GARANCIJA

T23

VRSTE OBEZBEĐENJA ZA ROBU U TRANZITU

T24

PRILOŽENE ISPRAVE I DODATNE INFORMACIJE

T26

VRSTE ISPRAVA NA OSNOVU KOJIH NASTAJE SAŽETA DEKLARACIJA                                           

T27

VRSTE TOVARNIH LISTOVA                                                                              

T28

TIP DEKLARACIJE (3. PODELA RUB.1 JCI U ISCS-U)                                                     

T29

VRSTA EVIDENCIJE (4. PODELA RUB.1 JCI U ISCS-U)                                                     

JSON API

Lista API poziva u JSON formatu data je u tabeli ispod. Za više detalja kliknite na željeni poziv

Poziv

Opis

test/?any={any}

Testni poziv

json/classifications

Lista svih klasifikacija

json/all

Lista svih šifarnika za tekući datum

json/all/?date={date}

Lista svih šifarnika za određeni datum

json/list/?code={code}

Šifarnik za tekući datum

json/listondate/?code={code}&date={date}

Šifarnik za određeni datum

GET test/?any={any}

Parametri

Naziv

Opis

Tip

Napomena

any Bilo koja vrednost String
Primer poziva
test/?any=65
Primer odgovora
{"Description":"TEST OK","ID":1,"Result":"65 received"}

GET json/classifications

Parametri

-

Primer odgovora

    [
        {
            "Opis": "CARINARNICE I NJIHOVE ORGANIZACIONE JEDINICE",
            "Sifra": "T1"
        },
        {
            "Opis": "DRŽAVE",
            "Sifra": "T2"
        },
        {
            "Opis": "VRSTA VALUTE",
            "Sifra": "T3"
        },
        {
            "Opis": "LICA",
            "Sifra": "T4"
        },
        {
            "Opis": "VRSTE PREVOZNOG, ODNOSNO PRENOSNOG SREDSTVA",
            "Sifra": "T5"
        }...
    ]
                

GET json/all

Parametri

-

Primer odgovora

    [
        {
            "List": [
                {
                    "NazivSifre": "CARINARNICA BEOGRAD",
                    "Sifra": "11002"
                },
                {
                    "NazivSifre": "CARINSKA ISPOSTAVA LUKA BEOGRAD",
                    "Sifra": "11029"
                },
                {
                    "NazivSifre": "CARINSKA ISPOSTAVA PANČEVO",
                    "Sifra": "11037"
                },
                {
                    "NazivSifre": "CARINSKA ISPOSTAVA POŠTA BEOGRAD",
                    "Sifra": "11045"
                }...
        }
    ]
                

GET json/all/?date={date}

Parametri

Naziv

Opis

Tip

Napomena

date DateTime vrednost u formatu godina-mesec-dan String
Primer poziva
json/all/?date=2015-06-17
Primer odgovora

    [
        {
            "List": [
                {
                    "NazivSifre": "CARINARNICA BEOGRAD",
                    "Sifra": "11002"
                },
                {
                    "NazivSifre": "CARINSKA ISPOSTAVA LUKA BEOGRAD",
                    "Sifra": "11029"
                },
                {
                    "NazivSifre": "CARINSKA ISPOSTAVA PANČEVO",
                    "Sifra": "11037"
                },
                {
                    "NazivSifre": "CARINSKA ISPOSTAVA POŠTA BEOGRAD",
                    "Sifra": "11045"
                }...
        }
    ]
                

GET json/list/?code={code}

Parametri

Naziv

Opis

Tip

Napomena

code Oznaka šifarnika (pogledati ovde) String
Primer poziva
json/list/?code=T12
Primer odgovora
{"List":[],"Opis":"NAMENA UVOZA","Sifra":"T12"}

GET json/listondate/?code={code}&date={date}

Parametri

Naziv

Opis

Tip

Napomena

code Oznaka šifarnika (pogledati ovde) String
date DateTime vrednost u formatu godina-mesec-dan String
Primer poziva
json/list/?code=T12&date=2015-06-17
Primer odgovora
{"List":[],"Opis":"NAMENA UVOZA","Sifra":"T12"}

XML API

Lista API poziva u XML formatu data je u tabeli ispod. Za više detalja kliknite na željeni poziv

Poziv

Opis

test/?any={any}

Testni poziv

xml/classifications

Lista svih klasifikacija

xml/all

Lista svih šifarnika za tekući datum

xml/all/?date={date}

Lista svih šifarnika za određeni datum

GET test/?any={any}

Parametri

Naziv

Opis

Tip

Napomena

any Bilo koja vrednost String
Primer poziva
test/?any=65
Primer odgovora
{"Description":"TEST OK","ID":1,"Result":"65 received"}

GET xml/classifications

Parametri

-

Primer odgovora

    <ArrayOfClassification xmlns="http://schemas.datacontract.org/2004/07/Classifications" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Classification>
            <Opis>CARINARNICE I NJIHOVE ORGANIZACIONE JEDINICE</Opis>
            <Sifra>T1</Sifra>
        </Classification>
        <Classification>
            <Opis>DRŽAVE</Opis>
            <Sifra>T2</Sifra>
        </Classification>
        <Classification>
            <Opis>VRSTA VALUTE</Opis>
            <Sifra>T3</Sifra>
        </Classification>...
                

GET xml/all

Parametri

-

Primer odgovora

    <NewDataSet>
        <T1>
            <Sifra>11002</Sifra>
            <NazivSifre>CARINARNICA BEOGRAD</NazivSifre>
        </T1>
        <T1>
            <Sifra>11029</Sifra>
            <NazivSifre>CARINSKA ISPOSTAVA LUKA BEOGRAD</NazivSifre>
        </T1>
        <T1>
            <Sifra>11037</Sifra>
            <NazivSifre>CARINSKA ISPOSTAVA PANČEVO</NazivSifre>
        </T1>
        <T1>
            <Sifra>11045</Sifra>
            <NazivSifre>CARINSKA ISPOSTAVA POŠTA BEOGRAD</NazivSifre>
        </T1>...
    </NewDataSet>
                

GET xml/all/?date={date}

Parametri

Naziv

Opis

Tip

Napomena

date DateTime vrednost u formatu godina-mesec-dan String
Primer poziva
xml/all/?date=2015-06-17
Primer odgovora

    <NewDataSet>
        <T1>
            <Sifra>11002</Sifra>
            <NazivSifre>CARINARNICA BEOGRAD</NazivSifre>
        </T1>
        <T1>
            <Sifra>11029</Sifra>
            <NazivSifre>CARINSKA ISPOSTAVA LUKA BEOGRAD</NazivSifre>
        </T1>
        <T1>
            <Sifra>11037</Sifra>
            <NazivSifre>CARINSKA ISPOSTAVA PANČEVO</NazivSifre>
        </T1>
        <T1>
            <Sifra>11045</Sifra>
            <NazivSifre>CARINSKA ISPOSTAVA POŠTA BEOGRAD</NazivSifre>
        </T1>...
    </NewDataSet>