Consulta RUC
Este endpoint le permite consultar RUC 20 y RUC 10 de personas jurídicas y personas naturales.
Consideraciones
- Los datos obtenidos se obtienen del padrón reducido de SUNAT.
- Los datos del padron reducido de SUNAT son actualizados diariamente a las 3:00 AM, el procesamiento de datos demora aproximadamente 15 minutos.
- Las peticiónes de RUC's se almacenan en cache durante 24 horas.
GET
https://api.perufacturacion.com/api
| Accept | application/json |
| Content-Type | application/json |
| api_token | API Token |
| json | Para consulta de RUC establecer este valor en "ruc" |
| id | Número de RUC
|
Ejemplos de uso
Asumimos que usted sabe cómo hacer solicitudes API en el lenguaje de programación elegido para su aplicativo. Hemos incluido algunos ejemplos simples en algunos lenguajes de programación.
Esta API funciona con distintos lenguajes de programación como C#, JavaScript, Python, PHP, Go, Java, Ruby, Visual Basic, también se puede integrar con Excel y Access.
Ejemplo de uso en PHP:
$curl = curl_init();
curl_setopt_array($curl, array(CURLOPT_URL => "https://api.perufacturacion.com/api?api_token={SU_API_TOKEN}&json=ruc&id={RUC}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_SSL_VERIFYPEER => false
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
Success Response:
{
"ruc": "20512862196",
"razon_social": "SINDICATO NACIONAL DE TRABAJADORES DE SUNAT/SUPERINTENDENCIA NACIONAL ADJUNTA DE ADUANAS-SINTRADUANA",
"estado": "ACTIVO",
"condicion": "HABIDO",
"direccion": "AV. ELMER FAUCETT URB. LA COLONIAL NRO. 230 INT. 203",
"ubigeo": "070101",
"departamento": "CALLAO",
"provincia": "CALLAO",
"distrito": "CALLAO",
"fecha_actualizacion": "2023-03-24 12:18:47",
"mensaje": "OK",
"code": "200"
}
Failed:
Si no se han encontrado resultados:
{
"mensaje": "No encontrado",
"code": "404"
}
Si ha excedido el limite de consultas diario /mensual:
{
"mensaje": "quota limit exceeded (daily/monthly) or token invalid",
"code": "503"
}
Si no ha enviado uno de los parametros a la endpoint:
{
"mensaje": "Empty parameters are not allowed ('json' or 'api_token' or 'id')",
"code": "503"
}