⚙️ Instalación y configuración
Iniciar sesión
⚙️

Instalación y configuración


1. Introducción

La facturación electrónica en el Perú es un requisito establecido por la SUNAT para determinadas empresas y contribuyentes, con el objetivo de agilizar y transparentar el proceso de emisión de comprobantes de pago. Odoo, un ERP de código abierto, permite cumplir con esta exigencia a través de diversos módulos de localización. Uno de ellos es l10n_pe_edi_odoofact, desarrollado por OPeru, que facilita la integración con la plataforma de Nubefact, un proveedor de servicios electrónicos (PSE) autorizado por la SUNAT.


Este manual describe el proceso de instalación, configuración y uso básico de la facturación electrónica en Odoo a través de Nubefact, utilizando nuestro módulo Odoofact.

2. Requisitos Previos

  • Instancia de Odoo (versión compatible con l10n_pe_edi_odoofact, generalmente Odoo 16, 17, 18 o superior, dependiendo de las especificaciones del módulo).
  • Módulo de localización peruana estándar instalado, por ejemplo l10n_pe (para contar con catálogos de SUNAT: documentos, monedas, unidades de medida, etc.).
  • Módulo l10n_pe_edi_odoofact publicado por OPeru, disponible en el Odoo Apps Store.

    📂

    Módulos necesarios:

    - Módulo Facturación electrónica: https://apps.odoo.com/apps/modules/18.0/l10n_pe_edi_odoofact

    Dependencias: 

    ​-  E-Documents --> https://apps.odoo.com/apps/modules/18.0/l10n_pe_edi_base

    -  Catálogos SUNAT: https://apps.odoo.com/apps/modules/18.0/l10n_pe_edi_catalog


  • Cuenta activa en Nubefact (con tus credenciales de acceso: usuario, contraseña y endpoints suministrados por Nubefact).

    📄 Creación de cuenta Nubefact

    💡

    Puedes crear una cuenta en Nubefact en: https://www.nubefact.com para contar con una cuenta de prueba y luego podrás acceder a uno de sus planes contratando su plan https://www.nubefact.com/precios

    ✅

    Todos nuestros planes ya incluyen una cuenta de Nubefact para que puedas emitir tus facturas sin ningún coste adicional para tus primeros 500 comprobantes cada mes.
    Consulta nuestros planes en Ver planes

  • Configuración de datos de la empresa en Odoo (RUC, dirección, régimen tributario, etc.).
  • Acceso a internet y permisos de administrador en Odoo para instalar/configurar los módulos.

3. Instalación del Módulo l10n_pe_edi_odoofact

  1. Descargar el módulo:

​ ​

    • Asegúrate de descargar la versión adecuada según tu Odoo.
    • La descarga tiene 3 carpetas, donde se incluye el módulo de facturación electrónica y sus dependencias.

​

  1. Actualizar la lista de aplicaciones en Odoo:

    • Inicia sesión en tu base de datos de Odoo con un usuario administrador.
    • Ve a Aplicaciones (Apps).
    • Haz clic en el botón Actualizar lista de aplicaciones (o Update Apps List si tu interfaz está en inglés).  Antes debes asegurarte de tener activado 'Modo desarrollador'. Luego podrás ver el módulo listo para instalar:

​

  1. Instalar el módulo:

    • Busca “l10n_pe_edi_odoofact”.
    • Haz clic en Instalar o Activar.
    • Odoo procesará la instalación y resolverá dependencias (asegúrate de que no falten módulos requeridos).

4. Configuración del Módulo y Credenciales de Nubefact

Una vez instalado el módulo, deberás configurar el entorno para que se conecte correctamente con Nubefact:

  1. Activar la facturación electrónica:

    • Dirígete a Contabilidad > Configuración > Ajustes (o Settings).
    • Busca la sección de Facturación Electrónica Peruana (o Electronic Invoicing), selecciona Enviar E-Documentos a PSE/OSE o asegúrate de que esté habilitada esa opción.




      ⚠️

      Debes elegir la opción correcta:

      - NUBEFACT: Debes usarlo sólo si has creado una cuenta directamente desde https://www.nubefact.com/ y tienes contratado el servicio como PSE.

      - ODOOFACT: Es para las empresas que tienen contratado Nubefact a través de nuestros Planes https://www.operu.pe/r/QW2 o si se trata de una cuenta Reseller.

      🚨

      Importante: 

      Este módulo solo funciona a través del PSE de Nubefact. Si estás obligado a enviar tus comprobantes vía OSE deberás primero crear tu cuenta tipo PSE y luego solicitar a Nubefact que todos los comprobantes sean enviados via OSE. De esta forma el PSE se mantendrá como puente para que tus comprobantes se envíen como OSE sin necesidad de hacer cambios ni desarrollos adicionales con Nubefact y Odoo. 


  2. Configuración de Tiendas o LOCALES en Odoo:

    • Ingresar al módulo 'E-Documentos > Configuración > Tiendas'



    • En el listado de Tiendas debe existir al menos una tienda por compañía. Por defecto el módulo crea una TIENDA por cada compañía pero luego se pueden crear más tiendas según la cantidad de LOCALES que tenga la compañía. Una Tienda es equivalente a un LOCAL en Nubefact.



      💡

      Antes de configurar una TIENDA en Odoo debes tener configurado el LOCAL en tu cuenta de Nubefact. 

      Revisa el manual de Configuración -> 📄 Creación y configuración Nubefact

    • Ahora configuramos la Tienda en Odoo:
      • Nombre: Descripción o nombre corto de la Tienda o LOCAL
      • Dirección: Contacto de Odoo que pertenece a uno de los contactos de la compañía y que representan a la Tienda o LOCAL
      • Código SUNAT: Es el código de LOCAL asignado en SUNAT
      • Enviar factura por correo: Esto es para indicar que Nubefact envíe automáticamente las facturas al cliente usando el formato propio de Nubefact y omitiendo el formato de Odoo. Si deseas enviar las facturas mediante Odoo debes dejar esta opción desactivada.
      • URL y token: Son los datos que se obtienen desde tu cuenta Nubefact . 



    • la URL y Token las Obtienes desde tu cuenta Nubefact en 'Menú principal -> Configuración -> API (Integración)'
      Puedes ver los pasos para obtener el token en 📄 Creación y configuración Nubefact

  4. Configuración de Diarios contables

    • Debemos configurar los Diarios contables para cada tipo de comprobante electrónico. Por defecto Odoo trae creado los Diarios:
      • Facturas de cliente
      • Debit note
    • Podemos reutilizar esos diarios o crear nuevos Diarios acorde a nuestras necesidades. En cualquier caso debemos crear los siguientes Diarios:
      • Ticket TK01: Diario para tickets en caso usen Punto de venta
      • Factura F001: Diario para facturas de venta de la serie F001
      • Boleta B001: Diario para boletas de venta de la serie B001
      • Nota de Crédito Factura FC01: Diario para notas de crédito de facturas, serie FC01
      • Nota de Crédito Boleta BC01: Diario para notas de crédito de boletas, serie BC01
      • Nota de Débito Factura FD01: Diario para notas de débito de facturas de serie FD01
      • Nota de Débito Boleta BD01: Diario para notas de débito de boletas de serie BD01



    • Para crear un Diario se debe considerar el tipo de comprobante y otros datos importantes
      • Tipo: En este caso todas son de tipo 'Ventas' ya que estamos viendo comprobantes de venta.
      • Tienda: Debe especificar la tienda o LOCAL según la Serie que se tiene configurada en Nubefact
      • Tipo de documento: Aquí debes elegir correctamente el tipo de comprobante ya que esto define el cómo se enviará el comprobante a Nubefact y en consecuencia a SUNAT.
      • Es E-factura: Indica que todos los documentos creados en este Diarios se consideran documentos electrónicos y se enviarán a Nubefact. Si está deshabilitado, estos comprobantes se consideran NO electrónicos y no se enviarán a SUNAT.
      • Contingencia: Si el Diario corresponde a Comprobantes físicos y que luego se tienen que enviar a Nubefact. Estos documentos, aunque sean físicos también se consideran Electrónicos ya que deberán ser enviados a Nubefact.
      • Usa documentos?: Lo dejamos desactivado ya que vamos a usar un diario para cada documento y nos más de uno para un solo Diario.
      • Código corto: Aquí se especifica la SERIE del comprobante



    • Ahora ya podemos iniciar con la emisión de comprobantes