Imprimante fiscale

• Cui vorbim:* decident care alege hardware-ul fiscal sau are deja unul.

Modele certificate

Recomandat principal — Intelect-Soft

• Intelect-Soft este partenerul nostru principal pentru integrare casa de marcat fiscală certificată — folosim soluția lor MCR* pentru integrarea cu SFS. Avantaje:

• Certificare oficială SFS Moldova.
• Modele variate — pentru retail mic, restaurant cu volum mare, mobilă pentru livrare.
• Suport tehnic local — ajutor rapid în Chișinău și principalele orașe.
• Costuri rezonabile — 4.000-12.000 MDL pentru modelele standard.
• Integrare completă cu platforma noastră — testat și validat.

Alți parteneri certificați

La cerere, integrăm și cu:

• Echipamente certificate SFS ale altor furnizori MD.
• Casa de marcat de tip "smart" cu API documentat.
• Soluții cloud-fiscal pentru deployment-uri speciale.

Pentru orice model nou (necertificat încă în sistemul nostru), integrarea durează 2-5 zile lucrătoare.

Cum se conectează

Conexiune fizică

• USB (cea mai comună) — cablu de la POS la casa de marcat.
• Ethernet / Wi-Fi (modelele moderne) — casa de marcat e în rețeaua locală.
• Serial RS-232 (modele mai vechi) — cu adaptor USB la nevoie.

Configurare logică

La onboarding, inginerul nostru:

1. Verifică dacă driverul fabricant e instalat pe POS-ul tău (Windows / Linux).
2. Configurează conexiunea în setările sistemului nostru.
3. Testează cu bonuri de probă (1 produs fictiv, storno imediat).
4. Validează cu codurile fiscale unice ale aparatului tău (înregistrate la SFS).

Configurare standard: 30-60 minute.

Operațiuni suportate

Emitere bon fiscal

• Tipărire bon hârtie + electronic la SFS.
• Suport pentru cote TVA multiple în același bon.
• Tipărire QR code cu link-ul către copia electronică SFS (pentru cumpărător).
• Mențiuni speciale: "ofertă casă", "storno", "factură nr. X".

Z-uri (raportul fiscal de zi)

• Tipărit automat la închiderea zilei.
• Atașat în arhivele electronice.
• Trimis pe e-mail managerului / contabilului.

Storno (semi-asistat)

• Conform procedurii SFS — bon de anulare cu sumă negativă.
• Sistemul nostru ghidează fluxul (selectare bon original, motiv, sume); casierul execută acțiunile efective pe casa de marcat fiscală conform procedurii SFS.
• Cu motiv obligatoriu (din nomenclator).
• Audit complet cine / când / de ce — logat la noi.

Raport X (raport intermediar)

• Pentru "vede cât am vândut până acum în ziua asta" fără să închizi.
• Tipărit la cerere oricând.

Conectare cu cash drawer

Casa de marcat (sau imprimanta de bonuri non-fiscală) trimite semnal cash drawer-ului:

• Auto-deschidere la finalizarea bonului fiscal cu cash.
• Manual dintr-un buton de pe POS (pentru schimb / verificare).
• Acțiunile sunt logate (pentru audit — câte ori s-a deschis cash drawer-ul în zi).

Setup gratuit pentru modelele recomandate de noi. Dacă alegi cash drawer-ul din catalogul nostru de parteneri (modele testate, conector standard cu casa de marcat), integrarea o facem gratuit, ca parte din onboarding. Pentru cash drawer adus de tine din afara catalogului nostru — integrare 500 MDL setup unic.

Hardware adițional

Imprimantă bonuri non-fiscale

Pentru:

• Bonuri de comandă online (pentru livrare cu curier).
• Etichete preț pentru raft.
• Etichete cod barcode pentru produse interne.
• Bonuri pasă pentru bucătărie (alternativă la kitchen-display).

Compatibilitate: EPSON, Star, Citizen — costuri hardware 1.000-3.000 MDL la furnizor.

Setup gratuit pentru modelele recomandate de noi. Dacă alegi imprimanta din catalogul nostru de parteneri, integrarea o facem gratuit. Pentru modele aduse din afara catalogului nostru — setup integrare 1.500-3.000 MDL (depinde de complexitatea driverului).

Cititor cod de bare

USB sau Bluetooth standard:

• Recomandare: cititor 2D (citește atât 1D cât și QR codes).
• Costuri: 200-800 MDL.
• Plug & play — funcționează cu sistemul fără configurare.

Cântar electronic

Pentru magazine alimentare cu vânzare la kg:

• Modele cu interfață cu casa de marcat (etichete preț + cod scan).
• Sau cântar manual + introducere cantitate în POS.
• Costuri: 2.000-15.000 MDL în funcție de model.

Suport în caz de defect

Dacă casa de marcat se strică:

1. Diagnoză remote (1-2 ore) — încercăm să rezolvăm fără deplasare.
2. Suport telefonic cu Intelect-Soft / partener (te ajutăm să-i contactezi).
3. Înlocuire temporară (la cerere, în Chișinău) — îți împrumutăm un model standby.
4. Backup operațional — bonuri pre-fiscale pe imprimantă non-fiscală până se rezolvă (legal pentru perioade scurte de avarie cu raportare ulterioară la SFS).

Performanță

• Emitere bon fiscal: 2-4 secunde (tipic, depinde de viteza imprimantei).
• Sincronizare cu SFS: rapidă (în background).
• Suport bonuri lungi (>30 produse): da, fără limită impusă de noi.

Tur vizual — Devices Manager

Aplicația Devices Manager e locul unde inginerul (sau operatorul avansat) configurează dispozitivele fizice conectate la POS: imprimante ESC/POS (TCP/USB/Bluetooth), case fiscale certificate, hub-uri de sincronizare cu MEV. Detectează AndroidBridge pe device Android, altfel cade elegant pe modul browser cu limitări CORS.

Captură din state fresh (0 dispozitive înregistrate). UI-ul e conceput să ghideze operatorul de la zero — trece prin Discover devices → configurare → Test print. Când există dispozitive înregistrate, secțiunea "Imprimante & case fiscale descoperite" afișează carduri per device cu status (online/offline), butoane test și config avansat.

• Buton Discover devices* — declanșează scanul concurent pe toate transporturile disponibile (LAN, USB, Bluetooth) și populează lista cu dispozitivele detectate. Pe mediu Android (AndroidBridge activ), scanul funcționează nativ; în browser pur, scanul LAN e blocat de politica mixed-content.

• Buton Test print* — trimite un bon de test către dispozitivul selectat (când există unul configurat). Util după orice modificare de config pentru validare rapidă că printer-ul răspunde corect.

• Empty state ghidat* — când nu există dispozitive înregistrate, aplicația spune explicit ce trebuie făcut ("Apăsați Discover devices pentru a scana LAN + USB + Bluetooth"). Nu lasă operatorul să presupună.

• Secțiune Remote hubs (LAN discovery).* Permite descoperirea altor devices-manager companion pe rețea (util într-o locație cu multiple POS-uri, fiecare cu propria imprimantă fiscală). Warning galben avertizează despre expunerea pe LAN; warning roșu explică de ce browser-ul blochează scanul (mixed-content policy) și oferă link către instrucțiuni.

• Buton Scan LAN* — declanșează căutarea manuală a companion-urilor pe rețea. Rezultatele apar apoi ca "Remote hosts (IPs)" în config-ul principal.

• Butoane config (Reset cache / Reset stuck / Clear / Copy).* Acțiuni de întreținere: Reset cache curăță tot cache-ul discovery, Reset stuck deblochează request-uri blocate, Clear șterge log-ul de evenimente, Copy pune URL-ul curent în clipboard pentru share cu suport.

• Warning Browser fallback.* Când AndroidBridge nu e detectat (rulare în browser desktop pur), un chip galben indică modul limitat. Utilizatorii care rulează pe device Android nu văd acest warning — au acces la full-native features (USB, Bluetooth, printer local, HTTP server on-device).

Cheat-sheet — ce face fiecare buton

Multe butoane din Devices Manager sunt legate de configurări persistente în SharedRefs (colecția devices-manager). Aceasta înseamnă că același UI se comportă diferit pe alt POS sau alt device în funcție de ce e setat în SharedRefs.

SharedRefs — colecția devices-manager

Colecția devices-manager (vizibilă în SharedRefs Manager) conține ref-urile care controlează comportamentul aplicației. Toate au fallback-uri sensibile — nu trebuie configurate manual pentru a folosi aplicația.

• Config general:*

• auto-start-enabled (bool, default false) — dacă true, la boot-ul webapp-ului se aplică automat config-ul salvat (fără click pe Discover).
• device-hosts (array de string) — lista IP-uri / hostname-uri care găzduiesc dispozitive.
• printer-hosts (array) — sub-listă doar cu printer-uri (subset al device-hosts).
• sync-enabled (bool) — activează sync-ul cu MEV/SFS în background.
• sync-token (string) — token de autentificare pentru sync (setat automat la login inițial).
• http-server-enabled (bool) — activează HTTP server-ul on-device (doar Android).
• http-server-port (int) — portul pe care ascultă HTTP server-ul on-device.
• default-printer-per-pos (object {<pos-id>: <printer-id>}) — mapare care spune "pentru POS X folosește printer Y".
• fiscal-sync-server (string) — URL server sync fiscal (default: dev.lut.md).

• Discovery periodic:*

• discover-auto-enabled (bool, default false) — dacă true, aplicația rulează Discover automat la interval.
• discover-interval-ms (int, clamped 15000-3600000) — intervalul între rulări automate.

• Sync trace (diagnostic):*

• sync-trace.enabled (bool) — activează captura de evenimente de sync.
• sync-trace.min-level (string) — level minim capturat (skip+, info+, warn+, error).
• sync-trace.buffer-size (int) — nr. maxim de events în buffer-ul ring.
• sync-audit.enabled (bool) — activează audit periodic al datelor sincronizate.
• sync-audit.recheck-cooldown-h (int) — ore între re-check audit.

• LAN scan (Remote hubs):*

• scan.hostnames (array) — hostname-uri / IP-uri specifice de încercat în scan (default: sgapps-pos-print.local, 127.0.0.1, 192.168.1.1, 192.168.0.2). Fiecare intrare acceptă și shape-ul host:port (ex: "192.168.0.2:8069", "sgapps-print.local:443") — portul din intrare override-uiește scan.port default doar pentru acea intrare. Util când companion-urile pe LAN rulează pe porturi diferite.
• scan.subnets (array) — subnete de scanat exhaustiv (când hostname-urile nu răspund).
• scan.port (int, default 8080) — portul pe care ascultă hub-urile companion.
• scan.timeout-ms (int) — timeout per host în scan.
• scan.probe-endpoint (string) — endpoint HTTP folosit ca "sondă" să identifice un hub.
• scan.last-working-hostname (string, auto-updated) — cache-ul hostname-ului găsit ultim, folosit ca shortcut la următorul scan.

Comportament dependent de mediu

• Pe Android (tablet POS): AndroidBridge activ → toate features funcționează nativ (USB, Bluetooth, printer local, HTTP server on-device). Config-ul se poate modifica din UI + apoi propagat la alte device-uri via SharedRefs (context global sau pos:<pos-id>).
• În browser desktop (Chromium): fallback CORS-limited. LAN scan e blocat de mixed-content policy — soluția e Discover via hub companion (alt device Android care expune HTTP server-ul devices-manager).
• Sync stopped indicator: cardul portocaliu "⏸ Sync oprit (click ⇒ pornește)" arată când sync-ul e dezactivat via sync-enabled = false. Click pe card face upsert la sync-enabled = true.

Următorul pas

→ Notificări sau Autentificare & RBAC.