Primeros pasos

En 3 pasos: obtén una API key, autentícate y emite una factura. Esta guía usa una API key; para conectar aplicaciones de terceros, consulta OAuth2 con PKCE.

1. Crea una API key

Desde el panel de Bilteo, genera una API key para tu tenant y asígnale los scopes que necesites (ver Autenticación y scopes). La clave tiene el prefijo bk_live_ (producción) o bk_test_ (pruebas).

Guárdala bien

La clave se muestra una sola vez. Trátala como un secreto: no la incrustes en clientes públicos (navegador, app móvil) ni la subas al control de versiones.

Si pierdes la clave siempre la puedes revocar desde el panel de Bilteo y generar una nueva.

2. Autentícate

En este ejemplo, cada petición lleva la clave en la cabecera Authorization:

curl https://api.test.bilteo.com/api/v1/invoices \
  -H "Authorization: Bearer bk_live_xxxxxxxxxxxxxxxx"

3. Crea y emite una factura

Crear una factura (queda en borrador):

curl -X POST https://api.test.bilteo.com/api/v1/invoices \
  -H "Authorization: Bearer bk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "…",
    "lines": [
      { "description": "Servicio de consultoría", "quantity": 1, "unit_price": "100.00" }
    ]
  }'

Emitirla (la numera y dispara la remisión a la AEAT vía Veri*Factu):

curl -X POST https://api.test.bilteo.com/api/v1/invoices/{id}/actions/issue \
  -H "Authorization: Bearer bk_live_xxxxxxxxxxxxxxxx"

TIP

El cuerpo exacto de cada endpoint y todos los campos están en la Referencia de la API, generada desde el OpenAPI del servicio.

Qué sigue

• Autenticación y scopes
• Webhooks — recibe avisos de la AEAT sin hacer polling
• Convenciones de la API — paginación, formatos, idempotencia
• Ciclo de vida de una factura
• Recetario — ejemplos completos copia-y-pega