============
Export local
============

Scop
****

Salvarea locala a documentelor de stoc faptic in format XML sau XLS, pentru situatii in care upload-ul direct in ERP nu este posibil sau nu este dorit. Fisierele generate sunt identice cu cele acceptate de importul ERP si pot fi transmise prin orice canal (email, Bluetooth, cablu USB, Drive, AirDrop) prin intermediul ShareSheet-ului nativ al sistemului de operare.

Cazuri de utilizare:

- dispozitivul mobil nu are conexiune la reteaua ERP (teren fara wifi / lte);
- serverul ERP este temporar indisponibil;
- se doreste arhivarea locala a documentelor inainte de upload;
- se doreste verificarea vizuala a continutului XML / XLS inainte de transmitere;
- import manual in ERP din in modlul Inventariere.

A. Formate disponibile
**********************

**XML** — format compatibil cu endpoint-ul de import faptic al ERP. Identic cu continutul trimis in timpul upload-ului online. Continutul XML:

- antet cu: ``comisieinv``, ``codresp``, ``anFiscal``, ``datadoc``, ``nrdoc``, ``codDoc``, ``datarefinv``, ``gest``, ``datadecizie``, ``nrdecizie``, ``observatii`` (daca e completat);
- pozitii cu: ``codart``, ``marca``, ``qinventinv``, ``qinventst``, ``coeftr``, ``codumst``, ``coduminv``, ``observatii`` (daca e completat).

Pentru mijloace fixe, structura XML-ului include in plus ``rezidenta`` atat la nivel de antet cat si de pozitie.

**XLS** — format ``.xlsx`` compatibil cu template-urile de import din aplicatia de office ERP:

- ``importStoc.xlsx`` — pentru stocuri (PINVS), fara coloana Marca.
- ``importOB.xlsx`` — pentru obiecte de inventar (PAINVOI), cu coloana Marca.
- ``importMF.xlsx`` — pentru mijloace fixe, cu Rezidenta, Gestiune, Marca.

Header-ul si numele sheet-ului (``Sheet0``) sunt aliniate cu template-urile ERP, deci fisierele pot fi importate direct fara ajustari manuale.

B. Procedura export
*******************

1. In lista documentelor de stoc faptic (stocuri / obiecte inventar / mijloace fixe), apasati iconita **Export local** din cardul documentului dorit.

2. Se deschide un bottom-sheet cu trei optiuni:

   |image1|

   - **Exporta XML** — genereaza doar fisierul ``.xml`` (format identic upload din aplicatie in ERP util pentru depanare si identificare probleme).
   - **Exporta XLS** — genereaza doar fisierul ``.xlsx`` (format import ERP in functiile Document Stoc faptic ST si Document Stoc faptic MF).
   - **Exporta XML + XLS** — genereaza ambele fisiere deodata.

3. Dupa alegerea optiunii, aplicatia:

   - genereaza fisierul / fisierele in storage-ul privat al aplicatiei;
   - construieste numele standardizat: ``inventar_[tip]_[nrdoc]_g[gest]_d[nrDecizie]_YYYYMMDD.[ext]``;

4. Selectati canalul de transmitere dorit (Gmail, Bluetooth, Drive, WhatsApp, Files etc.). Fisierele pot fi descarcate si pe calculator prin cablu USB, accesand directorul aplicatiei.

.. note::

   Aplicatia NU cere permisiuni runtime pentru stocare externa. Fisierele sunt salvate in sandbox-ul privat al aplicatiei (``/data/data/<pkg>/files/exports`` pe Android, ``Library/Application Support/exports`` pe iOS). ShareSheet-ul are acces automat la acest director, fara a fi nevoie de permisiuni MANAGE_EXTERNAL_STORAGE.

C. Exemplu nume fisier
**********************

Pentru un document stoc faptic cu:

- *Tip* — obiecte de inventar (PAINVOI)
- *Nr. Doc.* — 1
- *Gestiune* — 1200
- *Nr. Decizie* — 1
- *Data export* — 19 aprilie 2026

Numele fisierului exportat va fi:

``inventar_ST_PAINVOI_1_g1200_d1_20260419.xml``

``inventar_ST_PAINVOI_1_g1200_d1_20260419.xlsx``

Caracterele speciale / nesigure din numere sunt inlocuite cu ``_`` pentru a garanta compatibilitate cu toate sistemele de fisiere.

D. Import in ERP (dupa transmitere)
***********************************

Dupa ce fisierul a ajuns pe computerul utilizatorului cu drepturi de import:

- pentru **XML** — se transmite fisierul echipei de suport EMSYS pentru depanare;
- pentru **XLS** — se acceseaza functia corespunzatoare de import (Stocuri / MF) si se incarca fisierul ``.xlsx``.

Rezultatul importului este identic cu cel al upload-ului direct din aplicatia mobila.

.. warning::

   Este responsabilitatea utilizatorului sa asigure ca fisierul exportat ajunge integru la persoana cu drept de import si este incarcat in ERP. Aplicatia nu pastreaza istoric al exporturilor — fisierul ramane in sandbox pana la apasarea **Sterge** pe document sau la dezinstalarea aplicatiei.


.. |image1| image:: ../Inventory/Inventorymedia/exportlocal.png
      :alt: Bottom-sheet cu optiuni export XML / XLS / ambele