Descripción
Módulo base para conectar Odoo con el portal del Servicio de Administración Tributaria (SAT) de México usando credenciales de firma electrónica FIEL.
Proporciona:
- Credenciales FIEL multiempresa almacenadas en cada registro res.company.
- Una pestaña SAT en el formulario de la empresa para configurar flujos de descarga, fechas de sincronización y sincronización manual.
- Un asistente seguro de credenciales FIEL que almacena certificado, clave y contraseña sin exponer los valores guardados en la interfaz de usuario.
- Almacenamiento genérico de documentos del SAT (l10n_mx_sat.document) para CFDIs y retenciones, tanto emitidos como recibidos.
- Una capa de orquestación de descargas (l10n_mx_sat.download.request) que gestiona las descargas masivas de XML mediante satcfdi.
- Flujos de descarga de XML configurables por empresa: CFDI emitidos/recibidos y retenciones emitidas/recibidas.
- Un adaptador (SatClient) que envuelve la comunicación con el SAT a través de la librería satcfdi. Otros módulos pueden usar este adaptador sin depender directamente de satcfdi.
- Un método de fábrica company.l10n_mx_sat_get_client() que devuelve una instancia del adaptador. Se puede sobrescribir mediante _inherit para cambiar la implementación subyacente.
Este módulo descarga y almacena documentos XML del SAT. La sincronización automática de metadatos se pospone para una versión futura. Otros módulos personalizados pueden consumir los registros l10n_mx_sat.document para sus propios flujos de negocio.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Conecta Odoo al portal fiscal SAT de México usando credenciales de firma electrónica FIEL, descarga CFDIs y retenciones (emitidos y recibidos) automáticamente, y guárdalos como documentos SAT de solo lectura.
Este módulo permite a una empresa mexicana conectar Odoo con el portal del SAT (autoridad fiscal) usando su firma electrónica FIEL. En el formulario de la empresa aparece una pestaña SAT donde se sube el certificado FIEL (.cer), la clave privada (.key) y la contraseña, se establecen las fechas desde las que sincronizar, se elige qué flujos descargar (CFDIs emitidos/recibidos y retenciones emitidas/recibidas) y se activa la descarga diaria automática. Un asistente seguro almacena las credenciales sin volver a mostrar los valores guardados.
Los documentos descargados se conservan en un registro de solo lectura llamado SAT documents, con UUID, tipo, dirección, estado del SAT, RFC y nombre del emisor y receptor, fechas, total, moneda, serie y folio. Puedes abrir el archivo XML adjunto a cada documento. Los documentos no se pueden crear, editar ni eliminar manualmente; solo provienen de las solicitudes de descarga del SAT.
Un registro de solicitud de descarga del SAT hace seguimiento de cada descarga: su estado (draft, requested, processing, ready, downloading, done, error), rango de fechas, ID de solicitud del SAT, paquetes y documentos resultantes. Puedes poner en cola una solicitud, reintentar las fallidas, y el sistema divide automáticamente un rango de fechas cuando el SAT indica demasiados registros, espera y vuelve a comprobar mientras el SAT sigue procesando, y omite solicitudes duplicadas. Una tarea programada diaria realiza descargas masivas. Los menús aparecen bajo una raíz de conexión SAT: Documents, Download requests y Settings, con una acción Configure connections.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (5)
- res.company · amplía un modelo existentel10n_mx_sat_fiel_cer (FIEL certificate (.cer)), l10n_mx_sat_fiel_key (FIEL private key (.key)), l10n_mx_sat_fiel_rfc (RFC FIEL), l10n_mx_sat_last_sync (Last XML sync), l10n_mx_sat_sync_from (Sync documents from), l10n_mx_sat_auto_download (Automatic SAT download), l10n_mx_sat_fiel_password (FIEL password), l10n_mx_sat_document_count (SAT documents), l10n_mx_sat_fiel_configured (FIEL configured), l10n_mx_sat_last_metadata_sync (Last metadata sync), l10n_mx_sat_metadata_sync_from (Sync metadata from), l10n_mx_sat_fiel_key_configured (Llave FIEL configured), l10n_mx_sat_download_cfdi_issued (Download issued CFDIs), l10n_mx_sat_download_cfdi_received (Download received CFDIs), l10n_mx_sat_download_request_count (SAT download requests), l10n_mx_sat_download_retention_issued (Download issued retentions), l10n_mx_sat_download_retention_received (Download received retentions), l10n_mx_sat_fiel_certificate_configured (FIEL certificate configured)
- l10n_mx_sat.document · modelo nuevouuid (UUID), total, series, has_xml (Has XML), direction, company_id (Company), issue_date (Issue date), issuer_rfc (Issuer RFC), sat_status (SAT status), stamp_date (Stamp date), issuer_name (Issuer name), display_name, folio_number (Folio), receiver_rfc (Receiver RFC), voucher_type (Voucher type), attachment_id (XML), currency_code (Currency), document_kind (Document kind), receiver_name (Receiver name), cancellation_date (Cancellation date), download_request_id (SAT request)
- l10n_mx_sat.download.package · modelo nuevostate, company_id, request_id (SAT request), sat_package_id (Package ID)
- l10n_mx_sat.download.request · modelo nuevoname (Description), state, date_to (To), can_retry (Can retry), date_from (From), direction, company_id (Company), package_ids (Packages), document_ids (Documents), request_type (Request type), document_kind (Document kind), error_message (Error message), document_count (Processed documents), sat_request_id (SAT request ID), next_process_at (Next process at), reported_cfdi_count (SAT reported CFDIs), request_fingerprint (Request fingerprint)
- l10n_mx_sat.fiel.credentials.wizard · modelo nuevofiel_cer (FIEL certificate (.cer)), fiel_key (FIEL private key (.key)), company_id (Company), fiel_password (FIEL password)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 2 confirmadas, 7 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/l10n-mexico.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Instalación
Fuente · Odoo 19.0Este módulo requiere la librería de Python satcfdi para comunicarse con los servicios web del SAT. Instálala en el mismo entorno de Python que Odoo antes de usar las funciones de conexión con el SAT.
Instálala con pip (satcfdi >= 26.7.2, que restaura el soporte de Python 3.10 y la API de descarga de retenciones):
pip install "satcfdi>=26.7.2"satcfdi está declarado en el manifiesto del módulo external_dependencies. OCA CI y Runboat también lo fijan en la raíz del repositorio test-requirements.txt (satcfdi>=26.7.2), junto con fijaciones compatibles de urllib3 y requests.
Configuración
Fuente · Odoo 19.0Para cada empresa mexicana:
- Abra Ajustes > Empresas > [Empresa] > pestaña SAT.
- Haga clic en Actualizar credenciales FIEL y suba el certificado (
.cer), la clave privada (.key) y la contraseña en el asistente. El VAT/RFC de la empresa se establece automáticamente a partir del certificado FIEL. - Una vez configurada la FIEL, el VAT/RFC de la empresa pasa a ser de solo lectura y debe actualizarse a través del asistente de credenciales FIEL.
- Revise el indicador de FIEL configurada que se muestra en el formulario de la empresa. Las credenciales guardadas nunca se muestran ni se pueden descargar desde la interfaz de usuario.
- Elija qué flujos de descarga de XML están habilitados:
- CFDI emitidos
- CFDI recibidos
- Retenciones emitidas
- Retenciones recibidas
- Opcionalmente, configure:
- Sincronizar documentos desde: fecha de primera carga masiva de XML.
- Descarga automática del SAT: habilitar/deshabilitar el procesamiento diario por cron.
- Haga clic en Probar conexión para validar las credenciales FIEL.
- Haga clic en Sincronizar ahora para encolar inmediatamente las solicitudes de descarga de XML del SAT.
Multiempresa
Cada empresa mantiene sus propias credenciales FIEL, su selección de flujos de descarga y sus ventanas de sincronización. Los usuarios solo ven los documentos y solicitudes del SAT de las empresas a las que tienen permiso de acceso.
Metadatos
Las descargas automáticas de metadatos están deshabilitadas por ahora. La actualización del estado del SAT a partir de metadatos se implementará en una versión posterior.
Tras la configuración, el cron diario crea y procesa solicitudes de descarga de XML del SAT para cada compañía habilitada y para cada flujo habilitado.
Revisión manual
Abra SAT > Documents para explorar los CFDIs y retenciones descargados. Utilice los filtros por compañía, estado del SAT, dirección y tipo de documento.
Abra SAT > Download Requests para monitorizar los estados de las solicitudes, los paquetes y los errores.
Módulos posteriores
Otros módulos deberían leer de l10n_mx_sat.document en lugar de llamar directamente a los servicios web del SAT.
Metadatos
La sincronización automática de metadatos aún no está programada por este módulo. Utilice las descargas de XML para el almacenamiento de documentos y espere a la futura lógica de actualización de metadatos antes de esperar actualizaciones del estado del SAT a partir de archivos de metadatos.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.