Documentación Web Service Consulta RUC
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 via 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 puede 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"}