Api sunat consulta RUC y DNI
Api rest con alta disponibilidad para consulta de ruc y dni.
Api Consulta dni
El origen de datos para la consulta de DNI es el padron reducido sunat y scraping de datos publicos
Respuesta de la API cuando HTTP_CODE 200, consulta exitosa el número de DNI que busca si existe, retorna los siguientes datos.
{
"nombre":"HUAMANI MENDOZA ERACLEO JUAN",
"tipoDocumento":"1",
"numeroDocumento":"46027897",
"estado":"",
"condicion":"",
"direccion":"",
"ubigeo":"",
"viaTipo":"",
"viaNombre":"",
"zonaCodigo":"",
"zonaTipo":"",
"numero":"",
"interior":"",
"lote":"",
"dpto":"",
"manzana":"",
"kilometro":"",
"distrito":"",
"provincia":"",
"departamento":"",
"nombres": "ERACLE JUAN",
"apellidoPaterno": "HUAMANI",
"apellidoMaterno": "MENDOZA"
}
Respuesta de la API cuando HTTP_CODE 422, no cumple las reglas de validación de dni.
- La longitud debe ser igual a 8
- El DNI debe estar por Números [0-9]{8}
{
"error":"Descripción del error en el formato de ruc"
}
Respuesta de la API cuando HTTP_CODE 404, número de DNI que buscas no existe.
Api Consulta ruc
El origen de los datos para con la consulta de RUC es el padrón reducido sunat.
Los datos se actualizan a diario a las 23:00, los datos se cargan durante 15min.
Respuesta de la API cuando HTTP_CODE 200, consulta exitosa.
{
"nombre":"PROGRAMA NACIONAL DE ALIMENTACIÓN ESCOLAR QALI WARMA",
"tipoDocumento":"6",
"numeroDocumento":"20550154065",
"estado":"ACTIVO",
"condicion":"HABIDO",
"direccion":"AV. CIRCUNVALACION CLUB EL GO NRO 208 ",
"ubigeo":"150140",
"viaTipo":"AV.",
"viaNombre":"CIRCUNVALACION CLUB EL GO",
"zonaCodigo":"-",
"zonaTipo":"-",
"numero":"208",
"interior":"-",
"lote":"-",
"dpto":"-",
"manzana":"-",
"kilometro":"-",
"distrito":"SANTIAGO DE SURCO",
"provincia":"LIMA",
"departamento":"LIMA"
}
Respuesta de la API Con Información extendida
{
"razonSocial": "REXTIE S.A.C.",
"tipoDocumento": "6",
"numeroDocumento": "20601030013",
"estado": "ACTIVO",
"condicion": "HABIDO",
"direccion": "AV. JOSE GALVEZ BARRENECHEA NRO 566 INT. 101 URB. CORPAC ",
"ubigeo": "150131",
"viaTipo": "AV.",
"viaNombre": "JOSE GALVEZ BARRENECHEA",
"zonaCodigo": "URB.",
"zonaTipo": "CORPAC",
"numero": "566",
"interior": "101",
"lote": "-",
"dpto": "-",
"manzana": "-",
"kilometro": "-",
"distrito": "SAN ISIDRO",
"provincia": "LIMA",
"departamento": "LIMA",
"EsAgenteRetencion": false,
"tipo": "SOCIEDAD ANONIMA CERRADA",
"actividadEconomica": "OTROS TIPOS DE INTERMEDIACION MONETARIA",
"numeroTrabajadores": "60",
"tipoFacturacion": "MANUAL/COMPUTARIZADO",
"tipoContabilidad": "MANUAL/COMPUTARIZADO",
"comercioExterior": "SIN ACTIVIDAD"
}
Respuesta de la API cuando HTTP_CODE 422, no cumple la validación de ruc.
- Longitud del número ruc debe ser igual a 11
- Debe estar formado por número de [0-9]{11}
- Código de verificación(algoritmo de sunat para verificar RUC)
{
"error":"Descripción del error en el formato de ruc"
}
Respuesta de la API cuando HTTP_CODE 404, número de ruc que buscas no existe.
Las peticiónes de RUCs y DNIs se almacenan en cache durante 24 horas