Odopro
Inicio Industrias Casos
📄 Configuración - Certificado Dgital

Manual Certificado Digital


Para llevar a cabo el envío de facturas y sus documentos correctivos a la DIAN en nombre de una empresa específica en Odoo, es indispensable contar con un certificado digital de firma electrónica.


Este apartado esta dirigido a administradores del sistema, personal del área de Tecnologías de la Información (TI), consultores funcionales de Odoo, administradores de la plataforma, contadores, auxiliares contables y responsables de la facturación electrónica que participen en la configuración, administración y uso del certificado digital requerido para la emisión de documentos electrónicos.

Objetivo

Proporcionar una guía práctica para actualizar y administrar el certificado digital utilizado por Odoo en la firma de documentos electrónicos, garantizando la continuidad del proceso de facturación electrónica y el cumplimiento de los requisitos establecidos por la DIAN.

Alcance

Este documento describe el proceso de actualización del certificado digital utilizado por Odoo para:
  • Facturación Electrónica
  • Nómina Electrónica
  • Configuraciones Multiempresa
Incluye además recomendaciones de seguridad, validaciones posteriores y solución de incidencias frecuentes

Que es un certificado digital


El certificado digital es un archivo de seguridad que identifica a la empresa y permite que Odoo firme electrónicamente las facturas antes de enviarlas a la DIAN.

Puede compararse con la firma de un representante legal en un documento físico: confirma que la información proviene de la empresa y que no ha sido modificada.

Generalmente este certificado es entregado por una entidad certificadora en un archivo con extensión .P12 o .PFX, protegido mediante una contraseña.

Por que es importante actualizarlo


El certificado tiene una fecha de vencimiento.

Cuando vence, Odoo ya no puede firmar los documentos electrónicos y la DIAN rechazará automáticamente las nuevas facturas o documentos de nómina.

Actualizar el certificado antes de su vencimiento evita interrupciones en la operación de la empresa.

Algunas señales de que el certificado requiere actualización son:

  • Las facturas presentan errores al enviarse a la DIAN.
  • Los documentos quedan pendientes o rechazados.
  • El campo Certificado Válido aparece desmarcado.
  • La fecha de vigencia ya expiró o está próxima a vencer.
💡
Revise la fecha de vencimiento al menos cada tres meses y solicite la renovación con anticipación.

Requisitos antes de comenzar

Antes de actualizar el certificado, confirme que dispone de:

✔ Archivo del certificado (.P12 o .PFX).

✔ Contraseña o PIN del certificado.

✔ Acceso como Administrador en Odoo.

✔ Un certificado vigente emitido por la entidad certificadora.

Con esta información podrá realizar todo el procedimiento sin necesidad de herramientas adicionales.

Identifique su escenario

Antes de iniciar, verifique cuál de los siguientes casos corresponde a su empresa.

                   Escenario
                 ¿Qué debe hacer?
Solo utiliza Facturación Electrónica
Realice únicamente el procedimiento de actualización del certificado.
Utiliza Facturación y Nómina Electrónica
Actualice el certificado en ambas configuraciones
Maneja varias compañías en Odoo
Repita el procedimiento para cada compañía configurada en el sistema.
Si tiene dudas sobre cuál es su caso, puede verificar las compañías configuradas desde Ajustes → Usuarios y Compañías → Compañías.

Manos a la Obra Paso a Paso

  1. Debe configurarse la información de la empresa
    1. Ve a la aplicación Contactos y busca tu empresa o;

    2. Ve a la aplicación Ajustes , activa el modo desarrollador y, en la sección Empresas , haz clic en Actualizar información . A continuación, en el campo Contacto , haz clic en el nombre de la empresa.

  2. Configura la siguiente información:
    1. Nombre de empresa .

    2. Dirección : Incluya ciudad , departamento y código postal .

    3. Número de Identificación : Seleccione el Tipo de Identificación ( NIT , Cédula de Ciudadanía , Registro Civil , etc.). Cuando el Tipo de Identificación sea NIT , el Número de Identificación debe tener el dígito de verificación al final del ID precedido por un guion ( -).

  3. Vaya a la pestaña Ventas y Compras y configure la Información Fiscal :
    1. Obligaciones y Responsabilidades : Seleccione la responsabilidad fiscal de la empresa. ( O-13 Gran Contribuyente, O-15 Autorretenedor, O-23 Agente de retención IVA, O-47 Régimen de tributación simple, R-99-PN No Aplica).

    2. Gran Contribuyente : Si la empresa es Gran Contribuyente , habilite esta opción.

    3. Régimen fiscal : Seleccione el nombre del tributo para la empresa ( IVA , INC , IVA e INC o No aplica )

    4. Nombre comercial : Si la empresa utiliza un nombre comercial específico y este debe aparecer en la factura.

Credenciales de facturación electrónica y entorno DIAN

Para establecer las credenciales de usuario necesarias para la conexión con el servicio web de la DIAN y su entorno, dirígete a Contabilidad ‣ Configuración ‣ Ajustes y localiza la sección de Facturación Electrónica Colombiana. A continuación, sigue los pasos indicados:

  1. Seleccione DIAN: Servicio gratuito como proveedor de facturación electrónica .

  2. Configure los modos de operación para los respectivos tipos de documentos ( facturas electrónicas o documentos de soporte ) que se generarán desde Odoo. Haga clic en Agregar una línea y luego complete los campos:                            

    1. Modo de software : el tipo de documento que se generará con el modo de funcionamiento.

    2. ID de software : el ID generado por DIAN para el modo de operación específico.

    3. PIN del software : el PIN seleccionado en la configuración del modo de funcionamiento en el portal DIAN .

    4. ID de prueba : el ID de prueba generado por DIAN y obtenido después de probar el modo de operación.

  3. Configure los certificados disponibles para firmar los documentos electrónicos. Haga clic en Agregar una línea y, a continuación, complete los campos:

    1. Nombre : el nombre del certificado.

    2. Certificado : cargue el archivo de certificado en formato PEM. En el campo Clave privada que aparece en pantalla, seleccione una clave privada existente o cree una nueva. Para ello, introduzca un nombre para la clave y seleccione Crear y editar . A continuación, en el asistente Crear clave privada , cargue un archivo de clave válido y haga clic en Guardar y cerrar .

    4. ​Configure el entorno DIAN ; el módulo de facturación electrónica DIAN ofrece cuatro entornos DIAN diferentes con los que ​conectarse:

      • Modo de prueba de DIAN: Este entorno está diseñado para facilitar la evaluación de flujos de trabajo de facturación electrónica utilizando un certificado digital de prueba. Los archivos generados son aceptados automáticamente y no se envían a ningún entorno de DIAN. Se pueden realizar todas las validaciones internas necesarias. Para habilitar esta función, seleccione la opción «Modo de prueba de DIAN».
      • Entorno de certificación: Este entorno es esencial para completar el proceso de certificación ante la DIAN y lograr el estado de "Habilitado" para la emisión de facturas desde Odoo. Para su activación, asegúrese de seleccionar las opciones "Entorno de prueba" y "Activar el proceso de certificación". .

      • Entorno de prueba : Este entorno permite reproducir los flujos de facturación electrónica y las validaciones en el portal de pruebas de DIAN . Para activarlo, marque únicamente la casilla de verificación «Entorno de prueba» .

      • Entorno de producción : Este entorno permite generar documentos electrónicos válidos. Para activarlo, desactive las casillas de verificación "Entorno de prueba" y " Activar el proceso de certificación" .

💡
No active el modo de demostración de DIAN en una base de datos de producción. Este modo está diseñado únicamente para su uso en entornos de prueba.
⚠️

En una base de datos multicompañía, cada empresa puede tener su propio certificado.

Habilitación automática de DIAN

Odoo optimiza el proceso de habilitación ante la DIAN para convertirse en un emisor de facturas electrónicas, utilizando la solución de software desarrollada por la DIAN. Esto se logra mediante el envío del número requerido de facturas válidas de clientes, así como notas de crédito y notas de débito, al entorno de certificación de la DIAN.

💡
Siempre ejecute el proceso de habilitación en una base de datos de prueba que sirva como entorno para continuar las pruebas de facturación electrónica antes de pasar a producción

Para iniciar el procedimiento, dirígete a Contabilidad ‣ Configuración ‣ Ajustes, desplázate hasta la sección de Facturación electrónica colombiana y sigue los pasos que se indican a continuación:

  1. Habilite la casilla de verificación Entorno de prueba .

  2. Active la casilla de verificación "Activar proceso de certificación" .

  3. Ingrese el número de documentos solicitados por la DIAN para cada tipo de documento.

  4. Haga clic en Iniciar proceso de certificación y, a continuación, en Guardar .

⚠️
El número exacto de documentos requeridos por la DIAN se muestra en el portal al registrar el modo de operación.
Los documentos, productos y revistas requeridos se generan de manera automática y se envían al entorno de certificación de la DIAN.

Una vez que el proceso se haya completado, haga clic en Abrir para revisar los documentos generados y verificar el estado de validación de cada uno en la pestaña correspondiente a la DIAN..

Datos Maestros

Contactos

Configure los siguientes campos en el formulario de contacto :

  • Número de identificación (IVA): Seleccione el tipo de número de identificación e ingrese el número de identificación. Si el tipo de número de identificación es NIT , el número de identificación debe incluir el dígito de verificación al final, precedido por un guion ( -).

  • Campos de información fiscal en la pestaña Ventas y compras 

Productos

Acceda al formulario del producto mediante la ruta Contabilidad ‣ Clientes ‣ Productos y verifique que el campo Categoría UNSPSC (ubicado en la pestaña Contabilidad) o el campo Referencia interna (en la pestaña Información general) estén debidamente configurados.

Impuestos

Para establecer o modificar los impuestos, dirígete a Contabilidad ‣ Configuración ‣ Impuestos y selecciona el impuesto pertinente. En el caso de que las transacciones de venta incluyan productos gravados, asegúrate de ajustar el campo Tipo de valor en la pestaña Opciones avanzadas. También se contemplan los tipos de impuestos de retención, como ICA, IVA y Fuente. Esta configuración es esencial para garantizar la correcta visualización de los impuestos en la factura.

Diarios de ventas

Una vez que la DIAN haya proporcionado la secuencia y el prefijo oficiales para la emisión de facturas electrónicas, es imperativo proceder a la actualización de los diarios de ventas asociados a dichas facturas en Odoo. Para llevar a cabo este proceso, dirígete a Contabilidad ‣ Configuración ‣ Diarios, donde podrás seleccionar un diario de ventas existente o, si lo prefieres, crear uno nuevo utilizando el botón Crear.

En el formulario correspondiente al diario de ventas, introduzca el nombre y la categoría del diario. Posteriormente, asigne un código corto exclusivo en la sección de Entradas de diario. A continuación, proceda a configurar los datos requeridos en la pestaña de Configuración avanzada:

  • Facturación electrónica : habilitar UBL 2.1 (Colombia).

  • Resolución de facturación : número de resolución emitido por DIAN a la empresa a través de su equipo de prueba.

  • Fecha de la resolución : fecha de entrada en vigor inicial de la resolución.

  • Fecha de finalización de la resolución : fecha en que finaliza la vigencia de la resolución.

  • Rango de numeración (mínimo) : primer número de factura autorizado.

  • Rango de numeración (máximo) : último número de factura autorizado.

  • Clave técnica : clave de control recibida del conjunto de pruebas del portal DIAN o de su servicio web en el caso del entorno de producción.

Una vez que la base de datos esté debidamente configurada para el entorno de producción, en lugar de ingresar estos campos de forma manual, le recomendamos hacer clic en el botón de Recargar configuración de DIAN para obtener automáticamente la información de resolución de DIAN a través del servicio web correspondiente.

⚠️
  • El código corto y la resolución de la revista deben coincidir con los recibidos en el conjunto de pruebas del portal DIAN o del portal MUISCA.

  • La secuencia y el prefijo de la factura deben configurarse correctamente al crear la primera factura. Odoo asigna automáticamente un prefijo y una secuencia a las facturas siguiente

Flujos de trabajo principales


facturas electrónicas

A continuación se detalla el flujo de trabajo principal para las facturas electrónicas con la localización colombiana:

  1. El usuario crea una factura.

  2. Odoo genera el archivo XML legal.

  3. Odoo genera el CUFE (Código Electrónico de Factura) con la firma electrónica.

  4. Odoo envía una notificación a DIAN.

  5. DIAN valida la factura.

  6. DIAN acepta o rechaza la factura.

  7. Odoo genera la factura en formato PDF con un código QR.

  8. Odoo comprime el documento adjunto (que contiene el archivo XML enviado y la respuesta de validación de DIAN) y el PDF fiscalmente válido en un solo .ziparchivo.

  9. El usuario envía la factura ( .ziparchivo) a través de Odoo al adquirente.

Envío de facturas electrónicas

Una vez que haya confirmado la factura, proceda a hacer clic en Enviar. En el asistente que se desplegará, asegúrese de marcar las casillas correspondientes a DIAN y Email, lo que permitirá el envío del archivo XML al servicio web de DIAN y la remisión de la factura validada al correo electrónico fiscal del cliente. Posteriormente, haga clic en Enviar.

  • Se crea el documento XML.

  • Se genera el CUFE.

  • El XML es procesado de forma síncrona por DIAN .

  • Si se acepta, el archivo se muestra en el chat y se envía un correo electrónico al cliente con el .ziparchivo correspondiente.


La pestaña DIAN muestra lo siguiente:

  • Fecha de firma : marca de tiempo registrada de la creación del XML.

  • Estado : Resultado del estado obtenido en la respuesta de DIAN . Si la factura fue rechazada, aquí podrá ver los mensajes de error.

  • Entorno de prueba : Para saber si el documento enviado se entregó al entorno de prueba de DIAN .

  • Proceso de certificación : Para saber si el documento fue enviado como parte del proceso de certificación con la DIAN .

  • Descargar : Para descargar el archivo XML enviado, incluso si el resultado de DIAN fue rechazado.

  • Obtener documento adjunto : Para descargar el archivo de documento adjunto generado e incluido en el .ziparchivo entregado al cliente.

💡
Importante tener en cuenta que la funcionalidad  pueden ser complementados por OdoPro S.A.S,, pero manteniendo el proceso antes mencionado este es estandar

Actualización Certificado Digital 

Este es el procedimiento principal. Si tiene varias sucursales, repita estos mismos pasos para cada una (vea la Sección 5).

Paso 1 — Recibir el nuevo certificado del proveedor
Su proveedor de certificados digitales (por ejemplo Camerfirma, TutiendaContable,Certicámara, GSE, Andes SCD, etc.) le enviará por correo:

  • Un archivo con extensión .p12 o .pfx (a veces dentro de un .zip que debe descomprimir).
  • Un PIN o contraseña para abrir ese archivo, generalmente enviado en un correo aparte por seguridad.

Guarde ambos datos en un lugar seguro antes de continuar.

Paso 2 — Ir a la configuración de la empresa en Odoo

  • Inicie sesión en Odoo con un usuario que tenga permisos de Administrador.
  • Vaya a Ajustes (ícono de engranaje, usualmente en la esquina superior derecha).
  • Busque la sección "Empresas" o "Compañías" y haga clic en el nombre de su empresa (o de la sucursal que va a actualizar).
  • Busque la pestaña o sección llamada "Certificado Digital" o "Configuración DIAN".
Paso 3 — Cargar el nuevo certificado

  • En el campo "Archivo del certificado (.p12/.pfx)", haga clic en el ícono de editar/subir y seleccione el archivo nuevo que le envió el proveedor.
  • En el campo "Clave del certificado P12", borre la contraseña anterior (si aparece) y escriba el PIN nuevo exactamente como se lo enviaron (mayúsculas, símbolos y todo).
  •  Guarde los cambios (botón de guardar, usualmente una nube o un ícono de check).
⚠️
Al guardar, Odoo revisa automáticamente el archivo y la contraseña. Si algo está mal, mostrará un mensaje de error específico (por ejemplo "Contraseña incorrecta" o "Archivo P12 corrupto") — vea la Sección 6 si eso ocurre
Paso 4 — Verificar que quedó correcto

  • Después de guardar, recargue la página (F5).
  • Confirme que el campo "Certificado Válido" aparece marcado.
  • Confirme que el campo "Válido Hasta" muestra la nueva fecha de vencimiento (normalmente 1 año adelante).
  • Confirme que el campo "Nombre del Sujeto (CN)" muestra el nombre correcto de su empresa
Cuando cuentas con Nomina 

El certificado de nómina electrónica es independiente del de facturación, aunque normalmente se usa el mismo archivo .p12. Si su empresa envía nómina electrónica a la DIAN desde Odoo, debe cargar el certificado también en esa sección, o el envío de nómina seguirá fallando aunque la facturación ya esté funcionando

  • Desde la misma ficha de la empresa (Ajustes → Empresas → [su empresa]), busque una sección o pestaña relacionada con "Nómina Electrónica" o "Configuración de Nómina DIAN".
  • Repita el mismo proceso: cargue el archivo .p12 y escriba el PIN en los campos correspondientes de esa sección.
  • Guarde los cambios.
⚠️
Si no encuentra una sección separada para el certificado de nómina en la interfaz web de su instalación, contacte a su equipo de soporte técnico — en algunas instalaciones ese campo solo es visible en modo desarrollador o requiere activarse por consola.
Si tiene varias sucursales (múltiples compañías)

Este es el paso que con más frecuencia se pasa por alto, y causa que algunas sucursales sigan fallando después de "ya haber actualizado el certificado".

💡
Cada sucursal/tienda configurada como una compañía independiente en Odoo tiene SU PROPIO registro de certificado. Actualizar el de la empresa matriz NO actualiza automáticamente el de las demás sucursales.
  • Vaya a Ajustes → Usuarios y Compañías → Compañías, y liste todas las sucursales/tiendas registradas.
  • Para CADA una, repita el Paso 2 y Paso 3 de la Sección 3 (y la Sección 4 si aplica nómina).
  • Al final, revise una por una que todas muestren "Certificado Válido" — puede llevar un control simple en una hoja de cálculo con el nombre de cada sucursal y una marca de verificación
Como normalmente todas las sucursales pertenecen a la misma empresa/NIT, se usa el mismo archivo .p12 y el mismo PIN para todas — solo hay que repetir la carga en cada una.


Solución a problemas  comunes


Problema

Qué hacer

"Contraseña incorrecta del certificado P12"

Vuelva a copiar el PIN desde el correo original del proveedor. Verifique que no incluyó espacios al inicio/final ni caracteres de más.

"Error al cargar archivo P12/PFX" o "archivo corrupto"

Confirme que el archivo no quedó dañado al descomprimirlo. Vuelva a descargarlo del correo del proveedor y descomprímalo de nuevo con WinRAR o 7-Zip.

El campo "Certificado Válido" sigue sin marcar y no hay mensaje de error visible

Recargue la página (F5). Si persiste, revise que la fecha de vigencia del certificado nuevo ya haya iniciado (a veces el proveedor lo emite con inicio de vigencia el día siguiente).

Una sucursal específica sigue fallando aunque "ya actualicé el certificado"

Revise la Sección 5 — es muy probable que esa sucursal sea una compañía separada que aún no se ha actualizado.

La facturación funciona pero la nómina electrónica sigue fallando

Revise la Sección 4 — el certificado de nómina se configura aparte del de facturación.

Después de todo lo anterior, sigue sin funcionar

Contacte a su equipo de soporte técnico de Odoo con: el mensaje de error exacto, el nombre de la sucursal afectada, y la fecha de vigencia que muestra el certificado nuevo.