OdooWiki OCA HUB

ITA - Fattura elettronica - Supporto PEC

l10n_it_edi_pec folder_open OCA/l10n-italy open_in_new
Localization/Italy Licencia: AGPL-3

Italiano

Este módulo implementa el canal PEC (Posta Elettronica Certificata) para la comunicación con el Sistema de Intercambio (SdI), como alternativa al proxy IAP estándar de Odoo.

Se basa en l10n_it_edi_sdi para la lógica compartida de procesamiento de notificaciones y recepción de facturas, añadiendo el transporte específico vía PEC.

Funcionalidades principales:

  • Envío de facturas electrónicas vía PEC al SdI
  • Recepción de correos PEC del SdI y enrutamiento a los gestores apropiados
  • Gestión de errores PEC con notificación automática a los contactos configurados y deshabilitación del servidor tras fallos repetidos
  • Configuración de servidor SMTP e IMAP/POP3 dedicados a la PEC

English

This module implements the PEC (Certified Email) transport channel for communication with the Italian Exchange System (SdI), as an alternative to Odoo's standard IAP proxy.

It builds on l10n_it_edi_sdi for the shared notification processing and invoice reception logic, adding PEC-specific transport.

Main features:

  • Send electronic invoices to SdI via PEC
  • Receive PEC emails from SdI and route to appropriate handlers
  • PEC error handling with automatic notification to configured contacts and server auto-disable after repeated failures
  • Dedicated SMTP and IMAP/POP3 server configuration for PEC

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.0

Permite a las empresas italianas enviar y recibir facturas electrónicas a través de un buzón PEC (correo certificado) en lugar del proxy estándar de Odoo, con notificaciones automáticas de error y desactivación del servidor tras fallos repetidos.

Este módulo añade un canal PEC (correo certificado) para la facturación electrónica italiana. Cuando se activa para una compañía, las facturas se envían como adjuntos XML por correo electrónico a la dirección del Sistema de Intercambio (SdI) en lugar de pasar por el servicio proxy habitual de Odoo.

En Ajustes, dentro de la sección de facturación electrónica italiana, una nueva opción "Canal PEC" permite activarlo y elegir un servidor de correo PEC saliente, un servidor de correo PEC entrante y la dirección de correo PEC del SdI. Las pantallas de los servidores saliente y entrante incorporan una casilla "Servidor PEC de facturación electrónica"; el servidor saliente también necesita una dirección de remitente PEC.

Los mensajes PEC entrantes se leen mediante la obtención programada de correo. Las facturas y las notificaciones del SdI se dirigen al procesamiento existente de facturación electrónica italiana. Los acuses de entrega y aceptación (asuntos que empiezan por CONSEGNA o ACCETTAZIONE) simplemente se publican como mensajes en la factura correspondiente. Un mensaje que no se puede vincular a una factura genera un error y permanece sin leer en el buzón para su revisión manual.

En el servidor entrante puede indicar contactos a notificar cuando falla un mensaje PEC. El último error y un contador de errores se muestran en el formulario del servidor. Tras más fallos que el límite configurado (5 por defecto), el servidor se restablece automáticamente a borrador y se envía un correo electrónico a los contactos.

En una factura, el botón de verificación desencadena una obtención del buzón PEC en lugar de consultar el proxy.

Modelos y campos (6)
  • mail.thread · amplía un modelo existente
  • res.company · amplía un modelo existentel10n_it_edi_use_pec (Use PEC for e-invoicing), l10n_it_edi_pec_server_id (Outgoing PEC server), l10n_it_edi_pec_fetch_server_id (Incoming PEC server), l10n_it_edi_pec_email_exchange_system (SDI PEC Email Address)
  • account.move · amplía un modelo existente
  • ir.mail_server · amplía un modelo existenteis_l10n_it_edi_pec (E-invoice PEC server), l10n_it_edi_pec_email_from (PEC Sender Email Address)
  • fetchmail.server · amplía un modelo existentepec_error_count (PEC error count), is_l10n_it_edi_pec (E-invoice PEC server), last_pec_error_message (Last PEC Error Message), e_inv_notify_partner_ids (Contacts to notify)
  • res.config.settings · amplía un modelo existentel10n_it_edi_use_pec, l10n_it_edi_pec_server_id, l10n_it_edi_pec_fetch_server_id, l10n_it_edi_pec_email_exchange_system

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. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Italiano

  • Configurar un servidor SMTP saliente para la PEC:
  • Ir a Ajustes → Técnico → Servidores de correo saliente
  • Crear un nuevo servidor con los parámetros del proveedor PEC
  • Marcar "E-invoice PEC server"
  • Introducir la dirección de correo electrónico PEC del remitente
  • Configurar un servidor de correo entrante para la PEC:
  • Ir a Ajustes → Técnico → Servidores de correo entrante
  • Crear un nuevo servidor IMAP o POP3 con los parámetros del proveedor PEC
  • Marcar "E-invoice PEC server"
  • Configurar los contactos a notificar en caso de error
  • Habilitar el canal PEC para la empresa:
  • Ir a Ajustes → Contabilidad → Facturación electrónica
  • Marcar "Use PEC for e-invoicing"
  • Seleccionar los servidores PEC saliente y entrante
  • Introducir la dirección PEC del SdI
  • El parámetro de sistema fetchmail.pec.max.retry (default: 5) controla el número máximo de errores consecutivos antes de que el servidor de correo entrante se deshabilite automáticamente. Modificar el valor en Ajustes → Técnico → Parámetros → Parámetros del sistema si es necesario.

English

  • Configure an outgoing PEC SMTP server:
  • Go to Settings → Technical → Outgoing Mail Servers
  • Create a new server with your PEC provider parameters
  • Check "E-invoice PEC server"
  • Enter the PEC sender email address
  • Configure an incoming PEC mail server:
  • Go to Settings → Technical → Incoming Mail Servers
  • Create a new IMAP or POP3 server with your PEC provider parameters
  • Check "E-invoice PEC server"
  • Configure contacts to notify on errors
  • Enable PEC channel for the company:
  • Go to Settings → Accounting → Italian Electronic Invoicing
  • Check "Use PEC for e-invoicing"
  • Select the outgoing and incoming PEC servers
  • Enter the SdI PEC email address
  • The system parameter fetchmail.pec.max.retry (default: 5) controls the maximum number of consecutive errors before the incoming mail server is automatically disabled. Change its value in Settings → Technical → Parameters → System Parameters if needed.

Italiano

Invio fatture

Le fatture vengono inviate al SdI tramite PEC quando si utilizza il normale flusso di invio fattura elettronica di Odoo. Il modulo intercetta l'invio e usa la PEC al posto del proxy IAP standard.

Ricezione notifiche

Le notifiche dal SdI vengono ricevute automaticamente tramite il cron di fetchmail. Lo stato della fattura viene aggiornato automaticamente in base alla notifica ricevuta:

  • RC (Ricevuta di Consegna) → Inoltrata al destinatario
  • NS (Notifica di Scarto) → Rifiutata
  • MC (Mancata Consegna) → Inoltro al destinatario fallito
  • NE (Notifica Esito) → Accettata/Rifiutata dal partner PA
  • DT (Decorrenza Termini) → Accettata per decorrenza termini

Ricezione fatture passive

Le fatture dei fornitori inviate tramite SdI vengono ricevute automaticamente via PEC e importate come fatture in bozza.

Verifica manuale stato

Il pulsante "Controlla Invio" sulla fattura inviata avvia una lettura manuale della casella PEC per recuperare eventuali notifiche in attesa.

English

Sending invoices

Invoices are sent to SdI via PEC when using Odoo's standard electronic invoice sending flow. The module intercepts the send and uses PEC instead of the standard IAP proxy.

Receiving notifications

SdI notifications are received automatically via the fetchmail cron. The invoice state is updated automatically based on the notification received:

  • RC (Delivery Receipt) → Forwarded to recipient
  • NS (Rejection) → Rejected
  • MC (Failed Delivery) → Forward to recipient failed
  • NE (Outcome Notification) → Accepted/Rejected by PA partner
  • DT (Deadline Expiry) → Accepted after term expiry

Receiving vendor bills

Vendor bills sent through SdI are automatically received via PEC and imported as draft invoices.

Manual status check

The "Check Sending" button on a sent invoice triggers a manual PEC mailbox read to retrieve any pending notifications.

Documentación original de OCA, en inglés: aún no está traducida. Sin información verificada en OCA: Instalación.

info

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.