indică țara corespunzătoare.

Dacă se interoghează fiscalCountryProperties prin GET /api/v1/information/client/{clientId}/countryProperties, se specifică țara atribuită clientului respectiv.

Specifică dacă certificarea unei componente de fiscalizare este necesară într-o țară sau ce anume trebuie certificat.

„mandatory” – Certificarea sistemului din amonte (de exemplu, casa de marcat) este obligatorie. În acest caz, casa de marcat trebuie să treacă printr-un proces de certificare sau de aprobare.

„miniPOS” – Certificarea este obligatorie, dar este îndeplinită de o componentă deja certificată care poate fi integrată în RetailForce Middleware.

„notNecessary” – Nu este necesară certificarea sistemului anterior.

„true” – în țara respectivă, datele trebuie transmise rând cu rând, de exemplu, către o imprimantă fiscală.

• în prezent nu este acceptat

„false” – Interfață bazată pe documente (fără imprimare rând cu rând).

• Implementarea între sistemul din amonte și Serviciul de fiscalizare se bazează pe puncte finale api standard.

Specifică tipul de fiscalizare.

„fiscalPrinter” – Fiscalizarea se bazează pe o imprimantă fiscală certificată sau pe un sistem de casă de marcat fiscală certificată.

• Aceasta înseamnă că, pe lângă RetailForce system, este necesară o imprimantă fiscală. Este posibil ca aceasta să trebuiască achiziționată de la un furnizor local.

„online” – Fiscalizarea se realizează prin intermediul sistemelor online ale autorităților fiscale locale.

• Nu este necesară nicio componentă hardware suplimentară.

„signature” – Fiscalizarea se realizează prin semnarea datelor de pe chitanță folosind un certificat digital stocat în serviciul de fiscalizare.

• În unele țări, poate fi necesară obținerea unui certificat digital calificat furnizat de o autoritate de certificare (CA).

„signatureWithOnline” – Fiscalizare prin crearea de semnături și transmiterea datelor online către autoritățile fiscale.

• Combinația celor două tipuri menționate anterior.

Specifică ce mediu este acceptat:

„local” – instalarea locală a middleware-ului fiscal (local pe sistemul POS, pe serverul magazinului etc.)

• Se pot efectua apeluri api către serviciul de fiscalizare instalat local:
  • http://localhost:7678/ în cazul implementării REST, sau
  • apel de metodă în cazul implementării nuget.

„cloud” – middleware-ul fiscal este disponibil ca serviciu cloud găzduit la https://fiscalisation.retailforce.cloud/.

• Se pot efectua apeluri API către Serviciul de fiscalizare în cloud.

Specifică ce sisteme de operare/platforme sunt acceptate.

„linux”

• prin container Docker (implementare REST)

„windows”

• prin serviciul Windows (implementare REST) sau
• prin implementare nuget

„ios”

• prin implementarea nuget

„android”

• prin implementarea nuget, sau
• Serviciu Android (implementare REST)

Specifică cerințele legale acceptate și versiunile acestora.

De exemplu, pentru Grecia: „myDATA v1.x.x”

Tipurile de documente care trebuie „fiscalizate” în țara respectivă. De exemplu, acestea trebuie procesate de componenta hardware prescrisă, semnate etc.

„documentTypes” enumerate sub „fiscalDocumentTypes” sunt procesate automat (de exemplu, semnate) în țara respectivă de către serviciul de fiscalizare, în conformitate cu legislația privind fiscalizarea.

Aceste tipuri de documente TREBUIE transmise serviciului de fiscalizare din țara respectivă, cu condiția ca sistemul din amonte („casă de marcat”) să le accepte.

Lista tipurilor de documente acceptate în fiecare țară.

Pe lângă „fiscalDocumentTypes”, tipurile de documente enumerate la „supportedDocumentTypes” POT fi transmise serviciului de fiscalizare.

Aceste tipuri de documente sunt așa-numitele documente „nefiscale”, adică cele care nu sunt „fiscalizate” (de exemplu, semnate).

Lista tipurilor de documente care nu sunt acceptate în țara respectivă.

„DocumentTypes” enumerate la „notSupportedDocumentTypes” nu pot fi transmise către serviciul de fiscalizare din țara respectivă.

Motivele pot fi imposibilitatea tehnică sau reglementările/legile specifice țării respective.

Dacă un „notSupportedDocumentType” este trimis către serviciul de fiscalizare, acesta va răspunde cu un mesaj de eroare („documentType not supported!”).

Sistemul din amonte nu ar trebui să permită aceste tipuri de documente în țara respectivă.

Lista metodelor de plată acceptate în țara respectivă.

Aceste metode de plată pot fi utilizate în țara respectivă.

Sistemul din amonte ar trebui să ofere utilizatorului casei de marcat numai metodele de plată acceptate în țara respectivă.

Lista metodelor de plată care nu sunt acceptate (sau nu sunt permise) în țara respectivă.

Sistemul din amonte ar trebui să suprime metodele de plată care nu sunt acceptate în țara respectivă.

Lista metodelor de plată (PaymentTypes) pentru care nu este permisă plata unei sume mai mari decât cea datorată în țara respectivă.

Exemple:

Totalul bonului = 38,50 EUR

• Clientul plătește 50 EUR cu cardul de debit, deoarece dorește restul în numerar.
• Clientul plătește 50 EUR în numerar și primește 11,50 EUR rest (restul dat).

Aceste tranzacții nu sunt permise în unele țări (adică nu pot fi transmise către sistemul de fiscalizare).

Aceasta înseamnă că sumele de plată („payment.amount”) trebuie să corespundă întotdeauna cu valoarea brută a articolelor („GrossValue” a tuturor „pozițiilor”) și nu pot fi transferate sume de plată negative.

Lista tipurilor de cazuri de afaceri acceptate în fiecare țară.

Aceste cazuri de afaceri pot fi utilizate în țara respectivă, spre deosebire de notSupportedBusinessTransactionTypes.

Lista tipurilor de cazuri de afaceri care nu sunt acceptate (sau nu sunt permise) în țara respectivă.

Aceste cazuri de afaceri nu pot fi utilizate în țara respectivă și ar trebui să fie eliminate de sistemul sursă și să nu fie transmise serviciului de fiscalizare.

Informații detaliate privind cotele de Vat acceptate în fiecare țară.

Acest tablou conține următoarele informații:

• Cota de TVA: „VatPercent” / „VatPercent2”
• ID-ul intern utilizat pentru a corela rata respectivă de TVA: „VatIdentification”
• Denumirea cotei de Vat: „caption” / „caption_EN”
• Cote de Vat istorice cu detalii privind valabilitatea („ValidFrom” – „ValidTo”)

„nu este obligatoriu” – Afișarea clientului nu este necesară (nu există obligație).

„obligatoriu (fără RF)” – Afișarea clientului este obligatorie, dar nu este controlată prin intermediul RetailForce Middleware. Controlul se efectuează automat de către sistemul de fiscalizare respectiv (de exemplu, automat de către imprimanta fiscală).

„obligatoriu (RF)” – Este obligatorie utilizarea afișajului pentru client și acesta este controlat prin intermediul RetailForce Middleware.

• Afișajul pentru client este controlat prin intermediul funcției: POST /api/v1/transactions/display/{clientId}

„nu este permis” – Utilizarea unui afișaj pentru client este interzisă în această țară.

Specifică dacă dispozitivele de intrare trebuie înregistrate în țara respectivă („true” / „false”).

Dispozitivele de introducere a datelor nu sunt sisteme de înregistrare autonome. Pentru mai multe informații, consultați: Arhitecturi ale sistemelor electronice de înregistrare (EAS)

„true” – în țara respectivă există obligația de a ține un jurnal tehnic (jurnal de audit) (în acest caz inclus în licența RF).

• În acest caz, înregistrările evenimentelor tehnice trebuie trimise serviciului de fiscalizare prin intermediul
  • POST /api/v1/transactions/AuditLog , sau
  • POST /api/v1/transactions/storeDocument („documentType”: „[1002] = AuditLog”)

„false” – nu există obligația de a ține un jurnal tehnic (nu este inclus în licență).

• Evenimentele tehnice POT fi înregistrate, dar nu este obligatoriu.

„true” – în țara respectivă, reimprimarea unui document trebuie înregistrată în mod obligatoriu.

• Apelarea uneia dintre următoarele:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, sau

  • PUT /api/v1/transactions/reprintDocument

    obligatoriu.

„false” – Reimprimarea unui document nu trebuie înregistrată ca fiind obligatorie.

„terminal” – Un document poate fi reimprimat numai la aceeași casă de marcat la care a fost emis documentul original.

„magazin” – Reimprimările unui document pot fi efectuate numai în cadrul aceleiași sucursale/aceluiași magazin în care a fost emis și documentul original.

• Funcția de reimprimare în mai multe sucursale trebuie implementată de sistemul din amonte.

„all” – Reimprimarea unui document se poate efectua atât pe o altă casă de marcat, cât și într-o altă sucursală/magazin al aceleiași companii.

• Funcția de reimprimare între mai multe sucursale trebuie implementată de sistemul din amonte.

„true” – o închidere zilnică (raport Z) trebuie generată o dată pe zi.

• închidere zilnică
  • POST /api/v1/transactions/storeDocument
  • „documentType”: „[99] = EndOfDay”

„false” – nu este necesară o închidere zilnică.

Indică perioada de timp de la deschiderea zilnică a casei de marcat în care trebuie să aibă loc o închidere zilnică (de exemplu, în termen de 24 de ore).

"-1" – nu este setat.

Se specifică dacă vânzările și returnările pot fi înregistrate simultan pe o chitanță (document).

„oneReceiptAllowed” – permis (vânzările și returnările pot fi afișate împreună pe o singură chitanță).

• Vânzări:
  • „poziții” (tip 0 sau 1) cu valori pozitive,
• Retururi:
  • „positions” (tip 0 sau 1) cu valori negative și
  • „documentReference” setat.

„oneReceiptAllowedVat” – atâta timp cât suma Vat rămâne pozitivă, vânzările și returnările pot fi înregistrate pe o singură (aceeași) chitanță.

„multiReceipt” – Vânzările și returnările trebuie înregistrate pe chitanțe diferite.

• Înainte de a transmite datele către serviciul de fiscalizare, sistemul din amonte trebuie să împartă automat vânzările și returnările în tranzacții diferite.

„NoReturnAllowed” – în țara respectivă, procesarea retururilor prin intermediul sistemului de fiscalizare nu este posibilă. În aceste țări, retururile sunt adesea gestionate prin intermediul unor formulare speciale sau similare în departamentul de contabilitate.

Unde pot fi returnate articolele achiziționate?

„terminal” – Articolele pot fi returnate numai la aceeași casă de marcat (emiterea bonului) la care s-a efectuat vânzarea inițială.

„store” – Articolele pot fi returnate numai la aceeași filială/magazin (unde s-a emis bonul) în care s-a efectuat vânzarea inițială.

„all” – Articolele pot fi returnate și la alte sucursale ale aceleiași companii.

Referința documentului pentru retururi

„single” – în cazul returnărilor, se poate face referire doar la UN SINGUR document anterior (documentul de vânzare al serviciilor sau bunurilor returnate).

• „documentReference” este permisă doar pentru un singur document preliminar sau
• referința la nivel de articol („positionReference”) este permisă numai pentru un singur document preliminar.

„multiple” – în cazul retururilor, se pot face referințe la mai multe documente anterioare (mai multe chitanțe de vânzare dacă se returnează mai multe servicii sau bunuri provenite din mai multe achiziții). 

• „documentReference” la mai multe documente anterioare sau
• o referință la documentul anterior corespunzător prin „positionReference” la nivelul fiecărui articol din retur.

Specifică dacă elementul „fiscalDocumentNumber” din „fiscalResponse” al țării corespunzătoare trebuie tipărit pe documente.

• Numerele de document transferate din sistemul din amonte sunt ignorate. Sistemul fiscal (de exemplu, imprimanta) atribuie în mod autonom numărul de document/ID-ul de document respectiv.

„true” – în țara respectivă, sunt permise suprataxele pentru bunuri sau servicii.

• surcharges:
  • „positions.discounts” cu valori NEGATIVE

„false” – Suprataxele de preț nu sunt permise.

Indică dacă modul de instruire/demonstrație al casei de marcat este permis în țara respectivă

„true” – permis.

• Modul de instruire:
  • „IsTraining”: true

„false” – Casa de marcat nu trebuie să dispună de un mod de instruire/demonstrație.

„true” – Suma articolelor individuale se calculează pe baza valorii nete (NetValue) (de exemplu, Québec/Canada).

„false” – Suma articolelor individuale se calculează pe baza valorii brute (GrossValue) (implicit).

„true” – Elementele care au fost introduse, dar care nu sunt incluse ulterior în document, trebuie transmise în payload-ul JSON.

„false” – Articolele care au fost introduse, dar care nu sunt incluse ulterior în document, nu trebuie transmise.

Specifică tipul documentului de început în țara respectivă.

Este relevant numai dacă sistemul din amonte NU utilizează funcția GET /api/v1/transactions/document/{clientId}/start în timpul inițializării și generează el însuși documentul de început respectiv.

Lista tipurilor de plăți acceptate în țara respectivă.

Elementele enumerate la „supportedPayOutTypes” pot/trebuie specificate pentru plăți („documentType”: „[10] = PayOut” și „BusinessTransactionType”: „[10] = PayOut”).

Indică dacă ratele Vat sunt calculate de modulul de fiscalizare corespunzător al țării respective.

„true” – modulul de fiscalizare calculează cotele de Vat.

„false” – casa de marcat trebuie să calculeze cotele de Vat.

Specifică dacă și câte zecimale trebuie incluse în documentul JSON către middleware-ul fiscal la trimiterea sumelor/totalurilor.

Se aplică tuturor specificațiilor de valoare din payload („GrossValue”, „NetValue”, „TaxValue”, „Amount” etc.)