Este es el módulo base para el soporte de Chorus Pro, la plataforma de facturación electrónica de la administración francesa. Las especificaciones de Chorus Pro están disponibles en el sitio web de Chorus Pro Community. Todos los proveedores de la administración francesa deben enviar sus facturas a través de Chorus Pro. Para saber más sobre Chorus y la obligación de enviar facturas electrónicas a la administración francesa, lea la página dedicada en el sitio web del Ministerio de Asuntos Económicos.
Para poder generar una factura electrónica para Chorus, necesita el módulo l10n_fr_chorus_factur-x o l10n_fr_chorus_ubl.
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 18.0Envía facturas de cliente y notas de crédito francesas a la plataforma de facturación electrónica Chorus Pro directamente desde Odoo, y realiza un seguimiento automático de su estado de envío e identificadores.
Este módulo conecta Odoo con Chorus Pro, la plataforma pública francesa de facturación electrónica, para que los proveedores puedan transmitir facturas electrónicamente en lugar de por correo postal.
- En una factura de cliente o abono, puedes elegir Chorus como método de envío. Una vez publicada la factura, Odoo ejecuta comprobaciones específicas de Chorus (identificador del cliente, código de servicio, método de pago, cuenta bancaria IBAN) y bloquea la publicación si falta algo.
- Las facturas se envían mediante un asistente, 'Send to Chorus Pro', que puede agrupar varias facturas en un único flujo. Cada envío crea un registro
chorus.flowque contiene el archivo enviado, su estado y las notas de error. - Una tarea programada actualiza los estados del flujo, recupera los identificadores de factura de Chorus, actualiza los estados de las facturas y publica un mensaje en la factura cuando Chorus la rechaza, para que puedas corregirla y reenviarla.
- Los clientes llevan un identificador de Chorus y una lista de servicios de Chorus (
chorus.partner.service), con un botón para obtenerlos desde la API. El código de servicio 'FACTURES_PUBLIQUES' está prohibido. - Los archivos adjuntos añadidos a una factura de Chorus se validan por longitud del nombre de archivo, extensión, formato permitido y límites de tamaño.
- Los ajustes de la compañía contienen el usuario técnico de Chorus, la contraseña, el formato de factura, la fecha de caducidad de la contraseña y los destinatarios del recordatorio; un cron envía un correo de recordatorio antes de que caduque la contraseña.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (7)
- chorus.flow · modelo nuevodate (Flow Date), name (Flow Ref), notes, status (Flow Status (raw value)), syntax (Flow Syntax), company_id (Company), invoice_ids (Invoices), status_date (Last Status Update), attachment_id (File Sent to Chorus), status_display (Flow Status), initial_invoice_ids (Initial Invoices), invoice_identifiers
- res.company · amplía un modelo existentefr_chorus_api_login (Chorus Technical User Login), fr_chorus_api_password (Chorus Technical User Password), fr_chorus_invoice_format (Chorus Invoice Format), fr_chorus_pwd_expiry_date (Chorus Technical User Password Expiry Date), fr_chorus_expiry_remind_user_ids (Users Receiving the Expiry Reminder), fr_chorus_check_commitment_number (Check Commitment Numbers)
- res.partner · amplía un modelo existentefr_chorus_required (Info Required for Chorus), fr_chorus_identifier (Chorus Identifier), fr_chorus_service_id (Chorus Service), fr_chorus_service_ids (Chorus Services), invoice_sending_method, fr_chorus_service_count (Number of Chorus Services)
- account.move · amplía un modelo existentechorus_status (Chorus Invoice Status), chorus_flow_id (Chorus Flow), chorus_identifier (Chorus Invoice Identifier), chorus_status_date (Last Chorus Invoice Status Update), chorus_service_code (Chorus Service Code), chorus_attachment_ids (Chorus Attachments), invoice_sending_method
- res.config.settings · amplía un modelo existentefr_chorus_qualif (Use Chorus Qualification Platform), group_chorus_api (Use Chorus Pro API), fr_chorus_api_login, fr_chorus_api_password, fr_chorus_invoice_format, fr_chorus_pwd_expiry_date, fr_chorus_expiry_remind_user_ids, fr_chorus_check_commitment_number
- chorus.partner.service · modelo nuevocode (Service Code), name (Service Name), active, partner_id (Customer), chorus_identifier, engagement_required
- account.invoice.chorus.send · modelo nuevocompany_id (Company), invoice_ids (Invoices to Send), invoice_count (Number of Invoices), chorus_invoice_format
Texto generado por IA (DeepSeek) al leer el código de la versión 18.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: 6 confirmadas, 3 sin información de 9 versiones.
Fuentes · Odoo 18.0
Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-france.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Configuración
Fuente · Odoo 18.0En los clientes a los que facturas a través de Chorus, debes:
- introducir su SIRET (pestaña Accounting),
- seleccionar Chorus como Customer Invoice Transmission Method (pestaña Accounting),
- seleccionar el Info Required for Chorus al valor que hayas obtenido de Chorus (menú Rechercher Structure Publique),
- si el servicio es una información requerida para ese cliente en Chorus, debes crear el servicio Chorus y luego crear un contacto de facturación y seleccionar el Chorus Service relacionado y asegurarte de que este contacto se utilice como Customer en la factura.
Si quieres utilizar la Chorus API para enviar fácilmente facturas a Chorus desde Odoo, debes:
- editar el archivo de configuración del servidor Odoo y añadir dos claves chorus_api_oauth_id y chorus_api_oauth_secret que contengan tu Oauth client ID y client secret obtenidos a través de PISTE. No olvides reiniciar el servidor Odoo después de actualizar su archivo de configuración.
- en el menú Accounting \> Configuration \> Settings, en la sección Chorus API, activa la opción Use Chorus API, que añadirá a todos los usuarios al grupo Chorus API. A continuación, establece los parámetros de configuración adicionales para Chorus API que se solicitarán en la página de ajustes.
En el menú Settings \> Technical \> Automation \> Scheduled Actions, también debes activar las 3 acciones programadas relacionadas con Chorus Pro.
En la vista de formulario del cliente de una administración pública francesa, en la pestaña Contabilidad, establezca el Método de transmisión de facturas de cliente en Chorus Pro. A continuación, verá una nueva sección Chorus Pro. En esta sección, debe establecer la Info requerida para Chorus y, si la administración es Servicio requerido, debe crear los servicios Chorus.
Si habilitó la API de Chorus, simplemente haga clic en el botón Actualizar info requerida para Chorus y establecerá el campo Info requerida para Chorus y descargará todos los servicios Chorus de esa administración.
Cuando intente validar una factura/abono de cliente para un cliente al que envía las facturas a través de Chorus Pro, se comprobará el valor del campo Info requerida para Chorus y se verificará que esta factura tiene una referencia de pedido o/y un servicio Chorus si es requerido para ese cliente.
Si habilitó la API de Chorus, debería ver un botón Enviar a Chorus en las facturas y abonos de cliente validados que tengan un método de transmisión establecido en Chorus Pro. También puede seleccionar varias facturas/abonos de cliente y hacer Acción \> Enviar a Chorus Pro.
El envío de una factura a través de la API de Chorus crea un Chorus Flow, cf menú Contabilidad \> Configuración \> Chorus Pro \> Chorus Flows (no es realmente una cosa de configuración... ¡así que podríamos argumentar que no debería estar en el menú de configuración!). Puede hacer clic en el botón Actualizar estado del flujo para refrescar el estado del flujo, hasta que alcance el estado IN_INTEGRE. A continuación, haga clic en el botón Obtener identificadores de factura Chorus para obtener los identificadores técnicos de la factura en Chorus (y escribirlos en la factura en Odoo) y obtener el estado de la factura en Chorus. Finalmente, en la factura, puede hacer clic en el botón Actualizar estado de factura Chorus para refrescar el Estado de factura Chorus. Todas estas acciones para refrescar el estado de los flujos Chorus y de la factura están automatizadas mediante la Acción programada denominada Chorus Pro Invoice Status Update. Así que, si esa acción programada está activa, no debería tener que realizar manualmente las acciones descritas en este párrafo.
En la vista de lista de facturas de cliente, puede agrupar por Estado Chorus: de esa forma, obtiene una visión general del estado de todas las facturas que envió a Chorus Pro, y puede detectar fácilmente si una factura ha sido rechazada, por ejemplo.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
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.