Metadata-Version: 2.1
Name: odoo-addon-l10n_ro_message_spv
Version: 19.0.1.14.0.1
Requires-Dist: odoo-addon-l10n_ro_config==19.0.*
Requires-Dist: odoo==19.0.*
Summary: Romania - Mesaje SPV
Home-page: https://github.com/OCA/l10n-romania
License: AGPL-3
Author: Terrabit,Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

====================
Romania - Mesaje SPV
====================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:482ce4f568a7a53be70155f2d4b93546abfb96d65c96d13f80494f6f65b98060
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--romania-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-romania/tree/19.0/l10n_ro_message_spv
    :alt: OCA/l10n-romania
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-romania-19-0/l10n-romania-19-0-l10n_ro_message_spv
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-romania&target_branch=19.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Acest modul facilitează gestionarea mesajelor din Spațiul Privat Virtual
(SPV) ANAF, asigurând descărcarea și procesarea automată a facturilor
electronice (e-Factura):

- Funcționalități:

  - Descărcare automată mesaje SPV: sincronizare periodică (via cron) a
    listei de mesaje din SPV pentru facturi primite, trimise sau erori.
  - Procesare fișiere ZIP: descărcarea automată a arhivelor ZIP de la
    ANAF și extragerea fișierelor XML semnate.
  - Creare automată facturi de furnizor: generează schițe de factură
    (draft) direct din fișierele XML descărcate, mapând automat
    furnizorul pe baza codului fiscal (CIF).
  - Gestionare PDF-uri e-Factura:

    - Generare PDF ANAF: posibilitatea de a genera și descărca
      vizualizarea PDF oficială a XML-ului folosind serviciile ANAF.
    - Extragere PDF încorporat: extrage PDF-urile atașate direct în
      fișierul XML (dacă există).

  - Monitorizare stări: urmărirea stării fiecărui mesaj (Draft,
    Downloaded, Invoice, Error, Done) și a încercărilor de descărcare.
  - Integrare cu fluxul de facturare: legarea automată a mesajelor de
    facturile existente în sistem pe baza ID-ului de tranzacție sau a
    referinței.
  - Căutare produs după codul furnizorului: la importul UBL/CIUS-RO,
    produsul este identificat automat după codul furnizorului
    (``SellersItemIdentification`` sau ``StandardItemIdentification``)
    folosind ``product.supplierinfo``, cu prioritate maximă față de
    celelalte criterii de căutare.
  - Salvare cod furnizor pe linia de factură: codul furnizorului
    (``l10n_ro_vendor_code``) este salvat pe linia de factură la import,
    chiar dacă produsul nu a fost găsit, pentru a permite asocierea
    ulterioară la validarea facturii.
  - Sincronizarea datelor produselor: permite salvarea automată a
    codurilor de furnizor pentru produse la validarea facturilor
    primite.

--------------

Diferențe față de modulul standard ``l10n_ro_edi``
--------------------------------------------------

Modulul ``l10n_ro_message_spv`` extinde modulul standard Odoo
``l10n_ro_edi`` (Romania - E-invoicing), adăugând funcționalități
suplimentare pentru gestionarea avansată a mesajelor din SPV.

Ce face modulul standard ``l10n_ro_edi``?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- **Trimitere facturi de ieșire** către SPV ANAF (e-Factura) cu
  urmărirea stării (Trimis / Validat / Refuzat).
- **Sincronizare automată** (via cron) a stărilor facturilor trimise și
  descărcarea răspunsurilor de la SPV.
- **Descărcare facturi primite** (received bills): creează automat o
  factură draft de furnizor din XML-ul primit, atașează XML-ul și PDF-ul
  generat de ANAF.
- **Jurnal configurabil** pentru facturile importate
  (``l10n_ro_edi_anaf_imported_inv_journal_id``).
- **Deduplicare** facturi primite pe baza sumei totale, CIF-ului
  furnizorului și datei.

Ce adaugă ``l10n_ro_message_spv`` în plus?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+-------------------------+----------------------+--------------------------+
| Funcționalitate         | ``l10n_ro_edi``      | ``l10n_ro_message_spv``  |
|                         | (standard)           | (acest modul)            |
+=========================+======================+==========================+
| Trimitere facturi       | ✅                   | ✅ (moștenit)            |
| ieșire                  |                      |                          |
+-------------------------+----------------------+--------------------------+
| Descărcare facturi      | ✅ (simplu)          | ✅ (extins)              |
| primite                 |                      |                          |
+-------------------------+----------------------+--------------------------+
| Interfață dedicată      | ❌                   | ✅ cu stări: Draft,      |
| mesaje SPV              |                      | Downloaded, Invoice,     |
|                         |                      | Error, Done              |
+-------------------------+----------------------+--------------------------+
| Monitorizare încercări  | ❌                   | ✅                       |
| descărcare              |                      |                          |
+-------------------------+----------------------+--------------------------+
| Procesare fișiere ZIP   | ❌                   | ✅                       |
| ANAF                    |                      |                          |
+-------------------------+----------------------+--------------------------+
| Generare PDF oficial    | ✅                   | ✅                       |
| ANAF                    |                      |                          |
+-------------------------+----------------------+--------------------------+
| Extragere PDF           | ❌                   | ✅                       |
| încorporat în XML       |                      |                          |
+-------------------------+----------------------+--------------------------+
| Căutare produs după cod | ❌                   | ✅ via                   |
| furnizor                |                      | ``product.supplierinfo`` |
+-------------------------+----------------------+--------------------------+
| Salvare                 | ❌                   | ✅                       |
| ``l10n_ro_vendor_code`` |                      |                          |
| pe linie                |                      |                          |
+-------------------------+----------------------+--------------------------+
| Sincronizare coduri     | ❌                   | ✅                       |
| furnizor la validare    |                      |                          |
+-------------------------+----------------------+--------------------------+

..

   **Notă:** ``l10n_ro_message_spv`` depinde de ``l10n_ro_edi`` și îl
   extinde — nu îl înlocuiește. Ambele module trebuie instalate pentru
   funcționalitate completă.

--------------

De ce este importantă descărcarea periodică a mesajelor din SPV?
----------------------------------------------------------------

Descărcarea mesajelor și a facturilor din SPV nu este doar o recomandare
de „bună practică", ci o necesitate critică din motive legale, fiscale
și tehnice.

1. Termenul de Arhivare în SPV (Limitarea Tehnică)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Sistemul ANAF nu este un spațiu de stocare permanentă.

- **Ștergerea automată:** Mesajele și documentele (inclusiv facturile
  din e-Factura) sunt păstrate în SPV pentru o perioadă limitată (de
  regulă **60 de zile**).
- **Consecință:** Dacă nu le descarci în acest interval, ele dispar din
  interfață și recuperarea lor devine un proces birocratic anevoios sau
  chiar imposibil prin metodele standard.

2. Valabilitatea Juridică și Fiscală
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Conform legislației din România (Codul Fiscal), documentul original care
stă la baza deducerii TVA și a cheltuielilor este **fișierul XML însoțit
de sigiliul electronic al Ministerului Finanțelor**.

- **Proba în caz de control:** În fața inspectorilor ANAF, simpla
  vizualizare a facturii în portal nu este suficientă. Trebuie să poți
  prezenta fișierul descărcat care conține semnătura electronică ce
  atestă autenticitatea.
- **Arhivarea obligatorie:** Firmele sunt obligate prin lege să arhiveze
  documentele contabile pe termene lungi (de regulă 10 ani). Deoarece
  SPV le șterge după 60 de zile, sarcina arhivării îți revine exclusiv
  ție.

3. Integrarea în Contabilitate
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Majoritatea programelor de contabilitate au nevoie de fișierele XML
descărcate pentru a automatiza procesele.

- Fără descărcare, datele trebuie introduse manual, ceea ce crește
  riscul de erori umane.
- Descărcarea permite corelarea rapidă între plățile efectuate și
  facturile primite.

Ce trebuie descărcat?
~~~~~~~~~~~~~~~~~~~~~

Nu este suficient să salvezi doar PDF-ul (care este doar o reprezentare
vizuală). Trebuie să salvezi:

1. **Fișierul XML:** Acesta este documentul „rege" din punct de vedere
   legal.
2. **Recipisa (Semnătura electronică):** Fișierul care confirmă că
   XML-ul a fost validat de sistemul ANAF.

**Table of contents**

.. contents::
   :local:

Configuration
=============



Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-romania/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-romania/issues/new?body=module:%20l10n_ro_message_spv%0Aversion:%2019.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Terrabit

Contributors
------------

- `Terrabit <https://www.terrabit.ro>`__:

  - Dorin Hongu <dhongu@gmail.com>

Do not contact contributors directly about support or help with
technical issues.

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-dhongu| image:: https://github.com/dhongu.png?size=40px
    :target: https://github.com/dhongu
    :alt: dhongu

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-dhongu| 

This module is part of the `OCA/l10n-romania <https://github.com/OCA/l10n-romania/tree/19.0/l10n_ro_message_spv>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
