Primers passos

En tres passos: obtén una API key, autentica't i emet una factura. Aquesta guia fa servir una clau API; per connectar aplicacions externes, consulta OAuth2 amb PKCE.

1. Crea una API key

Des del tauler de Bilteo, genera una API key per al teu tenant i assigna-li els scopes que necessitis. La clau té el prefix bk_live_ (producció) o bk_test_ (proves).

Desa-la bé

La clau només es mostra una vegada. Tracta-la com un secret: no la incrustis en clients públics (navegador o app mòbil) ni la pugis al control de versions.

Si perds la clau, sempre la pots revocar des del tauler de Bilteo i generar-ne una de nova.

2. Autentica't

En aquest exemple, cada petició porta la clau a la capçalera Authorization:

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

3. Crea i emet una factura

Crea una factura, que queda en esborrany:

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": "Servei de consultoria", "quantity": 1, "unit_price": "100.00" }
    ]
  }'

Emet-la; Bilteo la numera i inicia la remissió a l'AEAT mitjançant Veri*Factu:

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

TIP

El cos exacte de cada endpoint i tots els camps són a la Referència de l'API, generada des de l'OpenAPI del servei.

I ara què?

• Verifactu Direct API — registra factures que ja emet el teu programari
• Referència de l'API — endpoints, paràmetres, esquemes i exemples