Skip to main content
Este artículo te guiará paso a paso para integrar la API de Consultas de json.pe con Odoo mediante el módulo oficial json_pe. Este módulo permite consultar información de DNI y RUC peruanos directamente desde el formulario de contactos (Partners) en Odoo, autocompletando automáticamente los datos del contacto con información actualizada.

​
Compatibilidad

El módulo json_pe es compatible con las siguientes versiones de Odoo:
  • Odoo 17.0
  • Odoo 18.0
  • Odoo 19.0
Disponibilidad: Odoo Online, Odoo.sh, On Premise
Dependencias: Contacts (contacts), Discuss (mail)
Licencia: LGPL-3
Módulo: Descargar desde Odoo Apps

​
1. Instalación del Módulo

​
Opción A: Desde Odoo Apps Store

  1. Inicia sesión en tu instancia de Odoo como administrador
  2. Ve a Apps en el menú principal
  3. Busca “Consulta DNI y RUC” o “json_pe”
  4. Haz clic en Instalar
  5. Espera a que se complete la instalación

​
Opción B: Instalación Manual

  1. Descarga el módulo desde Odoo Apps Store
  2. Extrae el archivo en la carpeta de módulos personalizados de tu instancia Odoo
  3. Actualiza la lista de aplicaciones en Odoo
  4. Busca e instala el módulo json_pe
Una vez instalado, el módulo estará activo y listo para configurar

​
2. Obtener tu API Token

Antes de configurar el módulo en Odoo, necesitas obtener tu API Token de json.pe:

​
Paso 1: Crear Cuenta

  1. Visita app.json.pe
  2. Regístrate completando el formulario de registro
  3. Verifica tu cuenta mediante el correo electrónico recibido

​
Paso 2: Generar Token

  1. Inicia sesión en tu cuenta de app.json.pe
  2. Navega a la sección de API Tokens
  3. Genera un nuevo token haciendo clic en “Crear Token” o “Generar Token”
  4. Copia y guarda el token de manera segura (no podrás verlo nuevamente)
Importante: Guarda tu token en un lugar seguro. Si lo pierdes, deberás generar uno nuevo.

​
3. Configurar el API Token en Odoo

Una vez que tengas tu API Token, sigue estos pasos para configurarlo en Odoo:
  1. Inicia sesión en Odoo como administrador
  2. Ve a Configuración → Configuración General (Settings → General Settings)
  3. Busca la sección JSON.PE en la configuración
  4. Pega tu API Token en el campo correspondiente
  5. Haz clic en Guardar para aplicar los cambios
¡Configuración completada! Ahora puedes usar las funciones de consulta DNI y RUC

​
4. Usar las Consultas DNI y RUC

​
Consultar DNI

El módulo permite consultar información de DNI peruanos directamente desde el formulario de contactos:
  1. Abre o crea un Contacto (Partner) en Odoo
  2. Ingresa el DNI (8 dígitos) en el campo correspondiente
  3. Haz clic en el botón “Consultar DNI” ubicado en el encabezado del formulario
  4. El sistema consultará la API de json.pe y autocompletará automáticamente:
    • Nombre completo
Los botones de consulta solo aparecerán si has ingresado un DNI o RUC válido en el formulario.

​
Consultar RUC

Para consultar información de empresas mediante RUC:
  1. Abre o crea un Contacto (Partner) en Odoo
  2. Ingresa el RUC (11 dígitos) en el campo correspondiente
  3. Haz clic en el botón “Consultar RUC” ubicado en el encabezado del formulario
  4. El sistema consultará la API de json.pe y autocompletará automáticamente:
    • Nombre o Razón Social
    • Número de identificación fiscal (RUC)
    • Dirección completa
    • Ciudad/Distrito
    • Código postal (Ubigeo)

​
5. Características del Módulo

Autocompletado Inteligente

Autocompleta automáticamente los datos del contacto con información oficial y actualizada de SUNAT.

Validación de Formatos

Valida automáticamente los formatos de DNI (8 dígitos) y RUC (11 dígitos) antes de realizar la consulta.

Manejo de Errores

Proporciona mensajes claros y útiles cuando ocurre un error en la consulta, facilitando la resolución de problemas.

Integración Nativa

Integración completamente nativa con Odoo, sin necesidad de configuraciones adicionales complejas.

​
6. Beneficios

  • Optimización del flujo de trabajo: Elimina la necesidad de ingresar manualmente la información de clientes y proveedores
  • Datos actualizados: Obtiene información directamente de fuentes oficiales (SUNAT)
  • Ahorro de tiempo: Reduce significativamente el tiempo de registro de contactos
  • Precisión: Minimiza errores de tipeo y datos incorrectos
  • Experiencia fluida: Interfaz intuitiva y fácil de usar

​
7. Preguntas frecuentes

Puedes descargar el módulo directamente desde el Odoo Apps Store. El módulo está disponible para Odoo Online, Odoo.sh y instalaciones On Premise.
El módulo puede tener un costo según la versión y el tipo de instalación. Consulta los detalles en la página del módulo en Odoo Apps. El API Token de json.pe se obtiene de forma gratuita registrándote en app.json.pe.
El módulo es compatible con Odoo 17.0, 18.0 y 19.0. Asegúrate de descargar la versión correcta según tu instalación de Odoo.
Es muy sencillo. Solo necesitas registrarte en app.json.pe, verificar tu cuenta por correo electrónico, y luego generar un token desde la sección de API Tokens en tu panel de control.
Al consultar un DNI, se autocompleta el nombre completo de la persona.
Al consultar un RUC, se autocompleta: nombre o razón social, número de identificación fiscal, dirección completa, ciudad/distrito y código postal (Ubigeo).
Los botones de consulta solo aparecen cuando has ingresado un DNI válido (8 dígitos) o un RUC válido (11 dígitos) en el formulario. Verifica que el formato sea correcto.
Sí, el módulo requiere conexión a internet para consultar la API de json.pe y obtener la información actualizada.
Para soporte del módulo Odoo, puedes contactar al autor a través de la información de contacto en la página del módulo. Para soporte de la API de json.pe, visita nuestra documentación o contacta a [email protected].

​
8. Enlaces y Recursos

Consejo: Mantén tu API Token actualizado y seguro. Si sospechas que ha sido comprometido, genera uno nuevo inmediatamente desde tu panel de control en app.json.pe.