Vigilancia de RUC
Entérate cuando un proveedor pasa a NO HABIDO, sin preguntar cada día
Pon tus clientes o proveedores en una lista. Cada vez que SUNAT publica su padrón, comparamos y, si algo cambió, te lo enviamos a tu sistema con un webhook firmado.
POST https://tu-sistema.pe/webhooks/nexoid
X-NexoID-Event: ruc.condicion_cambiada
X-NexoID-Delivery: <id de la entrega>
X-NexoID-Timestamp: <segundos>
X-NexoID-Signature: <firma HMAC-SHA256>{
"evento": "ruc.condicion_cambiada",
"ocurrido_en": "2026-09-27T04:12:30-05:00",
"datos": {
"ruc": "20XXXXXXXXX",
"campo": "condicion",
"antes": "HABIDO",
"despues": "NO HABIDO",
"fecha_dato": "2026-09-27"
},
"watchlist": { "id": 1, "nombre": "Proveedores", "referencia": null }
}Endpoints
POST /id/v1/watch/listas
Crear una lista · desde Crecimiento
POST /id/v1/watch/listas/{lista}/rucs
Agregar RUC a la lista · desde Crecimiento
POST /id/v1/watch/webhooks
Registrar la URL https que recibe los avisos · desde Crecimiento
GET /id/v1/watch/eventos
El historial de cambios detectados · desde Crecimiento
Solo se vigilan RUC de empresas (tipo 20). Cuando cambia el nombre, el aviso lleva el antiguo y el nuevo, y para una persona natural eso sería un dato de identidad saliendo a una URL ajena.
Qué devuelve
| Campo | Qué es | Presente en |
|---|---|---|
| evento | ruc.estado_cambiado, ruc.condicion_cambiada, ruc.agente_retencion_cambiado, ruc.buen_contribuyente_cambiado, ruc.nombre_cambiado, ruc.alta o ruc.baja | siempre |
| ocurrido_en | Cuándo lo detectamos | siempre |
| datos.ruc | El RUC que cambió | siempre |
| datos.campo | La columna del padrón que cambió | siempre |
| datos.antes · datos.despues | El valor anterior y el nuevo | siempre |
| datos.fecha_dato | La fecha del padrón en el que se vio el cambio | siempre |
| watchlist | La lista en la que está, con tu referencia | siempre |
Preguntas frecuentes
¿Cómo sé que el aviso viene de NexoID?
Cada entrega lleva una firma en la cabecera X-NexoID-Signature, calculada con un secreto que solo tú y nosotros conocemos. La guía de /docs trae cómo verificarla.
¿Qué pasa si mi sistema está caído?
Reintentamos la entrega. Si tu endpoint falla muchas veces seguidas, lo pausamos para no insistir, y lo reactivamos cuando nos avises de que ya está bien.
¿Cada cuánto revisan?
Cada vez que SUNAT publica su padrón, que es a diario. El aviso sale en cuanto terminamos de compararlo.