API og webhooks

Balancios API giver adgang til dine egne regnskabsdata. Opret en API-nøgle under Integrationer, når du er logget ind.

Senest opdateret 2. oktober 2026.

1. Godkendelse

Send nøglen i headeren på hver forespørgsel. Nøgler kan være “kun læs” eller “læs og skriv”.

Authorization: Bearer blc_xxxxxxxxxxxxxxxx

Grund-adresse: https://balancio.dk/api/public/v1

2. Læs data

GET /customers — kunder
GET /invoices — fakturaer
GET /expenses — udgifter
GET /journal — posteringer i kassekladden

Brug ?limit=100&offset=0 til at bladre (maks. 500 pr. kald).

curl https://balancio.dk/api/public/v1/invoices \
  -H "Authorization: Bearer blc_..."

3. Opret data (kræver skriveadgang)

POST /customers
{ "name": "Firma ApS", "email": "faktura@firma.dk", "cvr": "12345678" }

POST /expenses
{ "expense_date": "2026-10-01", "supplier": "Telia", "amount_incl_vat": 250, "vat_rate": 25, "account": "3600" }

POST /journal   (et salg bogføres som kladde: bank / salg / moms / gebyr)
{ "id": "ordre-1001", "date": "2026-10-01", "description": "Webshop-ordre 1001", "total": 1250, "vat": 250, "fee": 3.5 }

Samme id bogføres kun én gang, så det er sikkert at sende igen.

4. Webhooks (Balancio-standardformat)

Opret “Egen webhook” under Integrationer for at få en personlig adresse. Signér brødteksten med HMAC-SHA256 og den hemmelige nøgle, og send resultatet som hex i headeren X-Balancio-Signature.

POST https://balancio.dk/api/public/integrations/generic/<din-token>
X-Balancio-Signature: <hmac_sha256_hex(body, secret)>

{ "id": "1001", "date": "2026-10-01", "description": "Ordre 1001", "total": 1250, "vat": 250, "fee": 0 }

Shopify, WooCommerce og Stripe bruger deres egne formater og signaturer — dem håndterer Balancio automatisk.

5. Sikkerhed

Nøgler gemmes kun som en hash — vis og gem nøglen, når den oprettes.
Træk en nøgle tilbage med det samme, hvis den er kommet ud.
Alle posteringer fra integrationer oprettes som kladder, som du selv godkender i kassekladden.