Skip to Content

Consulta RUC/DNI - Perú

Technical name: l10n_pe_cs_api_partner

Name
Consulta RUC/DNI - Perú
Summary
Consulta datos RUC/DNI - Cloudia API para Perú
Description
Funcionalidad Consulta RUC / DNI para Perú con Cloudia API
Author
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
License
OPL-1
Version
18.0.1.0
Dependencies
  • contacts
  • l10n_pe
  • l10n_latam_base
  • l10n_pe_cs_api_settings

1. Configuration

  1. Open Ajustes and the Cloudia API app.
  2. Under Servicios de la API de Cloudia, copy Client ID (generated from the database and company VAT) and paste the Token provided by Cloudia.
  3. Save.
Cloudia API settings
Company-level Client ID and Token. The lookup buttons do nothing until a Token is saved.

RUC queries run automatically. DNI is never auto-queried: use Actualizar Contacto when you need a name lookup.

2. User instructions

Look up a RUC

  1. Open Contactos and create or open a company.
  2. Set identification type to RUC and enter the number.
  3. Save. The module fills name, street, district, city and SUNAT status from the API.
Contact form after a RUC lookup
Name and Peruvian address filled from the API. Child people live on Contacts; delivery/other addresses on Addresses.

Review SUNAT data

  1. On the same contact, open the SUNAT tab (only for RUC or DNI).
  2. Check Estado del Contribuyente, Estado de Domicilio del Contribuyente, IGV agents, and CIIU activities (RUC 20 companies).
SUNAT tab with taxpayer status
Fecha de Última Actualización de API is the monthly gate: automatic RUC updates skip if it is already this month.

If status is not ACTIVO or address is not HABIDO, a banner appears at the top of the form while editing.

Force a refresh, annexes, or directors

  1. On the contact, open Acciones.
  2. Actualizar Contacto — query again now (bypasses the monthly gate; also the way to look up a DNI name).
  3. Consultar direcciones adicionales — load SUNAT annexes as extra addresses (RUC companies only).
  4. Consultar Representantes Legales — load legal representatives as Contacts (RUC companies only).
Action menu on the contact
The three server actions on the contact. They require a Cloudia API Token.

Consulta RUC/DNI - Perú

Nombre técnico: l10n_pe_cs_api_partner

Nombre
Consulta RUC/DNI - Perú
Resumen
Consulta datos RUC/DNI - Cloudia API para Perú
Descripción
Funcionalidad Consulta RUC / DNI para Perú con Cloudia API
Autor
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
Licencia
OPL-1
Versión
18.0.1.0
Dependencias
  • contacts
  • l10n_pe
  • l10n_latam_base
  • l10n_pe_cs_api_settings

1. Configuración

  1. Abra Ajustes y la aplicación Cloudia API.
  2. En Servicios de la API de Cloudia, copie el Client ID (se genera con la base de datos y el RUC de la compañía) y pegue el Token que le dio Cloudia.
  3. Guarde.
Ajustes de Cloudia API
Client ID y Token por compañía. Sin Token no hay consulta.

El RUC se consulta solo. El DNI nunca se consulta automático: use Actualizar Contacto cuando necesite el nombre.

2. Instrucciones de usuario

Consultar un RUC

  1. Abra Contactos y cree o abra una compañía.
  2. Ponga el tipo de identificación en RUC y escriba el número.
  3. Guarde. El módulo completa nombre, calle, distrito, ciudad y estado SUNAT desde la API.
Formulario del contacto después de consultar el RUC
Nombre y dirección llenados por la API. Las personas van en Contacts; las direcciones de entrega u otras, en Addresses.

Revisar los datos SUNAT

  1. En el mismo contacto, abra la pestaña SUNAT (solo RUC o DNI).
  2. Revise Estado del Contribuyente, Estado de Domicilio del Contribuyente, agentes IGV y actividades CIIU (compañías RUC 20).
Pestaña SUNAT con estado del contribuyente
Fecha de Última Actualización de API es el candado mensual: si ya se actualizó este mes, la consulta automática se omite.

Si el estado no es ACTIVO o el domicilio no es HABIDO, al editar aparece un aviso arriba del formulario.

Forzar actualización, anexos o representantes

  1. En el contacto, abra Acciones.
  2. Actualizar Contacto — consulta ahora (salta el candado mensual; también sirve para un DNI).
  3. Consultar direcciones adicionales — carga anexos SUNAT como direcciones extra (solo compañías con RUC).
  4. Consultar Representantes Legales — carga representantes en Contacts (solo compañías con RUC).
Menú Acciones del contacto
Las tres acciones del contacto. Requieren Token de Cloudia API.