Ghid complet POS Bridge

Cum funcționează POS Bridge

POS Bridge este serviciul local pentru Windows dezvoltat de POINT OF BUSINESS SOFTWARE S.R.L. care asigură comunicarea directă, rapidă și fără erori între aplicația ta de vânzare / gestiune (Conexa, POB Soft sau orice alt ERP/POS comercial), casa de marcat fiscală și terminalul bancar POS.

Cerințe de sistem și instalare pas cu pas

Aplicația POS Bridge rulează în fundal (System Tray) pe stația Windows la care sunt conectate echipamentele fiscale.

Cerințe minime

• Sistem de operare: Windows 10 (64-bit) sau Windows 11.
• Conectivitate echipamente: Port USB disponibil (cu driver USB-to-Serial instalat pentru cablul casei de marcat), port serial RS-232 nativ sau rețea locală LAN (TCP/IP).
• Conexiune internet: Necesară la activarea inițială și pentru verificarea periodică a licenței anuale pe app.conexa.software.

Pașii de instalare

1. Conectează casa de marcat la PC: Introdu cablul USB sau serial și verifică în Device Manager → Ports (COM & LPT) numărul portului alocat (de exemplu COM3 sau COM4). Pentru casele conectate prin cablu de rețea (LAN), notează adresa IP statică a casei (ex. 192.168.1.200).
2. Rulează kitul de instalare POS Bridge: Instalează aplicația cu drepturi de Administrator și bifează opțiunea Pornire automată odată cu Windows.
3. Selectează modelul casei și portul: Deschide fereastra POS Bridge din bara de sistem (dreapta-jos lângă ceas), alege producătorul casei de marcat, portul COM / IP-ul și apasă Salvează și Testează Conexiunea.

Activarea automată a licenței și facturarea anuală recurentă

Licențierea POS Bridge este complet automatizată și legată de Seria fiscală a casei de marcat (sau de Codul Serial afișat în aplicația POS Bridge).

Cum se activează automat licența în 3 pași

1. Identificarea echipamentului: La prima conectare cu casa de marcat, POS Bridge citește automat seria fiscală a memoriei (ex. DB4140002164 sau TM30012345) și generează identificatorul stației (ex. POS_DESKTOP-...).
2. Achiziția online cu cardul: În pagina de comandă licență, introduci CUI-ul firmei (datele se preiau automat din ANAF) și, opțional, seria fiscală a casei de marcat (o poți introduce și ulterior, direct în pagina de confirmare a plății).
3. Activare instantanee + Factură fiscală în e-Factura: Imediat ce plata cu cardul este confirmată prin Stripe (în contul POINT OF BUSINESS SOFTWARE S.R.L., CUI RO36849440):
   • Dispozitivul primește automat statutul Activat pentru 12 luni și un certificat digital criptografic RS256 JWT.
   • Se emite automat factura fiscală pe seria POBC, se marchează achitată cu cardul și se transmite în ANAF e-Factura, iar copia PDF îți este trimisă pe email.
   • Abonamentul este anual recurent (120 lei/an sau 260 lei/an, TVA inclus): la fiecare aniversare anuală, licența se prelungește automat cu încă 12 luni și primești automat noua factură fiscală, fără întreruperea activității la casă.

Parametrii de conectare pentru casele de marcat

Mai jos găsești setările standard de comunicare pentru principalele modele de case de marcat și imprimante fiscale omologate ANAF în România.

Maparea cotelor de TVA și a metodelor de plată

În POS Bridge, grupele fiscale de TVA și instrumentele de încasare se mapează conform configurării din memoria fiscală a casei:

Conectarea terminalelor bancare ING și Banca Transilvania (BT)

Cu licența Casă + terminal bancar (260 lei / an), POS Bridge comunică direct cu terminalul EFT-POS furnizat de ING Bank sau Banca Transilvania (Ingenico / Verifone / PAX cu protocol ECR activat).

Fluxul unei încasări cu cardul

1. Operatorul selectează în programul de gestiune plata cu Card (sau plată mixtă Numerar + Card) și apasă Emite bon.
2. POS Bridge trimite automat suma exactă către terminalul bancar ING sau BT (prin cablu USB/Serial sau IP local).
3. Ecranul terminalului bancar se aprinde instantaneu cu suma de plată, iar clientul apropie cardul sau telefonul.
4. După confirmarea băncii (APPROVED / 00), POS Bridge trimite automat comanda de tipărire a bonului fiscal către casa de marcat și întoarce numărul bonului în aplicația de gestiune.
5. Dacă tranzacția pe card este respinsă sau anulată, bonul fiscal nu este tipărit, prevenind blocarea gestiunii.

Unde se pun fișierele și cum se formatează structura bonului (bon.txt)

Pe lângă integrarea directă cu Conexa și POB Soft, POS Bridge poate fi integrat în câteva minute cu orice program de gestiune, ERP sau aplicație proprie, fie prin Monitorizare Foldere (Mod Fișiere), fie prin API HTTP Local.

1. Unde se pun fișierele (Structura de directoare)

În directorul de lucru configurat în POS Bridge (implicit C:\POSBridge\ sau folderul selectat în Preferințe POS), aplicația utilizează 4 subdirectoare standard:

2. Reguli de aur pentru formatarea bonului

• Separator de câmpuri: caracterul ^ (caret), fără spații înainte sau după el. Fiecare linie se termină cu CRLF (\r\n), codificare UTF-8 fără BOM.
• Prețurile și sumele se scriu în BANI (întregi, RON × 100): fără virgulă sau punct zecimal. Exemplu: 12,50 lei se scrie 1250; 0,50 lei (garanția SGR) se scrie 50; 100,00 lei se scrie 10000.
• Cantitățile se scriu în MIIMI (întregi, Cantitate × 1000): 1 buc = 1000 · 2 buc = 2000 · 0,350 kg = 350 · 1,500 kg = 1500.
• Denumirea produsului: maximum 50 de caractere (36 de caractere recomandat pentru modelele compacte Activa / Daisy), fără caracterul ^.

3. Structura liniilor de comandă din fișierul bon.txt

4. Exemple complete (gata de copiat și testat)

Exemplul A — Bon fiscal simplu cu plata în numerar

2 × Cafea Espresso (12,00 lei/buc, TVA 11% — grupa 2) = total 24,00 lei achitat în numerar (cod plată 1):

TL^Bon nr 1041; utilizator: casier1
S^Cafea Espresso^1200^2000^buc^2^1
P^1^2400

Exemplul B — Bon fiscal complex: CUI client + Reducere (DV^) + Garanție SGR + Plată mixtă (Numerar + Card)

Produs de 50,00 lei cu reducere 5,00 lei (rămân 45,00 lei) + 2 băuturi la 10,00 lei/buc (20,00 lei) + 2 × Garanție SGR 0,50 lei (1,00 lei, grupa TVA 4) = Total 66,00 lei (16,00 lei numerar + 50,00 lei card):

CF^RO36849440
TL^Bon nr 1042; utilizator: admin
S^Pachet Cafea Boabe 1kg^5000^1000^buc^2^1
DV^500
S^Apa Minerala 0.5L^1000^2000^buc^2^1
S^Garantie SGR^50^2000^buc^4^1
P^1^1600
P^2^5000

Exemplul C — Bon nefiscal / Document informativ (prefix obligatoriu nf_)

Pentru bonuri nefiscale (note de plată informative, dispoziții de plată, vouchere), numele fișierului din Bonuri\ trebuie să înceapă obligatoriu cu nf_ și să conțină exclusiv linii TL^:

TL^================================
TL^      NOTA DE INFORMARE         
TL^================================
TL^Comanda masa: 12
TL^Ospatar: Andrei
TL^Total estimat: 85,00 RON
TL^Acest document nu este bon fiscal

Exemplul D — Fișierul de confirmare scris de POS Bridge în Raspuns\

După tipărirea cu succes a bonului, POS Bridge scrie în C:\POSBridge\Raspuns\ fișierul pereche cu numărul bonului fiscal atribuit de casa de marcat:

BONOK=1
NRBON=148
ERRCODE=0
ERRINFO=

Exemplul E — Apel direct prin API HTTP Local (fără fișiere pe disc)

Aplicațiile web sau desktop pot trimite aceleași linii de comandă direct ca array JSON prin POST http://127.0.0.1:65400/api/Receipt:

[
  "CF^RO36849440",
  "TL^Bon nr 1042; utilizator: admin",
  "S^Licenta POS Bridge^5000^1000^buc^1^1",
  "P^2^5000"
]

5. Verificarea stării licenței prin API Cloud

Serviciul POS Bridge își verifică și descarcă automat certificatul de licență prin endpointul public HTTPS:

GET https://app.conexa.software/api/licentiere/posdevice/check?serialNumber=POS_DESKTOP-01&fiscalPrinterSeries=DB4140002164

{
  "isActivated": true,
  "status": "Activated",
  "expiresAt": "2027-10-29T19:00:00.000Z",
  "message": "Dispozitiv activat"
}

Diagnosticare și rezolvarea erorilor frecvente