[This is preliminary documentation and is subject to change.]

Razmjena XML datoteka je drugi način rada sa Tring.Fiscal. Potrebno je definirati osnovnu putanju unutar sistema na u kojoj se nalaze komandne datoteke u XML formatu.

Primjer: C:\Tring\XML (ovo će biti default-na putanja)

Postoje tri vrste komandi:

  1. XML komanda za unos i izmjenu podataka o artiklima (C:\Tring\XML\artikli.xml)
  2. XML komanda za unos i izmjenu podataka o kupcima (C:\Tring\XML\kupci.xml)
  3. XML komanda za izdavanje fiskalnih računa (C:\Tring\XML\r1019.xml), gdje je "r" oznaka za račun, a "1019" slučajno generisan broj ili broj računa iz softverske aplikacije partnera.

Tring.Fiscal.Server vraća odgovor u vidu XML datoteke pod istim nazivom kao što je i zadana, samo u direktoriju "C:\Tring\XML\Odgovori\"

Tako na komandu (C:\Tring\XML\r1019.xml), Tring.Fiscal.Server vraća odgovor u daoteci: (C:\Tring\XML\Odgovori\r1019.xml)

NoteNote

XML datoteke "artikli.xml" i "kupci.xml" se ne moraju koristiti. Tring.Fiscal.Server će korištenjem XML komande za izdavanje računa, provjeriti da li artikal ili kupac već postoje u fiskalnom uređaju, a ako ne automatski će ga dodati.

Primjeri

NoteNote

Kod označen zelenom bojom je komentar i nije potreban u XML datotekama !

CopyŠtampanje kompletnog računa sa kupcem
<?xml version="1.0" encoding="utf-8" ?>
<RacunZahtjev xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <BrojZahtjeva>222</BrojZahtjeva> <!-- Unikatan broj zahtjeva (slučajno generisan broj ili broj računa) -->
    <VrstaZahtjeva>0</VrstaZahtjeva> <!-- 0-štampanje svih stavki računa i zatvaranje računa; 1- štampanje stavka po stavka bez zatvaranja računa /-->
    <racun> <!-- Početak računa -->
        <Datum>2010-08-10T00:00:00+02:00</Datum> <!-- Datum računa -->
        <Kupac> <!-- Ako ne postoji kupac, onda treba staviti <Kupac />  -->
            <IDbroj>1234567890123</IDbroj> <!-- Jedinstveni identifikacioni broj kupca-->
            <Naziv>TEST d.o.o.</Naziv>   <!-- Naziv kupca. Svi podaci o kupcu 4-reda x 18-znakova = 64-znaka -->
            <Adresa>Maka Dizdara 3</Adresa>  <!-- Adresa kupca --> 
            <PostanskiBroj>75320</PostanskiBroj>  <!-- Poštanski broj -->
            <Grad>Gračanica</Grad>  <!-- Grad -->
        </Kupac>
        <StavkeRacuna>  <!-- Početak niza stavki računa-->
            <RacunStavka>  <!-- Prva stavka računa-->
                <artikal>  <!-- Artikal-->
                    <Sifra>1</Sifra>  <!-- Šifra artikla ili barkod. Šifra (0-15999) za Favourite, (0-63999) za Partner. Barkod max. 13 brojeva. -->
                    <Naziv>Test artikal</Naziv> <!-- Naziv + JM = max. 36 znakova. -->
                    <JM>kom</JM> 
                    <Cijena>5.34</Cijena> <!-- Max. 9.999.999,99 ili 999.999,999. -->
                    <Stopa>E</Stopa>  <!-- Stopa PDV E=17%, A=0%, K=0% -->
                </artikal>
                <Kolicina>2</Kolicina>  <!-- Max. 999.999,999 -->
                <Rabat>0</Rabat>  <!-- Max. dva decimalna mjesta -->
            </RacunStavka>  <!-- Kraj prve stavke računa -->
            <RacunStavka> <!-- Početak druge stavke računa-->
                <artikal>  
                    <Sifra>2</Sifra> 
                    <Naziv>Test artikal 2</Naziv> 
                    <JM>kom</JM> 
                    <Cijena>15.42</Cijena> 
                    <Stopa>E</Stopa> 
                </artikal>
                <Kolicina>10.444</Kolicina> 
                <Rabat>10</Rabat> 
            </RacunStavka>
        </StavkeRacuna>
        <VrstePlacanja> <!-- Početak vrste plaćanja. Ako se radi o štampanju računa stavka po stavka (VrstaZahtjeva=1), onda treba izostaviti ovaj element tj. treba staviti <VrstePlacanja /> -->
            <VrstaPlacanja> <!-- Početak vrste plaćanja -->
                <Oznaka>Gotovina</Oznaka> <!-- Oznake plaćanja: Gotovina, Cek, Kartica, Virman -->
                <Iznos>0</Iznos> <!-- Iznos računa plaćen ovom vrstom plaćanja. Ako je 0, onda cijeli račun je plaćen tom vrstom plaćanja. --> 
            </VrstaPlacanja>
        </VrstePlacanja>
        <Napomena>Text napomene</Napomena> <!-- Napomena na kraju računa, 3-reda x 18-znakova = 54znaka-->
    </racun>
</RacunZahtjev>
CopyŠtampanje računa stavka po stavka - prva stavka (datoteka)
<?xml version="1.0" encoding="utf-8" ?>
<RacunZahtjev xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <BrojZahtjeva>223</BrojZahtjeva> <!-- Unikatan broj zahtjeva (slučajno generisan broj ili broj računa) -->
    <VrstaZahtjeva>1</VrstaZahtjeva> <!-- 0-štampanje svih stavki računa i zatvaranje računa; 1- štampanje stavka po stavka bez zatvaranja računa /-->
    <racun> <!-- Početak računa -->
        <Datum>2010-08-10T00:00:00+02:00</Datum> <!-- Datum računa -->
        <Kupac /> <!-- Ako ne postoji kupac, onda treba staviti <Kupac />  -->
        <StavkeRacuna>  <!-- Početak niza stavki računa-->
            <RacunStavka>  <!-- Prva stavka računa-->
                <artikal>  <!-- Artikal-->
                    <Sifra>1</Sifra>  <!-- Šifra artikla ili barkod. Šifra (0-15999) za Favourite, (0-63999) za Partner. Barkod max. 13 brojeva. -->
                    <Naziv>Test artikal</Naziv> <!-- Naziv + JM = max. 36 znakova. -->
                    <JM>kom</JM> 
                    <Cijena>5.34</Cijena>   <!-- Max. 9.999.999,99 ili 999.999,999. -->
                    <Stopa>E</Stopa>  <!-- Stopa PDV E=17%, A=0%, K=0% -->
                </artikal>
                <Kolicina>2</Kolicina>   <!-- Max. 999.999,999 -->
                <Rabat>0</Rabat>  <!-- Max. dva decimalna mjesta -->
            </RacunStavka>  <!-- Kraj prve stavke računa -->
        </StavkeRacuna>
        <VrstePlacanja /> <!-- Početak vrste plaćanja. Ako se radi o štampanju računa stavka po stavka (VrstaZahtjeva=1), onda treba treba staviti <VrstePlacanja />, sve do zadnje stavke (datoteke) -->
    </racun>
</RacunZahtjev>
CopyŠtampanje računa stavka po stavka - zadnja stavka (datoteka)
<?xml version="1.0" encoding="utf-8" ?>
<RacunZahtjev xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <BrojZahtjeva>223</BrojZahtjeva> <!-- Unikatan broj zahtjeva (slučajno generisan broj ili broj računa) -->
    <VrstaZahtjeva>1</VrstaZahtjeva> <!-- 0-štampanje svih stavki računa i zatvaranje računa; 1- štampanje stavka po stavka bez zatvaranja računa /-->
    <racun> <!-- Početak računa -->
        <Datum>2010-08-10T00:00:00+02:00</Datum> <!-- Datum računa -->
        <Kupac /> <!-- Ako ne postoji kupac, onda treba staviti <Kupac />  -->
        <StavkeRacuna>  <!-- Početak niza stavki računa-->
            <RacunStavka> <!-- Početak zadnje stavke računa-->
                <artikal>  
                    <Sifra>2</Sifra> <!-- Šifra artikla ili barkod. Šifra (0-15999) za Favourite, (0-63999) za Partner. Barkod max. 13 brojeva. -->
                    <Naziv>Test artikal 2</Naziv> <!-- Naziv + JM = max. 36 znakova. -->
                    <JM>kom</JM> 
                    <Cijena>15.42</Cijena>   <!-- Max. 9.999.999,99 ili 999.999,999. -->
                    <Stopa>E</Stopa> 
                </artikal>
                <Kolicina>10.444</Kolicina>   <!-- Max. 999.999,999 -->
                <Rabat>10</Rabat> 
            </RacunStavka>
        </StavkeRacuna>
        <VrstePlacanja> <!-- Početak vrste plaćanja. Ako se radi o štampanju računa stavka po stavka (VrstaZahtjeva=1), onda treba treba staviti <VrstePlacanja />, sve do zadnje stavke (datoteke) -->
            <VrstaPlacanja> <!-- Početak vrste plaćanja -->
                <Oznaka>Gotovina</Oznaka> <!-- Oznake plaćanja: Gotovina, Cek, Kartica, Virman -->
                <Iznos>0</Iznos> <!-- Iznos računa plaćen ovom vrstom plaćanja. Ako je 0, onda cijeli račun je plaćen tom vrstom plaćanja. --> 
            </VrstaPlacanja>
        </VrstePlacanja>
        <Napomena>Text napomene</Napomena> <!-- Napomena na kraju računa, 3-reda x 18-znakova = 54znaka-->
    </racun>
</RacunZahtjev>
CopyOdgovor u slučaju ispravnosti štampanja fiskalnog računa
<?xml version="1.0" encoding="utf-8" ?> 
<KasaOdgovor xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Odgovori>  <!-- Početak niza odgovora -->
        <Odgovor> <!-- Prvi odgovor -->
            <Naziv>BrojFiskalnogRacuna</Naziv>  <!-- Naziv parametra. -->
            <Vrijednost xsi:type="xsd:int">950</Vrijednost> <!-- Vrijednost parametra. U ovom slučaju "broj fiskalnog računa" iz fiskalnog uređaja -->
        </Odgovor>
    </Odgovori> <!-- Završetak niza odgovora -->
    <VrstaOdgovora>OK</VrstaOdgovora>  <!-- Tip odgovora: OK, Greska, Upozorenje -->
    <BrojZahtjeva>222</BrojZahtjeva> <!-- Broj zahtjeva na koji se daje odgovor -->
</KasaOdgovor>
CopyOdgovor u slučaju greške
<?xml version="1.0" encoding="utf-8" ?> 
<KasaOdgovor xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <Odgovori> <!-- Početak niza odgovora -->
        <Odgovor> <!-- Prvi odgovor -->
            <Naziv>Cijena nije u ispravnom formatu !</Naziv>  <!-- Objašnjenje greške -->
            <Vrijednost xsi:type="xsd:int">405</Vrijednost> <!-- Broj greške -->
        </Odgovor>
    </Odgovori> <!-- Završetak niza odgovora -->
    <VrstaOdgovora>Greska</VrstaOdgovora> <!-- Tip odgovora: OK, Greska, Upozorenje -->
    <BrojZahtjeva>222</BrojZahtjeva> <!-- Broj zahtjeva na koji se daje odgovor -->
</KasaOdgovor>