Documentación del API
Web service de consulta de RUC. Una sola llamada HTTP, respuesta en JSON.
Para conectarse con nuestro web service y consultar información de RUCs, deberá primero obtener su token de cliente.
La petición para obtener los datos de un número RUC es muy sencilla. Sólo debe enviar la siguiente petición vía HTTP utilizando Curl o cualquier lenguaje de programación:
GET https://www.devtechperu.com/api/ruc?ruc={ruc_a_consultar}&token={token_de_cliente}
donde:
- ruc_a_consultar: es el número de RUC de 11 dígitos sobre el cual desea conocer los datos completos en SUNAT.
- token: es el código que le proporcionamos como cliente para que podamos identificar sus peticiones.
Ejemplo
GET https://www.devtechperu.com/api/ruc?ruc=10086043306&token=e81e3392-5feb-4ecd-a5fe-8642c6ad9c18
Estructura de la respuesta
La respuesta será una cadena JSON con la siguiente información:
{
"ruc": "10086043306",
"nombre": "ALVARADO SARCO SERGIO AUGUSTO",
"estado": "BAJA DE OFICIO",
"ubigeo": "150112",
"condicion_de_domicilio": "HABIDO",
"tipo_de_via": "CAL.",
"nombre_de_via": "LAS FRAGUAS",
"codigo_de_zona": "-",
"tipo_de_zona": "-",
"numero": "191",
"interior": "-",
"lote": "-",
"departamento": "-",
"manzana": "-",
"kilometro": "-",
"success": "true",
"direccion": "CAL. LAS FRAGUAS NRO. 191 INT. - - -",
"direccion_completa": "CAL. LAS FRAGUAS NRO. 191 INT. - - - - LIMA LIMA INDEPENDENCIA ",
"distrito": "INDEPENDENCIA",
"provincia": "LIMA",
"departamento_ubigeo": "LIMA"
}Respuesta en caso de error
En caso de error, obtendrá una cadena JSON con el mensaje de error. Por ejemplo:
{"error":"Número de RUC inválido o no encontrado"}