označuje ustrezno državo.

Če se lastnosti fiscalCountryProperties pridobijo prek poizvedbe GET /api/v1/information/client/{clientId}/countryProperties, se določi država, dodeljena zadevnemu stranki.

Določa, ali je v državi potrebna certifikacija fiskalne komponente ali kaj je treba certificirati.

»mandatory« – Certifikacija predhodnega sistema (npr. blagajne) je obvezna. V tem primeru mora blagajna prestati certifikacijski ali odobritveni postopek.

»miniPOS« – Certifikacija je obvezna, vendar jo izpolnjuje že certificirana komponenta, ki se lahko integrira v RetailForce Middleware.

»notNecessary« – Certifikacija predhodnega sistema ni potrebna.

»true« – v zadevni državi je treba podatke pošiljati vrstico po vrstico, npr. na fiskalni tiskalnik.

• trenutno ni podprto

»false« – vmesnik na podlagi dokumenta (brez tiskanja po vrsticah).

• Izvajanje med nadrejenim sistemom in storitvijo fiskalizacije temelji na standardnih končnih točkah api.

Določa vrsto fiskalizacije.

"fiscalPrinter" – Fiskalizacija temelji na certificiranem fiskalnem tiskalniku ali certificiranem fiskalnem blagajniškem sistemu.

• To pomeni, da je poleg RetailForce sistema potreben tudi fiskalni tiskalnik. Ta ga bo morda treba kupiti pri lokalnem dobavitelju.

»online« – Fiskalizacija prek spletnih sistemov lokalnih davčnih organov.

• Ni potrebna nobena dodatna strojna oprema.

»signature« – Fiskalizacija s podpisovanjem podatkov na računu z uporabo digitalnega certifikata, shranjenega v storitvi fiskalizacije.

• V nekaterih državah bo morda potrebno pridobiti kvalificirano digitalno potrdilo, ki ga izda CA (Certificate Authority).

»signatureWithOnline« – fiskalizacija z ustvarjanjem podpisov in spletnim pošiljanjem podatkov davčnim organom.

• Kombinacija obeh zgoraj navedenih načinov.

Določa, katero okolje je podprto:

»local« – lokalna namestitev fiskalnega middlewareja (lokalno na POS-sistemu, na strežniku trgovine itd.)

• Klici API-ja se lahko izvajajo na lokalno nameščeno fiskalno storitev:
  • http://localhost:7678/ v primeru izvedbe REST ali
  • klic metode v primeru implementacije nuget.

»cloud« – fiskalno middleware je na voljo kot gostovana storitev v oblaku na naslovu https://fiscalisation.retailforce.cloud/.

• API-klici se lahko izvajajo na storitvi fiskalizacije v oblaku.

Določa, kateri operacijski sistemi/platforme so podprti.

»linux«

• prek Docker kontejnerja (izvedba REST)

»windows«

• prek storitve Windows (izvedba REST) ali
• prek implementacije nuget

»ios«

• prek implementacije nuget

»android«

• prek implementacije nuget ali
• storitev za Android (izvedba REST)

Določa, katere zakonske zahteve so podprte in njihove različice.

Npr. za Grčijo: »myDATA v1.x.x«

Vrste dokumentov, ki jih je treba v zadevni državi „fiskalizirati“. Na primer, morajo biti obdelani s predpisano strojno opremo, podpisani itd.

»documentTypes«, navedeni pod »fiscalDocumentTypes«, se v zadevni državi samodejno obdelajo (npr. podpišejo) s strani storitve fiskalizacije v skladu z zakoni o fiskalizaciji.

Te vrste dokumentov MORAJO biti poslane službi za fiskalizacijo v zadevni državi, če jih podpira sistem na višji stopnji („blagajna“).

Seznam vrst dokumentov, ki jih podpira vsaka država.

Poleg »fiscalDocumentTypes« se vrste dokumentov, navedene pod »supportedDocumentTypes«, LAHKO posredujejo službi za fiskalizacijo.

Te vrste dokumentov so tako imenovani »nefiskalni« dokumenti, tj. tisti, ki niso »fiskalizirani« (npr. podpisani).

Seznam vrst dokumentov, ki niso podprte v zadevni državi.

„DocumentTypes“, navedeni pod „notSupportedDocumentTypes“, se ne morejo posredovati storitvi fiskalizacije v zadevni državi.

Razlogi za to so lahko tehnična nezmožnost ali predpisi/zakoni, specifični za posamezno državo.

Če se »notSupportedDocumentType« pošlje v storitev fiskalizacije, bo ta odgovorila z napako („documentType ni podprt!“).

Nadrejeni sistem ne sme dovoliti teh vrst dokumentov v zadevni državi.

Seznam načinov plačila, ki so podprti (sprejeti) v zadevni državi.

Te načine plačila je mogoče uporabljati v zadevni državi.

Nadrejeni sistem mora uporabniku blagajne ponujati le načine plačila, ki so podprti v zadevni državi.

Seznam načinov plačila, ki v zadevni državi niso podprti (ali niso dovoljeni).

Nadrejeni sistem mora v zadevni državi izključiti načine plačila, ki niso podprti.

Seznam načinov plačila (PaymentTypes), za katere v zadevni državi ni dovoljeno preplačilo dolgovanega zneska.

Primeri:

Skupni znesek računa = 38,50 EUR

• Stranka plača 50 EUR z debetno kartico, ker želi preostanek v gotovini.
• Stranka plača 50 EUR v gotovini in prejme 11,50 EUR vračila (izdano vračilo).

Te transakcije v nekaterih državah niso dovoljene (kar pomeni, da jih ni mogoče poslati v sistem fiskalizacije).

To pomeni, da morajo zneski plačil („payment.amount“) vedno ustrezati bruto skupnemu znesku postavk („GrossValue“ vseh „positions“) in da se ne smejo prenesti negativni zneski plačil.

Seznam vrst poslovnih primerov, ki so podprti v posamezni državi.

Te poslovne transakcije se lahko uporabljajo v zadevni državi, za razliko od notSupportedBusinessTransactionTypes.

Seznam vrst poslovnih primerov, ki niso podprti (ali niso dovoljeni) v zadevni državi.

Te poslovne primere ni mogoče uporabljati v zadevni državi, zato jih mora izvorni sistem izločiti in jih ne sme posredovati storitvi za davčno obdelavo.

Podrobne informacije o stopnjah Vat, ki so podprte v posamezni državi.

Ta niz vsebuje naslednje informacije:

• Stopnja DDV: „VatPercent“ / „VatPercent2“
• Notranja ID, ki se uporablja za povezavo z ustrezno stopnjo DDV: »VatIdentification«
• Ime stopnje Vat: „caption“ / „Caption_EN“
• Zgodovinske stopnje Vat s podatki o veljavnosti („ValidFrom“ – „ValidTo“)

»ni obvezno« – Prikaz stranke ni obvezen (ni obveznosti).

»obvezno (no-RF)« – Prikaz stranke je obvezen, vendar se ne nadzoruje prek RetailForce Middleware. Nadzor se izvaja samodejno prek zadevnega fiskalnega sistema (npr. samodejno prek fiskalnega tiskalnika).

»obvezno (RF)« – Uporaba zaslona za stranke je obvezna in se nadzoruje prek RetailForce Middleware.

• Zaslon za stranke se nadzoruje prek funkcije: POST /api/v1/transactions/display/{clientId}

»ni dovoljeno« – Uporaba zaslona za stranke je v tej državi prepovedana.

Določa, ali morajo biti vhodne naprave registrirane v zadevni državi („true“ / „false“).

Vhodne naprave niso samostojni sistemi za evidentiranje. Za več informacij glej: Arhitekture elektronskih sistemov za evidentiranje (EAS)

»true« – v zadevni državi velja obveznost vodenja tehničnega dnevnika (revizijskega dnevnika) (v tem primeru je vključen v licenco RF).

• V tem primeru je treba vpise o tehničnih dogodkih poslati službi za fiskalizacijo prek
  • POST /api/v1/transactions/AuditLog ali
  • POST /api/v1/transactions/storeDocument („documentType“: „[1002] = AuditLog“)

»false« – ni zahteve za vodenje tehničnega dnevnika (ni vključen v licenco).

• Tehnični dogodki SE LAHKO beležijo, vendar to ni obvezno.

"true" – v zadevni državi je treba ponatis dokumenta obvezno evidentirati.

• Klic enega od naslednjih:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, ali

  • PUT /api/v1/transactions/reprintDocument

    obvezno.

»false« – ponatis dokumenta ni obvezno treba evidentirati.

»terminal« – Dokument se lahko ponovno natisne le na isti blagajni, na kateri je bil izdan izvirni dokument.

»store« – Ponovni izpis dokumenta je mogoč le v isti poslovalnici, v kateri je bil izdan tudi izvirni dokument.

• Funkcijo ponovnega tiskanja v več poslovalnicah mora izvajati nadrejeni sistem.

»vse« – Ponovni izpis dokumenta je mogoč na drugem blagajniškem terminalu ter v drugi poslovalnici istega podjetja.

• Funkcijo ponovnega tiskanja v več poslovalnicah mora omogočiti nadrejeni sistem.

»true« – dnevno zaključno poročilo (Z-poročilo) je treba ustvariti enkrat na dan.

• dnevno zaključevanje
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = EndOfDay"

»false« – dnevno zaključevanje ni obvezno.

Označuje časovno obdobje od dnevnega odprtja blagajne, v katerem mora potekati dnevno zaključevanje (npr. v 24 urah).

"-1" – ni nastavljeno.

Določite, ali se lahko prodaja in vračila hkrati evidentirajo na računu (dokumentu).

»oneReceiptAllowed« – dovoljeno (prodaja in vračila se lahko prikazujejo skupaj na enem računu).

• Prodaja:
  • »positions« (tip 0 ali 1) s pozitivnimi vrednostmi,
• Vračila:
  • »positions« (tip 0 ali 1) z negativnimi vrednostmi in
  • nastavljeno »documentReference«.

»oneReceiptAllowedVat« – dokler znesek Vat ostaja pozitiven, se prodaja in vračila lahko evidentirajo na enem (istem) računu.

»multiReceipt« – prodaja in vračila morajo biti evidentirani na različnih potrdilih.

• Pred pošiljanjem podatkov v fiskalno službo mora predhodni sistem samodejno razdeliti prodajo in vračila na različne transakcije.

»NoReturnAllowed« – v zadevni državi obdelava vračil prek fiskalnega sistema ni mogoča. V teh državah se vračila pogosto obdelujejo prek posebnih obrazcev ali podobnega v računovodskem oddelku.

Kje je mogoče vrniti kupljene izdelke?

»terminal« – izdelke je mogoče vrniti le na isti blagajni (izdaja potrdila), na kateri je bila opravljena prvotna prodaja.

»store« – izdelke je mogoče vrniti le v isti poslovalnici (kjer je bil izdan račun), v kateri je bila opravljena prvotna prodaja.

»vse« – izdelke je mogoče vrniti tudi v drugih poslovalnicah istega podjetja.

Sklic na dokument za vračila

»single« – v primeru vračil se lahko sklicuje le na EN prejšnji dokument (prodajni dokument za vrnjene storitve ali blago).

• »documentReference« je dovoljeno le za en predhodni dokument ali
• sklicevanje na ravni postavke („positionReference“) je dovoljeno le za en predhodni dokument.

»multiple« – v primeru vračil se lahko sklicuje na več predhodnih dokumentov (več prodajnih potrdil, če se vrača več storitev ali blaga iz več nakupov). 

• »documentReference« na več predhodnih dokumentov ali
• sklic na ustrezen predhodni dokument prek »positionReference« na posamezni postavki vračila.

Določa, ali je treba element »fiscalDocumentNumber« iz »fiscalResponse« ustrezne države natisniti na dokumente.

• Številke dokumentov, prenesene iz predhodnega sistema, se ne upoštevajo. Davčni sistem (npr. tiskalnik) samostojno dodeli ustrezno številko dokumenta/ID dokumenta.

"true" – v zadevni državi so dovoljeni dodatki na blago ali storitve.

• doplačila:
  • »positions.discounts« z NEGATIVNIMI vrednostmi

»false« – cenovni dodatki niso dovoljeni.

Kaže, ali je v zadevni državi dovoljen način usposabljanja/demonstracijski način delovanja blagajne

»true« – dovoljeno.

• Način usposabljanja:
  • "IsTraining": true

»false« – Blagajna ne sme imeti načina usposabljanja/predstavitve.

"true" – vsota posameznih artiklov se izračuna na podlagi neto zneska (NetValue) (npr. Québec/Kanada).

"false" – Vsota posameznih postavk se izračuna na podlagi bruto zneska (GrossValue) (privzeto).

»true« – Postavke, ki so bile vnesene, a kasneje niso vključene v dokument, morajo biti poslane v payloadu (JSON).

»false« – Postavke, ki so bile vnesene, vendar kasneje niso vključene v dokument, ni treba posredovati.

Določa vrsto začetnega dokumenta v zadevni državi.

To je pomembno le, če sistem na višji stopnji med inicializacijo NE uporablja funkcije GET /api/v1/transactions/document/{clientId}/start in sam ustvari zadevni začetni dokument.

Seznam vrst izplačil, ki so podprte v zadevni državi.

Elementi, navedeni pod »supportedPayOutTypes«, se lahko/morajo določiti za izplačila (»documentType«: »[10] = PayOut« in »BusinessTransactionType«: »[10] = PayOut«).

Navedba, ali stopnje Vat izračuna ustrezni fiskalni modul zadevne države.

»true« – Modul za obdavčevanje izračuna stopnje DDV.

»false« – stopnje Vat mora izračunati blagajna.

Določa, ali in koliko decimalnih mest je treba vključiti v JSON-dokument za Fiscal Middleware pri pošiljanju zneskov / skupnih zneskov.

Velja za vse specifikacije vrednosti v payloadu („GrossValue“, „NetValue“, „TaxValue“, „Amount“ itd.)