Cuánto vas a cobrar
Si tu cliente es agente y la operación supera S/ 700, te paga el 97 % y entrega el 3 % a SUNAT. Lo sabes antes de emitir la factura.
APIs Perú · RUC · Agentes de retención
Cualquier RUC del Perú.
Cualquier RUC del Perú.
En un milisegundo.
Sin captcha, sin colas y sin un scraper que se rompa el mes que viene.
Una petición GET con tu API key devuelve el RUC entero:
razón social, domicilio fiscal, actividad económica y los cinco
regímenes especiales. Otra te dice si es
agente de retención.
Sin tarjeta · 250 consultas al mes
$ curl https://apisperu.aetherumlabs.com/v1/ruc/20100030595 \ -H "Authorization: Bearer ael_live_••••••••" 200 OK 2.1 ms { "ruc": "20100030595", "razonSocial": "BANCO DE LA NACION", "estado": "ACTIVO", "condicion": "HABIDO", "direccion": { "tipoVia": "AV.", "nombreVia": "JAVIER PRADO ESTE", "numero": "2499" }, "ubicacion": { "ubigeo": "150130", "departamento": "LIMA", "provincia": "LIMA", "distrito": "SAN BORJA" }, "tipoContribuyente": "EMPRESA DE DERECHO PUBLICO", "actividadEconomica": { "principal": "OTROS TIPOS DE INTERMEDIACION MONETARIA" }, "nroTrabajadores": 4451, "regimenes": { "agenteDeRetencion": { "activo": true, "desde": "2002-06-01" } } } $
18 524 016
contribuyentes consultables
hace 3 h
última actualización de los datos
2.1 ms
tiempo de respuesta en servidor
Integración
Dos líneas. Cualquier lenguaje.
Una petición GET con tu key en la cabecera Authorization.
Sin SDK que instalar ni sesiones que mantener.
curl https://apisperu.aetherumlabs.com/v1/ruc/20100030595 \ -H "Authorization: Bearer ael_live_••••••••"
import requests
r = requests.get(
"https://apisperu.aetherumlabs.com/v1/ruc/20100030595",
headers={"Authorization": "Bearer ael_live_••••••••"},
)
print(r.json()["razonSocial"])
const r = await fetch( "https://apisperu.aetherumlabs.com/v1/ruc/20100030595", { headers: { Authorization: "Bearer ael_live_••••••••" } }, ); const { razonSocial, estado } = await r.json();
$ch = curl_init("https://apisperu.aetherumlabs.com/v1/ruc/20100030595"); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer ael_live_••••••••", ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $datos = json_decode(curl_exec($ch), true);
Agentes de retención
¿Tu cliente te retiene el IGV? Compruébalo antes de facturar.
Un endpoint propio te responde con un sí o un no, desde cuándo y por qué resolución. Con la misma API key y la misma cuota.
curl https://apisperu.aetherumlabs.com/v1/agente-retencion/20100030595 \ -H "Authorization: Bearer ael_live_••••••••"
{
"ruc": "20100030595",
"razonSocial": "BANCO DE LA NACION",
"estado": "ACTIVO",
"condicion": "HABIDO",
"esAgenteDeRetencion": true,
"desde": "2002-06-01",
"resolucion": "R.S. 037-2002"
}
Desde cuándo aplica
La fecha y la resolución dicen desde cuándo opera como agente. Si esa
fecha aún no llega, la respuesta es false y ya sabes
cuándo empezará.
Un no que puedes creer
Un false siempre sale de datos verificados. Si no podemos
confirmarlo, respondemos 503 para que reintentes, no un
no por defecto.
Precios
Precios visibles. Sin registrarte para verlos.
Aquí están, sin crear cuenta para verlos y sin pedir que nos escribas para que te pasemos una tarifa. Empieza gratis hoy, sin tarjeta y sin caducidad. Suscríbete a un plan de pago cuando lo necesites. Todos los precios incluyen IGV.
Free
Gratis
- 250 consultas al mes
- Todos los campos, sin recortes
- Sin tarjeta de crédito
Starter
S/19/ mes
- 50 000 consultas al mes
- Soporte por correo
Pro
S/39/ mes
- 100 000 consultas al mes
- Soporte prioritario
Empresa
S/69/ mes
- 200 000 consultas al mes
- Soporte prioritario
Medios de pago
Por qué Aetherum Labs
Completa, clara y rápida.
Los cinco regímenes
Los cinco regímenes especiales del IGV, cada uno con la fecha desde la que aplica: agente de retención, de percepción, de percepción de venta interna, buen contribuyente y renuncia a la exoneración del Apéndice I.
Frescos y disponibles 24/7
Datos actualizados todos los días y una API que responde las 24 horas. Cada consulta devuelve el dato vigente, no una copia del mes pasado.
Respuesta lista para facturar
Razón social, domicilio y regímenes ya vienen desglosados en campos, listos para volcar en el comprobante sin limpiar nada.
Preguntas
Lo que suelen preguntarnos.
¿De dónde salen los datos?
De fuentes oficiales de SUNAT, consolidadas y verificadas por nosotros. Devolvemos lo que SUNAT tiene registrado para cada RUC: razón social, estado, condición, domicilio fiscal, actividad económica, tipo de contribuyente, número de trabajadores y sus regímenes especiales —agente de retención o de percepción del IGV, buen contribuyente, renuncia a la exoneración del Apéndice I— con la fecha desde la que aplica cada uno.
¿Cómo sé si un RUC es agente de retención?
Llama a GET /v1/agente-retencion/{numero}. El campo esAgenteDeRetencion responde true o false, y desde y resolucion dicen desde cuándo opera y qué norma lo designó. Trae además su razón social, estado y condición. Si el RUC existe y no es agente, la respuesta es un 200 con false; si no existe, un 404. Cada llamada cuenta como una consulta de tu plan. GET /v1/ruc/{numero} también dice si es agente y desde cuándo, junto al resto de la ficha, pero sin la resolución.
¿Cuándo me retiene un agente de retención?
Al pagarte, si la operación supera S/ 700: retiene el 3 % del importe total con IGV y te entrega un comprobante de retención. No te retiene si eres buen contribuyente, agente de retención o agente de percepción, ni en operaciones sujetas a detracción. Esta es la regla general: para un caso concreto, consúltalo con tu contador.
¿Cada cuánto se actualizan?
Varias veces al día comprobamos si hay cambios y los incorporamos. En la parte de arriba de esta página ves hace cuántas horas fue la última actualización, calculado en el momento en que la abres.
¿Qué pasa cuando agoto las consultas del mes?
Las peticiones responden con un 429 y una cabecera Retry-After hasta que empiece el mes siguiente. Nunca cobramos de más ni cortamos sin avisar: el panel de tu cuenta muestra el consumo en todo momento.
¿Hay límite de ritmo?
Hay un límite de ritmo holgado para un uso normal. Sirve para proteger el servicio, no para molestarte; si tu integración necesita ráfagas mayores, escríbenos.
¿Puedo cambiar de plan o darme de baja?
El plan gratuito no se renueva solo: deja de usar la key cuando quieras. Si te suscribes a un plan de pago, el cobro es mensual por Mercado Pago y tienes que pagar con la cuenta de Mercado Pago del mismo correo con el que te registras aquí: con otra, Mercado Pago rechaza el pago. No hay cambio entre planes de pago: cancela y, al terminar el ciclo ya pagado, suscríbete a otro. Al cancelar, sigues con lo que pagaste hasta el final de ese mes; no hay reembolso. Si un cobro falla, bajas al plan Free al instante. El estado de los pagos lo ves en tu cuenta.
¿Emiten factura?
Sí. La factura llega al correo con el que te registraste. El precio ya incluye IGV, así que el importe que ves es el que pagas. El plan gratuito no genera comprobante porque no tiene costo.