Metadata-Version: 2.1
Name: odoo-addon-l10n_mx_cfdi_comex
Version: 19.0.1.1.0
Requires-Dist: odoo-addon-l10n_mx_catalogs_comex==19.0.*
Requires-Dist: odoo-addon-l10n_mx_cfdi_account==19.0.*
Requires-Dist: odoo==19.0.*
Summary: Mexico foreign trade invoicing compliance
Home-page: https://github.com/OCA/l10n-mexico
License: GPL-3
Author: =?utf-8?q?Alexis_L=C3=B3pez_Zubieta_=3Calexis=2Elopez=40augetec=2Ecom=3E_=28Auge_TEC=29=2C_Odoo_Community_Association_=28OCA=29?=
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
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

=========================================
Mexico foreign trade invoicing compliance
=========================================

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

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

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

This module adds Mexican foreign trade (COMEX) compliance on top of CFDI
invoicing.

**Features**

- Pedimento management linked to inventory lots (import path)
- Tariff code (fracción arancelaria) on products
- Import details on invoice lines for Mexican companies
- Pedimento numbers in CFDI concept ``InformacionAduanera`` /
  ``NumerosPedimento``
- Pedimento propagation from landed costs to lots
- **Complemento Comercio Exterior 2.0** on customer invoices:
  ``Exportacion=02`` plus satcfdi ``cce20.ComercioExterior``
  (Emisor/Receptor/ Destinatario domicilios, mercancías, TipoCambioUSD,
  TotalUSD)
- Reuses the standard invoice **Incoterm** field
  (``invoice_incoterm_id`` / ``account.incoterms``) for SAT
  ``c_INCOTERM``; no duplicate Incoterm field

**PAC notes**

- Stamp / XML-issue PACs can stamp sealed CFDIs that include CCE.
- Facturama Multiemisor cannot map CCE; ``l10n_mx_cfdi`` switches to
  FacturamaWeb when the complement is present.

**Table of contents**

.. contents::
   :local:

Installation
============

Install the module from the Apps menu after its dependencies are
installed (``l10n_mx_cfdi_account``, ``l10n_mx_catalogs_comex``, and
stock/sale stack).

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

Install ``l10n_mx_catalogs_comex`` and ``l10n_mx_cfdi_account`` before
this module.

Configure tariff codes on product templates and create pedimentos from
**Inventory > Operations > Pedimentos**.

For CCE exports, keep partner addresses complete and use the standard
invoice **Incoterm** field. Prefer Banxico USD rates for **Tipo cambio
USD**.

SAT catalog imports for ``c_INCOTERM``, ``c_ClavePedimento``, and
``c_UnidadAduana`` are not shipped as full data tables yet; codes are
entered as Char fields (Incoterm reuses ``account.incoterms.code``). See
ROADMAP.

Usage
=====

Import pedimentos
-----------------

Assign a pedimento to a landed cost before validation to copy it to the
related lots. When invoicing products received with pedimentos, import
details are appended to invoice lines and pedimento numbers are sent in
the CFDI concepts (independent of CCE export).

Export — Comercio Exterior 2.0
------------------------------

1. Set the product **Tariff Code** (fracción arancelaria).
2. Ensure issuer and customer partners have street, ZIP, country, and
   state (SAT domicilio fields).
3. On the invoice **Other Info** tab, set **Incoterm** (standard Odoo
   field).
4. On the **COMEX / CCE** tab, enable **Comercio Exterior (CCE)** and
   fill:

   - Clave de pedimento (default ``A1``)
   - Tipo cambio USD (MXN per 1 USD)
   - Optional certificado de origen / observaciones / destinatario

5. On invoice lines (optional columns), set **Valor dólares** and
   customs quantity / unit / unit value as needed.
6. Generate the CFDI as usual. The builder sets ``Exportacion=02`` and
   attaches the CCE complement.

Known issues / Roadmap
======================

- Import full SAT catalogs for ``c_INCOTERM``, ``c_ClavePedimento``,
  ``c_UnidadAduana``, and ``c_MotivoTraslado`` into
  ``l10n_mx_catalogs_comex`` (Many2one selectors instead of Char codes).
- Auto-default TipoCambioUSD from Banxico /
  ``currency_rate_update_banxico`` when available.
- Richer Destinatario / Propietario flows and DescripcionesEspecificas
  on mercancías.
- Live PAC certification matrix for CCE on each provider.

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

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

* Alexis López Zubieta <alexis.lopez@augetec.com> (Auge TEC)

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

- Alexis López Zubieta <alexis.lopez@augetec.com>
- Cristhiane Guadalupe Rangel Ferrusca
  <cristhiane.rangel@graymatterlogic.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.

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

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