.. _magazine: ============================== Sectiunea 3.1 Definire Magazin ============================== .. contents:: Cuprins :local: :depth: 1 Scop ---- Modulul **Magazine** permite definirea si configurarea magazinelor (punctelor de vanzare) din cadrul retelei comerciale. Aici se inregistreaza datele de identificare ale fiecarui magazin, conturile contabile asociate, integrari externe si parametrii de functionare ai statiilor POS. Sinonime si termeni alternativi: *magazin*, *punct de vanzare*, *unitate comerciala*, *locatie*, *store*. Prerechizite ------------ - Utilizatorul de configurare (poate fi utilizator de administrare, utilizator contabilitate, utilizator backend magazin, sau utilizator POS) trebuie sa aiba drepturi de administrare pentru modulul Vanzari & Retail. In |adm_path_utilizatori| se selecteaza utilizatorul si se verifica in tab Drepturi daca este adaugata functia 2.2 Vanzari & Retail, iar in tab Business Units daca BU pe care se afla magazinul este bifat. - Business Unit: daca exista cel putin o entitate **BU** (Business Unit) aceasta este propusa implicit. |fi_path_bu| - Zona / Purtator se definesc in |fi_path_oc| sunt obligatorii pentru fiecare magazin in parte. - Gestiuni: se defineste o gestiune de tip M magazin, cu optiunea sa permita descarcarea pe stoc negativ sau nu, se selecteaza zona si purtator definite mai sus |lo_path_definitii_logistica_gestiuni| - Regiune, Tara, Judet, Localitate, acestea sunt deja definite pentru alte module ERP, accesati |adm_path_arii| pentru actualizare daca este cazul. - Cont Client, Cont Marfa se definesc in |fi_path_conturi| consultati dep. contabilitate pentru confirmarea lor. .. _magazine-ecran-principal: Ecranul principal Magazine -------------------------- La accesarea modulului se afiseaza lista magazinelor existente, cu posibilitate de filtrare rapida. Fiecare inregistrare afiseaza **numele magazinului** (evidentiat cu verde) si gestiunea asociata (format: ``Gestiune: | ``). Actiuni disponibile: - **Adauga** — adaugare magazin nou. - **Modifica** — editare magazin selectat. - **Copiaza** — copiaza magazinul selectat. - **Sterge** — sterge magazinul selectat. Actiuni disponibile in lista: - **Filtrare rapida** — camp de cautare text in timp real pentru localizarea rapida a unui magazin. - **Setari** - optiuni filtrare si sortare in lista - **Import/Export** — permite exportul listei de magazine in format XLSX. In partea dreapta-sus a ecranului sunt disponibile trei butoane de configurare avansata: - :ref:`magazine-setari` - :ref:`magazine-gestiuni` - :ref:`magazine-configurare-pos` .. _magazine-formular: Adaugare Magazin ---------------- Ecranul este impartit in patru sectiuni: **Descriere**, **Conturi**, **Integrari** si **Particularitati**. Sectiunea Descriere ^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 25 15 60 * - Camp - Obligatoriu - Descriere * - Cod Magazin - DA - Identificator numeric unic al magazinului in sistem (ex: ``1``). * - Cod Retea - NU - Cod utilizat in contextul retelelor de magazine (lant comercial). * - Nume Magazin - DA - Denumirea completa a magazinului (ex: ``MAGAZIN PITESTI``). * - Tip - DA - Tipul unitatii. Valori posibile: ``POS``, ``Amanunt``, pentru Amanunt devin dipobile campurile Adaos Comercial, TVA Neexigibil, Venit, Cheltuieli din sectiunea Conturi. * - BU - DA - Business Unit-ul caruia ii apartine magazinul (In cazul in care este definit un singur BU acesta va fi propus implicit). * - Gestionar - DA - Numele gestionarului responsabil - (ex: ``G1``). * - Partener - NU - Partenerul ERP asociat magazinului. * - Agent - NU - Agentul de vanzari asociat. * - Regiune - DA - Codul regiunii geografice (ex: ``1`` — ``ROMANA``). * - Tara - DA - Codul tarii (ex: ``RO`` — ``Romania``). * - Judet - DA - Codul judetului (ex: ``AG`` — ``ARGES``). * - Localitate - DA - Codul localitatii (ex: ``AG999`` — ``PITESTI``). * - Adresa - DA - Adresa fizica a magazinului (ex: ``Str. Exercitiu, Nr. 10, Parter``). * - Telefon - DA - Numarul de telefon al magazinului. Sectiunea Conturi ^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 25 15 60 * - Camp - Obligatoriu - Descriere * - Cont Client - NU - Contul contabil pentru clienti (ex: ``411x``) se completeaza cand operatiile se desfasora pe activitati si sunt necesare conturi distincte diferite de cele implicite. * - Marfa - DA - Contul contabil pentru marfuri (ex: ``3711`` — ``MARFURI``). * - Adaos Comercial - NU - Contul de adaos comercial (disponibil doar pentru tip magazin = Amanunt). * - TVA Neexigibil - NU - Contul de TVA neexigibil (disponibil doar pentru tip magazin = Amanunt). * - Venit - NU - Contul de venituri din vanzari (disponibil doar pentru tip magazin = Amanunt). * - Cheltuieli - NU - Contul de cheltuieli (disponibil doar pentru tip magazin = Amanunt). Sectiunea Integrari ^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 25 15 60 * - Camp - Obligatoriu - Descriere * - Online - DA - Activeaza integrarea cu platforma de comert online. Valori: ``DA`` / ``NU``. * - Kiosk - DA - Activeaza modul kiosk (autoservire). Valori: ``DA`` / ``NU``. Sectiunea Particularitati ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 25 15 60 * - Camp - Obligatoriu - Descriere * - Stare - DA - Starea magazinului. Valori: ``Activ`` / ``Inactiv``. * - Data Inceput - DA - Data de la care este activ magazinul (format: ``ZZ.LL.AAAA``). * - Data Sfarsit - DA - Data pana la care este activ (implicit: ``31.12.2999`` pentru fara limita). * - Zona - NU - Codul zonei comerciale (ex: ``201`` — ``MAGAZIN PITESTI``). * - Purtator - NU - Codul purtatorului de cost asociat (ex: ``2011`` — ``Magazin Pitesti``). Procedura — Adaugare magazin nou ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. Din lista Magazine, apasa butonul **+ Adauga** (dreapta jos). 2. Completeaza campurile obligatorii din sectiunea **Descriere**: Cod Magazin, Nume Magazin, Tip, BU, Tara, Judet, Localitate. 3. Completeaza sectiunea **Conturi** — cel putin campul **Marfa** cu contul contabil corespunzator. 4. In sectiunea **Integrari**, seteaza ``Online`` si ``Kiosk`` cu ``NU`` daca nu sunt necesare. 5. In sectiunea **Particularitati**, seteaza **Stare** = ``Activ`` si completeaza **Data Inceput**. 6. Salveaza inregistrarea. .. note:: Dupa salvarea magazinului, continua cu configurarea statiilor POS prin butonul :ref:`magazine-setari` si generarea link-ului de conexiune prin :ref:`magazine-configurare-pos`. Rezultat ^^^^^^^^ Magazinul apare in lista cu numele evidentiat cu verde si gestiunea asociata afisata dedesubt. Erori posibile ^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 40 60 * - Eroare - Cauza si remediu * - Camp obligatoriu necompletat - Sistemul marcheaza campul lipsa; completeaza toate campurile obligatorii inainte de salvare. * - Cod magazin duplicat - Codul introdus exista deja; foloseste un cod unic. * - Contul contabil invalid - Contul de marfa nu este activ sau nu se afla in perioada de activitate. ---- .. _magazine-setari: Setari Magazine --------------- **Cale:** Magazine → buton ``Setari Magazine`` (dreapta sus) Scop ^^^^ Sectiunea **Setari Magazine** permite configurarea parametrilor de functionare pentru fiecare statie POS (``Nr. pos``) din cadrul magazinului selectat. Fiecare statie poate avea setari individuale. Campuri disponibile ^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 30 15 55 * - Camp - Valori posibile - Descriere * - Nr. pos - Numeric - Numarul de identificare al statiei POS in cadrul magazinului (ex: ``1``). * - Afisare subgrupe pos - ``DA`` / ``NU`` - Controleaza daca subgrupele de articole sunt vizibile in interfata POS. * - Model vanzare pos - ``Magazin``, ``Cantina``, ``Self Sale`` - Defineste modelul de vanzare utilizat la casa. ``Magazin`` = vanzare standard cu scanner/tastatuta. * - Model propunere client - ``DA`` / ``NU`` - Reprezinta metoda de propunere a clientului la vanzare (ex: Angajati / Clienti, se selecteaza din lista in interfata POS). * - Afisare Cantitati Disp. - ``DA`` / ``NU`` - Daca ``DA``, casierul vede stocul disponibil pentru fiecare articol in POS. * - Plata CARD Automata - ``DA`` / ``NU`` - Daca ``DA``, plata prin card bancar este initiata automat catre terminalul integrat. Implica configurarea echipamentului bancar pe mod automat, sumele de plata se transmit direct de catre aplicatie catre echipamentul bancar, introducerea manuala a sumelor nu este disponibila. Daca ``NU``, plata prin card bancar este initiata manual de catre operator. Implica configurarea echipamentului bancar pe mod manual, introducerea sumei de plata se face manual din echipamentul bancar. Dupa modificarea acestei setari este necesara efectuarea operatiei Preluare liste PLU din POS pentru actualizarea setarilor. Procedura — Adaugare setari pentru o statie POS ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. Din ecranul **Magazine**, selecteaza magazinul dorit si apasa ``Setari Magazine``. 2. Apasa **+ Adauga** pentru a crea setari pentru o statie noua. 3. Introdu **Nr. pos** (numarul statiei, incepand de la ``1``). 4. Configureaza parametrii: model vanzare, afisare subgrupe, cantitati disponibile, plata card. 5. Salveaza. .. note:: Foloseste **Copiaza** pentru a duplica rapid setarile unei statii catre o statie noua, modificand doar ``Nr. pos``. Rezultat ^^^^^^^^ Setarile apar listate pe statie (``Nr. pos: 1``, ``Nr. pos: 2`` etc.) in ecranul Setari Magazine al magazinului respectiv. Erori posibile ^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 40 60 * - Eroare - Cauza si remediu * - Nr. pos duplicat - Exista deja setari pentru acel numar de statie; foloseste un alt numar sau modifica inregistrarea existenta. .. _magazine-pos-banca: Pos Banca — Configurare echipamente bancare ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ **Conditie de activare:** campul **Plata CARD Automata** trebuie setat la ``DA`` in setarile statiei POS. Cand plata automata cu cardul este activata, devine disponibila sectiunea **Pos Banca**, unde se definesc terminalele bancare (POS-urile fizice) asociate statiei. Fiecare terminal definit va putea fi selectat de casier in momentul initierii platii cu cardul in EMSYS POS. Sinonime: *terminal bancar*, *POS bancar*, *cititor card*, *echipament plata card*. Campuri formular Pos Banca ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. list-table:: :header-rows: 1 :widths: 25 20 55 * - Camp - Exemplu valoare - Descriere * - Nume POS - ``ING`` - Denumirea comerciala a terminalului bancar sau a bancii emitente. Aceasta denumire apare in lista de selectie din EMSYS POS la initierea platii cu cardul. * - Cod Device - ``1`` - Identificatorul numeric al dispozitivului fizic (terminalului) in cadrul statiei. Folosit pentru comunicarea software cu echipamentul bancar. * - Stare - ``Activa`` - Starea terminalului. Valori: ``Activa`` / ``Inactiva``. Doar terminalele cu starea ``Activa`` sunt propuse la plata in POS. Procedura — Adaugare terminal bancar ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. In ecranul **Setari Magazine**, asigura-te ca **Plata CARD Automata** este setata la ``DA`` pentru statia dorita. 2. In sectiunea **Pos Banca**, apasa butonul **+** (Adauga). 3. Completeaza campurile: - **Nume POS** — denumirea bancii sau terminalului (ex: ``ING``, ``BCR``, ``BRD``). - **Cod Device** — numarul de ordine al echipamentului fizic (ex: ``1``). - **Stare** — selecteaza ``Activa``. 4. Confirma salvarea cu butonul **✓** (bifa verde). Pentru anulare, apasa **✗** (X rosu). .. note:: Poti defini mai multe terminale bancare per statie (ex: ING si BCR). La initierea platii cu cardul in EMSYS POS, casierul va selecta terminalul dorit din lista celor active. Rezultat ~~~~~~~~~ Terminalul apare in lista **Pos Banca** cu numele, codul device si starea configurate. La urmatoarea sesiune POS, terminalul este disponibil pentru selectie la plata cu cardul. ---- .. _magazine-gestiuni: Magazine Gestiuni ----------------- **Cale:** Magazine → buton ``Magazine Gestiuni`` (dreapta sus) Scop ^^^^ Sectiunea **Magazine Gestiuni** gestioneaza asocierea dintre un magazin si gestiunea din care se alimenteaza vanzarile POS. Un magazin poate fi asociat o singura gestiune. Informatii afisate ^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 30 70 * - Coloana - Descriere * - Gestiune (cod) - Codul numeric al gestiunii asociate (ex: ``11``). * - Denumire gestiune - Denumirea completa a gestiunii (ex: ``MAGAZIN PITESTI``). Procedura — Asociere gestiune la magazin ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. Din ecranul **Magazine**, selecteaza magazinul dorit. 2. Apasa butonul **Magazine Gestiuni**. 3. In lista afisata, apasa **Adauga** pentru prima inregistrare sau **Modifica** pentru a edita o asocierea existenta. 4. Selecteaza gestiunea dorita si salveaza. .. warning:: Gestiunea asociata unui magazin POS trebuie sa corespunda gestiunii configurate in ERP pentru acel punct de vanzare. O asociere incorecta poate genera erori de stoc sau documente inregistrate pe gestiunea gresita. Rezultat ^^^^^^^^ Gestiunea apare in lista asociata magazinului, in formatul ``Gestiune: | ``, vizibila si in lista principala Magazine. ---- .. _magazine-configurare-pos: Configurare POS --------------- **Cale:** Magazine → buton ``Configurare POS`` (dreapta sus) Scop ^^^^ Fereastra **Configurare POS** genereaza parametrii tehnici de conexiune necesari pornirii aplicatiei POS pe statiile de lucru. Dupa completare, se genereaza un link de lansare care se distribuie pe fiecare statie. Sinonime: *parametri conexiune POS*, *link pornire POS*, *configuratie statie*, *setup POS*. Campuri disponibile ^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 25 20 55 * - Camp - Exemplu valoare - Descriere * - Magazin - ``1`` - Codul magazinului pentru care se genereaza configuratia (completat automat). * - Tip POS - ``Magazin`` - Tipul aplicatiei POS. Valori: ``Magazin``, ``MagazinOUI``, ``Horeca``. * - Utilizator ERP - ``utilizator`` - Utilizatorul ERP cu care se efectueaza configurarea. * - Parola ERP - ``••••••••`` - Parola utilizatorului ERP (afisata mascat). * - Port BD - ``5432`` - Portul bazei de date PostgreSQL (implicit ``5432``), se modifica daca pentru instalarea postgres s-a configurat alt port. * - Tip download - ``Windows Batch``, ``Jar (Online si Offline)``, ``Powershell`` - Metoda de descarcare/actualizare a aplicatiei POS. Recomandat este Jar si este necesara instalarea Amazon Corretto. * - Port Tomcat - ``29997`` - Portul serverului Tomcat pe care ruleaza aplicatia ERP/POS. * - Host BD - ``localhost`` - Adresa IP sau hostname-ul serverului de baza de date. Pe statie singulara: ``localhost``. * - Utilizator BD - ``postgres`` - Utilizatorul PostgreSQL folosit de aplicatie. * - Parola BD - ``••••••••`` - Parola utilizatorului PostgreSQL. * - IP Restrict - *(gol)* - IP-ul de la care este permisa conexiunea (optional; gol = fara restrictie). * - Model POS - ``Grafic``, ``Consola`` - Interfata grafica a aplicatiei POS. Valori: ``Grafic`` pentru sisteme de operare Windows, ``Consola`` pentru sisteme de operare linux. * - Link - *(generat)* - Link-ul de lansare generat de sistem, gata de copiat si distribuit pe statii. Procedura — Generare link de pornire POS ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 1. Din ecranul **Magazine**, selecteaza magazinul dorit. 2. Apasa butonul **Configurare POS** (dreapta sus). 3. Verifica si completeaza campurile tehnice: - **Utilizator ERP** si **Parola ERP** — contul cu care EMSYS POS se conecteaza la ERP. - **Parola BD** — parola bazei de date locale. - **Port BD** — de obicei ``5432`` (PostgreSQL implicit). - **Tip download** — ``Jar (Online si Offline)`` pentru statii Windows. - **Model POS** — ``Grafic`` pentru interfata vizuala. 4. Apasa butonul **Generare link**. 5. Link-ul generat apare in campul **Link**. 6. Apasa **Copy to Clipboard** si distribuie link-ul pe statia POS tinta. .. warning:: Fisierul ``magazine.jar`` generat trebuie sa fie prezent doar pe statia server, pe statiile client se acceseaza aplicatia Client POS. Ex 1 magazin cu o singura statie de vanzare - pe aceeasi statie trebuie sa existe magazin.jar si client POS. Ex 2: magazin cu mai multe statii de vanzare - pe statie server pe care trebuie sa existe magazin.jar, iar pe statiile client trebuie sa existe doar Client POS. .. note:: Link-ul generat contine toti parametrii de conexiune codificati. Daca se modifica portul, host-ul sau utilizatorul ERP, trebuie regenerat link-ul si redistribuit pe statia server. Rezultat ^^^^^^^^ Pe statie, deschiderea link-ului generat lanseaza aplicatia POS cu parametrii configurati, conectata la magazinul si gestiunea corecta. Erori posibile ^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 45 55 * - Eroare - Cauza si remediu * - magazin.jar nu porneste dupa deschiderea link-ului - Verifica daca EMSYS ERP poate fi accesat de pe statie. * - Eroare de autentificare la pornire - Utilizatorul ERP sau parola ERP este incorecta; reverifica campurile si regenereaza link-ul. * - Nu se poate conecta la baza de date - ``Host BD`` sau ``Port BD`` incorect; verifica adresa serverului PostgreSQL si ca portul ``5432`` nu este blocat de firewall. * - Link-ul nu se genereaza - Campurile obligatorii (Utilizator ERP, Port BD, Port Tomcat) nu sunt completate; completeaza-le si incearca din nou.