Översikt över de steg som krävs för att ta en client i drift:

1. Skapa organisationsstruktur
2. Konfiguration
3. Upprätta Cloud-anslutning
4. Initialisering av client

1. Skapa organisationsstruktur

Som ett första steg inför driftsättningen måste först organisationsstrukturen för det företag som driver kassasystemet skapas i RetailForce Cloud. Du hittar mer information om detta i den länkade artikeln.

Detta steg kan hoppas över för system som ska fungera helt offline och som aldrig upprättar en anslutning till RetailForce Cloud.

2. Konfiguration

Konfigurationen av en Fiscal middleware-client kan i princip göras på två olika sätt (beroende på inställningar och överenskommelser mellan tillverkaren av kassasystemet och det företag som driver kassasystemet):

1. Konfiguration via RetailForce Cloud, eller alternativt
2. Konfiguration via POS-programvara (kassasystem, elektroniskt registreringssystem)

1. Konfiguration via RetailForce Cloud

I detta fall laddar clienten ner ett konfigurationsobjekt som skapats i RetailForce Cloud till sin dator. Detta kan betraktas som en automatisk konfiguration. Hur man skapar konfigurationsobjekt beskrivs i den länkade artikeln.

Vid konfiguration av en skatteenhet via Cloud finns alla uppgifter som systemet kräver redan konfigurerade i Cloud (instruktioner och allmän information om hur man skapar en konfiguration). Dessa uppgifter hämtas från Cloud genom ett anrop från skatteklienten (CreateClientByCloud).

Parametrarna för anropet är:

• Företagsidentifikation (companyIdentification), vanligtvis momsregistreringsnumret (VatNumber). Beroende på vilket land det gäller kan det vara nödvändigt att ange andra ID-uppgifter som alternativ eller komplement (!). Momsregistreringsnumret rekommenderas dock vid uppstarten.
• Butiks-/filialnummer
• Kassanummer
• cloudApiKey
• cloudApiSecret

Om funktionen PUT api/v1/management/clients/byCloud genomförs utan fel är konfigurationen av skatteklienten klar. Guid för skattemodulen (=clientId) överförs som returvärde.

2. Konfiguration via POS-programvara

Som ett alternativ till automatisk klientkonfiguration via RetailForce Cloud systemet kan konfigurationsobjektet även förberedas av POS-programvaran. Denna typ av konfiguration används för system som inte har en anslutning till RetailForce Cloud. Endpunkten PUT /api/v1/management/clients används för detta.

Vid konfiguration av kassaprogramvaran finns det två sätt att starta modulen korrekt:

1. Modul utan anslutning till Cloud med lokal datalagring och export
2. Modul med Cloud-anslutning med lokal och Cloud-baserad datalagring samt export

I båda fallen är det nödvändigt att de nödvändiga konfigurationsparametrarna ställs in korrekt enligt dokumentationen.

Variant 2 (med Cloud-anslutning) kan även aktiveras i efterhand, dvs. det är möjligt att skapa en skattekonfiguration utan Cloud-anslutning och sedan synkronisera den med Cloud.

Observera att skapandet av en client i Cloud måste aktiveras av POS-programvarutillverkaren och/eller organisationen i Cloud-inställningarna. Det vanliga tillvägagångssättet är att först skapa ett konfigurationsobjekt i Cloud.

3. Upprätta Cloud-anslutning

Nästa steg är att ansluta klienten till RetailForce Cloud (för offlinesystem utan molnanslutning kan detta steg hoppas över). Detta görs via funktionen:

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

Parametrar för anropet:

• clientId – det unika klient-ID:t (Guid) som returnerades till kassan vid konfigurationen via RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Clientinitialisering

Genom att anropa funktionen InitializeClient (POST /api/v1/management/clients/initialize) med parametern (startdokument) anropas initialiseringsrutinen för respektive land, och eventuella säkerhetskomponenter initialiseras också i denna process (om nödvändigt).
För land- och/eller hårdvaruspecifika frågor, se relevant dokumentation.

Startdokumentet kan begäras från tjänsten genom att utföra funktionen:

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

Om FiscalClient används utan fiskalisering (NoFiscalisation), till exempel om endast digitala kvitton eller arkivdata överförs till klienten, är initialisering inte nödvändig.

• Anrop av initialiseringsfunktionen (InitializeClient – POST /api/v1/management/clients/initialize)

Initialiseringen av den skattepliktiga enheten utförs sedan med hjälp av anropet InitializeClient.

Ett NullReceipt skickas till funktionen InitializeClient; ett exempel finns nedan:

{
    "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 är i grunden landsspecifik, men anropet är detsamma för alla länder. För detaljer om de landsspecifika initialiseringarna, se respektive lands dokumentation.

Driftsättning i korthet

Följande funktioner anropas i nedanstående ordning för att driftsätta en client:

Relaterade artiklar

Initialisering Tyskland

Felhantering

Fel: GetConfiguration för klient <CLIENTID> hittades inte

Den här artikeln har översatts automatiskt.