API Consulta RUC/DNI

  • Da de alta tu empresa para usar la api desde aquí. (Si ya lo hiciste perfecto)

  • Inicia sesión en tu panel de facturalibre, te llegará los datos de acceso al correo electrónico.

  • Tu panel lucirá de la siguiente forma:


Genera el token la primera vez para que puedas autenticarte.

Cómo autenticarte

Servicio para consultar DNI, RUC y tipo de cambio.

URL base: https://apis.facturalibre.org/api

En cada pedido incluye tu token:

Authorization: Bearer {tu_token}
Accept: application/json

Tu cuenta debe estar activa y con un plan vigente. Si algo falla en la cuenta, verás algo así:

Situación

Qué recibes

Token incorrecto o ausente

HTTP 401 — {"message":"Unauthenticated."}

Plan vencido

HTTP 200 — {"success":false,"message":"Tu plan ha vencido"}

Sin plan

HTTP 200 — {"success":false,"message":"No tienes un plan asignado"}

Se acabó el cupo de consultas

HTTP 200 — ver JSON abajo

Cuenta suspendida

HTTP 403 — {"success":false,"message":"Cuenta suspendida"}

Se acabó el cupo de consultas (respuesta exacta de la API):

{
  "success": false,
  "message": "Ha superado el límite de consultas",
  "quantity": 5000
}

quantity es la cantidad de consultas ya usadas en el período de tu plan (el número varía según tu uso). En este caso no se descuenta una consulta adicional.

Si no hay respuesta (por ejemplo timeout o fallo de red), tu cliente no recibe ese JSON: es un error de conexión en tu lado. Conviene reintentar.

Guías por ruta

  1. Consultar DNI

  2. Consultar RUC

  3. Consultar tipo de cambio

Cada consulta válida consume una unidad de tu plan.