RetailForce utvecklar programvara för att uppfylla bestämmelserna om skattehantering av elektroniska registreringssystem i olika länder. Denna programvara kallas ”Fiscal Middleware”.
Detta dokument ger en översikt över hur man integrerar RetailForce Fiscal Middleware. Systemarkitekturen hos det uppströmsliggande systemet som skickar och tar emot data från Fiscal Middleware, liksom särskilda krav och funktioner hos detta system, kan göra det nödvändigt att avvika från denna beskrivning.
1. Grundläggande information
Nedan listas de enskilda steg som måste genomföras innan du påbörjar integrationen. Dessa steg går vi även igenom i detalj under introduktionsmötet.
1.1 Översikt över integrationsvarianter
Innan du påbörjar integrationen bör du skaffa dig en överblick över de olika integrationsvarianter som finns tillgängliga. Dessa varianter beskrivs i följande artikel: Översikt över skattehantering med RetailForce – RetailForce Software GmbH (=översiktsartikel).
Källorna från vilka du kan ladda ner RetailForce Middleware i de olika varianterna finns också i den länkade artikeln.
När du har laddat ner Fiscal Middleware ska du genomföra installationen. En beskrivning av hur de olika varianterna installeras finns i översiktsartikeln.
1.1.1 Online vs. offline
RetailForce Middleware är i grunden ett fristående programvarusystem. Vissa funktioner är dock endast tillgängliga när middleware är anslutet till RetailForce Cloud.
RetailForce Cloud erbjuder olika hanteringsfunktioner, såsom automatisk fjärrkonfiguration av middleware, inklusive tilldelning av licenser, samt säkra funktioner för långsiktig arkivering.
För att kunna använda funktionerna i RetailForce Cloud måste Fiscal Middleware eller den specifika klienten inom installationen (klient = enskild instans av det elektroniska registreringssystemet) vara ansluten till en terminal i RetailForce Cloud.
Om middleware ska användas utan att en Cloud-anslutning upprättas (offlinesystem) kan följande steg hoppas över. Fortsätt med punkt 1.5.
1.2 Åtkomst till RetailForce portalen
Alla funktioner i RetailForce Cloud tillhandahålls via
- RetailForce Cloud Portal (https://portal.retailforce.cloud) samt via
- Cloud API (https://api.retailforce.cloud/swagger)
Av säkerhetsskäl är det inte möjligt att registrera sig själv i RetailForce-portalen. För att få tillgång till portalen måste du få en inbjudningslänk från en redan auktoriserad användare. Den efterföljande registreringsprocessen beskrivs i följande artikel: Registrering i RetailForce portal – RetailForce Software GmbH.
1.3 Organisationsstruktur
En organisationsstruktur måste först skapas i portalen. Artikeln Skapa organisationsstruktur i RetailForce Cloud – RetailForce Software GmbH ger en översikt över vilka funktioner som finns tillgängliga för detta ändamål.
1.4 Konfiguration
När organisationsstrukturen är klar och minst en organisation (=kund), en butik (=filial) och en terminal (=kassa) har skapats måste ett konfigurationsobjekt förberedas i Clouden och tilldelas en enhet (organisation, företag, butik eller terminal). En beskrivning av denna process finns under: Allmän information om konfiguration – RetailForce Software GmbH.
1.5 Initialisering
Om de föregående stegen har genomförts framgångsrikt kan Fiscal Middleware tas i drift. De steg som krävs för driftsättning (med och utan upprättande av molnanslutning) förklaras mer detaljerat i artikeln Initialisering (allmänt) – RetailForce Software GmbH.
Som ett resultat av driftsättnings-/initialiseringsprocessen bör Fiscal Client
- vara fullständigt konfigurerad,
- antingen via ett konfigurationsobjekt som förberetts i Cloud, eller
- ”manuellt” av det elektroniska bokföringssystemet,
- och ha ett unikt klient-ID.
2. Integration
Efter att driftsättningen av en client (”kassasystem”) har slutförts framgångsrikt kan integrationen påbörjas.
Detta avsnitt innehåller vägledning om dokumentöverföringsprocessen mellan kassan (det elektroniska registreringssystemet) och den specifika klienten.
2.1 REST-webbtjänst
Följande artikel hjälper dig att komma igång med integrationen av REST-webbtjänstgränssnittet, som används för
- Windows-tjänsten såväl som
- Docker-containern.
Första stegen med skattetjänsten – RetailForce Software GmbH
2.2 NuGet-implementering
Hjälp för nuget-implementeringen (DLL) av middleware finns i följande artikel: Första stegen i nuget-implementeringen – RetailForce Software GmbH.
2.3 Filsystemgränssnitt
Utöver de två ovan nämnda implementeringsvarianterna, REST-webbtjänst och nuget, kan middlewaren även nås via ett filgränssnitt. Mer information om detta finns i artikeln: Filsystemgränssnitt – RetailForce Software GmbH.
2.4 Process för dokumentöverföring
Efter att Fiscal middleware, i form av en Windows-tjänst, har installerats på en dator. Api-beskrivningen kan nås via http://localhost:7678/swagger/index.html.
Vid installation på en fjärrdator (t.ex. i ett LAN) ska du använda IP-adressen till det system där middleware har installerats istället för ”localhost”.
Alla slutpunkter för middleware beskrivs i swagger. För överföring av dokument (t.ex. kontantkvitton) är slutpunkterna i avsnittet ”Transaktioner” viktiga.
Dokumentöverföring sker alltid i två steg och inleds med
- ”createDocument” och avslutas med antingen
- ”storeDocument” eller med ”cancelDocument”, om dokumentet ska annulleras.
Dokumentöverföringsprocessen förklaras i detalj här: Grundläggande dokumentöverföringsprocess – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
RetailForce tillhandahåller ett exempelprogram, Fiscal Service Client Sample. Detta ger vägledning om hur man skapar den JSON-struktur i vilken dokument skickas till Fiscal Service.
Fiscal Service Client Sample kan användas för att generera exempel på olika dokumenttyper och affärsscenarier.
En beskrivning av programmet finns på: Fiscal Service Client Sample – RetailForce Software GmbH.
Du kan också hitta exempel på olika dokument och affärsscenarier i Solution Center på: Affärstransaktioner – RetailForce Software GmbH.
2.6 Lista över slutpunkter
Därefter beskrivs de slutpunkter som under alla omständigheter bör implementeras.
| Endpunkt | Beskrivning |
| PUT /api/va/management/clients | endast nödvändigt om klientkonfigurationen ska göras från POS-programvaran och inte från molnsystemet. Alternativ: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | nödvändigt om klientkonfigurationen ska göras från Cloud-systemet. Alternativ: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | upprättar en clients molnanslutning. Måste göras efter varje omstart av datorn (systemet). De uppgifter som krävs för att upprätta molnanslutningen (API-nyckel och API Secret) måste lagras av det elektroniska registreringssystemet. |
| POST /api/v1/management/clients/initialize | Initierar klienten eller eventuell nödvändig skattehårdvara (teknisk säkerhetsenhet, signaturgenerator, skrivare etc.). Ett startdokument krävs för initieringen. Detta kan genereras antingen av det elektroniska registreringssystemet eller automatiskt via middleware med slutpunkten GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Rekommenderas. Skapar ett så kallat startdokument för den specifika clienten, för initialisering. |
| PUT /api/v1/transactions/createDocument | Denna metod skapar inte ett dokument i sig, utan startar endast processen, till exempel på TSE (Technical Security Device) i Tyskland. (Krävs i alla länder!) |
| POST /api/v1/transactions/storeDocument | Sparar respektive dokument |
| POST /api/v1/transactions/cancelDocument | Avbryter ett dokument på fiscaliseringsenheten. |
Den här artikeln har översatts automatiskt.
Kommentarer
0 kommentarer
logga in för att lämna en kommentar.