Treci de pe FiscalNet sau Fisco, fără schimbări în programul tău.

Ce rămâne la fel

Programul scris pentru driverele vechi merge neschimbat prin patru intrări:

Ce instalezi

1. Aplicația FiscalLink pe același calculator, cu Windows, macOS sau Linux. Folderele merg doar pe desktop.
2. O licență pe casă și dispozitivul autorizat: fără ele, fiecare lucrare e refuzată (LICENSE_REQUIRED, DEVICE_AUTHORIZATION_REQUIRED). Pașii clientului: /app/docs.
3. La o instalare nouă, aplicația pornește singură API-ul Fisco (doar pe acest calculator) și preia sau creează folderul ~/FiscalLink. La o actualizare de la versiunea 2.2.1 le lasă oprite și ți le oferă în setări.
4. Oprește driverul vechi. Dacă găsește un driver concurent pornit (Fisco, FiscoDriver, EcmFiscalNet, FiscalNet, DriverFiscal) sau portul 4040 ocupat, aplicația nu preia nimic și îți spune de ce. Două drivere pe aceeași casă tipăresc aceeași vânzare de două ori.
5. Fișierele care erau deja în folder când îl preia aplicația nu se tipăresc: se mută în Preluate-la-activare.

Folderele

• Un fișier fără linie de plată e refuzat: într-un fișier, o plată lipsă e semnul unei scrieri întrerupte.
• O linie de raport trebuie să fie singura comandă din fișier.
• Sumele INP cu virgulă zecimală sunt refuzate.
• Codurile de plată trec printr-o hartă a instalării, care implicit le lasă neschimbate. Pe o casă Daisy, fișierele care numerotează plățile ca Datecs sunt traduse, dacă nu ai configurat altă hartă.
• Fișierul cu totalurile zilei (Z.txt / X.txt) se scrie pentru fiecare raport, din orice intrare, când e configurat un folder pentru el.

API-ul Fisco

• Ascultă pe portul 4040, doar pe acest calculator, deci un POS setat pe localhost:4040 se conectează. Ascultarea pe toate interfețele (pentru tablete) se pornește explicit, cu avertisment. Dacă portul e ocupat, de exemplu de driverul vechi, API-ul rămâne oprit, iar Starea arată „Port ocupat”.
• Refuză paginile web (403, antetul Origin), în afară de un POS din browser servit de pe același calculator (localhost sau o adresă loopback).
• /print și /validate primesc doar application/json; altfel 415.
• /api/v1/health arată separat dacă e conectată casa, dacă are licență și dacă dispozitivul e autorizat.
• Un external_id se tipărește cel mult o dată, chiar și după o repornire. Un external_id a cărui lucrare sigur nu a tipărit nimic se poate trimite din nou; unul cu rezultat necunoscut rămâne folosit.

Ruta /api/Receipt

[
  "S^Espresso^1000^1000^pcs^1^1",
  "ST^",
  "P^1^1000"
]

[
  "S,1,______,_,__;Espresso;10.00;1.000;1;1;2;0;0;pcs",
  "T,1,______,_,__;0;10.00;;;;"
]

{
  "ReceiptStatus": "true",
  "ReceiptNumber": "12345",
  "ErrorCode": "",
  "ErrorInfo": ""
}

{
  "ReceiptStatus": "false",
  "ReceiptNumber": "",
  "ErrorCode": "123",
  "ErrorInfo": "<error text>"
}