Consultas SUNAT / RENIEC
Pantalla para validar un RUC o DNI contra los padrones SUNAT y RENIEC sin necesidad de guardarlo como contacto. Útil para verificar contribuyentes antes de venderles o comprarles.
La pantalla Consultas SUNAT/RENIEC te deja consultar libremente un RUC contra el padrón de SUNAT o un DNI contra RENIEC sin guardar nada en tu directorio. Es el lugar para verificar al contribuyente antes de venderle, comprarle o registrarlo como contacto — saber si está activo, si su domicilio fiscal está habido, si es persona natural o jurídica, y a qué distrito pertenece.
Es una pantalla antigua — antes del rediseño de Contactos, tenía un enlace visible en la navegación de Gestión. Desde el rediseño de mayo 2026, la consulta principal vive embebida dentro de los forms de creación de cliente y proveedor (botón 🔍 SUNAT). La antigua dirección de «Buscar» ahora redirige a Contactos para los enlaces guardados, pero la pantalla sigue accesible desde Contactos si la necesitas para una validación libre sin crear contacto.
Eliges el tipo de documento (radio buttons RUC o DNI), tipeas el número, presionas Buscar y obtienes un card con los datos: razón social/nombre, estado, condición de domicilio, dirección completa con ubigeo y tipo de RUC (persona natural 10… o jurídica 20…). Si el contribuyente está suspendido o tiene domicilio no habido, aparece un warning ámbar advirtiendo que SUNAT puede rechazar tus comprobantes contra él.
Los resultados se cachean 24h por documento — la primera consulta golpea la API real de Migo (cuesta créditos), las siguientes en el día son gratis y casi instantáneas. Si necesitas datos frescos (ej. porque el proveedor te dijo que cambió de domicilio), hay un botón ↻ Refrescar que limpia el cache de ese documento y consulta de nuevo.
Manual completo
Las dos modalidades de consulta
| Modalidad | Validación | Qué devuelve |
|---|---|---|
| RUC | Exactamente 11 dígitos numéricos | Razón social, estado del contribuyente, condición de domicilio, dirección, departamento, provincia, distrito, ubigeo, tipo (persona natural 10… o jurídica 20…) |
| DNI | Exactamente 8 dígitos numéricos | Solo nombre completo. RENIEC no devuelve dirección por privacidad. |
⚠️ Si tipeas un número con guiones, espacios o cantidad de dígitos incorrecta, el sistema te devuelve mensaje de validación («El RUC debe tener exactamente 11 dígitos.»). Sin guiones, sin puntos, solo números.
Resultado de consulta RUC
El card de resultado RUC muestra:
| Sección | Qué contiene |
|---|---|
| Encabezado | Razón social en grande, RUC en monospace pequeño, 2 badges apilados a la derecha con estado del contribuyente y condición de domicilio. |
| Grid de detalle | Dirección completa, ubigeo + distrito + provincia + departamento, tipo (persona natural o jurídica). |
| Warning ámbar | Aparece solo si el contribuyente no está activo o su domicilio no está habido. Texto: «⚠ Este RUC no está totalmente operativo — SUNAT puede rechazar comprobantes contra este contribuyente.» |
| Footer de acciones | Links rápidos «Usar en nueva venta →» y «Usar en nueva cotización →» que te llevan al form correspondiente con el cliente pre-llenado (en el futuro — actualmente solo navegan al form vacío). |
Estado del contribuyente (badges)
| Estado | Badge | Significado |
|---|---|---|
| ACTIVO | Verde | El contribuyente está habilitado en SUNAT para realizar actividades comerciales. Puede emitir y recibir comprobantes. |
| BAJA DE OFICIO | Rojo | SUNAT lo dio de baja unilateralmente (por incumplimientos o cese voluntario). NO puede emitir comprobantes. |
| SUSPENSION TEMPORAL | Rojo | Suspensión transitoria. Mientras dure, los comprobantes contra este RUC pueden ser rechazados. |
| BAJA PROVISIONAL | Rojo | Estado intermedio antes de baja definitiva. Riesgo alto. |
| HABILITADO | Verde | Variante de ACTIVO en algunas categorías de contribuyente. |
Condición de domicilio (badges)
| Condición | Badge | Significado |
|---|---|---|
| HABIDO | Verde | El domicilio fiscal declarado está confirmado por SUNAT (la dirección existe y el contribuyente está localizable). |
| NO HABIDO | Ámbar | SUNAT no ha podido confirmar el domicilio. Los comprobantes pueden ser observados o el crédito fiscal puede ser desconocido. |
| POR VERIFICAR | Ámbar | Estado en proceso de verificación. |
| HALLADO | Verde | Variante de HABIDO. |
Tipo de contribuyente (deducido del RUC)
| Inicio del RUC | Tipo |
|---|---|
10 |
Persona natural con negocio. Genera RUC al inscribirse, pero el documento personal sigue siendo el DNI. |
15 |
Persona natural sin negocio (RUC histórico de servicios independientes). |
17 |
Sucesión indivisa. |
20 |
Persona jurídica (S.A., S.A.C., E.I.R.L., S.R.L., etc.). |
El sistema solo distingue persona natural (10) y persona jurídica (20). El resto se etiqueta como «Otro».
Resultado de consulta DNI
El card de resultado DNI es más simple — RENIEC solo entrega nombre completo:
| Campo | Qué muestra |
|---|---|
| Nombre completo | Texto grande en negrita (formato apellidos + nombres). |
| DNI | 8 dígitos en monospace pequeño. |
| Footer | Links «Usar en nueva venta →» y «Usar en nueva cotización →». |
💡 No hay badges ni warnings en DNI — RENIEC no expone estado del ciudadano. La consulta es solo para verificar que el DNI existe y obtener el nombre oficial.
Botón ↻ Refrescar
Aparece junto al input solo después de una consulta exitosa. Al hacer click:
- Limpia la información guardada de ese documento en particular.
- Re-ejecuta la consulta — esta vez va sí o sí al padrón real (no toca la información guardada).
- Cuesta un crédito de Migo, pero te garantiza datos frescos.
Útil cuando:
- El contribuyente te dice que actualizó algo en SUNAT y quieres ver el cambio antes de las 24h del cache.
- Sospechas que el dato cacheado es incorrecto.
- Estás haciendo una verificación crítica antes de una compra grande.
Casos de error
| Error | Mensaje |
|---|---|
| Documento vacío | «El RUC debe tener exactamente 11 dígitos.» / «El DNI debe tener exactamente 8 dígitos.» |
| Cantidad de dígitos incorrecta | Mismo mensaje (validación de Livewire). |
| Documento no existe en padrón | «{TIPO} {número} no encontrado en los padrones SUNAT/RENIEC.» (se asume que pasó la validación de formato pero el padrón no lo encontró). |
| Consulta caída / demora | «Error consultando el padrón: {detalle}.» Posibles causas: el servicio de consulta caído, sin conexión a internet. |
| Error de configuración del servidor | «Ocurrió un problema de configuración. Contacta a soporte.» |
Cuándo usar esta pantalla
- Verificar a un cliente nuevo antes de venderle: confirmas que su RUC está activo y habido antes de emitir la factura. Si está suspendido, el comprobante puede ser observado.
- Validar a un proveedor antes de pagarle: confirmas que su RUC es real y operativo antes de hacer la transferencia. Te protege contra estafas con RUCs fantasma.
- Buscar un dato sin guardar: si solo necesitas saber «¿este RUC qué razón social tiene?» sin guardarlo en tu directorio, esta pantalla es lo más rápido.
- Forzar refresh de cache: cuando ya tienes el contacto registrado pero SUNAT cambió algo y quieres ver los datos actualizados.
- Verificar identidad por DNI: confirmas que un DNI dado por un cliente corresponde al nombre que te dijo.
Casos comunes
«El RUC dice "ACTIVO HABIDO" pero igual mi factura fue rechazada por SUNAT» Migo cachea por 24h. Es posible que el cambio de estado en SUNAT haya ocurrido después del último refresh del cache. Usa el botón ↻ Refrescar para confirmar el estado en tiempo real. Si Migo confirma que sigue ACTIVO HABIDO pero el comprobante fue rechazado, el motivo puede ser otro — revisa el CDR de rechazo.
«El RUC dice "NO HABIDO" — ¿puedo igual venderle?» Técnicamente sí, pero ⚠ tu factura podría ser observada por SUNAT y el cliente perdería el derecho al crédito fiscal. Mejor pide al cliente que regularice su situación en SUNAT antes de emitirle factura. Para boleta no hay restricción (no aplica crédito fiscal).
«¿La consulta de DNI cuesta lo mismo que la de RUC?» Sí — Migo cobra por consulta, no por tipo. Por eso aprovecha el cache: una vez consultado un DNI, las siguientes 24h son gratis para ese mismo número.
«Hice una consulta hace una semana, ¿queda guardada en algún historial?» No hay historial visible — esta pantalla NO guarda el resultado en ninguna tabla de Gestión. Si quieres registrar la información como contacto, usa el link «Usar en nueva venta →» o créalo desde Clientes — Nuevo. El cache de 24h sí existe pero es invisible para el usuario.
«El RUC del proveedor empieza en 10 — ¿es persona o empresa?»
RUC 10xxxxxxxxx = persona natural con negocio (un emprendedor individual con RUC propio). Para ti es lo mismo que cualquier otro proveedor: le compras con factura y descuentas IGV.
«¿Por qué la consulta tarda?» La primera consulta a un RUC/DNI nuevo va a la API de Migo con timeout de 10 segundos. Si Migo está lento, puede tardar varios segundos. Las siguientes consultas al mismo documento (en 24h) son instantáneas porque vienen del cache local.
Cosas que NO puedes hacer
- Buscar por razón social o nombre: SUNAT no expone búsqueda inversa — solo entregas RUC/DNI y obtienes datos. Si no sabes el RUC, no hay forma de obtenerlo desde aquí.
- Consultar régimen tributario del contribuyente: Migo no lo devuelve. Tienes que preguntárselo al contribuyente.
- Validar si está habilitado como emisor electrónico: tampoco lo devuelve la API. Se asume «habilitado» por default — si no lo está, SUNAT rechaza la emisión al momento de mandar el comprobante.
- Consultar masivamente una lista de RUCs (bulk). Una consulta a la vez.
- Guardar el resultado automáticamente como cliente o proveedor — eso se hace explícitamente desde el form de cliente o proveedor.
- Ver historial de consultas pasadas — esta pantalla es stateless. Solo recuerda la consulta actual mientras navegas.
- Consultar otros tipos de documento (CE, Pasaporte, Otros) — la API solo soporta RUC y DNI.