================================== Lista Dispozitii Livrare (DL) ================================== .. contents:: :depth: 2 :local: Scop **** Vizualizarea si gestionarea dispozitiilor de livrare disponibile pentru operatorul curent. Ecranul permite identificarea DL-urilor libere, preluarea acestora, vizualizarea celor preluate de mine sau de alti utilizatori, si accesul la istoricul DL-urilor aprobate. Prerechizite ************* - Autentificarea cu succes (vezi :doc:`Setari `). - Utilizatorul are drepturi in ERP pe modulul Logistica / Vanzari. - Exista cel putin un DL definit in ERP (functia Vanzari → Dispozitii Livrare in EMSYS). A. Acces la lista DL ********************* Din meniul principal, apasati cardul **Vanzari & Retail**. Se deschide submeniul cu o singura optiune disponibila momentan: **Dispozitii Livrare**. Apasati pe card pentru a deschide lista. |image_main| |image_vanzari| La incarcarea listei, aplicatia descarca de pe server toate DL-urile la care utilizatorul curent are acces (libere sau preluate de altii) si afiseaza un spinner pe durata acestei operatii. Tipic 1-3 secunde pentru ~50-200 DL-uri. B. Structura ecran lista DL **************************** |image_lista1| |image_lista2| |image_lista3| Ecranul **Dispozitii Livrare** contine: - **Bara de cautare** (sus) — filtrare rapida dupa text liber. Suporta prefixe speciale: - ``dl `` — cauta dupa numar document - ``cmd `` — cauta dupa numar comanda client - ``tranz `` — cauta dupa numar tranzactie Fara prefix, cautarea se face concomitent dupa client, numar comanda si numar tranzactie. - **Trei butoane circulare de filtru** (dreapta sus, langa cautare) — filtru pe stare: - |filter_open| **Deschise** (cyan) — DL-uri libere, neasumate de niciun utilizator - |filter_mine| **Preluate** (rosu) — DL-uri preluate de **mine** - |filter_done| **Aprobate** (portocaliu) — DL-uri finalizate (aprobate in ERP) Doar un filtru este activ la un moment dat. Butoanele inactive sunt afisate cu contur colorat fara umplere. - **Lista carduri DL** — sortata descrescator dupa numar document. - **Buton refresh** (iconita reincarcare in bara de titlu) — re-fetch lista de pe server. - **Pull-to-refresh** — trageti lista in jos pentru reincarcare. C. Card DL — informatii afisate ******************************** |image_card| Fiecare DL este afisat ca un card cu fundal colorat in functie de stare: - *Alb* — disponibil (liber) **SAU** aprobat (read-only). Distinctia se face prin iconul de stare (vezi mai jos) si prin culoarea butonului de actiune (cyan = preluare, portocaliu = anulare aprobare). - *Albastru deschis* — preluat de mine. - *Gri deschis* — preluat de alt utilizator. Continutul cardului: - *Iconita stare* (stanga-sus) + numar DL + data document - *Denumire client* (font mai mare, max 2 randuri) - *Stare* (text mic, dreapta) — ``aprobat`` / ``preluat de mine`` / ``disponibil`` / ``preluat de `` - *Cmd* — numar comanda client - *Tranz* — numar tranzactie unic - *Buton de actiune* (dreapta) — actiunea principala depinde de stare (vezi sectiunea D). D. Actiuni disponibile per stare ********************************* |action_play_blue| **Preluare** — pe DL disponibil (galben) Apasarea butonului albastru de Play face POST la ERP cu ``preluare=1``. La succes, DL devine **rosu** (preluat de mine), iar in lista apare un snackbar verde: *"DL preluat (Tranz )"*. Pozitiile cu codurile de bare sunt descarcate in background si salvate local in SQLite pentru rezilienta la kill/reboot. |action_play_red| **Anulare preluare** — pe DL preluat de mine (rosu) Apasarea butonului rosu de Play deschide un dialog de confirmare. La confirmare, DL revine la *disponibil* (galben) si toate cantitatile scanate local sunt sterse. Snackbar rosu: *"Preluare anulata — DL (Tranz )"*. |action_play_orange| **Anulare aprobare** — pe DL aprobat (alb) Apasarea butonului portocaliu deschide un dialog de confirmare. La confirmare, DL revine la *preluat de mine* (rosu) si poate fi rescanat / corectat. Cantitatile scanate inainte de aprobare sunt pastrate in SQLite local — la redeschiderea DL-ului apar exact unde erau. .. note:: Tehnic, anularea aprobarii face doua apeluri server consecutive: ``aprobare=0`` (sterge starea aprobat) si ``preluare=1`` (re-revendica DL-ul). Server-ul EMSYS poate, in functie de implementare, sa stearga ``userPreluat`` la anulare aprobare — re-revendicarea explicita asigura ca DL ramane in lista *Preluate* la urmatorul refresh. E. Filtrele si lista goala *************************** Daca dupa selectarea unui filtru lista este goala, aplicatia afiseaza un ecran de informare contextual cu pictograma + titlu + indicatie de actiune: - *Filtrul Deschise gol* — "Nu sunt DL deschise. Trage in jos pentru a re-incarca lista." - *Filtrul Preluate gol* — "Nu ai DL-uri preluate. Schimba filtrul pe Deschise si apasa Preluare pe un DL." - *Filtrul Aprobate gol* — "Niciun DL aprobat. DL-urile aprobate apar aici dupa ce confirmi cantitatile scanate." - *Cu cautare activa* — "Niciun rezultat. Niciun DL nu corespunde cautarii curente." |image_empty| F. Tap pe card — deschidere detaliu ************************************* Apasati pe corpul cardului (oriunde, in afara butonului Play / actiune) pentru a deschide ecranul de detaliu DL. Vezi :doc:`Detaliu DL `. Comportamentul deschiderii detaliului depinde de starea DL-ului: - *Deschis (liber)* — vedere read-only. Nu pot scana fara a face mai intai *Preluare*. - *Preluat de mine* — mod editare completa: scanare, reset, trimitere, aprobare. - *Preluat de alt utilizator* — vedere read-only. - *Aprobat (de mine sau altul)* — vedere read-only, cu mesajul "DL APROBAT". .. |image_main| image:: ../Logistics/Logisticsmedia/main.png :alt: Meniu principal cu cardul Vanzari & Retail .. |image_vanzari| image:: ../Logistics/Logisticsmedia/vanzari.png :alt: Submeniul Vanzari cu Dispozitii Livrare .. |image_lista1| image:: ../Logistics/Logisticsmedia/lista_dl_disponibil.png :alt: Lista Dispozitii Livrare cu bara de cautare si filtru deschide .. |image_lista2| image:: ../Logistics/Logisticsmedia/lista_dl_preluat.png :alt: Lista Dispozitii Livrare cu bara de cautare si filtru preluate .. |image_lista3| image:: ../Logistics/Logisticsmedia/lista_dl_aprobat.png :alt: Lista Dispozitii Livrare cu bara de cautare si filtru aprobate .. |image_card| image:: ../Logistics/Logisticsmedia/card_dl.png :alt: Card DL cu informatii numar / client / cmd / tranz .. |image_empty| image:: ../Logistics/Logisticsmedia/empty_preluate.png :alt: Ecran empty state pentru filtrul Preluate .. |filter_open| image:: ../Logistics/Logisticsmedia/filter_open.png :alt: Filtru Deschise (cyan) .. |filter_mine| image:: ../Logistics/Logisticsmedia/filter_mine.png :alt: Filtru Preluate (rosu) .. |filter_done| image:: ../Logistics/Logisticsmedia/filter_done.png :alt: Filtru Aprobate (portocaliu) .. |action_play_blue| image:: ../Logistics/Logisticsmedia/action_play_blue.png :alt: Buton Preluare (albastru) .. |action_play_red| image:: ../Logistics/Logisticsmedia/action_play_red.png :alt: Buton Anulare preluare (rosu) .. |action_play_orange| image:: ../Logistics/Logisticsmedia/action_play_orange.png :alt: Buton Anulare aprobare (portocaliu)