Prezentare generală a pașilor necesari pentru punerea în funcțiune a unui client:

1. Crearea structurii organizaționale
2. Configurare
3. Stabilirea conexiunii la Cloud
4. Inițializarea clientului

1. Crearea structurii organizaționale

Ca prim pas către punerea în funcțiune, structura organizațională a companiei care operează casa de marcat trebuie creată mai întâi în RetailForce Cloud. Puteți găsi detalii despre acest lucru în articolul la care face referire linkul.

Acest pas poate fi omis în cazul sistemelor care ar trebui să funcționeze complet offline și care nu stabilesc niciodată o conexiune la RetailForce Cloud.

2. Configurare

Configurarea unui client de middleware se poate realiza, în principiu, în două moduri diferite (în funcție de setările și acordurile stabilite de producătorul software-ului casei de marcat și de compania care operează casa de marcat):

1. Configurarea prin RetailForce Cloud sau, alternativ
2. Configurarea prin intermediul software-ului POS (sistem de casă de marcat, sistem de înregistrare electronică)

1. Configurare prin RetailForce Cloud

În această variantă, clientul descarcă local un obiect de configurare pregătit în RetailForce Cloud. Aceasta poate fi considerată o configurare automată. Crearea obiectelor de configurare este descrisă în articolul la care se face referire.

Atunci când se configurează o unitate fiscală prin intermediul Cloud-ului, toate datele necesare sistemului sunt deja configurate în Cloud (instrucțiuni și informații generale privind crearea unei configurații). Aceste date sunt încărcate din Cloud printr-un apel din partea clientului fiscal (CreateClientByCloud).

Parametrii apelului sunt:

• Identificarea companiei (companyIdentification), de obicei numărul de identificare TVA (VatNumber). În funcție de țara de impozitare, poate fi necesar să se introducă alte caracteristici de identificare, alternativ sau suplimentar (!). Cu toate acestea, pentru început se recomandă utilizarea numărului de identificare TVA.
• Numărul magazinului / sucursalei
• Numărul casei de marcat
• cloudApiKey
• cloudApiSecret

Dacă funcția PUT api/v1/management/clients/byCloud se execută fără erori, configurarea clientului fiscal este finalizată. Guid-ul modulului fiscal (=clientId) este transmis ca valoare de returnare.

2. Configurare prin intermediul software-ului POS

Ca alternativă la configurarea automată a clientului prin RetailForce Cloud system, obiectul de configurare poate fi pregătit și de software-ul POS. Acest tip de configurare este utilizat pentru sistemele care nu au o conexiune la RetailForce Cloud. Pentru aceasta se utilizează punctul final PUT /api/v1/management/clients.

La configurarea software-ului casei de marcat, există două modalități de a porni corect modulul:

1. Modul fără conexiune la Cloud, cu stocare și export local al datelor
2. Modul cu conexiune la Cloud, cu stocare și export de date locale și în Cloud

În orice caz, este necesar ca parametrii de configurare necesari să fie setați corect, conform documentației.

Varianta 2 (cu conexiune la Cloud) poate fi activată și ulterior, adică este posibil să se creeze o configurație fiscală fără conexiune la Cloud și apoi să se sincronizeze cu Cloud-ul.

Trebuie menționat că crearea unui client în cloud trebuie să fie activată de către producătorul software-ului POS și/sau de către organizație în setările cloud. Metoda standard este aceea de a crea mai întâi un obiect de configurare în cloud.

3. Stabilirea conexiunii la Cloud

Următorul pas este conectarea clientului la RetailForce Cloud (pentru sistemele offline, fără conexiune la cloud, acest pas poate fi omis). Acest lucru se realizează prin intermediul funcției:

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

Parametrii pentru apel:

• clientId – ID-ul unic al clientului (Guid) a fost returnat casei de marcat la configurarea prin RetailForce Cloud.
• cloudApiKey
• cloudApiSecret

4. Inițializarea clientului

Prin apelarea funcției InitializeClient (POST /api/v1/management/clients/initialize), cu parametrul (document de pornire), se apelează rutina de inițializare a țării respective, iar în acest proces sunt inițializate și componentele de securitate (dacă este necesar).
Pentru aspecte specifice țării și/sau hardware-ului, vă rugăm să consultați documentația relevantă.

Documentul de început poate fi solicitat de la serviciu prin executarea funcției:

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

Dacă FiscalClient este utilizat fără fiscalizare (NoFiscalisation), de exemplu dacă către client sunt transmise doar chitanțe digitale sau date de arhivă, inițializarea nu este necesară.

• Apelarea funcției de inițializare (InitializeClient - POST /api/v1/management/clients/initialize)

Inițializarea unității fiscale se efectuează apoi prin apelul InitializeClient.

Un NullReceipt este transmis funcției InitializeClient; un exemplu poate fi găsit mai jos:

{
    "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": {}
}

Procesul de inițializare este, în principiu, specific fiecărei țări, dar apelul rămâne același pentru toate țările. Pentru detalii privind inițializările specifice fiecărei țări, vă rugăm să consultați documentația corespunzătoare fiecărei țări.

Prezentare generală a punerii în funcțiune

Următoarele funcții sunt apelate în ordinea prezentată pentru punerea în funcțiune a unui client:

Articole conexe

Inițializare Germania

Gestionarea erorilor

Eroare: GetConfiguration pentru clientul <CLIENTID> nu a fost găsit

Acest articol a fost tradus automat.