Customs Tariff API

API carinske tarife

Baza podataka carinske tarife sadrži podatke o tarifama za sve vrste robe i prateća dokumenta koja pojašnjavaju tarifiranje određenih proizvoda.

API nudi mogućnost pristupa i pretrage tarifa, prema različitim kriterijumima. API podržava dva osnovna formata za razmenu podataka, JSON (Java Script Object Notation) i XML (Extensable Markup Language). Web servis je projektovan kao klasični RESTfull API.

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

Token koji je dodeljen korisniku mora biti prosleđen uz svaki poziv servisu u zaglavlju (header) u formatu "Authorization: Basic [vrednost tokena]".

JSON API

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

Poziv	Opis
api/customs-tariff/chapters	Lista svih odeljaka i glava u carinskoj tarifi
api/customs-tariff	Svi detalji pojedinačne tarife prema broju
api/customs-tariff/code	Pretraga tarifa prema tarifnom broju
api/customs-tariff/description	Pretraga tarifa prema željenom pojmu

GET api/customs-tariff/chapters

Parametri

-

Primer odgovora


{
  "Status": {
    "ID": 1,
    "Description": "",
    "Result": ""
  },
  "Value": {
    "All": [
      {
        "ID": 1,
        "Roman": "I",
        "Description": "ŽIVE ŽIVOTINJE; PROIZVODI ŽIVOTINJSKOG POREKLA",
        "Sections": [
          {
            "ID": "01",
            "Description": "Žive životinje"
          },
          {
            "ID": "02",
            "Description": "Meso i ostali klanicni proizvodi za jelo"
          }...

POST api/customs-tariff

Parametri

Naziv	Opis	Tip	Napomena
Value	Tarifni broj za koji se traže detalji	string
Key	Vrednost polja "Key" u slučaju da je traženi broj prethodno bio pronađen kroz listu tarifa	integer	Nije obavezan parametar
Date	Datum za koji se traže detalji tarife	string	U formatu "YYYY-MM-DD"

Primer objekta poziva


{
    "Value" : "040630100080",
    "Date": "2016-05-20"
}

Primer odgovora


    {
  "Status": {
    "ID": 1,
    "Description": "",
    "Result": ""
  },
  "Value": {
    "Origins": [
      {
        "Code": "1",
        "ParentCode": null,
        "Description": "ŽIVE ŽIVOTINJE; PROIZVODI ŽIVOTINJSKOG POREKLA",
        "Level": 1,
        "Main": false,
        "Key": null,
        "Children": 0
      },
      {
        "Code": "04",
        "ParentCode": null,
        "Description": "Mleko i proizvodi od mleka; živinska i pticija jaja; prirodni med; jestivi proizvodi životinjskog porekla, nepomenuti niti obuhvaceni na drugom mestu",
        "Level": 2,
        "Main": false,
        "Key": null,
        "Children": 0
      },
      {
        "Code": "0406",
        "ParentCode": null,
        "Description": "SIR I URDA:",
        "Level": 3,
        "Main": false,
        "Key": null,
        "Children": 0
      },
      {
        "Code": "040630",
        "ParentCode": null,
        "Description": "- SIR TOPLJEN, OSIM RENDANOG ILI U PRAHU:",
        "Level": 4,
        "Main": false,
        "Key": 80,
        "Children": 0
      },
      {
        "Code": "04063010",
        "ParentCode": null,
        "Description": "-- ZA CIJU PROIZVODNJU SE UPOTREBLJAVAJU SAMO SIREVI EMMENTALER, GRUIYERE I APP-ENZELL I KOJI MOŽE, KAO DODATAK, SADR-ŽATI GLARUS SIR SA ZACINSKIM BILJEM(PO-ZNAT KAO SCHABZIGER); PRIPREMLJEN ZA PRODAJU NA MALO, SA SADRŽAJEM MASNOCE U SUVOJ MATERIJI DO 56% PO MASI",
        "Level": 5,
        "Main": false,
        "Key": 80,
        "Children": 0
      },
      {
        "Code": "0406301000",
        "ParentCode": null,
        "Description": "-- ZA CIJU PROIZVODNJU SE UPOTREBLJAVAJU SAMO SIREVI EMMENTALER, GRUIYERE I APP-ENZELL I KOJI MOŽE, KAO DODATAK, SADR-ŽATI GLARUS SIR SA ZACINSKIM BILJEM(PO-ZNAT KAO SCHABZIGER); PRIPREMLJEN ZA PRODAJU NA MALO, SA SADRŽAJEM MASNOCE U SUVOJ MATERIJI DO 56% PO MASI",
        "Level": 6,
        "Main": false,
        "Key": 80,
        "Children": 0
      }
    ],
    "Code": "040630100080",
    "Description": "- Ostalo",
    "UOM": "  ",
    "IsEx": true,
    "ExNumber": "80",
    "Taxes": {
      "All": [
        {
          "Code": "1",
          "ShortDescription": "CARINA",
          "Description": "CARINA",
          "Rate": 30,
          "Indicator": null,
          "Type": 1,
          "Amount": 0,
          "UOM": null,
          "Calculation": null
        },
        {
          "Code": "5 ",
          "ShortDescription": null,
          "Description": "POSEBNA DAŽBINA NA UVOZ PP PROIZVODA",
          "Rate": 0,
          "Indicator": null,
          "Type": 5,
          "Amount": 80,
          "UOM": "KG",
          "Calculation": null
        },
        {
          "Code": "9 ",
          "ShortDescription": null,
          "Description": "POREZ NA DODATU VREDNOST",
          "Rate": 20,
          "Indicator": "U",
          "Type": 9,
          "Amount": 0,
          "UOM": null,
          "Calculation": null
        }
      ]
    },
    "Approvals": {
      "All": [
        {
          "Code": "U64 ",
          "Description": "Uverenje,saglasnost ili dozvola veterinarsko-sanitarne inspekcije",
          "Indicator": "N"
        }
      ]
    },
    "Regimes": {
      "All": [
        {
          "Code": "LB ",
          "ImportExport": "I",
          "Description": "Slobodan izvoz-uvoz",
          "Indicator": " "
        },
        {
          "Code": "LB ",
          "ImportExport": "U",
          "Description": "Slobodan izvoz-uvoz",
          "Indicator": " "
        }
      ]
    },
    "Preferentials": {
      "All": []
    },
    "Agreements": {
      "All": []
    }
  }
}

POST api/customs-tariff/code

Parametri

Naziv	Opis	Tip	Napomena
Value	Tarifni broj za koji se traže tarifni brojevi u hijerarhiji	string
Key	Vrednost polja "Key" u slučaju da je traženi broj prethodno bio pronađen kroz listu tarifa	integer	Nije obavezan parametar
Date	Datum za koji se traže tarifni brojevi	string	U formatu "YYYY-MM-DD"

Primer objekta poziva


{
    "Value" : "0406",
    "Date": "2016-05-20",
    "Key": 80
}

Primer odgovora


{
  "Status": {
    "ID": 1,
    "Description": "",
    "Result": ""
  },
  "Value": {
    "All": [
      {
        "Code": "0406",
        "ParentCode": "04",
        "Description": "SIR I URDA:",
        "Level": 3,
        "Main": true,
        "Key": null,
        "Children": 0
      },
      {
        "Code": "0406000000",
        "ParentCode": "04060000",
        "Description": "SIR I URDA:",
        "Level": 6,
        "Main": false,
        "Key": 80,
        "Children": 0
      }...

POST api/customs-tariff/description

Parametri

Naziv	Opis	Tip	Napomena
Value	Pojam za koji se traže tarifni brojevi	string
Date	Datum za koji se traže tarife	string	U formatu "YYYY-MM-DD"

Primer objekta poziva


{
    "Value" : "SIR OD SURUTKE",
    "Date": "2016-05-20"
}

Primer odgovora


{
  "Status": {
    "ID": 1,
    "Description": "",
    "Result": ""
  },
  "Value": {
    "All": [
      {
        "Code": "0406100000",
        "ParentCode": "04061000",
        "Description": "- SVEŽ (NEZREO) SIR, UKLJUCUJUCI SIR OD SURUTKE I URDA:",
        "Level": 6,
        "Main": false,
        "Key": 80,
        "Children": 0
      }
    ]
  }
}

XML API

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

NAPOMENA: Ukoliko je potrebno da API vraća podatke u XML formatu, potrebno je da u zaglavlju (header) zahteva (request) bude unešen header Accept sa vrednošću application/xml

Poziv	Opis
api/customs-tariff/chapters	Lista svih odeljaka i glava u carinskoj tarifi
api/customs-tariff	Svi detalji pojedinačne tarife prema broju
api/customs-tariff/code	Pretraga tarifa prema tarifnom broju
api/customs-tariff/description	Pretraga tarifa prema željenom pojmu

GET api/customs-tariff/chapters

Parametri

-

Primer odgovora


<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Status>
        <ID>1</ID>
        <Description />
    </Status>
    <Value xsi:type="Chapters">
        <All>
            <Chapter>
                <ID>1</ID>
                <Roman>I</Roman>
                <Description>ŽIVE ŽIVOTINJE; PROIZVODI ŽIVOTINJSKOG POREKLA</Description>
                <Sections>
                    <Section>
                        <ID>01</ID>
                        <Description>Žive životinje</Description>
                    </Section>
                    <Section>
                        <ID>02</ID>
                        <Description>Meso i ostali klanicni proizvodi za jelo</Description>
                    </Section>
                    <Section>
                        <ID>03</ID>
                        <Description>Ribe, ljuskari, mekušci, i ostali vodeni beskicmenjaci</Description>
                    </Section>
                    <Section>
                        <ID>04</ID>
                        <Description>Mleko i proizvodi od mleka; živinska i pticija jaja; prirodni med; jestivi proizvodi životinjskog porekla, nepomenuti niti obuhvaceni na drugom mestu</Description>
                    </Section>
                    <Section>
                        <ID>05</ID>
                        <Description>Proizvodi životinjskog porekla, na drugom mestu nepomenuti niti obuhvaceni</Description>
                    </Section>
                </Sections>
            </Chapter>...

POST api/customs-tariff

Parametri

Naziv	Opis	Tip	Napomena
Value	Tarifni broj za koji se traže detalji	string
Key	Vrednost polja "Key" u slučaju da je traženi broj prethodno bio pronađen kroz listu tarifa	integer	Nije obavezan parametar
Date	Datum za koji se traže detalji tarife	string	U formatu "YYYY-MM-DD"

Primer objekta poziva


<SearchFilter xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Value>040630100080</Value>
  <Date>2016-05-20</Date>
</SearchFilter>

Primer odgovora


<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Status>
        <ID>1</ID>
        <Description />
    </Status>
    <Value xsi:type="CustomsTariff">
        <Origins>
            <CustomsTariffResultItem>
                <Code>1</Code>
                <Description>ŽIVE ŽIVOTINJE; PROIZVODI ŽIVOTINJSKOG POREKLA</Description>
                <Level>1</Level>
                <Main>false</Main>
                <Key xsi:nil="true" />
                <Children>0</Children>
            </CustomsTariffResultItem>
            <CustomsTariffResultItem>
                <Code>04</Code>
                <Description>Mleko i proizvodi od mleka; živinska i pticija jaja; prirodni med; jestivi proizvodi životinjskog porekla, nepomenuti niti obuhvaceni na drugom mestu</Description>
                <Level>2</Level>
                <Main>false</Main>
                <Key xsi:nil="true" />
                <Children>0</Children>
            </CustomsTariffResultItem>
            <CustomsTariffResultItem>
                <Code>0406</Code>
                <Description>SIR I URDA:</Description>
                <Level>3</Level>
                <Main>false</Main>
                <Key xsi:nil="true" />
                <Children>0</Children>
            </CustomsTariffResultItem>
            <CustomsTariffResultItem>
                <Code>040630</Code>
                <Description>- SIR TOPLJEN, OSIM RENDANOG ILI U PRAHU:</Description>
                <Level>4</Level>
                <Main>false</Main>
                <Key>80</Key>
                <Children>0</Children>
            </CustomsTariffResultItem>
            <CustomsTariffResultItem>
                <Code>04063010</Code>
                <Description>-- ZA CIJU PROIZVODNJU SE UPOTREBLJAVAJU SAMO SIREVI EMMENTALER, GRUIYERE I APP-ENZELL I KOJI MOŽE, KAO DODATAK, SADR-ŽATI GLARUS SIR SA ZACINSKIM BILJEM(PO-ZNAT KAO SCHABZIGER); PRIPREMLJEN ZA PRODAJU NA MALO, SA SADRŽAJEM MASNOCE U SUVOJ MATERIJI DO 56% PO MASI</Description>
                <Level>5</Level>
                <Main>false</Main>
                <Key>80</Key>
                <Children>0</Children>
            </CustomsTariffResultItem>
            <CustomsTariffResultItem>
                <Code>0406301000</Code>
                <Description>-- ZA CIJU PROIZVODNJU SE UPOTREBLJAVAJU SAMO SIREVI EMMENTALER, GRUIYERE I APP-ENZELL I KOJI MOŽE, KAO DODATAK, SADR-ŽATI GLARUS SIR SA ZACINSKIM BILJEM(PO-ZNAT KAO SCHABZIGER); PRIPREMLJEN ZA PRODAJU NA MALO, SA SADRŽAJEM MASNOCE U SUVOJ MATERIJI DO 56% PO MASI</Description>
                <Level>6</Level>
                <Main>false</Main>
                <Key>80</Key>
                <Children>0</Children>
            </CustomsTariffResultItem>
        </Origins>
        <Code>040630100080</Code>
        <Description>- Ostalo</Description>
        <UOM>  </UOM>
        <IsEx>true</IsEx>
        <ExNumber>80</ExNumber>
        <Taxes>
            <All>
                <Tax>
                    <Code>1</Code>
                    <ShortDescription>CARINA</ShortDescription>
                    <Description>CARINA</Description>
                    <Rate>30</Rate>
                    <Type>Duty</Type>
                    <Amount>0</Amount>
                </Tax>
                <Tax>
                    <Code>5 </Code>
                    <Description>POSEBNA DAŽBINA NA UVOZ PP PROIZVODA</Description>
                    <Rate>0.00</Rate>
                    <Type>Agrar</Type>
                    <Amount>80.00</Amount>
                    <UOM>KG</UOM>
                </Tax>
                <Tax>
                    <Code>9 </Code>
                    <Description>POREZ NA DODATU VREDNOST</Description>
                    <Rate>20.00</Rate>
                    <Indicator>U</Indicator>
                    <Type>VAT</Type>
                    <Amount>0</Amount>
                </Tax>
            </All>
        </Taxes>
        <Approvals>
            <All>
                <CustomsApproval>
                    <Code>U64 </Code>
                    <Description>Uverenje,saglasnost ili dozvola veterinarsko-sanitarne inspekcije</Description>
                    <Indicator>N</Indicator>
                </CustomsApproval>
            </All>
        </Approvals>
        <Regimes>
            <All>
                <CustomsRegime>
                    <Code>LB </Code>
                    <ImportExport>I</ImportExport>
                    <Description>Slobodan izvoz-uvoz</Description>
                    <Indicator> </Indicator>
                </CustomsRegime>
                <CustomsRegime>
                    <Code>LB </Code>
                    <ImportExport>U</ImportExport>
                    <Description>Slobodan izvoz-uvoz</Description>
                    <Indicator> </Indicator>
                </CustomsRegime>
            </All>
        </Regimes>
        <Preferentials>
            <All />
        </Preferentials>
        <Agreements>
            <All />
        </Agreements>
    </Value>
</Response>

POST api/customs-tariff/code

Parametri

Naziv	Opis	Tip	Napomena
Value	Tarifni broj za koji se traže tarifni brojevi u hijerarhiji	string
Key	Vrednost polja "Key" u slučaju da je traženi broj prethodno bio pronađen kroz listu tarifa	integer	Nije obavezan parametar
Date	Datum za koji se traže tarifni brojevi	string	U formatu "YYYY-MM-DD"

Primer objekta poziva


<SearchFilter xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Value>0406</Value>
  <Key>80</Key>
  <Date>2016-05-20</Date>
</SearchFilter>

Primer odgovora


<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Status>
        <ID>1</ID>
        <Description />
    </Status>
    <Value xsi:type="CustomsTariffResultItems">
        <All>
            <CustomsTariffResultItem>
                <Code>0406</Code>
                <ParentCode>04</ParentCode>
                <Description>SIR I URDA:</Description>
                <Level>3</Level>
                <Main>true</Main>
                <Key xsi:nil="true" />
                <Children>0</Children>
            </CustomsTariffResultItem>
            <CustomsTariffResultItem>
                <Code>0406000000</Code>
                <ParentCode>04060000</ParentCode>
                <Description>SIR I URDA:</Description>
                <Level>6</Level>
                <Main>false</Main>
                <Key>80</Key>
                <Children>0</Children>
            </CustomsTariffResultItem>...

POST api/customs-tariff/description

Parametri

Naziv	Opis	Tip	Napomena
Value	Pojam za koji se traže tarifni brojevi	string
Date	Datum za koji se traže tarife	string	U formatu "YYYY-MM-DD"

Primer objekta poziva


<SearchFilter xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Value>SIR OD SURUTKE</Value>
  <Date>2016-05-20</Date>
</SearchFilter>

Primer odgovora


<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Status>
        <ID>1</ID>
        <Description />
    </Status>
    <Value xsi:type="CustomsTariffResultItems">
        <All>
            <CustomsTariffResultItem>
                <Code>0406100000</Code>
                <ParentCode>04061000</ParentCode>
                <Description>- SVEŽ (NEZREO) SIR, UKLJUCUJUCI SIR OD SURUTKE I URDA:</Description>
                <Level>6</Level>
                <Main>false</Main>
                <Key>80</Key>
                <Children>0</Children>
            </CustomsTariffResultItem>
        </All>
    </Value>
</Response>