V tem članku boste izvedeli, kako poizvedovati različne lastnosti držav ter kako jih najti v RetailForce Cloud. Na koncu članka boste našli pojasnilo različnih elementov fiscalCountryProperties.
Da bi ponazorili potrebne implementacije za vašo implementacijo, so bile ustvarjene lastnosti držav (fiscalCountryProperties). Te prikazujejo, katere dele celotnega vmesnika je treba za vsako državo vsaj implementirati.
Lastnosti države so na voljo od različice V1.2.12 (razen za clients od različice V1.2.13).
Poizvedba lastnosti držav v Cloud
Do lastnosti držav lahko dostopate v portalu v Cloud prek naslednje povezave:
https://portal.retailforce.cloud/information/fiscal-country
Za dostop do fiscalCountryProperties morate biti prijavljeni v portal.
Poizvedba lastnosti držav v clientu
Lastnosti držav lahko poizvedujete tudi prek programa. To omogoča odzivanje na različne lastnosti držav v programu blagajne.
Primer: določena vrsta dokumenta v določeni državi ni dovoljena in zato ni podprta.
Poizvedba prek neposredne implementacije (nuget)
Za poizvedbo vseh obstoječih lastnosti držav za vse države lahko pokličete naslednjo metodo:
List<IFiscalCountryProperties> TrustedFiscalModul.GetFiscalCountryPropertiesList()Poizvedba prek clienta
REST storitev
V storitvi REST sta na voljo 2 končne točke za poizvedbo lastnosti držav:
GET /api/v1/information/countryPropertiesTa metoda se lahko uporabi za poizvedbo lastnosti države za določeno državo.
/api/v1/information/client/{clientId}/countryPropertiesTo metodo lahko uporabite za poizvedbo lastnosti države za določeno stranko.
Client storitve Fiscal Service
Na odjemalcu fiskalne storitve (.NET Standard 2.0 in .NET Framework 2) so na voljo naslednje metode za poizvedovanje lastnosti države.
FiscalCountryProperties GetFiscalCountryProperties(FiscalCountry fiscalCountry)To metodo je mogoče uporabiti za poizvedbo lastnosti države za določeno državo.
FiscalCountryProperties GetFiscalCountryProperties(Guid clientId)To metodo je mogoče uporabiti za poizvedbo lastnosti države za določeno stranko.
fiscalCountryProperties – Pojasnilo
fiscalCountryProperties vsebujejo podatke, ki so zgolj informativne narave, ter informacije, pomembne za implementacijo.
Informativni podatki so v stolpcu »Type« označeni z INFO. Podatki, ki jih je treba upoštevati pri implementaciji, so označeni z »RFI« (pomembno za implementacijo).
| fiscalCountryProperties | Vrsta |
Opis |
| fiscalCountry | INFO |
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. |
| countryModuleVersion | INFO |
Trenutna različica modula Trusted Fiscal Country v middleware (pomembno za države, v katerih mora biti določena različica programske opreme certificirana; npr. Francija). |
| certificationType | INFO |
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 postopek certifikacije ali odobritve. »miniPOS« – Certifikacija je obvezna, vendar jo izpolnjuje že certificirana komponenta, ki se lahko integrira v RetailForce middleware. »notNecessary« – Certifikacija predhodnega sistema ni potrebna. |
| fiscalLineInterface | RFI |
»true« – v zadevni državi je treba podatke pošiljati po vrsticah, npr. na fiskalni tiskalnik.
»false« – vmesnik na podlagi dokumenta (brez tiskanja po vrsticah).
|
| fiscalisationType | INFO |
Določa vrsto fiskalizacije. "fiscalPrinter" – Fiskalizacija temelji na certificiranem fiskalnem tiskalniku ali certificiranem fiskalnem blagajniškem sistemu.
»online« – Fiskalizacija prek spletnih sistemov lokalnih davčnih organov.
»signature« – Fiskalizacija s podpisovanjem podatkov na računu z uporabo digitalnega certifikata, shranjenega v fiskalizacijski storitvi.
»signatureWithOnline« – fiskalizacija z ustvarjanjem podpisov in spletnim pošiljanjem podatkov davčnim organom.
|
| podprta okolja | RFI |
Določa, katero okolje je podprto: »local« – lokalna namestitev fiskalnega middlewareja (lokalno na POS-sistemu, na strežniku trgovine itd.)
»cloud« – fiskalna middleware je na voljo kot gostovana storitev v oblaku na naslovu https://fiscalisation.retailforce.cloud/.
|
| podprtiTipiPlatform | RFI |
Določa, kateri operacijski sistemi/platforme so podprti. »linux«
»windows«
»ios«
»android«
|
| podprta zakonodaja | INFO |
Določa, katere zakonske zahteve so podprte in njihove različice. Npr. za Grčijo: »myDATA v1.x.x« |
| vrste davčnih dokumentov | RFI |
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“). |
| podprte vrste dokumentov | RFI |
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). |
| nepodprti tipi dokumentov | RFI |
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. |
| podprte vrste plačil | RFI |
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. |
| nepodprti načini plačila | RFI |
Seznam načinov plačila, ki niso podprti (ali niso dovoljeni) v zadevni državi. Nadrejeni sistem mora v zadevni državi onemogočiti nepodprte načine plačila. |
| preplačiloNiDovoljeno | RFI |
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
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. |
| podprtiTipiPoslovnihTransakcij | RFI |
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. |
| notSupportedBusinessTransactionTypes | RFI |
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 službi za fiskalizacijo. |
| podprte opredelitve DDV | RFI |
Podrobne informacije o stopnjah Vat, ki so podprte v posamezni državi. Ta niz vsebuje naslednje informacije:
|
| companyIdentification | RFI |
Informacije o tem, katere identifikatorje podjetij je treba uporabljati v posamezni državi. |
| customerDisplayMandatory | RFI |
»ni obvezno« – Prikaz stranke ni obvezen (ni obveznosti). »obvezno (brez 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.
»ni dovoljeno« – Uporaba zaslona za stranke je v tej državi prepovedana. |
| terminalSlaveSupported | RFI |
Določa, ali morajo biti vhodne naprave registrirane v zadevni državi („true“ / „false“). Vhodne naprave niso samostojni sistemi za beleženje. Za več informacij glej: Arhitekture elektronskih sistemov za beleženje (EAS) |
| auditLogMandatory | RFI |
»true« – v zadevni državi velja obveznost vodenja tehničnega dnevnika (revizijskega dnevnika) (v tem primeru je vključena v licenco RF).
»false« – ni zahteve za vodenje tehničnega dnevnika (ni vključen v licenco).
|
| mustRecordDocumentReprint | RFI |
"true" – v zadevni državi je treba ponatis dokumenta obvezno evidentirati.
»false« – Ponatis dokumenta ni obvezno treba evidentirati. |
| reprintAllowedDomain | RFI |
»terminal« – Dokument se lahko ponovno natisne le na isti blagajni, na kateri je bil izdan izvirni dokument. »trgovina« – Ponovni izpis dokumenta je mogoč le v isti poslovalnici/trgovini, v kateri je bil izdan tudi izvirni dokument.
»vse« – Ponatis dokumenta je mogoč na drugem blagajniškem terminalu ter v drugi poslovalnici istega podjetja.
|
| mustSendClosingPerDay | RFI |
»true« – dnevno zaključno poročilo (Z-poročilo) je treba pripraviti enkrat na dan.
»false« – dnevno zaključevanje ni obvezno. |
| najdaljši časovni interval za zaključek | RFI |
Označuje časovno obdobje od zadnjega dnevnega zaključka, v katerem mora potekati naslednji dnevni zaključek (npr. v 24 urah). Ko to obdobje poteče, storitev fiskalizacije zavrne vsak dokument razen dnevnega zaključka („documentType“: „[99] = EndOfDay“) s statusom HTTP 400, dokler ni shranjen dnevni zaključek. Pred prvim dnevnim zaključkom ne velja nobena omejitev. „-1“ – ni nastavljeno. |
| returnAndSaleBehavior | RFI |
Določite, ali se lahko prodaja in vračila hkrati evidentirata na računu (dokumentu). »oneReceiptAllowed« – dovoljeno (prodaja in vračila se lahko prikazujejo skupaj na enem računu).
»oneReceiptAllowedPerVatRate« – prodajo in vračila je mogoče evidentirati na enem (istem) računu, če imajo bruto zneski vseh stopenj Vat na računu enak predznak (vsi pozitivni ali vsi negativni). »multiReceipt« – prodaja in vračila morajo biti evidentirani na različnih potrdilih.
»NoReturnAllowed« – v zadevni državi obdelava vračil prek fiskalizacijskega sistema ni mogoča. V teh državah se vračila pogosto obdelujejo prek posebnih obrazcev ali podobnega v računovodskem oddelku. |
| returnDomainAllowed | RFI |
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. |
| returnReferenceBehavior | RFI |
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).
»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).
|
| printFiscalDocumentNumber | RFI |
Določa, ali je treba element »fiscalDocumentNumber« iz »fiscalResponse« ustrezne države natisniti na dokumente.
|
| taxFreeVat |
|
|
| getCloudArchiveAccessLicense |
|
Vrne potrebno licenco za arhiviranje davčnih podatkov v Cloud. |
| surchargesPossible | RFI |
»true« – v zadevni državi so dovoljeni dodatki na blago ali storitve.
»false« – cenovni dodatki niso dovoljeni. |
| trainingModeAllowed | RFI |
Kaže, ali storitev fiskalizacije za zadevno državo podpira način usposabljanja/demo »true« – dovoljeno.
»false« – način usposabljanja/predstavitve ni podprt. Storitev fiskalizacije zavrne vsak dokument z »IsTraining«: true (napaka pri preverjanju »Potrdilo o usposabljanju v tej državi ni dovoljeno.«). |
| netValuePositionCalculation | RFI |
»true« – vsota posameznih postavk 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). |
| mustSendCanceledPosition | RFI |
»true« – Postavke, ki so bile vnesene, a kasneje niso vključene v dokument, je treba posredovati v JSON payloadu. »false« – Postavke, ki so bile vnesene, vendar kasneje niso vključene v dokument, ni treba posredovati. Opomba: Za več informacij glejte članek »Pošiljanje pozicij izbrisanih postavk«. |
| startDocumentType | RFI |
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 ustrezen začetni dokument. |
| podprtiTipiIzplačil | RFI |
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«). |
| notSupportedPayOutTypes | RFI |
Seznam vrst izplačil, ki niso podprte (ali niso dovoljene) v zadevni državi. |
| fiscalModuleCalculatesTaxRates | RFI |
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. |
| veljavni znaki za številko trgovine (Regex) | RFI |
Dovoljeni izraz RegEx za številko trgovine (številko poslovalnice) |
| terminalNumberValidCharsRegex | RFI |
Dovoljeni izraz RegEx za številko termina (številko blagajne) |
| fiscalRegions | RFI |
Navedba davčnih regij, če je to v zadevni državi primerno. |
| decimalna mesta zneska | RFI |
Določa, ali in koliko decimalnih mest je treba vključiti v JSON-dokument, namenjen fiskalnemu middlewareju, pri pošiljanju zneskov/skupnih zneskov. Velja za vse specifikacije vrednosti v payloadu („GrossValue“, „NetValue“, „TaxValue“, „Amount“ itd.) |
| entityParameters |
|
Določa, kateri parametri morajo biti shranjeni za katere entitete portala. |
| legalForms | RFI |
Seznam pravnih oblik podjetij, ki so na voljo v državi. |
| mustIndicateTipCompanyTipPayment |
Ta flag kaže, ali je v zadevni državi obvezno ustrezno označiti plačila, namenjena kot napitnina. Če je določeno več kot eno plačilo, mora biti tisto, prek katerega stranka plača napitnino, označeno z flagom „isTip“, nastavljeno na vrednost „true“. Primer: Skupni znesek računa je 46,30 EUR; stranka plača
Za več informacij si oglejte članek: Razdeljena plačila za določene namene. |
|
| itemTypeClassificationRequired | RFI |
V nekaterih državah je potrebna podrobnejša specifikacija določenih artiklov. Če je vrednost te lastnosti »true«, je treba za ustrezne artikle v zadevni državi nastaviti vrednosti, določene v `supportedItemTypeClassification` (lastnost ItemTypeClassification mora biti ustrezno nastavljena v objektu positions). |
| supportedItemTypeClassification | RFI |
Določa, katere postavke morajo biti v zadevni državi posebej označene (lastnost ItemTypeClassification mora biti ustrezno nastavljena v objektu positions). |
| documentTypeBusinessTransactionTypeSupport | RFI |
Informacije o tem, katere vrste BusinessTransactionTypes se lahko kombinirajo s katerimi vrstami dokumentov (documentTypes). |
Ta članek je bil samodejno preveden.
Komentar
0 komentarjev
Za dodajanje komentarja prosimo kliknite Vpis.