Retail (POS)

Aceasta sectiune ofera exemple practice si solutii rapide pentru rezolvarea situatiilor frecvent intalnite pe fluxul de Vanzari - Retail (comert cu amanuntul), la nivelul aplicatiei.

Sectiunea A — Utilizare POS (Casieri si Operatori)

A.1 Erori la pornire si autentificare

Simptom: PIN-ul este respins la autentificarea in ``ClientPos.jar``.

Cauze si rezolvare:

  • PIN-ul nu a fost inca setat (stare NESETAT) — contactati administratorul pentru setarea PIN-ului in Administrare > PIN Utilizatori POS.

  • PIN-ul a fost introdus gresit — reincercati; PIN-ul implicit este identic cu codul de utilizator (ex: utilizator 10, PIN 10).

  • S-a efectuat o modificare de configuratie fara a rula ulterior Preluare Liste PLU — solicitati administratorului sa ruleze operatia.

Configurarea PIN-ului este descrisa in Pasul 8 — Definire utilizator POS.


Simptom: La autentificare apare mesajul ``Nu aveti drepturi pe acest POS``.

Cauza: Responsabilul corespunzator utilizatorului nu este asociat contului POS selectat sau asocierea este inactiva.

Rezolvare: Contactati administratorul pentru a verifica si reactiva asocierea responsabilului in Roluri Responsabili Asociati al contului POS (vezi Pasul 4 — Asociere Responsabili (Roluri Responsabili Asociati)).


Simptom: ``ClientPos.jar`` nu se conecteaza la server — eroare de conexiune la lansare.

Cauze si rezolvare in ordine:

  1. magazin_oui.jar nu este pornit pe server — lansati-l si asteptati mesajul de confirmare ca serverul este activ.

  2. Portul 29997 este blocat de firewall — contactati IT pentru deblocare.

  3. Adresa IP sau hostname-ul serverului POS este incorect in configuratia statiei client.


Simptom: Modificarile de configuratie (utilizator nou, pret nou) nu apar in ``ClientPos.jar``.

Cauza: Operatia Preluare Liste PLU nu a fost efectuata dupa modificarea de configuratie in ERP.

Rezolvare: Rulati Preluare Liste PLU din POS Console pe serverul POS (vezi Flux de pornire — ordinea corecta, pasul 3).


A.2 Erori la adaugarea articolelor pe bon

Simptom: La adaugarea unui articol pe bon apare eroarea ``Serverul de la adresa http://localhost:21040 nu este pornit!``

Cauza: Aplicatia EMSYS Devices (devices.jar) nu este pornita.

Rezolvare:

  1. Inchideti ClientPos.jar.

  2. Porniti devices.jar si asteptati ca serverul sau sa fie activ (iconita vizibila in tray).

  3. Relansati ClientPos.jar in ordinea corecta.

Detalii in Flux de pornire — ordinea corecta.


Simptom: Dupa scanarea unui cod de bare, produsul nu se adauga automat pe bon. Trebuie apasat Enter manual.

Cauza: Scannerul nu trimite comanda ENTER dupa cod.

Rezolvare: 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.


A.3 Erori la inchiderea bonului — casa de marcat

Important

Consultati intotdeauna Raportul X inainte de orice actiune pentru a stabili daca bonul a fost sau nu fiscalizat pe casa de marcat.

Simptom A — EMSYS Devices nu este pornit:

  • La adaugarea unui articol: Serverul de la adresa http://localhost:21040 nu este pornit!

  • La inchiderea bonului: acelasi mesaj de eroare.

Rezolvare: Porniti sau reporniti componenta EMSYS Devices (devices.jar), apoi reluati procesul de la inceput in ordinea corecta de lansare.


Simptom B — Driver-ul casei de marcat nefunctional sau articol cu TVA gresit:

  • Aplicatia POS asteapta pana la 30 de secunde, apoi afiseaza: Bonul nu s-a putut tipari.

  • Apare mesajul: ERROR: Nu exista fisierul de iesire. Verificati functionalitatea driver-ului si a imprimantei.

Rezolvare:

  1. Verificati si reporniti driver-ul casei de marcat (FiscalNet, FiscalWire).

  2. Dupa repornire, verificati in Raportul X daca bonul a fost emis pe casa:

    • Daca bonul a fost emis: apasati Conf. Emitere pentru a inchide tranzactia in POS fara a retipari.

    • Daca bonul nu a fost emis: apasati din nou Inchidere Bon.

  3. Daca problema persista dupa repornirea driverului, verificati grupa de TVA a articolelor de pe bon — un Simbol TVA nealocat pe casa genereaza eroare la tiparire.


Simptom C — Terminarea rolei de hartie in timpul tipariri:

  • Casa tipareste partial bonul; bonul nu este fiscalizat.

  • In POS apare: Bonul nu s-a putut tipari.

Rezolvare:

  1. Inlocuiti rola de hartie.

  2. Verificati daca driver-ul casei tipareste automat bonul ramas (functionalitate implementata in unele drivere).

  3. Verificati in Raportul X daca bonul a fost emis dupa inlocuirea rolei:

    • Daca bonul a fost emis: apasati Conf. Emitere.

    • Daca bonul nu a fost emis: apasati Inchidere Bon.

Atenționare

In cazul lipsei de hartie, comanda de tiparire ramane activa in EMSYS POS. Din punct de vedere al aplicatiei, bonul a fost trimis catre casa de marcat — nu efectuati o noua tiparire fara a consulta mai intai Raportul X.


A.4 Erori la plata cu cardul — terminal bancar

Simptom: Terminalul bancar nu raspunde sau nu primeste suma automat din POS.

Cauze si rezolvare:

  1. Terminalul nu este configurat in mod automat de catre banca — contactati banca pentru reconfigurarea terminalului in mod automat.

  2. Campul Plata CARD Automata nu este setat la DA in Setari Magazine pentru statia respectiva — contactati administratorul (vezi Setari Magazine). Dupa modificare, efectuati Preluare Liste PLU.

  3. Lipsa semnal internet sau cablu deconectat — verificati conexiunea fizica si semnal; dupa restabilire, folositi butonul Conf. Plata pentru a finaliza tranzactia in asteptare.

Atenționare

Nu reluati tranzactia pe terminalul bancar inainte de a folosi butonul Confirmare Plata. Aceasta poate duce la dubla incasare a clientului.


A.5 Erori la inchiderea turei

Simptom: Raportul Z nu poate fi generat sau este blocat.

Cauza posibila: Exista un bon deschis (neinchis) pe casa. In unele modele de case de marcat, Raportul Z este blocat pana la inchiderea tuturor tranzactiilor.

Rezolvare: Verificati daca exista tranzactii deschise in POS si inchideti-le. Consultati driverul casei de marcat sau furnizorul echipamentului fiscal daca problema persista.


Sectiunea B — Backend POS (Responsabili Magazin)

B.1 Erori la liste PLU

Simptom: Lista PLU nu poate fi lansata.

Cauze si rezolvare:

  • Lista nu are produse adaugate — adaugati cel putin un produs in Pozitii Lista.

  • Produsele au campuri obligatorii incomplete (Pret, UM, Cod TVA) — verificati si completati datele lipsa.


Simptom: Lista PLU nu poate fi activata.

Cauze si rezolvare:

  • Lista nu se afla in starea LANSATA — parcurgeti mai intai operatia de Lansare.

  • Exista deja o alta lista ACTIVA pentru acelasi magazin — blocati lista activa curenta inainte de activarea celei noi.


Simptom: Produsele noi din lista PLU activa nu apar in POS dupa activare.

Cauza: Operatia Preluare Liste PLU nu a fost efectuata pe statie dupa activarea listei.

Rezolvare: Rulati Preluare Liste PLU din POS Console pe serverul POS. Pana la sincronizare, statia continua sa foloseasca lista anterioara.


Simptom: Un articol nu apare in POS desi este in lista PLU activa.

Verificati in ordine:

  1. Articolul este adaugat in Pozitii Lista ale listei PLU active (nu intr-o lista cu starea BLOCATA sau LANSATA).

  2. A fost efectuata Preluare Liste PLU pe statie dupa adaugarea articolului.

  3. Campul Simbol TVA al articolului este completat corect — un Simbol TVA lipsa impiedica tiparirea bonului cu acel articol.


Simptom: La adaugarea unui produs in lista PLU, pretul nu se completeaza automat.

Cauza: Articolul nu are pret definit in lista de preturi ERP pentru grupa de parteneri selectata.

Rezolvare: Definiti pretul in Vanzari & Retail → Lista de Preturi Vanzare sau introduceti pretul manual in campul Pret din Pozitii Lista.


Simptom: La vanzare in POS apare eroarea ``articol negasit in lista PLU``.

Cauze si rezolvare:

  • Produsul nu a fost adaugat in lista PLU activa — verificati Pozitii Lista.

  • Lista PLU nu a fost sincronizata pe statie — rulati Preluare Liste PLU.


Simptom: Butonul Redeschidere nu este disponibil pentru o lista.

Cauza: Lista se afla in stare BLOCATA (stare finala) — editarea nu mai este posibila.

Rezolvare: Creati o lista noua sau utilizati functia Copiaza pentru a duplica lista existenta si modificati copia.


Simptom: Doua magazine primesc preturi diferite pentru acelasi articol.

Cauza: Cele doua magazine sunt asociate la liste PLU diferite cu preturi diferite.

Rezolvare: Verificati asocierile din butonul Magazine al fiecarei liste PLU si aliniati preturile sau asocierile dupa necesitati.


B.2 Erori la preluarea vanzarilor din POS

Simptom: Preluarea esueaza cu eroarea ``Unitate de masura diferita``.

Cauza: Vanzarea a fost efectuata intr-o unitate de masura diferita fata de unitatea definita in stoc (ex: vanzare in portii, stoc in grame).

Rezolvare: Adaugati conversia corespunzatoare in Logistics > Definitii Logistica > Unitati de masura, astfel incat aplicatia sa stie cate grame corespund unei portii.


Simptom: Preluarea esueaza cu eroarea ``Stoc insuficient``.

Cauze si rezolvare:

  1. Intrari lipsa sau incorecte — operati sau corectati documentul de intrare (NIR, Transfer sau Nota de predare).

  2. Vanzare efectuata pe cod gresit — intrarea s-a facut pe articolul A, dar vanzarea s-a inregistrat pe articolul B (acelasi produs, cod de bare diferit). Utilizati Actualizare Cod Articol Preluare pentru a pointa bonul catre articolul cu stoc disponibil, apoi stornati eventualele documente generate eronat si reluati preluarea.


Simptom: Preluarea esueaza cu eroarea ``Articol inactiv sau in afara perioadei de activitate``.

Cauze si rezolvare:

  • Articolul din POS nu este activ in nomenclatorul ERP — modificati starea sau perioada de activitate in nomenclatorul de articole.

  • Articolul din POS este gresit (cod de bare eronat in PLU) — identificati articolul corect si utilizati Actualizare Cod Articol Preluare, corectand si Lista PLU pentru a preveni repetarea erorii.


Simptom: Preluarea esueaza cu eroarea ``Lipsa comanda sau client``.

Cauza: Pentru magazinul selectat sunt definite mai multe comenzi sau mai multi clienti disponibili si sistemul nu poate determina automat care se aplica.

Rezolvare: La reluarea preluarii, selectati manual comanda de vanzare si/sau clientul corespunzator gestiunii.


Simptom: Preluarea a reusit (OK) dar ulterior s-a constatat o eroare in documentele generate.

Rezolvare — procedura de corectie:

  1. Identificati Dispozitia de Livrare eronata dupa numarul de tranzactie afisat in tab-ul MESAJE PRELUARE VANZARI DIN POS pe inregistrarea marcata cu OK.

  2. Stornati Dispozitia de Livrare.

  3. Corectati eroarea identificata:

    • Cod articol gresit → utilizati Actualizare Cod Articol Preluare.

    • Unitate de masura lipsa → definiti transformarea in Logistics > Definitii Logistica > Unitati de masura.

    • Articol inactiv → corectati starea sau perioada de activitate in nomenclatorul de articole.

    • Lipsa comanda/client → selectati corect la reluarea preluarii.

  4. Efectuati o noua preluare — rezultatul corect va aparea in MESAJE PRELUARE ca OK.

Detalii complete in Backend_POS/sectiunea_2_4_corectii.


B.3 Erori la transferul incasarilor

Simptom: Transferul de incasari a generat note contabile eronate.

Rezolvare — procedura de corectie in ordine obligatorie:

  1. Stergeti obligatoriu operatiunile contabile generate in registrul de contabilitate.

  2. Efectuati Anulare Transfer Incasari din POS Agregat pe Magazin.

  3. Corectati bonurile cu probleme folosind Anulare / Reconfirmare Bonuri din POS.

  4. Reluati Transfer Incasari din POS Agregat pe Magazin.

Atenționare

Pasul 1 (stergerea operatiunilor contabile) este obligatoriu inainte de anularea transferului. Anularea fara stergerea prealabila a inregistrarilor contabile genereaza inconsistente in contabilitate.


Simptom: Soldul final al unui casier in Raportul de Casa nu este zero.

Cauza: Casierul nu a efectuat inchiderea de schimb.

Rezolvare: Solicitati casierului sa efectueze operatia Inchidere schimb din Actiuni > Numerar > Inchidere schimb in Client POS, apoi reluati verificarea si transferul.


Sectiunea C — Configurare Initiala Magazin POS (Administratori / IT)

C.1 Erori la pornirea componentelor

Simptom: ``magazin_oui.jar`` nu porneste — eroare de conexiune la baza de date.

Cauza: Parola utilizatorului postgres din instalarea PostgreSQL nu corespunde cu valoarea campului Parola BD din ecranul Configurare POS al magazinului din EMSYS ERP.

Rezolvare: Aliniati cele doua valori — fie modificati parola PostgreSQL, fie corectati campul Parola BD si regenerati link-ul de pornire din Configurare POS.


Simptom: ``ClientPos.jar`` nu se conecteaza la server.

Cauze si rezolvare:

  • magazin_oui.jar nu este pornit pe server — lansati-l si asteptati confirmarea pornirii.

  • Adresa sau portul serverului este incorect — verificati ca portul 29997 nu este blocat de firewall si ca adresa IP/hostname-ul serverului este accesibil din retea.


Simptom: La selectarea unui produs in ``ClientPos.jar`` apare mesajul ``Serverul de la adresa http://localhost:21040 nu este pornit!``

Cauza: devices.jar nu este pornit.

Rezolvare: Inchideti ClientPos.jar, porniti devices.jar, asteptati confirmarea pornirii, apoi relansati ClientPos.jar.


Simptom: Casa de marcat nu emite bon fiscal dupa lansarea ``ClientPos.jar``.

Cauze si rezolvare in ordine:

  1. Driverul casei de marcat nu este pornit — porniti FiscalNet/FiscalWire si verificati comunicarea cu echipamentul.

  2. Portul de comunicare (USB/serial) este ocupat de alt dispozitiv — inchideti alte aplicatii care ar putea folosi acelasi port si reporniti driverul.

  3. Corespondenta TVA in Devices este gresita — verificati valorile TVA A–N fata de raportul X al casei (vezi mai jos).


Simptom: Casierul nu se poate autentifica in ``ClientPos.jar``.

Verificati in ordine:

  1. PIN-ul este setat (starea SETAT in PIN Utilizatori POS).

  2. Responsabilul corespunzator utilizatorului este asociat contului POS cu rol Operator activ.

  3. A fost efectuata Preluare Liste PLU dupa ultima modificare de utilizatori.

Detalii in Pasul 8 — Definire utilizator POS.


Simptom: Modificarile de configuratie nu apar in ``ClientPos.jar`` dupa salvarea in ERP.

Cauza: Operatia Preluare Liste PLU nu a fost efectuata dupa modificare.

Rezolvare: Rulati Preluare Liste PLU din POS Console (pasul 3 din fluxul de pornire in Flux de pornire — ordinea corecta).


C.2 Erori de configurare Devices

Simptom: Bonurile fiscale sunt emise cu cote TVA incorecte.

Cauza: Corespondenta cotelor TVA in Devices este gresita. Valorile TVA A–N reprezinta pozitia cotei in memoria casei de marcat, nu valoarea procentuala.

Rezolvare: Consultati raportul X al casei de marcat pentru a verifica ordinea cotelor configurate fizic pe aparat, aliniati valorile in Devices si efectuati Restart Server in Devices.

Atenționare

Eroarea de corespondenta TVA genereaza bonuri fiscale cu cote incorecte, cu impact fiscal. Verificati intotdeauna configuratia inainte de prima zi de vanzare pe o statie noua.


Simptom: Modificarile in tab-ul Configurari din Devices nu se aplica.

Cauza: Nu a fost efectuat Restart Server dupa modificare.

Rezolvare: In tab-ul Server din Devices, apasati Restart Server dupa orice modificare de configuratie. Modificarile nu se aplica pana la repornirea serverului.


Simptom: Terminalul bancar nu este detectat sau nu functioneaza in modul automat.

Cauze si rezolvare:

  1. Campul Cod Device in Devices nu corespunde cu Id terminal din FiscalNet Plus — verificati si aliniati valorile.

  2. Device name-ul nu respecta conventia PAY_TERMINAL sau PAY_TERMINAL#BANCA — corectati denumirea.

  3. Nu a fost efectuat Restart Server dupa configurare — reporniti serverul Devices.

  4. Terminalul nu este configurat in mod automat de catre banca — contactati banca.


C.3 Erori la configurarea utilizatorilor POS

Simptom: Utilizatorul nu apare in lista din ``PIN Utilizatori POS``.

Cauza: Utilizatorul nu este activ in Actualizare Utilizatori sau nu are profil POS asociat.

Rezolvare: In Actualizare Utilizatori, verificati ca utilizatorul are starea activa, profilul POS marcat ca Profil Implicit si grupul BU-ului magazinului bifat in tab-ul Grupuri.


Simptom: Utilizatorul nu poate accesa datele BU-ului magazinului la autentificarea in POS.

Cauza: Grupul corespunzator BU-ului magazinului nu este bifat pentru utilizator.

Rezolvare: In Actualizare Utilizatori, selectati utilizatorul, accesati tab-ul Grupuri si bifati grupul BU-ului magazinului. Efectuati Preluare Liste PLU dupa modificare.


Simptom: Casierul nu poate deschide casa in POS — acces refuzat.

Verificati in ordine:

  1. Responsabilul corespunzator utilizatorului este definit in Cash Management > Setari > Responsabili.

  2. Responsabilul este asociat contului POS cu rol Operator activ — verificati Roluri Responsabili Asociati din contul POS.

  3. Data de sfarsit a asocierii nu a expirat.

  4. A fost efectuata Preluare Liste PLU dupa ultima modificare de configuratie.

Detalii in Pasul 4 — Asociere Responsabili (Roluri Responsabili Asociati).


Simptom: Seriile de documente ale unui responsabil genereaza erori de numerotare.

Cauza: Seriile se suprapun cu seriile altui responsabil activ pe acelasi cont.

Rezolvare: Verificati Alocare Serii pentru toti responsabilii activi pe contul respectiv si ajustati intervalele astfel incat sa nu se suprapuna.


Sectiunea D — Scenarii de depanare recomandate (neacoperite inca)

Notă

Aceasta sectiune listeaza scenariile de eroare identificate ca relevante operational, ale caror proceduri de rezolvare necesita validare cu expertii EMSYS inainte de publicare. Rezolvarile marcate (de completat) sunt schite.


D.1 Utilizare POS

Simptom: Casa de marcat se defecteaza in mijlocul zilei de lucru.

Rezolvare (de completat): Procedura de urgenta — daca vanzarea poate continua pe alta statie, cum se gestioneaza numerarul manual, ce documente trebuie emise manual si cum se inregistreaza ulterior tranzactiile in ERP.


Simptom: S-a emis un bon fiscal cu pret gresit (eroare de scanare, pret vechi in PLU).

Rezolvare (de completat): Distinctia intre anularea bonului in POS (posibila inainte de preluare) si emiterea unui bon de corectura fiscala (reglementat de H.G. nr. 479/2003 si normele ANAF), cu descrierea documentelor ERP generate si procedura pas cu pas.


Simptom: Un client reclama o dubla incasare pe card.

Rezolvare (de completat): Procedura de verificare a tranzactiei in Vizualizare Bonuri din POS, verificarea settlement-ului in POS-ul bancar, si pașii de restituire/contestare.


D.2 Backend POS

Simptom: Preluarea vanzarilor esueaza sistematic pe un anumit cod de articol fara mesaj de eroare clar.

Rezolvare (de completat): Procedura de identificare a cauzei prin log-urile de preluare, verificarea configuratiei articolului (TVA, UM, stare) si pașii de corectie.


Simptom: Transferul incasarilor nu genereaza nota contabila.

Rezolvare (de completat): Verificarea definitiilor contabile asociate tipurilor de tranzactii, verificarea registrului contabil asociat contului POS si pașii de depanare.


Simptom: Raportul Zilnic Informativ arata valori diferite fata de raportul Z de pe casa de marcat.

Rezolvare (de completat): Procedura de reconciliere — identificarea discrepantelor, cauzele posibile (bonuri nesincronizate, tranzactii anulate partial, diferente de fus orar) si pașii de corectie.


D.3 Configurare initiala

Simptom: EMSYS POS functioneaza offline dar nu sincronizeaza vanzarile la revenirea conexiunii.

Rezolvare (de completat): Descrierea mecanismului de sincronizare automata vs manuala, verificarea log-urilor de sincronizare si pașii de fortare a sincronizarii manuale.


Simptom: Componentele EMSYS POS nu pornesc dupa un update de sistem de operare Windows.

Rezolvare (de completat): Verificarea compatibilitatii Java (Amazon Corretto 8), verificarea permisiunilor de executie ale fisierelor .jar dupa update, si configurarile de antivirus/firewall care pot bloca componentele Java.


Simptom: PostgreSQL nu porneste automat la repornirea calculatorului server.

Rezolvare (de completat): Verificarea configuratiei serviciului PostgreSQL in Windows Services, reconfigurarea modului de pornire la Automatic, si pașii de recuperare daca baza de date emsyspos este corupta.


Vezi și

  • Utilizare POS: Utilizare_POS/index

  • Backend POS: Backend_POS/index

  • Configurare initiala magazin: Configurare_Magazine_POS/index

  • Intrebari frecvente (Q&A): Q&A_Retail(POS)>>>>>>> .r9001