> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# Odoo

> Integra API dni/ruc con Odoo usando el módulo json_pe

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**

<Info>
  **Disponibilidad:** Odoo Online, Odoo.sh, On Premise\
  **Dependencias:** Contacts (contacts), Discuss (mail)\
  **Licencia:** LGPL-3\
  **Módulo:** [Descargar desde Odoo Apps](https://apps.odoo.com/apps/modules/19.0/json_pe)
</Info>

## 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](https://apps.odoo.com/apps/modules/19.0/json_pe)
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**

<Check>
  Una vez instalado, el módulo estará activo y listo para configurar
</Check>

## 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](https://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](https://app.json.pe/login)
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)

<Warning>
  **Importante:** Guarda tu token en un lugar seguro. Si lo pierdes, deberás generar uno nuevo.
</Warning>

## 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

<Check>
  ¡Configuración completada! Ahora puedes usar las funciones de consulta DNI y RUC
</Check>

## 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**

<Info>
  Los botones de consulta solo aparecerán si has ingresado un DNI o RUC válido en el formulario.
</Info>

### 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

<CardGroup cols={2}>
  <Card title="Autocompletado Inteligente" icon="wand-magic-sparkles">
    Autocompleta automáticamente los datos del contacto con información oficial y actualizada de SUNAT.
  </Card>

  <Card title="Validación de Formatos" icon="shield-check">
    Valida automáticamente los formatos de DNI (8 dígitos) y RUC (11 dígitos) antes de realizar la consulta.
  </Card>

  <Card title="Manejo de Errores" icon="circle-exclamation">
    Proporciona mensajes claros y útiles cuando ocurre un error en la consulta, facilitando la resolución de problemas.
  </Card>

  <Card title="Integración Nativa" icon="plug">
    Integración completamente nativa con Odoo, sin necesidad de configuraciones adicionales complejas.
  </Card>
</CardGroup>

## 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

<AccordionGroup>
  <Accordion title="¿Cómo obtengo el módulo json_pe?">
    Puedes descargar el módulo directamente desde el [Odoo Apps Store](https://apps.odoo.com/apps/modules/19.0/json_pe). El módulo está disponible para Odoo Online, Odoo.sh y instalaciones On Premise.
  </Accordion>

  <Accordion title="¿Necesito pagar por el módulo?">
    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](https://apps.odoo.com/apps/modules/19.0/json_pe). El API Token de json.pe se obtiene de forma gratuita registrándote en [app.json.pe](https://app.json.pe).
  </Accordion>

  <Accordion title="¿Qué versión de Odoo es compatible?">
    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.
  </Accordion>

  <Accordion title="¿Cómo obtengo un API Token?">
    Es muy sencillo. Solo necesitas registrarte en [app.json.pe](https://app.json.pe/signup), verificar tu cuenta por correo electrónico, y luego generar un token desde la sección de API Tokens en tu panel de control.
  </Accordion>

  <Accordion title="¿Qué información se autocompleta al consultar DNI?">
    Al consultar un DNI, se autocompleta el nombre completo de la persona.
  </Accordion>

  <Accordion title="¿Qué información se autocompleta al consultar RUC?">
    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).
  </Accordion>

  <Accordion title="¿Qué hago si el botón de consulta no aparece?">
    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.
  </Accordion>

  <Accordion title="¿Necesito conexión a internet para usar el módulo?">
    Sí, el módulo requiere conexión a internet para consultar la API de json.pe y obtener la información actualizada.
  </Accordion>

  <Accordion title="¿Cómo obtengo soporte técnico?">
    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](https://apps.odoo.com/apps/modules/19.0/json_pe). Para soporte de la API de json.pe, visita nuestra [documentación](https://docs.json.pe) o contacta a [soporte@json.pe](mailto:soporte@json.pe).
  </Accordion>
</AccordionGroup>

## 8. Enlaces y Recursos

* **Sitio web:** [json.pe](https://json.pe)
* **Registro gratis:** [json.pe/signup](https://json.pe/signup)
* **Dashboard json.pe:** [app.json.pe](https://app.json.pe/login)
* **Módulo Odoo:** [Odoo Apps Store](https://apps.odoo.com/apps/modules/19.0/json_pe)

<Tip>
  **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.
</Tip>