Metadata-Version: 2.1
Name: odoo-addon-l10n_py_maquila_ops
Version: 19.0.1.0.0.5
Requires-Dist: odoo-addon-l10n_py_maquila_base==19.0.*
Requires-Dist: odoo==19.0.*
Summary: Temporary admission, export, guarantees and fiscal ops for Maquila
Home-page: https://github.com/OCA/l10n-paraguay
License: AGPL-3
Author: KMEE, 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
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

=============================
Paraguay - Maquila Operations
=============================

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

.. |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--paraguay-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-paraguay/tree/19.0/l10n_py_maquila_ops
    :alt: OCA/l10n-paraguay
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-paraguay-19-0/l10n-paraguay-19-0-l10n_py_maquila_ops
    :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-paraguay&target_branch=19.0
    :alt: Try me on Runboat

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

Operations of Paraguay's Maquila regime (Ley 7547/2025):

- **Temporary admission** of goods with a customs guarantee, CIF control
  and per-line remaining balance. The stay follows Ley 7547/2025 Art. 14
  by type of good: raw materials and inputs 12 months from the import
  date (extendable once, up to the same period); containers and trailer
  boxes 12 months from the arrival declaration (no extension); other
  goods while the program is in force.
- **Export dispatches** with traceability to the source admissions.
- **Customs guarantees** (bank, insurance, deposit, mortgage), per
  operation or global (Decreto 5714/2026 Art. 28), with available
  balance control and automatic expiry. Form and validity of the
  guarantee follow art. 293 of the Customs Code and are not validated by
  the module.
- **Fiscal positions** for temporary admission and exempt export.
- Wizards for the **Tributo Único Maquilador (TUM, 1%)**, the **IVA
  credit** (compensate/transfer) and the **VAN** period computation.
- **Domestic-market sales** control (Ley 7547/2025 Art. 18): only pure
  maquila is capped, at 10% of what it exported in the last year. A pure
  maquila with no exports in that period has a zero cap and cannot sell
  domestically, unless a Maquila manager sets an explicit, logged
  override on the order.

All monetary comparisons and accounting entries are converted to the
company currency.

Open legal questions (not decided by the module): the law caps sales at
10% of the "volumen exportado en el ultimo ano"; the module measures the
exported FOB value (quantities of different products and units cannot be
added) and reads "ultimo ano" as the previous calendar year. Both
readings must be confirmed with the Secretaria Ejecutiva / DNIT.

**Table of contents**

.. contents::
   :local:

Usage
=====

1. Register a **customs guarantee** for the program.
2. Create a **temporary admission** with its CIF amount and lines;
   admitting it checks the CNIME certificate and that the guarantee
   covers the CIF (converted to the guarantee currency). Pick the type
   of good (it defines the Art. 14 deadline); for containers and trailer
   boxes also fill in the arrival declaration date. *Extend 12 Months*
   is only available for raw materials and inputs.
3. Create an **export** and link it to its source admissions before
   confirming.
4. Use the **TUM**, **IVA credit** and **VAN** wizards to compute and
   post the corresponding entries.

The two fiscal positions shipped in this module (temporary admission and
exempt export) carry no tax mapping: the actual IVA/customs tax mapping
depends on the chart of accounts in use and is left to the integrator.

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

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

* KMEE

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

- KMEE INFORMÁTICA LTDA

  - Luis Felipe Mileo <mileo@kmee.com.br>
  - André Marcos Ferreira <andre.ferreira@kmee.com.br>

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.

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

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