angiver det tilhørende land.

Hvis fiscalCountryProperties forespørges via GET /api/v1/information/client/{clientId}/countryProperties, angives det land, der er tildelt den pågældende klient.

Angiver, om certificering af en skattekomponent er påkrævet i et land, eller hvad der skal certificeres.

"mandatory" – Certificering af det opstrøms system (f.eks. kasseapparatet) er obligatorisk. I dette tilfælde skal kasseapparatet gennemgå en certificerings- eller godkendelsesproces.

"miniPOS" – Certificering er obligatorisk, men opfyldes af en allerede certificeret komponent, der kan integreres i RetailForce Middleware.

"notNecessary" – Der kræves ingen certificering af det forudgående system.

"true" – I det pågældende land skal data sendes linje for linje, f.eks. til en skatteprinter.

• understøttes ikke i øjeblikket

"false" – Dokumentbaseret grænseflade (ingen udskrivning linje for linje).

• Implementeringen mellem det opstrøms system og Fiscalisation Service er baseret på standard api-endpoints.

Angiver typen af fiskalisering.

"fiscalPrinter" – Fiscalisationen er baseret på en certificeret fiscalprinter eller et certificeret fiskalt kassesystem.

• Dette betyder, at der ud over RetailForce-systemet kræves en fiskalprinter. Denne skal muligvis købes hos en lokal leverandør.

"online" – Registrering via de lokale skattemyndigheders onlinesystemer.

• Der kræves ingen yderligere hardwarekomponenter.

"signature" – Registrering ved at underskrive kvitteringsdata ved hjælp af et digitalt certifikat, der er gemt i registreringstjenesten.

• I nogle lande kan det være nødvendigt at anskaffe et kvalificeret digitalt certifikat udstedt af en CA (certifikatmyndighed).

"signatureWithOnline" – Fiskalisering ved at oprette signaturer og overføre data online til skattemyndighederne.

• En kombination af de to ovennævnte typer.

Angiver, hvilket miljø der understøttes:

"local" – lokal installation af den skattemæssige middleware (lokalt på POS-systemet, på butiksserveren osv.)

• Der kan foretages api-kald til den lokalt installerede fiscalisationstjeneste:
  • http://localhost:7678/ i tilfælde af REST-implementering, eller
  • metodeopkald i tilfælde af nuget-implementering.

"cloud" – fiscal middleware er tilgængelig som en hostet cloud-tjeneste på https://fiscalisation.retailforce.cloud/.

• Der kan foretages api-kald til Cloud Fiscalisation Service.

Angiver, hvilke operativsystemer/platforme der understøttes.

"linux"

• via Docker-container (REST-implementering)

"windows"

• via Windows-tjeneste (REST-implementering) eller
• via nuget-implementering

"ios"

• via nuget-implementering

"Android"

• via nuget-implementering, eller
• Android-tjeneste (REST-implementering)

Angiver, hvilke lovkrav der understøttes, samt deres versioner.

F.eks. for Grækenland: "myDATA v1.x.x"

Dokumenttyper, der skal "fiskaliseres" i det pågældende land. De skal f.eks. behandles af den foreskrevne hardwarekomponent, underskrives osv.

"documentTypes", der er anført under "fiscalDocumentTypes", behandles automatisk (f.eks. underskrives) i det pågældende land af fiscalisationstjenesten i overensstemmelse med fiscalisationlovgivningen.

Disse dokumenttyper SKAL overføres til fiscaliseringsservicen i det pågældende land, forudsat at det opstrøms system ("kasseapparatet") understøtter dem.

Liste over dokumenttyper, der understøttes i hvert land.

Ud over "fiscalDocumentTypes" KAN de dokumenttyper, der er anført under "supportedDocumentTypes", overføres til fiscalisationstjenesten.

Disse dokumenttyper er såkaldte »ikke-fiskale« dokumenter, dvs. dokumenter, der ikke er »fiskaliseret« (f.eks. underskrevet).

Liste over dokumenttyper, der ikke understøttes i det pågældende land.

"DocumentTypes", der er anført under "notSupportedDocumentTypes", kan ikke overføres til fiscalisationstjenesten i det pågældende land.

Årsagerne hertil kan være teknisk umulighed eller landespecifikke regler/love.

Hvis en "notSupportedDocumentType" sendes til skattebehandlingssystemet, vil det svare med en fejlmeddelelse ("documentType not supported!").

Det opstrøms system bør ikke tillade disse dokumenttyper i det pågældende land.

Liste over betalingsmetoder, der understøttes (accepteres) i det pågældende land.

Disse betalingsmetoder kan anvendes i det pågældende land.

Upstream-systemet bør kun tilbyde kassebrugeren de betalingsmetoder, der understøttes i det pågældende land.

Liste over betalingsmetoder, der ikke understøttes (eller ikke er tilladt) i det pågældende land.

Det overordnede system bør udelukke betalingsmetoder, der ikke understøttes i det pågældende land.

Liste over betalingsmetoder (PaymentTypes), hvor overbetaling af det skyldige beløb ikke er tilladt i det pågældende land.

Eksempler:

Kvitteringens samlede beløb = 38,50 EUR

• Kunden betaler 50 EUR med betalingskort, fordi vedkommende ønsker at få byttepengene i kontanter.
• Kunden betaler 50 EUR i kontanter og modtager 11,50 EUR i byttepenge (byttepenge udleveret).

Disse transaktioner er ikke tilladt i nogle lande (dvs. de kan ikke sendes til skattesystemet).

Dette betyder, at betalingsbeløbene ("payment.amount") altid skal svare til bruttototalen for varerne ("GrossValue" for alle "positions"), og at der ikke må overføres negative betalingsbeløb.

Liste over forretningsscenarier, der understøttes i hvert land.

Disse forretningstransaktionstyper kan anvendes i det pågældende land, i modsætning til notSupportedBusinessTransactionTypes.

Liste over forretningsscenarier, der ikke understøttes (eller ikke er tilladt) i det pågældende land.

Disse forretningsscenarier kan ikke anvendes i det pågældende land og bør undertrykkes af kildesystemet og ikke overføres til skattebehandlingssystemet.

Detaljerede oplysninger om de Vat-satser, der understøttes i hvert land.

Denne matrix indeholder følgende oplysninger:

• Momsats: "VatPercent" / "VatPercent2"
• Internt ID, der bruges til at kortlægge den respektive momssats: "VatIdentification"
• Navn på momssatsen: "caption" / "caption_EN"
• Historiske Vat-satser med gyldighedsoplysninger ("ValidFrom" – "ValidTo")

"ikke obligatorisk" – Visning af kunde er ikke påkrævet (ingen forpligtelse).

"obligatorisk (no-RF)" – Visning af kunde er obligatorisk, men styres ikke via RetailForce Middleware. Styringen udføres automatisk af det respektive skattesystem (f.eks. automatisk via skatteprinteren).

"obligatorisk (RF)" – Det er obligatorisk at anvende en kundedisplay, og det styres via RetailForce Middleware.

• Kundedisplayet styres via funktionen: POST /api/v1/transactions/display/{clientId}

"ikke tilladt" – Brug af kundedisplay er forbudt i dette land.

Angiver, om indtastningsenheder skal registreres i det pågældende land ("true" / "false").

Indtastningsenheder er ikke selvstændige registreringssystemer. Se for yderligere oplysninger: Arkitekturer for elektroniske registreringssystemer (EAS)

"true" – i det pågældende land er der krav om at føre en teknisk logbog (auditlog) (i dette tilfælde inkluderet i RF-licensen).

• I dette tilfælde skal tekniske hændelsesposter sendes til fiscalisationstjenesten via
  • POST /api/v1/transactions/AuditLog , eller
  • POST /api/v1/transactions/storeDocument ("documentType": "[1002] = AuditLog")

"false" – der er ikke noget krav om at føre en teknisk logbog (ikke inkluderet i licensen).

• Tekniske hændelser KAN registreres, men det er ikke obligatorisk.

"true" – i det pågældende land skal genudskrivning af et dokument obligatorisk registreres.

• Kald enten:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, eller

  • PUT /api/v1/transactions/reprintDocument

    obligatorisk.

"false" – Genudskrivning af et dokument behøver ikke at blive registreret som obligatorisk.

"terminal" – Et dokument må kun genudskrives på den samme kasseapparat, hvor det oprindelige dokument blev udstedt.

"butik" – Genudskrivning af et dokument må kun foretages i den samme filial/butik, hvor det oprindelige dokument også blev udstedt.

• Funktionen til genudskrivning på tværs af flere filialer skal implementeres af det overordnede system.

"all" – Genudskrivning af et dokument kan foretages på en anden kasse samt i en anden filial/butik i samme virksomhed.

• Funktionen til genudskrivning på tværs af flere filialer skal implementeres af det overordnede system.

"true" – der skal genereres en daglig afslutning (Z-rapport) én gang om dagen.

• daglig afslutning
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = EndOfDay"

"false" – der er ikke krav om en daglig afslutning.

Angiver den tidsperiode siden kasseapparatets daglige åbning, inden for hvilken en daglig afslutning skal finde sted (f.eks. inden for 24 timer).

"-1" – ikke angivet.

Angiver, om salg og returneringer må registreres samtidigt på en kvittering (dokument).

"oneReceiptAllowed" – tilladt (salg og retur kan vises blandet på én kvittering).

• Salg:
  • "positions" (type 0 eller 1) med positive værdier,
• Returvarer:
  • "positions" (type 0 eller 1) med negative værdier og
  • "documentReference" angivet.

"oneReceiptAllowedVat" – så længe Vat-beløbet forbliver positivt, kan salg og returneringer registreres på én (den samme) kvittering.

"multiReceipt" – Salg og returneringer skal registreres på forskellige kvitteringer.

• Inden data overføres til skatteovervågningstjenesten, skal det opstrøms system automatisk opdele salg og returneringer i forskellige transaktioner.

"NoReturnAllowed" – i det pågældende land er det ikke muligt at behandle returvarer via skatteovervågningssystemet. I disse lande håndteres returvarer ofte via særlige formularer eller lignende i regnskabsafdelingen.

Hvor kan købte varer returneres?

"terminal" – Varer kan kun returneres ved den samme terminal (udstedelse af kvittering), hvor det oprindelige salg fandt sted.

"store" – Varer kan kun returneres til den samme filial/butik (udstedelse af kvittering), hvor det oprindelige salg fandt sted.

"all" – Varer kan også returneres til andre filialer af samme virksomhed.

Dokumenthenvisning ved returnering

"single" – i tilfælde af returneringer må der kun henvises til ÉT tidligere dokument (salgsdokument for de returnerede tjenesteydelser eller varer).

• "documentReference" er kun tilladt for et enkelt foreløbigt dokument, eller
• henvisning på vareniveau ("positionReference") er kun tilladt for et enkelt forudgående dokument.

"multiple" – i tilfælde af returvarer kan der henvises til flere tidligere dokumenter (flere salgsbilag, hvis flere tjenesteydelser eller varer fra flere køb returneres). 

• "documentReference" til flere tidligere dokumenter, eller
• henvisning til det tilsvarende forudgående dokument via "positionReference" på den enkelte returpost.

Angiver, om elementet "fiscalDocumentNumber" i "fiscalResponse" for det pågældende land skal udskrives på dokumenter.

• Dokumentnumre, der overføres fra det opstrøms system, ignoreres. Det skattemæssige system (f.eks. printeren) tildeler det respektive dokumentnummer/dokument-ID autonomt.

"true" – i det pågældende land er tillæg på varer eller tjenesteydelser tilladt.

• tillæg:
  • "positions.discounts" med NEGATIVE værdier

"false" – Pristillæg er ikke tilladt.

Angiver, om en trænings-/demotilstand på kasseapparatet er tilladt i det pågældende land

"true" – tilladt.

• Træningstilstand:
  • "IsTraining": true

"false" – Kasseapparatet må ikke have en trænings-/demotilstand.

"true" – Summen af de enkelte varer beregnes ud fra nettobeløbet (NetValue) (f.eks. Québec/Canada).

"false" – Summen af de enkelte varer beregnes ud fra bruttobeløbet (GrossValue) (standard).

"true" – Poster, der er indtastet, men som efterfølgende ikke medtages i dokumentet, skal overføres i payloaden (JSON).

"false" – Varer, der er blevet indtastet, men som efterfølgende ikke er medtaget i dokumentet, behøver ikke at blive overført.

Angiver typen af startdokument i det pågældende land.

Kun relevant, hvis det opstrøms system IKKE bruger funktionen GET /api/v1/transactions/document/{clientId}/start under initialiseringen og selv genererer det pågældende startdokument.

Liste over udbetalingstyper, der understøttes i det pågældende land.

De poster, der er anført under "supportedPayOutTypes", kan/skal angives for udbetalinger ("documentType": "[10] = PayOut" og "BusinessTransactionType": "[10] = PayOut").

Angiver, om Vat-satserne beregnes af landets respektive skattemodul.

"true" – Beskatningsmodulet beregner momssatserne.

"false" – kasseapparatet skal beregne Vat-satserne.

Angiver, om og hvor mange decimaler der skal medtages i JSON-dokumentet til Fiscal Middleware ved afsendelse af beløb/totaler.

Gælder for alle værdispecifikationer i payloaden ("GrossValue", "NetValue", "TaxValue", "Amount" osv.)