============= 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 :ref:`casierie-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 :ref:`casierie-responsabili`). ---- **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 :ref:`statii-flux-pornire`, 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 :ref:`statii-flux-pornire`. ---- **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*. .. warning:: 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 :ref:`magazine-setari`). 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. .. warning:: 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. ---- .. _ts-backend: 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 :doc:`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**. .. warning:: 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. ---- .. _ts-configurare: 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 :ref:`casierie-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 :ref:`statii-flux-pornire`). ---- 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. .. warning:: 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 :ref:`casierie-responsabili`. ---- **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. ---- C.4 Erori la generarea link-ului de pornire POS ------------------------------------------------- **Simptom: Link-ul de pornire nu se genereaza.** Cauza: Campurile obligatorii (Utilizator ERP, Port BD, Port Tomcat) nu sunt completate in ecranul **Configurare POS**. Rezolvare: Completati toate campurile obligatorii si apasati din nou **Generare link**. ---- **Simptom: Eroare de autentificare la pornirea ``magazin_oui.jar`` din link.** Cauza: Utilizatorul ERP sau parola ERP din **Configurare POS** este incorecta. Rezolvare: Reverificati campurile **Utilizator ERP** si **Parola ERP**, regenerati link-ul si redistribuiti-l pe statie. ---- **Simptom: ``magazin_oui.jar`` nu se conecteaza la baza de date dupa lansarea din link.** Cauze si rezolvare: - **Host BD** sau **Port BD** incorect — verificati adresa serverului PostgreSQL si ca portul ``5432`` nu este blocat de firewall. - Parola BD nu corespunde cu parola utilizatorului ``postgres`` din PostgreSQL — aliniati valorile si regenerati link-ul. ---- .. _ts-propuneri: Sectiunea D — Scenarii de depanare recomandate (neacoperite inca) ================================================================== .. note:: 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. ---- .. seealso:: * Utilizare POS: :doc:`Utilizare_POS/index` * Backend POS: :doc:`Backend_POS/index` * Configurare initiala magazin: :doc:`Configurare_Magazine_POS/index` * Intrebari frecvente (Q&A): :doc:`Q&A_Retail(POS)`>>>>>>> .r9001