Oversigt over de trin, der kræves for at idriftsætte en client:

1. Oprettelse af organisationsstruktur
2. Konfiguration
3. Etablering af Cloud-forbindelse
4. Initialisering af client

1. Oprettelse af organisationsstruktur

Som et første skridt mod idriftsættelse skal organisationsstrukturen for den virksomhed, der driver kasseapparatet, først oprettes i RetailForce Cloud. Du kan finde detaljer om dette i den linkede artikel.

Dette trin kan springes over for systemer, der skal fungere fuldstændigt offline og på intet tidspunkt opretter forbindelse til RetailForce Cloud.

2. Konfiguration

Konfigurationen af en Fiscal Middleware-client kan grundlæggende udføres på to forskellige måder (afhængigt af de indstillinger og aftaler, der er indgået mellem kasseapparatets softwareproducent og den virksomhed, der driver kasseapparatet):

1. Konfiguration via RetailForce Cloud, eller alternativt
2. Konfiguration via POS-software (kasseapparat, elektronisk registreringssystem)

1. Konfiguration via RetailForce Cloud

I denne variant downloader klienten et konfigurationsobjekt, der er forberedt i RetailForce Cloud, lokalt. Dette kan betragtes som en automatisk konfiguration. Oprettelsen af konfigurationsobjekter er beskrevet i den linkede artikel.

Når en skatteenhed konfigureres via Cloud, er alle de data, som systemet kræver, allerede konfigureret i Cloud (vejledning og generelle oplysninger om oprettelse af en konfiguration). Disse data hentes fra Cloud ved hjælp af et kald fra skatteklienten (CreateClientByCloud).

Parametrene for opkaldet er:

• Virksomhedsidentifikation (companyIdentification), normalt momsnummeret (VatNumber). Afhængigt af skattelandet kan det være nødvendigt at indtaste andre ID-karakteristika som alternativ eller i tillæg (!). Momsnummeret anbefales dog til opstarten.
• Butiks-/filialnummer
• Kasseapparatnummer
• cloudApiKey
• cloudApiSecret

Hvis funktionen PUT api/v1/management/clients/byCloud gennemføres uden fejl, er konfigurationen af skatteklienten afsluttet. Guid'en for skattemodulet (=clientId) overføres som returværdi.

2. Konfiguration via POS-software

Som et alternativ til automatisk klientkonfiguration via RetailForce Cloud systemet kan konfigurationsobjektet også forberedes af POS-softwaren. Denne type konfiguration anvendes til systemer, der ikke har forbindelse til RetailForce Cloud. Endpointet PUT /api/v1/management/clients anvendes til dette.

Ved konfiguration af kassesystemet er der to måder at starte modulet korrekt op på:

1. Modul uden Cloud-forbindelse med lokal datalagring og eksport
2. Modul med cloud-forbindelse med lokal og cloud-datalagring samt eksport

Under alle omstændigheder er det nødvendigt, at de nødvendige konfigurationsparametre indstilles korrekt i henhold til dokumentationen.

Variant 2 (med cloud-forbindelse) kan også aktiveres senere, dvs. det er muligt at oprette en skattekonfiguration uden cloud-forbindelse og derefter synkronisere den med clouden.

Det skal bemærkes, at oprettelsen af en client i Cloud skal aktiveres af POS-softwareproducenten og/eller organisationen i Cloud-indstillingerne. Den standardmæssige fremgangsmåde er først at oprette et konfigurationsobjekt i Cloud.

3. Oprettelse af Cloud-forbindelse

Det næste trin er at forbinde klienten til RetailForce Cloud (for offline-systemer uden cloud-forbindelse kan dette trin springes over). Dette gøres via funktionen:

• POST /api/v1/management/cloud/connect .

Parametre for opkaldet:

• clientId – det unikke klient-ID (Guid), som kasseapparatet modtog, da det blev konfigureret via RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Clientinitialisering

Ved at kalde funktionen InitializeClient (POST /api/v1/management/clients/initialize) med parameteren (startdokument) kaldes initialiseringsrutinen for det pågældende land, og eventuelle sikkerhedskomponenter initialiseres også i denne proces (hvis nødvendigt).
For landespecifikke og/eller hardwarespecifikke emner henvises til den relevante dokumentation.

Startdokumentet kan hentes fra tjenesten ved at udføre funktionen:

• GET /api/v1/transactions/document/{clientId}/start
  (parameter: clientId, optional: BookDate).

Hvis FiscalClient anvendes uden fiskalisering (NoFiscalisation), f.eks. hvis der kun overføres digitale kvitteringer eller arkivdata til klienten, er initialisering ikke nødvendig.

• Kald af initialiseringsfunktionen (InitializeClient – POST /api/v1/management/clients/initialize)

Initialiseringen af den skattemæssige enhed udføres derefter ved hjælp af opkaldet InitializeClient.

Der overføres en NullReceipt til InitializeClient-funktionen; et eksempel findes nedenfor:

{
    "modelVersion": "1.5.2",
    "uniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
    "additionalFields": {},
    "documentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
    "documentId": "1",
    "createDate": "2025-05-02T07:08:17.8334419+02:00",
    "bookDate": "2025-05-02T07:08:17.8335535+02:00",
    "documentNumber": "1",
    "documentType": 1000,
    "documentTypeCaption": "Startbeleg",
    "user": {
        "id": "1",
        "caption": "User 1",
        "firstName": "1",
        "lastName": "User",
        "dateOfEntry": "2025-05-02T07:08:17.833596+02:00"
    },
    "allocationGroups": [],
    "positionCount": 0,
    "fiscalDocumentNumber": 1,            
    "fiscalDocumentRevision": 1,          
    "positions": [],
    "Payments": [],
    "additionalHeader": [],
    "additionalFooter": [],
    "fiscalAdditionalFields": {}
}

Initialiseringsprocessen er grundlæggende landespecifik, men opkaldet forbliver det samme for alle lande. For detaljer om de landespecifikke initialiseringer henvises til den respektive landespecifikke dokumentation.

Idriftsættelse i korte træk

Følgende funktioner kaldes i nedenstående rækkefølge for at idriftsætte en client:

Relaterede artikler

Initialisering i Tyskland

Fejlhåndtering

Fejl: GetConfiguration for klient <CLIENTID> ikke fundet

Denne artikel er oversat automatisk.