API REST · OAuth 2.0
Conecta tu sistema a relBase
Productos, clientes, inventario, entregas y documentos tributarios, desde tu propia aplicación. Autenticación OAuth 2.0, respuestas con estructura uniforme y webhooks para no consultar en bucle.
- Autenticación
- OAuth 2.0 · PKCE
- Permisos
- 10 áreas
- Escrituras
- Idempotentes
# Listar productos · requiere el permiso products:read curl -X GET "https://api.relbase.cl/api/v2/productos?page=2" \ -H "Authorization: Bearer $ACCESS_TOKEN" # { # "data": [ … ], # "meta": { # "code": 200, # "message": "success", # "current_page": 2, # "next_page": 3, # "total_pages": 8, # "total_count": 94 # } # }
const res = await fetch( "https://api.relbase.cl/api/v2/productos?page=2", { headers: { Authorization: `Bearer ${accessToken}` } } ); const { data, meta } = await res.json(); console.log(meta.total_count); // 94 console.log(meta.next_page); // 3 (-1 si no hay siguiente) // Ajusta el ritmo antes de quedarte sin cupo diario console.log(res.headers.get("X-RateLimit-Daily-Remaining"));
$res = $client->get('https://api.relbase.cl/api/v2/productos', [ 'headers' => [ 'Authorization' => 'Bearer ' . $accessToken, ], 'query' => ['page' => 2], ]); $body = json_decode($res->getBody(), true); echo $body['meta']['total_count']; // 94 echo $body['meta']['next_page']; // 3
Primeros pasos
De cero a tu primera llamada
Cada integración registra su propia Aplicación OAuth dentro de la cuenta de la empresa. El detalle de cada paso está en la guía de primeros pasos.
- 1
Crea tu Aplicación OAuth
Desde la cuenta de la empresa en relBase. Obtienes client_id y client_secret.
- 2
Pide autorización
Rediriges al usuario con los permisos que necesitas. Recomendado con PKCE S256.
- 3
Canjea el código
Intercambias el código recibido por un access_token y un refresh_token.
- 4
Consume los endpoints
Envías el token en Authorization. El token ya queda asociado a la empresa.
Alcance
Qué puedes integrar
Solicita únicamente los permisos que tu integración necesita. Si a tu token le falta uno, la respuesta es 403.
- Productosreadwrite
- Clientesreadwrite
- Proveedoresreadwrite
- Documentosreadwrite
- Inventarioreadwrite
- Entregasreadwrite
- Usuariosreadwrite
- Webhooksreadwrite
- Bodegasread
- Administraciónread
Las escrituras aceptan Idempotency-Key: repetir una solicitud con la misma clave devuelve la respuesta original en vez de ejecutar la operación dos veces. En inventario es obligatoria.
Emitir un documento
Esto es todo lo que necesitas enviar
Una boleta necesita el tipo de documento, las fechas y el detalle: ni siquiera exige cliente. El resto —cliente, referencias, descuentos, datos de exportación o de guía de despacho— es opcional y está en la referencia de endpoints.
Solicitud
# Boleta electrónica (39) con un producto POST https://api.relbase.cl/api/v2/dtes { "type_document": 39, "start_date": "08-09-2026", "end_date": "08-09-2026", "products": [ { "product_id": 915, "price": 12990, "quantity": 2, "tax_affected": true, "unit_item": "UNID" } ] }
Respuesta · recortada
{
"data": {
"folio": 10428,
"sii_status": "sent_sii",
"sii_status_name": "Enviado",
"track_id": "3944821057",
"amount_neto": 25980,
"amount_iva": 4936,
"amount_total": 30916,
"pdf_file": "https://...",
"xml_inter_file": "https://..."
// ...
},
"meta": { "code": 200, "message": "success" }
}Límites de uso
Dos controles independientes
Ambos responden 429 Too Many Requests al excederse.
Control 1 · Velocidad
Ventana de 60 segundos
300
solicitudes por empresa
Con token OAuth, además de 5 por segundo. Sin token, el tope es de 60 por minuto y 3 por segundo por IP.
El límite por segundo es más estricto en ráfagas: enviar varias solicitudes en paralelo puede devolver un 429 bastante por debajo del tope por minuto. Reparte las llamadas en el tiempo.
Control 2 · Volumen
Cuota diaria según tu plan
00:00
UTC · reinicio del contador
Cada plan incluye una cantidad distinta de solicitudes diarias. Al alcanzar el tope recibes un aviso por correo.
Puedes seguir tu consumo del día desde relBase, en Mi Cuenta → Consumo de API.
| Plan | Solicitudes por día | DTE mensuales |
|---|---|---|
| Despegue | 25.000 | hasta 1.000 |
| Pyme | 50.000 | hasta 2.000 |
| Corporativo | 100.000 | hasta 4.000 |
Consulta tu cupo exacto y tu consumo del día en relBase, en Mi Cuenta → Consumo de API, o compara los planes.
Monitorea tu consumo sin esperar el error
Cada respuesta incluye encabezados con el estado de tu cuota. Léelos para ajustar el ritmo a tiempo.
| Encabezado | Contenido |
|---|---|
| X-RateLimit-Limit | Límite de la ventana vigente. Viene siempre. |
| X-RateLimit-Remaining | Solicitudes que te quedan en esa ventana. Viene siempre. |
| X-RateLimit-Daily-Limit | Cupo diario de tu plan. Solo si tu plan tiene cuota configurada. |
| X-RateLimit-Daily-Remaining | Solicitudes que te quedan hoy. Solo si tu plan tiene cuota configurada. |
| Retry-After | En un 429: segundos de espera, o hasta medianoche UTC si agotaste la cuota diaria. |
Preguntas frecuentes
Lo que más nos preguntan
Si tu duda no está acá, escríbenos a contacto@relbase.cl.
Empieza por la guía de primeros pasos
Crea tu Aplicación OAuth, genera tu token y haz tu primera llamada. Después, la referencia completa de cada endpoint está en apidocs.relbase.cl.