RetailForce dezvoltă software pentru a respecta reglementările privind fiscalizarea sistemelor de înregistrare electronică din diferite țări. Acest software se numește „Fiscal Middleware”.
Acest document oferă o prezentare generală a modului de integrare a RetailForce Middleware. Arhitectura sistemului din amonte care trimite și primește date de la RetailForce Middleware, precum și cerințele și funcțiile speciale ale acestui sistem, pot face necesară abaterea de la această descriere.
1. Noțiuni de bază
În continuare sunt enumerate pașii individuali care trebuie parcurși înainte de a începe integrarea. Acești pași sunt, de asemenea, discutați în detaliu în cadrul sesiunii de inițiere.
1.1 Prezentare generală a variantelor de integrare
Înainte de a începe integrarea, familiarizați-vă cu diferitele variante de integrare disponibile. Aceste variante sunt descrise în articolul următor: Prezentare generală a fiscalizării cu RetailForce – RetailForce Software GmbH (= articol de prezentare generală).
Sursele de unde puteți descărca RetailForce Middleware în diferitele variante se găsesc, de asemenea, în articolul menționat.
După ce ați descărcat Fiscal Middleware, efectuați instalarea. O descriere a modului de instalare a diferitelor variante poate fi găsită în articolul de prezentare generală.
1.1.1 Online vs. Offline
RetailForce Fiscal Middleware este, în esență, un sistem software autonom. Cu toate acestea, diverse funcții sunt disponibile numai atunci când middleware-ul este conectat la RetailForce Cloud.
RetailForce Cloud oferă diverse funcții de gestionare, cum ar fi configurarea automată de la distanță a middleware-ului, inclusiv alocarea licențelor, precum și funcții de arhivare securizată pe termen lung.
Pentru a utiliza funcțiile RetailForce Cloud, middleware-ul fiscal sau clientul specific din cadrul instalării (client = o singură instanță a sistemului de înregistrare electronică) trebuie să fie conectat la un terminal din RetailForce Cloud.
Dacă middleware-ul urmează să fie utilizat fără a se stabili o conexiune la Cloud (sistem offline), pașii următori pot fi omisi. Continuați cu punctul 1.5.
1.2 Acces la RetailForce portal
Toate funcțiile RetailForce Cloud sunt disponibile prin intermediul
- RetailForce Cloud Portal (https://portal.retailforce.cloud), precum și prin intermediul
- Cloud API (https://api.retailforce.cloud/swagger)
Autoregistrarea în RetailForce portal nu este posibilă din motive de securitate. Pentru a obține acces la portal, trebuie să primiți un link de invitație de la un utilizator deja autorizat. Procesul de înregistrare ulterior este descris în următorul articol: Înregistrarea în RetailForce portal – RetailForce Software GmbH.
1.3 Structura organizațională
Mai întâi trebuie creată o structură organizațională în portal. Articolul Crearea structurii organizaționale în RetailForce Cloud – RetailForce Software GmbH oferă o prezentare generală a funcțiilor disponibile în acest scop.
1.4 Configurare
După crearea structurii organizaționale, a cel puțin unei organizații (= client), a unui magazin (= sucursală) și a unui terminal (= casă de marcat), trebuie pregătit un obiect de configurare în Cloud și atribuit unei entități (organizație, companie, magazin sau terminal). Puteți găsi o descriere a acestui proces la: Informații generale privind configurarea – RetailForce Software GmbH.
1.5 Inițializare
Dacă pașii anteriori au fost parcurși cu succes, Fiscal Middleware poate fi pus în funcțiune. Pașii necesari pentru punerea în funcțiune (cu și fără stabilirea conexiunii la Cloud) sunt explicați mai detaliat în articolul Inițializare (general) – RetailForce Software GmbH.
Ca urmare a procesului de punere în funcțiune/inițializare, Fiscal Client ar trebui
- să fie complet configurat,
- fie printr-un obiect de configurare pregătit în Cloud, fie
- „manual” de către sistemul de înregistrare electronică,
- și să aibă un ID unic de client.
2. Integrare
După finalizarea cu succes a punerii în funcțiune a unui client („casă de marcat”), se poate începe integrarea.
Această secțiune oferă îndrumări privind procesul de transfer al documentelor între casa de marcat (sistemul de înregistrare electronică) și clientul respectiv.
2.1 Serviciul web REST
Articolul următor vă ajută să începeți integrarea interfeței serviciului web REST, care este utilizată atât pentru
- serviciul Windows, precum și
- containerul Docker.
Primii pași cu serviciul fiscal – RetailForce Software GmbH
2.2 Implementarea NuGet
Ajutorul pentru implementarea middleware-ului prin nuget (DLL) este furnizat în următorul articol: Primii pași în implementarea prin nuget – RetailForce Software GmbH.
2.3 Interfața sistemului de fișiere
Pe lângă cele două variante de implementare menționate mai sus, serviciul web REST și nuget, middleware-ul poate fi accesat și printr-o interfață de fișiere. Puteți găsi mai multe informații despre acest lucru în articolul: Interfața sistemului de fișiere – RetailForce Software GmbH.
2.4 Procesul de transmitere a documentelor
După ce middleware-ul fiscal, sub forma unui serviciu Windows, a fost instalat pe un computer, descrierea api-ului poate fi accesată la adresa http://localhost:7678/swagger/index.html.
În cazul instalării pe un computer la distanță (de exemplu, LAN), utilizați adresa IP a sistemului pe care a fost instalat middleware-ul în locul „localhost”.
Toate punctele finale ale middleware-ului sunt descrise în swagger. Pentru transmiterea documentelor (de exemplu, bonuri de casă) sunt importante punctele finale din secțiunea „Tranzacții”.
Transmiterea documentelor este întotdeauna un proces în două etape, care începe cu
- „createDocument” și se încheie fie cu
- „storeDocument”, fie cu „cancelDocument”, în cazul anulării documentului.
Procesul de transmitere a documentelor este explicat în detaliu aici: Procesul de bază al transferului de documente – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
RetailForce pune la dispoziție un program de exemplu, numit „Fiscal Service Client Sample”. Acesta oferă îndrumări privind modul de creare a structurii JSON în care documentele sunt trimise către Serviciul Fiscal.
Fiscal Service Client Sample poate fi utilizat pentru a genera exemple de diferite tipuri de documente și cazuri de afaceri.
O descriere a programului poate fi găsită la: Fiscal Service Client Sample – RetailForce Software GmbH.
De asemenea, puteți găsi exemple de documente și cazuri de afaceri diferite în Centrul de soluții la: Tranzacții comerciale – RetailForce Software GmbH.
2.6 Lista punctelor finale
În continuare, sunt descrise punctele finale care trebuie implementate în orice caz.
| Punct de capăt | Descriere |
| PUT /api/va/management/clients | necesar numai dacă configurarea clientului se realizează din software-ul POS și nu din sistemul Cloud. Alternativă: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | necesar dacă configurarea clientului se face din sistemul cloud. Alternativă: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | stabilește conexiunea la cloud a unui client. Trebuie efectuată după fiecare repornire a computerului (sistemului). Datele necesare pentru stabilirea conexiunii la cloud (cheia API și API Secret) trebuie stocate de sistemul de înregistrare electronică. |
| POST /api/v1/management/clients/initialize | Inițializează clientul sau orice echipament fiscal necesar (dispozitiv tehnic de securitate, unitate de creare a semnăturii, imprimantă etc.). Pentru inițializare este necesar un document de pornire. Acesta poate fi generat fie de sistemul de înregistrare electronică, fie automat prin intermediul middleware-ului, utilizând punctul final GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Recomandat. Creează un așa-numit document de pornire pentru clientul specific, în vederea inițializării. |
| PUT /api/v1/transactions/createDocument | Această metodă nu creează un document în sine, ci doar inițiază procesul, de exemplu pe TSE (Dispozitivul Tehnic de Securitate) din Germania. (Obligatoriu în fiecare țară!) |
| POST /api/v1/transactions/storeDocument | Salvează documentul respectiv |
| POST /api/v1/transactions/cancelDocument | Anulează un document în unitatea de fiscalizare. |
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.