Interfața Fișiere INP

Interfața de fișiere INP oferă o metodă de integrare bazată pe fișiere pentru operațiunile fiscale. Driverul monitorizează un director dedicat pentru fiecare dispozitiv fiscal cu INP activat; când un fișier de comandă este plasat în acel director, driverul îl procesează și generează fișierele de rezultat corespunzătoare.

Instalare și Configurare

Pentru a activa procesarea fișierelor INP pentru un dispozitiv fiscal:

1. În interfața FisCool, deschideți configurarea dispozitivului fiscal
2. Activați opțiunea „Compatibilitate INP"
3. Setați un „Director INP" (ex: C:\FisCool\INP)
4. Driverul începe să monitorizeze acel folder pentru fișiere noi

Driverul creează automat subdirectoarele de rezultat BonOK, BonERR și BonANSWER în interiorul directorului INP.

Detectarea și Procesarea Fișierelor

• Fișierele cu extensiile .inp, .txt sau .bon sunt procesate întotdeauna drept comenzi INP.
• Fișierele cu alte extensii sunt procesate doar dacă conținutul lor este recunoscut drept comenzi INP; altfel sunt ignorate.
• Fișierele mai mari de 1 MB sunt ignorate.
• Codificare: se recomandă UTF-8. Fișierele care nu sunt UTF-8 valid sunt decodate ca Windows-1252 (compatibilitate legacy). Spațiile non-breaking sunt normalizate la spații obișnuite.
• Liniile goale și liniile de comentariu care încep cu # sau // sunt ignorate.

Ciclul de Procesare

Structura Directoarelor de Rezultat

• <Director INP>\BonOK\ - fișierele de intrare procesate cu succes (mutate intact)
• <Director INP>\BonERR\ - fișierele de intrare eșuate (cu detaliile erorii atașate)
• <Director INP>\BonANSWER\ - fișierele de răspuns (același nume ca fișierul de intrare) cu rezultatele operațiunii

Formatul Fișierului de Intrare

Fișierele INP sunt fișiere text simplu, cu o comandă pe linie. Sunt suportate două sintaxe de comenzi:

Sintaxa este detectată automat pentru fiecare fișier, pe baza comenzilor pe care le conține - nu amestecați cele două sintaxe în același fișier. Formatul fișierelor de răspuns și de eroare urmează sintaxa fișierului de intrare (vezi Formatul Fișierului de Răspuns mai jos). Comenzile nu țin cont de majuscule/minuscule; se recomandă MAJUSCULE.

Exemplu de Fișier INP - Legacy / FPrint

S,1,______,_,__;Cafea;2.50;1.000;1;1;1;0;0;buc
T,1,______,_,__;0;2.50;;;;

Exemplu de Fișier INP - Simplu / Modern

S^Cafea^250^1000^buc^1^1
P^1^250

Formatul Legacy / FPrint - Referința Comenzilor

Fiecare comandă începe cu litera comenzii urmată de antetul standard ,1,______,_,__; parametrii de după primul ; variază după tipul comenzii.

S,1,______,_,__;Cafea Espresso;2.50;1.000;1;1;1;0;0;buc
S,1,______,_,__;Paine 500g;1.20;1.000;1;1;2;0;0;buc
S,1,______,_,__;Benzina Premium;1.45;25.500;3;1;1;0;0;l

T,1,______,_,__;0;20.00;;;;   <!-- 20.00 numerar -->
T,1,______,_,__;1;15.50;;;;   <!-- 15.50 card -->
T,1,______,_,__;4;;;;;        <!-- tipul 4 cu suma GOALĂ = subtotal -->

C,1,______,_,__;1;5.00;;;;    <!-- discount 5% pe linia anterioară -->
C,1,______,_,__;3;2.50;;;;    <!-- discount valoric 2.50 -->
C,1,______,_,__;0;10.00;;;;   <!-- majorare 10% -->

P,1,______,_,__;Va multumim;pentru vizita;Va mai asteptam;;;

K,1,______,_,__;RO22352741;

I,1,______,_,__;0;100.00;;;;   <!-- introducere 100.00 -->
I,1,______,_,__;1;50.00;;;;    <!-- retragere 50.00 -->

Z,1,______,_,__;0;      <!-- raport X -->
Z,1,______,_,__;1;      <!-- raport Z -->
Z,1,______,_,__;3;      <!-- raport pe departamente -->
A,1,______,_,__;;;X;;;  <!-- raport X (forma A) -->

DS;        <!-- deschide cu impulsul implicit al driverului/dispozitivului -->
DS;200     <!-- deschide cu impuls de 200 ms -->

54,Text simplu^^^^^^
54,Text bold^1^^^^^
54,Bold, inaltime dubla, centrat^1^^1^^1^

Formatul Simplu / Modern - Referința Comenzilor

Sintaxa simplu/modern folosește ^ ca separator de câmpuri, fără antetul FPrint. Toate valorile monetare se transmit în bani (întreg, 2 zecimale implicite: 250 = 2.50 lei), cantitățile cu 3 zecimale implicite (1000 = 1.000), iar procentele cu 2 zecimale implicite (500 = 5%). Caracterul ^ nu poate apărea în interiorul valorilor.

S^Cafea Espresso^250^1000^buc^1^1
S^Paine 500g^120^1000^buc^2^1
S^Mere Golden^850^120^kg^1^1      <!-- 0.120 kg la 8.50 lei/kg -->

S^Cafea Espresso^250^1000^buc^1^1
VS^Cafea Espresso^250^1000^buc^1^1   <!-- anulează linia de mai sus -->
S^Cappuccino^400^1000^buc^1^1
P^1^400

P^1^2000        <!-- 20.00 numerar -->
P^2^1550        <!-- 15.50 card -->
P^1^1000
P^2^1300        <!-- plată mixtă: 10.00 numerar + 13.00 card -->

S^Cafea^1000^1000^buc^1^1
DP^1000                          <!-- discount 10% la cafea -->
P^1^900

TL^Va multumim
TL^pentru vizita

CF^RO22352741
S^Cafea^250^1000^buc^1^1
P^1^250

I^10000     <!-- introducere 100.00 -->
O^5000      <!-- scoatere 50.00 -->

TL^-------------------------
TL^BON DE TEST POS
TL^-------------------------
VB^

Exemple Complete de Fișiere INP

S,1,______,_,__;Cafea;2.50;1.000;1;1;1;0;0;buc
S,1,______,_,__;Croissant;1.80;1.000;1;1;2;0;0;buc
T,1,______,_,__;0;4.30;;;;

S,1,______,_,__;Laptop;899.99;1.000;2;1;1;0;0;buc
S,1,______,_,__;Mouse Wireless;25.50;1.000;2;1;1;0;0;buc
C,1,______,_,__;1;5.00;;;;
T,1,______,_,__;1;924.21;;;;

S,1,______,_,__;Benzina Premium;1.45;40.000;3;1;1;0;0;l
T,1,______,_,__;0;50.00;;;;
T,1,______,_,__;1;8.00;;;;

K,1,______,_,__;RO22352741;
S,1,______,_,__;Servicii Profesionale;150.00;1.000;1;1;1;0;0;buc
T,1,______,_,__;1;150.00;;;;

S,1,______,_,__;Produs A;10.00;1.000;1;1;1;0;0;buc
P,1,______,_,__;Va multumim pentru;cumparaturi;Va mai asteptam;;;
T,1,______,_,__;0;10.00;;;;

P,1,______,_,__;--- COMANDA #42 ---;;;
P,1,______,_,__;2x Cafea;1x Croissant;;
P,1,______,_,__;--- SFARSIT ---;;;

I,1,______,_,__;0;100.00;;;;

Z,1,______,_,__;0;
Z,1,______,_,__;1;
Z,1,______,_,__;3;

Aceleași operațiuni în sintaxa simplu/modern (o operațiune per fișier):

S^Cafea^250^1000^buc^1^1
S^Croissant^180^1000^buc^2^1
P^1^430

CF^RO22352741
S^Caiet A4^380^5000^buc^1^1
DP^500
TL^Eco taxa este inclusa in pret
P^1^1000
P^2^805

I^10000     <!-- introducere 100.00 (fișier separat) -->
O^5000      <!-- scoatere 50.00 (fișier separat) -->

X^
Z^
D^

Formatul Fișierului de Răspuns (BonANSWER)

Fișierele de răspuns sunt create în BonANSWER/ cu același nume ca fișierul de intrare. Formatul răspunsului urmează sintaxa fișierului de intrare.

Răspunsuri Legacy / FPrint (format INI)

Răspuns pentru Bon

[Answer]
SlipNumber=123
nZrep=45
nFNum=1050

Doar pentru dispozitivele Daisy: pentru compatibilitate cu software-ul de vânzare configurat pentru driverele Daisy legacy, se adaugă următoarele câmpuri suplimentare:

CommandName=close_fiscal_receipt
Allreceipt=000123      ; toate bonurile (fiscale + nefiscale) de la ultimul Z, completat cu zerouri la 6 cifre
FiscReceipt=000098     ; bonurile fiscale de la ultimul Z, completat cu zerouri la 6 cifre
DeviceSerial=8000596182

Răspuns pentru Raport (X/Z)

[Answer]
nRep=42
TaxA=125.50
TaxB=67.80
TaxC=0.00
TaxD=0.00
TaxE=0.00

TaxA–TaxE sunt totalurile zilnice de vânzare per grupă de TVA, în lei cu 2 zecimale.

Raportul pe departamente (tipul 3) se tipărește doar pe hârtie și nu returnează totaluri - fișierul lui de răspuns folosește forma generică Status=0 de mai jos.

Răspuns pentru Operațiune de Numerar

[Answer]
TotalCash=1250.75

TotalCash este totalul din sertar după operațiune, în lei.

Alte Operațiuni (ex: deschidere sertar)

[Answer]
Status=0

Răspunsuri Simplu / Modern

Fișierele scrise în sintaxa simplu/modern primesc în schimb un răspuns compact cheie=valoare:

Răspuns pentru Bon

BONOK=1
NRBON=123

NRBON este numărul bonului fiscal.

Alte Operațiuni

Formatul Fișierului de Eroare (BonERR)

Și formatul erorii urmează sintaxa fișierului de intrare.

Erori Legacy / FPrint

Fișierele de eroare conțin conținutul INP original urmat de detaliile erorii, ca linii de comentariu:

S,1,______,_,__;Produs Test;10.50;1.500;120;1;1;0;0;kg
#Linia 1 | S,1,______,_,__;Produs Test;10.50;1.500;120;1;1;0;0;kg
#ErrorCode (-112207) : Valoare incorecta a parametrului departament.

• Erorile de parsare folosesc coduri negative în intervalul -112200…-112231 și indică linia problematică.
• Erorile de execuție (erori de dispozitiv/comunicare de după o parsare reușită) folosesc Linia 0 | Execution Error și poartă codurile de eroare standard ale driverului (vezi Coduri Eroare - ex: 500 lipsă hârtie, 1004 dispozitiv neconectat):

S,1,______,_,__;Produs Test;10.50;1.500;1;1;1;0;0;buc
#Linia 0 | Execution Error
#ErrorCode (1004) : Problemă la conexiune: Dispozitivul refuză conexiunea

Erori Simplu / Modern

Pentru fișierele în sintaxa simplu/modern, fișierul BonERR conține în schimb o eroare compactă cheie=valoare:

BONOK=0
ERRCODE=-112203
ERRINFO=Preț invalid.

ERRCODE folosește aceleași coduri ca formatul legacy: coduri negative pentru erorile de parsare, codurile standard pozitive ale driverului pentru erorile de execuție.

Bune Practici

• Denumirea fișierelor: folosiți nume unice, secvențiale, pentru a evita conflictele.
• Monitorizarea rezultatelor: urmăriți BonANSWER și BonERR pentru rezultatul fiecărui fișier; fișierul de rezultat are întotdeauna același nume cu fișierul de intrare.
• Codificare: preferați UTF-8; Windows-1252 este acceptat pentru compatibilitate legacy.
• Separator: nu folosiți niciodată separatorul de câmpuri în interiorul valorilor - ; în fișierele legacy/FPrint, ^ în fișierele simplu/modern.
• Un singur scriitor per fișier: scrieți fișierul complet (sau scrieți într-un nume temporar și redenumiți) înainte ca driverul să îl preia.
• Un singur monitor per folder: doar FisCool trebuie să proceseze directorul INP, pentru a preveni condițiile de cursă.
• Spațiu pe disc: BonOK și BonANSWER se acumulează în timp - arhivați-le sau curățați-le periodic.

Note de Integrare

Interfața de fișiere INP este ideală pentru:

• Integrarea sistemelor legacy: sisteme care nu pot folosi API-urile HTTP/WebSocket
• Procesare în loturi: tipărirea bonurilor din cozi de tranzacții
• Fiabilitate: operațiunile pe bază de fișiere oferă persistență naturală și o pistă de audit integrată
• Depanare: fișierele de intrare, de răspuns și de eroare documentează complet fiecare tranzacție