anger motsvarande land.

Om fiscalCountryProperties hämtas via GET /api/v1/information/client/{clientId}/countryProperties, anges det land som tilldelats respektive klient.

Anger om certifiering av en skattekomponent krävs i ett land, eller vad som måste certifieras.

”mandatory” – Certifiering av det uppströms liggande systemet (t.ex. kassasystemet) är obligatorisk. I detta fall måste kassasystemet genomgå en certifierings- eller godkännandeprocess.

"miniPOS" – Certifiering är obligatorisk, men uppfylls av en redan certifierad komponent som kan integreras i RetailForce Middleware.

"notNecessary" – Ingen certifiering av det föregående systemet krävs.

"true" – I det aktuella landet måste data skickas rad för rad, t.ex. till en skatteskrivare.

• stöds för närvarande inte

"false" – Dokumentbaserat gränssnitt (ingen utskrift rad för rad).

• Implementeringen mellan uppströmsystemet och Fiscalisation Service baseras på standardiserade api-ändpunkter.

Anger typen av fiscalisation.

"fiscalPrinter" – Fiscalisationen baseras på en certifierad fiscalprinter eller ett certifierat fiscalregistreringssystem.

• Detta innebär att det, utöver RetailForce systemet, krävs en skatteskrivare. Denna kan behöva köpas in från en lokal leverantör.

"online" – Registrering via de lokala skattemyndigheternas onlinesystem.

• Ingen ytterligare hårdvara krävs.

"signature" – Fiscalisation genom att signera kvittodata med ett digitalt certifikat som lagras i fiscalisationstjänsten.

• I vissa länder kan det vara nödvändigt att skaffa ett kvalificerat digitalt certifikat utfärdat av en certifikatutfärdare (CA).

”signatureWithOnline” – Fiscalisation genom att skapa signaturer och överföra data online till skattemyndigheterna.

• En kombination av de två ovannämnda metoderna.

Anger vilken miljö som stöds:

"local" – lokal installation av den skattemässiga middleware-programvaran (lokalt på kassasystemet, på butiksservern osv.)

• API-anrop kan göras till den lokalt installerade skattemässiga tjänsten:
  • http://localhost:7678/ vid REST-implementering, eller
  • metodanrop vid nuget-implementering.

"cloud" – fiscal middleware finns tillgängligt som en molntjänst på https://fiscalisation.retailforce.cloud/.

• API-anrop kan göras till Cloud-tjänsten för skattehantering.

Anger vilka operativsystem/plattformar som stöds.

"linux"

• via Docker-container (REST-implementering)

"windows"

• via Windows-tjänst (REST-implementering), eller
• via nuget-implementering

"ios"

• via nuget-implementering

"android"

• via nuget-implementering, eller
• Android-tjänst (REST-implementering)

Anger vilka lagkrav som stöds samt deras versioner.

T.ex. för Grekland: ”myDATA v1.x.x”

Dokumenttyper som ska ”fiskaliseras” i respektive land. De måste till exempel bearbetas av den föreskrivna hårdvarukomponenten, signeras osv.

"documentTypes" som anges under "fiscalDocumentTypes" behandlas automatiskt (t.ex. signeras) i respektive land av fiscaliseringstjänsten i enlighet med fiscaliseringslagstiftningen.

Dessa dokumenttyper MÅSTE överföras till skattehanteringstjänsten i respektive land, förutsatt att det uppströms liggande systemet (”kassasystemet”) stöder dem.

Förteckning över dokumenttyper som stöds i varje land.

Utöver ”fiscalDocumentTypes” KAN de dokumenttyper som anges under ”supportedDocumentTypes” överföras till fiscalisationstjänsten.

Dessa dokumenttyper är så kallade ”icke-fiskala” dokument, dvs. sådana som inte är ”fiskaliserade” (t.ex. signerade).

Lista över dokumenttyper som inte stöds i respektive land.

"DocumentTypes" som anges under "notSupportedDocumentTypes" kan inte överföras till skattehanteringstjänsten i respektive land.

Orsakerna till detta kan vara teknisk omöjlighet eller landspecifika bestämmelser/lagar.

Om en ”notSupportedDocumentType” skickas till skatteregistreringstjänsten kommer den att svara med ett felmeddelande (”documentType not supported!”).

Det uppströms liggande systemet bör inte tillåta dessa dokumenttyper i det aktuella landet.

Lista över betalningsmetoder som stöds (accepteras) i respektive land.

Dessa betalningsmetoder kan användas i respektive land.

Uppströmsystemet bör endast erbjuda kassanvändaren de betalningsmetoder som stöds i respektive land.

Lista över betalningsmetoder som inte stöds (eller inte är tillåtna) i respektive land.

Uppströmsystemet bör undertrycka betalningsmetoder som inte stöds i respektive land.

Lista över betalningsmetoder (PaymentTypes) för vilka överbetalning av det belopp som ska betalas inte är tillåten i det berörda landet.

Exempel:

Kvittots summa = 38,50 EUR

• Kunden betalar 50 EUR med betalkort eftersom hen vill ha växel i kontanter.
• Kunden betalar 50 EUR kontant och får 11,50 EUR i växel (växel utbetald).

Dessa transaktioner är inte tillåtna i vissa länder (vilket innebär att de inte kan skickas till skatterapporteringssystemet).

Detta innebär att betalningsbeloppen ("payment.amount") alltid måste motsvara bruttosumman för varorna ("GrossValue" för alla "positioner") och att inga negativa betalningsbelopp får överföras.

Lista över affärsslag som stöds i respektive land.

Dessa affärsfall kan användas i respektive land, till skillnad från notSupportedBusinessTransactionTypes.

Lista över affärsslag som inte stöds (eller inte är tillåtna) i respektive land.

Dessa affärsfall kan inte användas i respektive land och bör undertryckas av källsystemet och inte överföras till skattetjänsten.

Detaljerad information om de mervärdesskattesatser som stöds i varje land.

Denna matris innehåller följande information:

• Momsats: "VatPercent" / "VatPercent2"
• Internt ID som används för att koppla respektive momssats: "VatIdentification"
• Namn på Vat-satsen: "caption" / "Caption_EN"
• Historiska Vat-satser med giltighetsuppgifter ("ValidFrom" – "ValidTo")

”inte obligatoriskt” – Kundvisning krävs inte (ingen skyldighet).

”obligatoriskt (no-RF)” – Kundvisning är obligatorisk, men styrs inte via RetailForce Middleware. Styrningen sker automatiskt via respektive skattesystem (t.ex. automatiskt via skatteskrivaren).

"obligatoriskt (RF)" – Det är obligatoriskt att använda kunddisplayen och kontrollen sker via RetailForce Middleware.

• Kunddisplayen styrs via funktionen: POST /api/v1/transactions/display/{clientId}

”inte tillåtet” – Användning av kunddisplay är förbjuden i detta land.

Anger om inmatningsenheter måste registreras i respektive land ("true" / "false").

Inmatningsenheter är inte fristående registreringssystem. För mer information, se: Arkitekturer för elektroniska registreringssystem (EAS)

"true" – i respektive land finns ett krav på att föra en teknisk logg (revisionslogg) (i detta fall ingår den i RF-licensen).

• I detta fall måste tekniska händelseposter skickas till fiscalisationstjänsten via
  • POST /api/v1/transactions/AuditLog , eller
  • POST /api/v1/transactions/storeDocument ("documentType": "[1002] = AuditLog")

"false" – det finns inget krav på att föra en teknisk logg (ingår inte i licensen).

• Tekniska händelser FÅR registreras, men det är inte obligatoriskt.

"true" – i det aktuella landet måste omtryck av ett dokument registreras obligatoriskt.

• Anropa antingen:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, eller

  • PUT /api/v1/transactions/reprintDocument

    obligatoriskt.

"false" – Utskrift av ett dokument behöver inte registreras som obligatorisk.

"terminal" – Ett dokument får endast skrivas ut på samma kassa där originaldokumentet utfärdades.

"butik" – Utskrifter av ett dokument får endast göras inom samma filial/butik där även originaldokumentet utfärdades.

• Funktionen för utskrift på nytt över flera filialer måste implementeras av det uppströms liggande systemet.

"all" – Ett dokument får återutskrivas på en annan kassa samt i en annan filial/butik inom samma företag.

• Funktionen för utskrift på nytt över flera filialer måste implementeras av det överordnade systemet.

"true" – en daglig avstämning (Z-rapport) måste genereras en gång om dagen.

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

"false" – inget krav på en daglig avstämning.

Anger den tidsperiod sedan kassans dagliga öppning inom vilken en daglig avstängning måste ske (t.ex. inom 24 timmar).

"-1" – inte angivet.

Ange om försäljning och returer får registreras samtidigt på ett kvitto (dokument).

"oneReceiptAllowed" – tillåtet (försäljning och returer kan visas blandat på ett kvitto).

• Försäljning:
  • "positions" (typ 0 eller 1) med positiva värden,
• Returer:
  • "positions" (typ 0 eller 1) med negativa värden och
  • "documentReference" angiven.

"oneReceiptAllowedVat" – så länge Vat-beloppet är positivt kan försäljning och returer registreras på ett enda (samma) kvitto.

"multiReceipt" – Försäljning och returer måste registreras på olika kvitton.

• Innan data överförs till skattehanteringstjänsten måste det uppströms liggande systemet automatiskt dela upp försäljning och returer i olika transaktioner.

"NoReturnAllowed" – i det aktuella landet är det inte möjligt att hantera returer via skattehanteringssystemet. I dessa länder hanteras returer ofta via särskilda formulär eller liknande inom redovisningsavdelningen.

Var får köpta varor returneras?

"terminal" – Varor får endast tas tillbaka vid samma kassa (kvittoutfärdning) där den ursprungliga försäljningen ägde rum.

"store" – Varor får endast returneras till samma filial/butik (kvittoutfärdningsställe) där det ursprungliga köpet gjordes.

"all" – Varor kan även returneras till andra filialer inom samma företag.

Dokumentreferens för returer

"single" – vid returer får hänvisning endast göras till ETT tidigare dokument (försäljningsdokument för de returnerade tjänsterna eller varorna).

• "documentReference" är endast tillåtet för ett enda underliggande dokument, eller
• referens på artikelnivå ("positionReference") är endast tillåten för ett enda underliggande dokument.

”multiple” – vid returer får hänvisningar göras till flera tidigare dokument (flera försäljningskvitton om flera tjänster eller varor från flera inköp returneras). 

• "documentReference" till flera tidigare dokument, eller
• hänvisning till motsvarande tidigare dokument via ”positionReference” på den enskilda returposten.

Anger om elementet ”fiscalDocumentNumber” i ”fiscalResponse” för motsvarande land måste skrivas ut på dokumenten.

• Dokumentnummer som överförs från det uppströms liggande systemet ignoreras. Det skattemässiga systemet (t.ex. skrivaren) tilldelar respektive dokumentnummer/dokument-ID självständigt.

"true" – i det aktuella landet är tilläggsavgifter på varor eller tjänster tillåtna.

• surcharges:
  • "positions.discounts" med NEGATIVA värden

"false" – Pristillägg är inte tillåtna.

Anger om ett tränings-/demoläge för kassan är tillåtet i respektive land

"true" – tillåtet.

• Träningsläge:
  • "IsTraining": true

"false" – Kassaapparaten får inte ha något utbildnings- eller demoläge.

"true" – Summan av de enskilda varorna beräknas utifrån nettobeloppet (NetValue) (t.ex. Québec/Kanada).

"false" – Summan av de enskilda artiklarna beräknas utifrån bruttobeloppet (GrossValue) (standard).

"true" – Poster som har matats in men som inte senare ingår i dokumentet måste överföras i JSON payload.

"false" – Poster som har matats in men som inte senare ingår i dokumentet behöver inte överföras.

Anger typen av startdokument i det aktuella landet.

Endast relevant om uppströmsystemet INTE använder funktionen GET /api/v1/transactions/document/{clientId}/start vid initialiseringen och själv genererar respektive startdokument.

Lista över utbetalningstyper som stöds i det aktuella landet.

De poster som anges under ”supportedPayOutTypes” kan/måste anges för utbetalningar (”documentType”: ”[10] = PayOut” och ”BusinessTransactionType”: ”[10] = PayOut”).

Anger om Vat-satserna beräknas av landets respektive skattemodul.

"true" – Skattemodulen beräknar momssatserna.

"false" – Kassaapparaten måste beräkna Vat-satserna.

Anger om och hur många decimaler som måste inkluderas i JSON-dokumentet till Fiscal Middleware vid sändning av belopp/totalbelopp.

Gäller alla värdespecifikationer i payloaden ("GrossValue", "NetValue", "TaxValue", "Amount" osv.)