Metadata-Version: 2.1
Name: odoo-addon-l10n_ve_fiscal_document
Version: 19.0.1.0.0.6
Requires-Dist: odoo==19.0.*
Summary: Store Venezuelan fiscal document identification data
Home-page: https://github.com/OCA/l10n-venezuela
License: LGPL-3
Author: BWEALTHICS LLC, 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 Lesser General Public License v3 (LGPLv3)
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

===========================
Venezuela - Fiscal Document
===========================

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

.. |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-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--venezuela-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-venezuela/tree/19.0/l10n_ve_fiscal_document
    :alt: OCA/l10n-venezuela
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-venezuela-19-0/l10n-venezuela-19-0-l10n_ve_fiscal_document
    :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-venezuela&target_branch=19.0
    :alt: Try me on Runboat

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

This addon stores the fiscal control number, its assignment date, and
the emission medium used for Venezuelan customer documents.

The emission medium is copied from the sales journal when a document is
posted, so later journal configuration changes do not alter its fiscal
history. Posted customer fiscal identification is immutable; supplier
document data remains correctable.

Existing posted or cancelled customer documents are also locked at
installation, without attempting to infer missing historical fiscal
data.

The addon does not allocate control numbers, manage paper batches, print
fiscal documents, or communicate with fiscal machines or digital
printers.

The legal basis covered by this addon is:

- `Providencia Administrativa
  SNAT/2011/00071 <https://tributos.ivecofi.net/informacion/legislacion/providencias/pa-2011-71>`__,
  published in Official Gazette No. 39,795 of November 8, 2011, which
  regulates fiscal-document emission media and control numbers.
- `Providencia Administrativa
  SNAT/2024/000102 <http://www.gacetaoficial.gob.ve/storage/2024/T028700051511-0-GO_43.032-000.pdf>`__,
  published by Venezuela's Imprenta Nacional in Official Gazette No.
  43,032 of December 19, 2024, especially articles 7.4 and 7.15 on
  digitally assigned control numbers and assignment dates.

**Table of contents**

.. contents::
   :local:

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

On each Venezuelan sales journal, select the emission medium used for
customer documents: free form, contingency, fiscal machine, or digital
billing. Customer documents cannot be posted until this setting is
configured.

When the addon is installed, existing posted or cancelled Venezuelan
customer documents are locked. Their historical fiscal data is not
reconstructed.

Usage
=====

Enter the fiscal control number and assignment date on the invoice when
they are available. Integrations with fiscal machines or digital
printers can write these fields while the document is still in draft.

Trusted in-process connector addons can assign control data returned
after posting for digital or fiscal-machine documents with
``_l10n_ve_assign_control_data(control_number, control_date=None)``. The
method is idempotent and does not expose an RPC context bypass for the
fiscal lock. ``control_date`` must be a Python date-only value;
datetimes, strings, and other types are rejected.

After a Venezuelan customer document is posted, it cannot be reset to
draft or deleted and its fiscal identification cannot be changed. Use a
credit or debit note to correct the transaction.

A fiscal machine or an authorized digital printing house connector
normally only learns the control number *after* the document is posted
and totalled. For that case, call
``account.move._l10n_ve_set_control_number(control_number, control_date=False)``
on the posted document: it is the only supported way to assign the
control number once posting has locked the fiscal data, refuses to run
on a document that is still a draft, and refuses to overwrite a number
already assigned.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-venezuela/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-venezuela/issues/new?body=module:%20l10n_ve_fiscal_document%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
-------

* BWEALTHICS LLC

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

- Alejandro Fernandez alejandro@bwealthics.com

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-bwealthics| image:: https://github.com/bwealthics.png?size=40px
    :target: https://github.com/bwealthics
    :alt: bwealthics

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

|maintainer-bwealthics| 

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

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