Sectiunea 3.4 Configurare statie vanzare

Scop 

Acest capitol descrie cerintele hardware si software necesare pentru functionarea statiilor de vanzare EMSYS POS, structurile de magazine suportate, procedura de instalare a componentelor si fluxul de pornire a sistemului.

Sinonime si termeni alternativi: statie POS, statie vanzare, casa de marcat, ClientPos.jar, server POS, punct de vanzare.

Prerechizite hardware 

Inainte de instalarea software-ului, echipamentele fizice ale statiei de vanzare trebuie sa fie instalate, conectate si testate.

Casa de marcat fiscala

Casa de marcat trebuie sa fie instalata si testata de catre furnizorul de echipamente fiscalizate (dealer autorizat).
Verificarea functionarii se face prin emiterea unui raport X (raport fara inchidere de zi) si a unui bon nefiscal de test.
Conectarea la calculator se realizeaza prin port USB sau port serial (RS-232), in functie de modelul casei de marcat.
Fiecare model de casa de marcat necesita instalarea unui driver / aplicatie proprie furnizata de producator sau dealer (ex: FiscalNet, FiscalWire, Zeka etc.). Instalarea si configurarea acestui driver este responsabilitatea furnizorului de echipamente.

Atenționare

Aplicatia devices.jar (componenta EMSYS pentru comunicarea cu casa de marcat) nu inlocuieste driverul furnizorului. Ambele trebuie sa fie instalate si functionale simultan. Verificati ca driverul casei de marcat comunica corect cu echipamentul inainte de instalarea componentelor EMSYS, recomandat sa poarneasca automat la Startup.

POS bancar (terminal card)

Terminalul bancar poate fi configurat in doua moduri de operare, exclusiv de catre banca apartinatoare:

Mod operare	Descriere	Configurare EMSYS corespunzatoare
Automat	Terminalul este conectat la calculator prin USB. Suma de plata este transmisa automat din EMSYS POS catre terminal — casierul nu introduce suma manual de la tastatura terminalului.	In Setari Magazine (vezi Setari Magazine): Plata CARD Automata = `DA`. Terminalul bancar trebuie configurat in Pos Banca (vezi Pos Banca — Configurare echipamente bancare).
Manual (independent)	Terminalul functioneaza independent de calculator. Casierul introduce suma de plata manual de la tastatura terminalului. Nu este necesara conexiunea USB la calculator.	In Setari Magazine: Plata CARD Automata = `NU`.

Atenționare

Schimbarea modului de operare al terminalului bancar din automat in manual si invers se poate efectua exclusiv de catre banca apartinatoare. Nu incercati sa modificati configuratia terminalului fara acordul bancii. Dupa modificarea modului de operare efectuati setarea corespunzatore in Setari Magazine (vezi Setari Magazine)

Scanner cod de bare

Scannerul se conecteaza la calculator prin port USB.
Dupa conectare, verificati functionarea prin deschiderea unui fisier text (Notepad) si scanarea unui cod de bare — codul trebuie sa apara in fisier.
Majoritatea scannerelor sunt configurate implicit sa trimita doar codul de bare, fara a efectua pasul ENTER dupa scanare. In EMSYS POS este necesar ca scannerul sa trimita si comanda ENTER pentru a valida automat produsul dupa scanare.

Notă

Daca dupa scanare produsul nu este adaugat automat in tranzactie si trebuie apasat manual ENTER, consultati manualul scannerului pentru activarea optiunii «sufx ENTER» sau «CR suffix». Aceasta setare se activeaza de obicei prin scanarea unui cod de bare de configurare din manualul echipamentului.

Prerechizite software 

Urmatoarele componente software trebuie sa fie instalate pe statiile de vanzare. Verificati periodic disponibilitatea actualizarilor pentru fiecare componenta.

Componenta	Obligatoriu	Detalii
Amazon Corretto 8 (64-bit)	DA	Mediul de executie Java necesar pentru rularea aplicatiilor EMSYS POS (magazin_oui.jar, ClientPos.jar, devices.jar). Se descarca de la: `https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html` — selectati versiunea 64-bit corespunzatoare sistemului de operare.
Adobe Acrobat Reader	NU	Necesar doar daca pe statie se acceseaza si EMSYS ERP pentru vizualizarea rapoartelor sau listarea documentelor in format PDF.
Browser web (Chrome / Firefox / Edge)	DA	Necesar pentru accesarea interfetei web EMSYS ERP si pentru descarcarea ClientPos.jar de pe statia server.
Sistem de operare Windows	DA	Windows 10 sau o versiune mai noua suportata de Microsoft. Verificati periodic pe site-ul Microsoft ce versiuni sunt inca in suport activ.

Notă

Server POS poate rula pe Windows sau Linux. ClientPos.jar functioneaza exclusiv pe Windows. Asigurati-va ca alegeti sistemul de operare potrivit pentru fiecare tip de statie.

Prerechizite EMSYS — componente de instalat 

Sistemul EMSYS POS este format din trei componente distincte, instalate diferentiat in functie de rolul calculatorului (server sau client):

Componenta	Se instaleaza pe	Descriere
devices.jar	Toate statiile cu casa de marcat conectata	Aplicatia care asigura comunicarea intre EMSYS POS si echipamentele periferice ale statiei: casa de marcat fiscala, scanner, terminal bancar (in mod automat). Trebuie sa fie pornita inainte de lansarea ClientPos.jar. Se descarca de la adresa `devices.emsys.ro`.
magazin_oui.jar (Server POS)	Exclusiv pe calculatorul server POS	Aplicatia server a magazinului. Gestioneaza baza de date locala POS si sincronizeaza datele intre ERP si statiile client. Se genereaza si se descarca din Logistics → Vanzari & Retail → Setari → Magazine → selectie magazin → Configurare POS (vezi Configurare POS).
PostgreSQL (baza de date locala)	Exclusiv pe calculatorul server POS	Baza de date locala a magazinului POS. Se instaleaza ultima versiune stabila de PostgreSQL, cu baza de date `emsyspos` si schema `pos`. Parola utilizatorului `postgres` trebuie sa fie identica cu cea configurata in campul Parola BD din ecranul Configurare POS al magazinului.
ClientPos.jar	Toate statiile cu casa de marcat conectata	Aplicatia de vanzare propriu-zisa utilizata de casieri. Se descarca de pe statia server accesand din browser adresa `http://<numeserver>:29997/`, unde `<numeserver>` este numele sau IP-ul calculatorului server POS. Fisierul descarcat se salveaza pe Desktop.

Atenționare

devices.jar trebuie instalat pe toate calculatoarele care au casa de marcat conectata, inclusiv pe calculatorul care este in acelasi timp server POS si statie de vanzare. Absenta sau nefunctionarea devices.jar impiedica comunicarea cu casa de marcat si blocheaza emiterea bonurilor fiscale.

Atenționare

Parola utilizatorului postgres din instalarea PostgreSQL trebuie sa fie identica cu valoarea campului Parola BD din configuratia POS a magazinului (Configurare POS → camp Parola BD). O nepotrivire impiedica pornirea aplicatiei server magazin_oui.jar.

Structuri de magazine configurabile 

In functie de numarul de puncte de vanzare si de configuratia hardware disponibila, EMSYS POS suporta mai multe structuri de instalare.

Magazin cu un singur punct de vanzare

Varianta A — Calculator server separat de statia de vanzare

1 calculator dedicat server POS (ruleaza magazin_oui.jar + PostgreSQL)
1 calculator statie de vanzare (ruleaza devices.jar + ClientPos.jar)

Notă

Statia de vanzare nu poate efectua vanzarea pana cand calculatorul server POS nu este pornit si aplicatia magazin_oui.jar este activa. Porniti intotdeauna serverul inaintea statiei client.

Varianta B — Un singur calculator (server si statie de vanzare)

1 calculator care indeplineste ambele roluri: server POS si statie de vanzare
Pe acesta se instaleaza: magazin_oui.jar + PostgreSQL + devices.jar + ClientPos.jar

Magazin cu mai multe puncte de vanzare

Exemplu: 3 puncte de vanzare

Varianta A — Server POS dedicat

1 calculator server POS (magazin_oui.jar + PostgreSQL) — fara casa de marcat conectata
3 calculatoare statii de vanzare (devices.jar + ClientPos.jar + casa de marcat conectata pe fiecare)

Varianta B — Server POS combinat cu statie de vanzare

1 calculator server POS si statie de vanzare (magazin_oui.jar + PostgreSQL + devices.jar + ClientPos.jar + casa de marcat)
2 calculatoare statii de vanzare (devices.jar + ClientPos.jar + casa de marcat)

Notă

In varianta B, statiile de vanzare suplimentare nu pot efectua vanzarea pana cand calculatorul care este si server POS nu este pornit complet si magazin_oui.jar este activ.

Rezumat componente per tip de statie

Componenta	Server POS dedicat	Server POS + statie vanzare	Statie vanzare (client)	Statie vanzare suplimentara
Amazon Corretto 8 (64-bit)	DA	DA	DA	DA
PostgreSQL	DA	DA	NU	NU
magazin_oui.jar	DA	DA	NU	NU
devices.jar	NU	DA	DA	DA
ClientPos.jar	NU	DA	DA	DA

Instalare componente 

Instalare pe calculatorul server POS

Instalare Amazon Corretto 8 (64-bit)

Accesati https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html, descarcati versiunea Windows x64 (sau Linux, dupa caz) si instalati urmand instructiunile programului de instalare.
Instalare PostgreSQL

Instalati ultima versiune stabila de PostgreSQL. In timpul instalarii:
- Creati baza de date cu numele emsyspos.
- Creati schema pos in cadrul bazei de date.
- Setati parola utilizatorului postgres — aceasta trebuie sa fie identica cu valoarea campului Parola BD din ecranul Configurare POS al magazinului din EMSYS ERP.
Descarcare si configurare magazin_oui.jar
- Accesati Logistics → Vanzari & Retail → Setari → Magazine, selectati magazinul.
- Apasati Configurare POS si completati parametrii de conexiune (utilizator ERP, parola BD, port Tomcat etc.).
- Apasati Generare link, copiati link-ul generat si deschideti-l pe calculatorul server.
- Fisierul magazin_oui.jar se descarca si se salveaza. Lansati-l pentru a porni serverul POS.
Notă

Dupa orice modificare a parametrilor din Configurare POS (port, parola, utilizator), link-ul trebuie regenerat si redistribut pe statia server.

Instalare pe calculatoarele statii de vanzare (client)

Instalare Amazon Corretto 8 (64-bit)

Identic cu instalarea de pe server (aceeasi versiune 64-bit).
Descarcare si instalare devices.jar

Accesati devices.emsys.ro si descarcati fisierul devices.jar. Configurati-l cu portul si setarile corespunzatoare casei de marcat conectate pe acea statie, conform sectiunii Configurare Devices de mai jos.
Descarcare ClientPos.jar

Pe calculatorul statie de vanzare, deschideti browserul si accesati:
```
http://<numeserver>:29997/
```
unde <numeserver> este numele sau adresa IP a calculatorului server POS din retea. Descarcati fisierul ClientPos.jar si salvati-l pe Desktop pentru acces rapid.

Configurare Devices 

Sinonime si termeni alternativi

Devices = dispozitive periferice = hardware POS | Casa de marcat = imprimanta fiscala = fiscal printer | Terminal bancar = POS bancar = terminal plata card = pay terminal | FiscalNet = driver comunicare casa de marcat | Folder bonuri = folder comunicare fisiere = director bonuri fiscale

Modulul Devices (devices.jar) permite configurarea dispozitivelor hardware conectate la statia de vanzare: imprimante fiscale (case de marcat) si terminale de plata cu cardul (POS bancar). Configurarile realizate in acest modul sunt necesare pentru ca statia POS sa poata emite bonuri fiscale si sa proceseze platile cu cardul.

Notă

Aplicatia Devices ruleaza separat de EMSYS POS si se gaseste de obicei in bara de taskuri Windows sau ca shortcut pe desktop. Orice modificare de configuratie necesita salvare si repornire server inainte de testare.

Inainte de configurarea dispozitivelor, asigura-te ca:

driverul casei de marcat (ex: FiscalNet Plus) este instalat si functional pe statia de lucru
folderul de comunicare fisiere (ex: C:\FiscalNet\Bonuri) exista pe disc si este accesibil
ai la dispozitie specificatia tehnica a casei de marcat (necesar pentru corespondenta cote TVA si simboluri plata)
terminalul bancar este configurat si inregistrat in aplicatia FiscalNet Plus (necesar pentru a obtine ID-ul terminalului)

Sectiunea Imprimante Fiscale din tab-ul Configurari al aplicatiei Devices gestioneaza comunicarea dintre EMSYS si casa de marcat prin intermediul unui driver (ex: FiscalNet).

Campuri configurare imprimanta fiscala
Camp	Obligatoriu	Descriere
Device name	Da	Numele dispozitivului. Valoarea trebuie sa fie exact `FISCAL_PRINTER`. Orice alta valoare va impiedica recunoasterea dispozitivului de catre EMSYS POS.
Tip dispozitiv	Da	Tipul driverului folosit pentru comunicarea cu casa de marcat (ex: `Fiscal Printer Generic` pentru FiscalNet). Valoarea corecta se gaseste in documentatia tehnica a driverului.
Folder comunicare fisiere	Da	Calea catre directorul unde driverul genereaza fisierele de comanda pentru casa de marcat (ex: `C:\FiscalNet\Bonuri`). Folderul trebuie sa existe pe disc si sa fie configurat identic in setarile driverului casei de marcat.
TVA A / B / C / D / E / F / N	Da	Corespondenta dintre cotele TVA definite in EMSYS si pozitia lor pe casa de marcat. Valorile posibile sunt numere de la 1 la 7 (sau alt interval, conform specificatiei casei de marcat). Consulta raportul X al casei de marcat pentru a verifica ordinea cotelor configurate fizic pe aparat.
Simbol cash	Da	Codul numeric al metodei de plata numerar, conform specificatiei casei de marcat. Valoare uzuala: `0`.
Simbol card	Da	Codul numeric al metodei de plata card, conform specificatiei casei de marcat. Valoare uzuala: `1`.
Simbol bon valoric	Da	Codul numeric al metodei de plata bon valoric, conform specificatiei casei de marcat. Valoare uzuala: `2`.
Simbol plata moderna	Nu	Codul numeric al metodei de plata moderna (ex: voucher electronic). Daca nu este utilizata, se lasa pe `Simbol plata nesetat`.
Cod ECR	Da	Codul de identificare al casei de marcat in driverul FiscalNet. Valoare uzuala: `1`.

Atenționare

Corespondenta cote TVA — Valorile campurilor TVA A–N reprezinta pozitia cotei respective in memoria casei de marcat, nu valoarea procentuala. Eroarea de corespondenta genereaza bonuri fiscale cu cote TVA incorecte. Consulta intotdeauna raportul X al casei de marcat inainte de configurare.

Atenționare

Simboluri metode de plata — Unele modele de casa de marcat accepta doar valorile 0, 1, 2 pentru simbolurile de plata. Consulta specificatia tehnica a modelului tau inainte de a introduce valori diferite.

Procedura — Adaugare imprimanta fiscala:

Deschide aplicatia Devices.
In tab-ul Configurari, apasa pe Imprimante Fiscale din panoul din stanga.
Apasa butonul Adauga dispozitiv.
In fereastra Adauga dispozitiv, selecteaza tipul driverului din lista Dispozitiv (ex: FiscalNet Printer Server).
Apasa Salveaza. Dispozitivul nou apare in lista cu numele implicit FISCAL_PRINTER.
Selecteaza dispozitivul FISCAL_PRINTER din lista.
Completeaza campurile conform tabelului de mai sus: verifica ca Device name este FISCAL_PRINTER, seteaza Folder comunicare fisiere, corespondenta TVA A–N, simbolurile de plata si Cod ECR.
Apasa Salveaza.
Mergi la tab-ul Server si apasa Restart Server.
Dupa repornire, apasa Testeaza pentru a verifica comunicarea cu casa de marcat.

Sectiunea Terminale Plata (POS) gestioneaza terminalele bancare integrate cu EMSYS pentru procesarea automata a platilor cu cardul. Integrarea se realizeaza prin driverul FiscalNet, singurul driver care suporta configurare automata a terminalului POS.

Campuri configurare terminal de plata
Camp	Obligatoriu	Descriere
Device name	Da	Numele dispozitivului. Valoarea de baza este `PAY_TERMINAL`. Pentru un terminal bancar dedicat unei banci specifice, se adauga sufixul `#BANCA` (ex: `PAY_TERMINAL#ING`, `PAY_TERMINAL#BCR`, `PAY_TERMINAL#BRD`). Aceasta conventie permite configurarea mai multor terminale simultan.
Tip dispozitiv	Da	Tipul driverului. Se selecteaza `Fiscal Net`. Acesta este singurul driver care suporta configurare automata a platii cu cardul in integrare cu EMSYS.
Tip Raspuns	Da	Defineste modul in care EMSYS interpreteaza raspunsul terminalului dupa finalizarea tranzactiei. Valori posibile: `Plata Card acceptata`, `Plata Card refuzata`, `Plata Card incerta`. Valoarea implicita recomandata: `Plata Card acceptata`.
Cod Device	Da	ID-ul terminalului bancar asa cum este configurat in aplicatia FiscalNet Plus (campul Id terminal din fereastra Setari POS Bancar). Aceasta valoare determina catre ce terminal fizic este directionata plata automata.

Notă

Corespondenta Cod Device cu FiscalNet Plus — In aplicatia FiscalNet Plus, deschide Setari POS Bancar si noteaza valoarea din campul Id terminal. Aceasta valoare trebuie introdusa identic in campul Cod Device din Devices. Exemplu: daca in FiscalNet Plus Id terminal = 3, atunci in Devices Cod Device = 3.

Procedura — Caz 1: Terminal generic (fara banca specifica)

Foloseste acest caz cand ai un singur terminal bancar sau cand nu este necesara selectia bancii la casa.

In tab-ul Configurari, apasa pe Terminale Plata (POS).
Selecteaza PAY_TERMINAL din lista.
Seteaza Tip Raspuns la Plata Card acceptata.
Completeaza Cod Device cu ID-ul terminalului din FiscalNet Plus daca este cazul.
Apasa Salveaza, apoi Restart Server din tab-ul Server.
Dupa repornire, apasa Testeaza.

Procedura — Caz 2: Terminal bancar dedicat (ex: ING)

Foloseste acest caz cand ai mai multe terminale bancare (de la banci diferite) si doresti ca operatorul sa selecteze banca la efectuarea platii cu cardul.

In tab-ul Configurari, apasa pe Terminale Plata (POS).
Apasa Adauga dispozitiv si creeaza un dispozitiv nou cu numele PAY_TERMINAL#ING (inlocuieste ING cu numele bancii corespunzatoare).
Seteaza Tip dispozitiv la PaymentTerminalGeneric.
Seteaza Tip Raspuns la Plata Card acceptata.
In campul Cod Device, introdu ID-ul terminalului din FiscalNet Plus (ex: 3).
Apasa Salveaza.
Repeta pasii 2–6 pentru fiecare banca suplimentara (ex: PAY_TERMINAL#BCR, PAY_TERMINAL#BRD).
Mergi la tab-ul Server si apasa Restart Server.
Dupa repornire, apasa Testeaza pentru fiecare terminal configurat.

Notă

Selectia bancii la plata cu cardul — Cand sunt configurate mai multe terminale cu sufix #BANCA, la efectuarea platii cu cardul din Client POS va fi afisata o lista cu toate terminalele bancare disponibile. Operatorul selecteaza banca corespondenta terminalului fizic catre care se trimite automat plata. Aceasta optiune nu este disponibila pentru terminalele configurate cu plata manuala.

Tab-ul Server din aplicatia Devices permite pornirea, oprirea si repornirea serviciului care asigura comunicarea dintre EMSYS si dispozitivele configurate.

Butoane server
Buton	Functie
Start Server	Porneste serviciul. Apare mesajul `Server started` in log.
Stop Server	Opreste serviciul. Apare mesajul `Server stopped` in log.
Restart Server	Opreste si reporneste serviciul. Necesar dupa orice modificare de configuratie.
Clear log	Sterge istoricul mesajelor din fereastra de log.
IP Restrict	Permite restrictionarea accesului la server pe baza adresei IP (configuratie avansata).
Port	Portul pe care serverul asculta conexiunile (implicit: `21040`). Nu modifica fara consultarea documentatiei tehnice.

Important

Dupa orice modificare in tab-ul Configurari (adaugare dispozitiv, modificare campuri, stergere dispozitiv), este obligatorie apasarea Restart Server inainte de testare. Modificarile nu se aplica pana la repornirea serverului.

Flux de pornire — ordinea corecta 

Respectati ordinea de mai jos la fiecare deschidere de zi. Nerespectarea ordinii poate duce la erori de conexiune sau la imposibilitatea emiterii bonurilor fiscale.

Pas	Actiune	Detalii
1	Porniti calculatorul server POS	PostgreSQL porneste automat odata cu sistemul de operare (serviciu Windows/Linux). Asteptati ca sistemul sa fie complet incarcat.
2	Lansati magazin_oui.jar pe server	Deschideti fisierul magazin_oui.jar de pe serverul POS. Asteptati mesajul de confirmare ca serverul este pornit si conectat la baza de date.
3	Efectuati Preluare liste PLU din POS Console	Aceasta operatie descarca pe statia server toate modificarile de configuratie din ERP: liste PLU actualizate, utilizatori noi, PIN-uri, setari magazin. Se efectueaza obligatoriu dupa orice modificare de configuratie si recomandat la inceputul fiecarei zile de lucru.
4	Porniti calculatorul statie de vanzare (client)	Daca serverul si statia client sunt calculatoare separate, porniti statia client dupa ce serverul este complet functional.
5	Verificati driverul casei de marcat	Asigurati-va ca aplicatia driver a casei de marcat (FiscalNet, FiscalWire etc.) este pornita si comunica corect cu echipamentul. Testati printr-un raport X sau bon nefiscal.
6	Lansati devices.jar	Porniti aplicatia devices.jar pe statia de vanzare. Aceasta trebuie sa fie activa inainte de lansarea ClientPos.jar. Verificati in interfata devices.jar ca echipamentele (casa de marcat, terminal bancar) sunt detectate si in stare OK.
7	Lansati ClientPos.jar	Deschideti fisierul ClientPos.jar de pe Desktop. La prima lansare a zilei, casierul se autentifica cu codul de utilizator si PIN-ul configurat. Selectati contul POS corespunzator si deschideti ziua de lucru.

Atenționare

ClientPos.jar nu trebuie lansat inaintea devices.jar. Daca devices.jar nu este pornit la momentul lansarii ClientPos.jar, comunicarea cu casa de marcat nu va fi stabilita, iar emiterea bonurilor fiscale va fi imposibila pana la repornirea aplicatiei in ordinea corecta.

Erori posibile la pornire 

Eroare / Simptom	Cauza si remediu
magazin_oui.jar nu porneste / eroare conexiune baza de date	Parola utilizatorului `postgres` nu corespunde cu valoarea din campul Parola BD din Configurare POS; verificati si aliniati cele doua valori.
ClientPos.jar nu se conecteaza la server	magazin_oui.jar nu este pornit pe server sau adresa/portul serverului este incorect; verificati ca serverul ruleaza si ca portul `29997` nu este blocat de firewall.
Casa de marcat nu emite bon fiscal	Driverul casei de marcat nu este pornit sau portul de comunicare (USB/serial) este ocupat de alt dispozitiv; verificati driverul si setarile de port.
La selectare produs in aplicatia ClientPos.jar apare mesajul: Serverul de la adresa http://localhost:21040 nu este pornit!	devices.jar nu este pornit.
Casierul nu se poate autentifica in ClientPos.jar	PIN-ul nu este setat sau responsabilul nu este asociat contului POS; verificati pasii de configurare din Pasul 8 — Definire utilizator POS. Dupa orice modificare de utilizatori, efectuati Preluare liste PLU.
Modificarile de configuratie nu apar in ClientPos.jar	Operatia Preluare liste PLU nu a fost efectuata dupa modificare; rulati-o din POS Console (pasul 3 din fluxul de pornire).
Scannerul nu adauga automat produsul dupa scanare	Scannerul nu trimite comanda ENTER dupa cod; configurati suffix-ul ENTER conform manualului scannerului.
Terminalul bancar nu primeste suma automat din POS	Terminalul nu este configurat in mod automat de catre banca sau campul Plata CARD Automata nu este setat la `DA` in Setari Magazine; contactati banca pentru reconfigurarea terminalului.