✔️ Validador RUC / DNI
Iniciar sesión
✔️

Validador RUC / DNI

1. Descripción General

El módulo odoope_ruc_validation permite que, al ingresar un RUC/DNI en la ficha de un contacto (modelo res.partner), se realice una consulta automática a un servicio externo para validar la existencia del RUC/DNI y obtener los datos fiscales básicos (razón social, dirección, estado, condición, etc.) para RUC y Nombre y apellidos para DNI. De esta forma, se reducen los errores de digitación y se agiliza la creación y mantenimiento de clientes y proveedores en Odoo.

2. Requisitos Previos

  • Odoo en versión compatible (comúnmente v12, v13, v14 o superior, verificar en la página oficial del módulo).
  • Acceso de administrador en Odoo para instalar el módulo.
  • Módulo odoope_ruc_validation publicado por OPeru, disponible en el Odoo Apps Store.

    📂

    Módulos necesarios:

    - Módulo Validador de Datos - Peru: https://apps.odoo.com/apps/modules/18.0/odoope_ruc_validation

  • Token ilimitado requerido para realizar consultas de RUC y DNI ilimitadas.

    ⚠️

    El token ilimitado:

    Se puede comprar desde nuestra página web: https://www.operu.pe/shop/token-ilimitado-anual-92

  • Conexión a Internet para que la validación pueda comunicarse con el servicio externo.

3. Instalación

  1. Odoo Apps Store:

    • Ingresa a https://apps.odoo.com y busca “odoope_ruc_validation”.



    • Descarga el paquete ZIP con el módulo.

  2. Actualizar la Lista de Aplicaciones

    • 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:



  4. Instalar el módulo:

    • Busca “odoope_ruc_validation”.
    • 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 Inicial

Dependiendo de la versión específica del módulo, la ubicación donde se configura el el módulo puede variar:

  1. Ir a Ajustes (Settings) -> Usuarios y compañías -> Compañías.
  2. En la ficha de la compañía ingresa el TOKEN y activa las opciones que creas conveniente se van a validar con este token. 



    ⚠️

    El token ilimitado:

    Se puede comprar desde nuestra página web: https://www.operu.pe/shop/token-ilimitado-anual-92

    ✅

    El token ilimitado es multicompañía y se configura por separado en cada compañía. No es necesario comprar otro token, siempre que todas las compañías estén en la misma base de datos.

    ❌

    Aunque el Token sea multicompañía, es válido únicamente para UNA base de datos. Si por error fue registrado en más de una base de datos, recomendamos eliminarla de la que no corresponde para que el sistema no la bloquee en un futuro.

5. Uso del Módulo en la Creación/Edición de Contactos

Una vez instalado y configurado, el módulo permite validar y autocompletar datos del RUC o DNI cuando creas o editas un Contacto en Odoo.

Crear un Nuevo Contacto

  1. Ve al módulo Contactos (o Ventas > Clientes, Facturación > Clientes, etc., dependiendo de tu menú de Odoo).
  2. Haz clic en Crear (Create) para abrir el formulario de nuevo contacto.
  3. Localiza el campo RUC (o “VAT” si tu interfaz está en inglés y/o la localización peruana lo mapea a ese campo).
  4. Ingresa el RUC (11 dígitos) y presiona Tab o haz clic en otro campo.

Validación y Autocompletado

  • Una vez que ingreses el RUC, el módulo generalmente realiza la consulta al servicio externo.

  • Si la validación es exitosa, la pantalla autocompletará los campos según el tipo de Documento:

    • Si es para DNI
      • Nombre y Apellidos.



    • Si es para RUC
      • Razón Social o Nombre Comercial.
      • Dirección.
      • Estado y Condición del contribuyente (Activo/Habido, Baja, etc.).