Saltar al contenido
Facturador

Consultar RUC (servicio anterior)

GET /api/services/ruc/{ruc_number}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Consulta un RUC directamente en la web de SUNAT. Puede fallar si SUNAT cambia su página: usa preferentemente Consultar RUC o DNI.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.

Errores (HTTP 200 con success: false): RUC inválido o no encontrado.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
ruc_number ruta sí 20501973522

Respuestas

200 — RUC

{
  "success": true,
  "data": {
    "name": "EMPRESA XYZ S.A.C.",
    "trade_name": "XYZ",
    "address": "AV. 2 DE MAYO NRO. 123",
    "phone": "014271148",
    "department": "LIMA",
    "department_id": "15",
    "province": "LIMA",
    "province_id": "1501",
    "district": "LIMA",
    "district_id": "150101"
  }
}

200 — Inválido

{
  "success": false,
  "message": "Ruc debe tener 11 dígitos"
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.