Consulta RUC
Devuelve la ficha SUNAT de un RUC: razón social, estado, condición, domicilio fiscal, actividades y regímenes. Primero busca en el padrón reducido y, si no está, en SUNAT en línea.
POST https://api.factosperu.com/api/v1/ruc
Solicitud
Encabezados: Authorization: Bearer TU_TOKEN y Content-Type: application/json.
{ "ruc": "20123456789" }
El campo ruc es obligatorio, debe tener 11 caracteres y pasar una validación de dígitos.
Respuesta
Toda respuesta trae success, code, retryable y time, más data si hubo éxito o message si hubo error.
{
"success": true,
"code": "found",
"retryable": false,
"data": {
"ruc": "…",
"nombre_o_razon_social": "…",
"estado": "…",
"condicion": "…",
"direccion": "…",
"departamento": "…",
"tipo_contribuyente": "…",
"fecha_inscripcion": "…",
"fecha_inicio_actividades": "…",
"actividades_economicas": [],
"sistema_emision": "…",
"sistema_contabilidad": "…",
"es_agente_de_retencion": "NO",
"es_buen_contribuyente": "NO"
},
"time": 0.12
}
nombre_o_razon_social trae el nombre comercial y, si no tiene, la razón social. Si SUNAT no registra un dato, el campo llega vacío.
Códigos: 200 encontrado; 404 no existe (not_found, retryable: false) o SUNAT no respondió (retryable: true); 422 si no son 11 dígitos (code: invalid_ruc).