Consultar RUC

Obtén razón social, estado, condición y dirección de un RUC.

Qué enviar


Método	`GET`
URL	`https://apis.facturalibre.org/api/ruc/{ruc}`
`{ruc}`	Número de 11 dígitos
Cabeceras	`Authorization: Bearer {tu_token}` y `Accept: application/json`

Ejemplo:

curl -sS -H "Authorization: Bearer TOKEN" -H "Accept: application/json" \
  "https://apis.facturalibre.org/api/ruc/20100070970"

Si todo salió bien

Respuesta HTTP 200:

{
  "success": true,
  "data": {
    "direccion": "CAL. MORELLI NRO. 181 INT. P-2",
    "direccion_completa": "CAL. MORELLI NRO. 181 INT. P-2, LIMA - LIMA - SAN BORJA",
    "ruc": "20100070970",
    "nombre_o_razon_social": "SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA 'O ' S.P.S.A.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "departamento": "LIMA",
    "provincia": "LIMA",
    "distrito": "SAN BORJA",
    "ubigeo_sunat": "150130",
    "ubigeo": ["15", "1501", "150130"],
    "tipo_via": "CAL.",
    "nombre_via": "MORELLI",
    "codigo_zona": "-",
    "tipo_zona": "-",
    "numero": "181",
    "interior": "P-2",
    "lote": "-",
    "manzana": "-",
    "kilometro": "-"
  },
  "source": "facturalibre.org"
}

Los campos que más se usan al integrar: nombre_o_razon_social, estado, condicion, direccion y ubigeo.

Si no se encuentra o el RUC no es válido

HTTP 200 con success: false.

El número no tiene 11 dígitos:

{
  "success": false,
  "message": "El número de RUC ingresado es inválido."
}

No se encuentra en SUNAT:

{
  "success": false,
  "message": "El número de RUC no fué encontrado."
}

Los errores de cupo, plan o cuenta suspendida están en el documento padre API Consulta RUC.

Si no hay respuesta

Si la petición no obtiene respuesta (timeout, red, etc.), tu cliente verá un error de conexión y no el JSON habitual con success. Reintenta más tarde.