RetailForce udvikler software til at overholde lovgivningen vedrørende fiskalisering af elektroniske registreringssystemer i forskellige lande. Denne software kaldes »Fiscal Middleware«.
Dette dokument giver et overblik over, hvordan man integrerer RetailForce Fiscal Middleware. Systemarkitekturen i det opstrøms system, der sender data til og modtager data fra Fiscal Middleware, samt særlige krav og funktioner i dette system, kan gøre det nødvendigt at afvige fra denne beskrivelse.
1. Grundlæggende
I det følgende er der angivet de enkelte trin, der skal udføres, inden du påbegynder integrationen. Disse trin gennemgås også i detaljer under onboarding-sessionen.
1.1 Oversigt over integrationsvarianter
Inden du påbegynder integrationen, bør du danne dig et overblik over de forskellige integrationsvarianter, der er tilgængelige. Disse varianter er beskrevet i følgende artikel: Oversigt over fiscalisation med RetailForce – RetailForce Software GmbH (=oversigtsartikel).
De kilder, hvorfra du kan downloade RetailForce Middleware i de forskellige varianter, findes også i den linkede artikel.
Når du har downloadet Fiscal Middleware, skal du udføre installationen. En beskrivelse af, hvordan de forskellige varianter installeres, findes i oversigtsartiklen.
1.1.1 Online vs. offline
RetailForce Fiscal Middleware er grundlæggende et selvstændigt softwaresystem. Visse funktioner er dog kun tilgængelige, når middlewaren er forbundet til RetailForce Cloud.
RetailForce Cloud tilbyder forskellige administrationsfunktioner, såsom automatisk fjernkonfiguration af middlewaren, herunder tildeling af licenser, samt sikre funktioner til langtidsarkivering.
For at kunne benytte funktionerne i RetailForce Cloud skal Fiscal Middleware eller den specifikke klient i installationen (klient = enkeltinstans af det elektroniske registreringssystem) være forbundet til en terminal i RetailForce Cloud.
Hvis middlewaren skal drives uden at oprette en Cloud-forbindelse (offline-system), kan følgende trin springes over. Fortsæt med punkt 1.5.
1.2 Adgang til RetailForce portalen
Alle funktioner i RetailForce Cloud stilles til rådighed via
- RetailForce Cloud Portal (https://portal.retailforce.cloud) samt via
- Cloud API (https://api.retailforce.cloud/swagger)
Selvregistrering i RetailForce portalen er ikke mulig af sikkerhedsmæssige årsager. For at få adgang til portalen skal du modtage et invitationslink fra en allerede autoriseret bruger. Den efterfølgende registreringsproces er beskrevet i følgende artikel: Registrering i RetailForce portalen – RetailForce Software GmbH.
1.3 Organisationsstruktur
Der skal først oprettes en organisationsstruktur i portalen. Artiklen Oprettelse af organisationsstruktur i RetailForce Cloud – RetailForce Software GmbH giver et overblik over, hvilke funktioner der er til rådighed til dette formål.
1.4 Konfiguration
Når organisationsstrukturen er oprettet, og der er oprettet mindst én organisation (=kunde), én butik (=filial) og én terminal (=kasse), skal der oprettes et konfigurationsobjekt i Clouden og tildeles en enhed (organisation, virksomhed, butik eller terminal). Du kan finde en beskrivelse af denne proces under: Generelle oplysninger om konfiguration – RetailForce Software GmbH.
1.5 Initialisering
Hvis de foregående trin er gennemført med succes, kan Fiscal Middleware tages i brug. De trin, der kræves for idriftsættelse (med og uden oprettelse af cloud-forbindelsen), forklares mere detaljeret i artiklen Initialisering (generelt) – RetailForce Software GmbH.
Som resultat af idriftsættelses-/initialiseringsprocessen bør Fiscal Client
- være fuldt konfigureret,
- enten via et konfigurationsobjekt, der er forberedt i Clouden, eller
- »manuelt« af det elektroniske registreringssystem,
- og have et et unikt client-ID.
2. Integration
Når idriftsættelsen af en client („kasseapparat“) er gennemført, kan integrationen påbegyndes.
Dette afsnit indeholder vejledning om dokumentoverførselsprocessen mellem kasseapparatet (det elektroniske registreringssystem) og den pågældende client.
2.1 REST-webservice
Følgende artikel hjælper med at komme i gang med integrationen af REST-webservice-grænsefladen, som bruges til
- både Windows-tjenesten og
- Docker-containeren.
Første skridt med den skattepligtige tjeneste – RetailForce Software GmbH
2.2 NuGet-implementering
Hjælp til nuget-implementeringen (DLL) af middlewaren findes i følgende artikel: Første skridt i nuget-implementeringen – RetailForce Software GmbH.
2.3 Filsystemgrænseflade
Ud over de to ovennævnte implementeringsvarianter, REST-webservice og nuget, kan middlewaren også tilgås via en filgrænseflade. Du kan finde mere information herom i artiklen: Filsystemgrænseflade – RetailForce Software GmbH.
2.4 Dokumentoverførselsproces
Når Fiscal Middleware – i form af en Windows-tjeneste – er installeret på en computer, kan api-beskrivelsen tilgås via http://localhost:7678/swagger/index.html.
Ved installation på en fjerncomputer (f.eks. LAN) skal du bruge IP-adressen på det system, hvor middlewaren er installeret, i stedet for "localhost".
Alle middleware-endpoints er beskrevet i swagger. Endpoints i afsnittet »Transactions« er vigtige for overførsel af dokumenter (f.eks. kassebilag).
Dokumentoverførsel foregår altid i to trin, som indledes med
- "createDocument" og afsluttes enten med
- "storeDocument" eller med "cancelDocument", hvis dokumentet annulleres.
Dokumentoverførselsprocessen forklares detaljeret her: Grundlæggende dokumentoverførselsproces – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
RetailForce stiller et eksempelprogram til rådighed, nemlig Fiscal Service Client Sample. Dette giver vejledning i, hvordan man opretter den JSON-struktur, hvori dokumenter sendes til Fiscal Service.
Fiscal Service Client Sample kan bruges til at generere eksempler på forskellige dokumenttyper og forretningsscenarier.
En beskrivelse af programmet findes her: Fiscal Service Client Sample – RetailForce Software GmbH.
Du kan også finde eksempler på forskellige dokumenter og forretningsscenarier i Solution Center under: Forretningstransaktioner – RetailForce Software GmbH.
2.6 Liste over slutpunkter
Herefter beskrives de endpoints, der under alle omstændigheder skal implementeres.
| Endepunkt | Beskrivelse |
| PUT /api/va/management/clients | kun nødvendigt, hvis klientkonfigurationen skal foretages fra POS-softwaren og ikke fra cloud-systemet. Alternativ: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | nødvendigt, hvis klientkonfigurationen skal foretages fra Cloud-systemet. Alternativ: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | opretter en clients cloud-forbindelse. Skal udføres efter hver genstart af computeren (systemet). De data, der kræves for at oprette cloud-forbindelsen (API-nøgle og API Secret), skal gemmes af det elektroniske registreringssystem. |
| POST /api/v1/management/clients/initialize | Initialiserer klienten eller eventuel nødvendig skattehardware (teknisk sikkerhedsenhed, signaturgenerator, printer osv.). Der kræves et startdokument til initialiseringen. Dette kan genereres enten af det elektroniske registreringssystem eller automatisk via middlewaren med endpointet GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Anbefales. Opretter et såkaldt startdokument til den specifikke client med henblik på initialisering. |
| PUT /api/v1/transactions/createDocument | Denne metode opretter ikke selve dokumentet, men starter blot processen, f.eks. på TSE (Technical Security Device) i Tyskland. (Påkrævet i alle lande!) |
| POST /api/v1/transactions/storeDocument | Gemmer det pågældende dokument |
| POST /api/v1/transactions/cancelDocument | Annullerer et dokument på fiskaliseringsenheden. |
Denne artikel er oversat automatisk.
Kommentarer
0 kommentarer
Log ind for at kommentere.