OPIS VSEBINE RESPONSE DATOTEKE, KI SE GENERIRA PO KLICU PROGRAMA SimplyTax (29.09.2015)
Ko pokličete SimplyTax.exe, na želeno mesto v skladu s podanimi parametri dobite datoteko tipa .txt
(v nadaljevanju ji pravimo »response file«), v kateri vas čaka vse potrebno.
Praviloma vsebina izgleda približno takole (v primeru prijave računa):
ZOI;OK;c9e1b81c9f346d8fa6383a5a4f45c350
IMG;OK;9709a0af-70e5-4992-be79-6be368dd9751.JPG
EOR;OK; cbfc5349-40c0-4ad8-b993-0d05948cdfa2
oziroma tako (v primeru prijave prostora):
BusinessPremise;OK;Lokal5
V času, ko ima FURS-ov servis težave sam s seboj, lahko response izgleda tudi tako  :
BusinessPremise;ERROR;The remote server returned an error: (500) Internal Server Error.
(poimenovanje BusinessPremise je povzeto po FURS dokumentaciji/imenu značke)
V primeru, da ste pozabili predhodno prijaviti prostor iz katerega želite potrjevati račune, bi response
na račun izgledal približno tako:
ZOI;OK;c9e1b81c9f346d8fa6383a5a4f45c350
IMG;OK;9709a0af-70e5-4992-be79-6be368dd9751.JPG
EOR;ERROR;Podatki o poslovnem prostoru niso posredovani
Response na prijavo računa je torej sestavljen iz treh vrstic, reponse na prijavo prostora iz ene.
Vsaka vrstica ima tri polja, ločena s podpičjem.
Prvo polje identificira vsebino podano v tretjem polju.
ZOI = Zaščitna Oznaka Izdajatelja, izračuna se iz podanih podatkov po predpisanem algoritmu
IMG = Slika črtne kode v izbranem formatu, privzeto .JPG
EOR = Enotna Oznaka Računa, določi jo FURS
Drugo polje identificira uspešnost pridobitve vsebine (podane v tretjem polju).
Možni vrednosti sta OK ali ERROR. OK pove, da je v tretjem polju pričakovanja vsebina. Če je
vrednost drugega polja ERROR, je v tretjem polju nazoren opis napake oziroma težave.
Tretje polje je torej dejanska vsebina. ZOI in EOR preberete in neposredno prepišete na račun, pri
IMG pa je v tretjem polju zapisano generično ime datoteke v kateri je generirana črtna koda,
specifično izdelana za posamezni račun. Datoteka se zapiše na isti direktorij kot se zapiše response
file. To pomeni, da jo neposredno dosežete tako, da poti, ki ste jo podali za response file, dodate ime,
prebrano iz response datoteke.
Podatki o prostoru in podatki o računu se pripravijo v dokaj enostavni tekstovni obliki (v bistvu gre za
CSV delimiterjem podpičje). Navodila za pripravo se nahajajo v samostojnem dokumentu.
Želimo vam uspešno delo in čim manj težav.
Ekipa storitve SimplyTax.
P.S.
Ponudniki programske opreme, ki ne želite klicati zunanje .EXE datoteke, ampak bi želeli uporabiti
mini knjižnico (.dll za .NET) z dvema objavljenima API-jima, ki jima lahko neposredno podajate
parametre in od njiju pridobivate response brez vmesnega zapisovanja na disk, to sporočite na mail
[email protected] oziroma se registrirajte in oddajte zahtevo tehnični podpori.