Basis-URL
https://freebillgen.com/api/v1Godkendelse
Hver anmodning bruger et Bearer-token. Opret et under Indstillinger → API-nøgler, giv det de læse- og skriveadgange pr. ressource, som det har brug for, angiv eventuelt en udløbsdato, og send det med hver anmodning:
Authorization: Bearer <din-api-nøgle>Anmodninger knyttes til den konto, der oprettede nøglen, og kontrolleres mod nøglens tildelte adgange. Hold tokenet hemmeligt, og tilbagekald det, hvis det bliver afsløret eller ikke længere bruges.
Dette kan du gøre
- Læs fakturaer, kunder, virksomheder, betalinger og tilbagevendende planer
- Opret og opdatér dem (skrive-API - Pro)
- Hent momsrapporter og aldersfordelte saldorapporter som JSON
- Læs den samme afgrænsede kø med Næste handlinger, som dashboardet bruger
- Læs leverandørers e-fakturafiler, som du manuelt har uploadet til indbakken (ikke et slutpunkt til modtagelse gennem Peppol eller e-mail)
- Hent generiske OASIS UBL- og UN/CEFACT CII-kortlægninger til gennemgang (ikke profilvalideret)
- Registrér webhook-endpoints til faktura- og betalingshændelser (Pro)
- Idempotency-Key på understøttede skrivehandlinger. Ændrede anmodningsdata med samme nøgle giver 409
- Cursor-paginering gennem links.next, som kan tilpasses med per_page (højst 100)
- Lad AI-agenter læse enhver delt faktura gennem schema.org/Invoice JSON-LD samt Accept: application/json eller text/markdown på alle signerede delingslinks
- Skrivebeskyttet MCP-server uden godkendelse på https://freebillgen.com/api/mcp (get_invoice, verify_invoice) til AI-agenter
Konventioner
- Idempotens
- Send en unik Idempotency-Key ved understøttede oprettelses- og handlingskald. Et nyt forsøg med de samme anmodningsdata afspiller det oprindelige resultat. Ændrede anmodningsdata giver 409.
- Paginering
- Lister over gemte ressourcer bruger cursor-paginering. Følg links.next, eller send ?cursor=..., og tilpas ?per_page= op til 100. Det afgrænsede handlingsfeed oplyser sin grænse og om resultatet er forkortet.
- Beløb
- Pengebeløb er præcise JSON-strenge formateret med valutaens ISO 4217-antal decimaler, for eksempel "121.00" for EUR eller "500" for JPY. Enhedspriser kan bevare ekstra præcision fra indtastningen.
- ID'er
- Hver ressource adresseres med et uigennemsigtigt id, aldrig et fortløbende nummer.
Eksempel: vis dine fakturaer
curl https://freebillgen.com/api/v1/invoices \
-H "Authorization: Bearer $FREEBILLGEN_API_KEY"Åbn den komplette interaktive API-reference →
Spørgsmål om faktura-API'et
Er faktura-API'et gratis?
Ja. Læse-API'et er med i den gratis plan uden omkostninger. Skrive-API'et og udgående webhooks er med i Lifetime Pro til 49 € inklusive skat: én betaling uden månedligt gebyr eller årlig fornyelse.
Hvordan godkender jeg en anmodning?
Opret et Bearer-token under Indstillinger -> API-nøgler, tildel læse- og skriveadgange pr. ressource, og send det som Authorization: Bearer-header ved hver anmodning. Nøgler er afgrænset til din egen konto og kan tilbagekaldes eller udløbe.
Kan jeg oprette fakturaer gennem kode?
Ja, gennem skrive-API'et, som er en del af Pro-tilkøbet. Det opretter de samme professionelle fakturaer som webappen med fortløbende nummerering og momsbehandling, som kan tilpasses, på serveren. API'et certificerer ikke overholdelse af lokal lovgivning.
Hvordan undgår jeg dublerede fakturaer ved et nyt forsøg?
Send en unik Idempotency-Key ved oprettelseskaldet. Et nyt forsøg med de samme anmodningsdata og samme nøgle returnerer det oprindelige resultat. Hvis dataene ændres, returneres 409 i stedet for at afspille en anden faktura.
Kan jeg læse de fakturaer, jeg har modtaget?
Ja, gratis. GET /api/v1/inbox viser understøttede UBL/CII-filer fra leverandører, som du manuelt har uploadet, og som FreeBillGen har analyseret. Originalen gemmes som dokumentation. GET /api/v1/inbox/{id} returnerer én fil. Syntaksgenkendelse er ikke profilvalidering, og disse slutpunkter gør ikke FreeBillGen til et slutpunkt for modtagelse gennem Peppol, et offentligt netværk eller e-mail.
Kan en AI-agent læse en faktura uden en konto?
Ja. Alle fakturaer, som du deler med et signeret offentligt link, kan læses af agenter på samme URL. Siden indeholder schema.org/Invoice JSON-LD. Accept: application/json returnerer en struktureret faktura med parter, linjer, totaler, udestående saldo og betalingsmuligheder, mens Accept: text/markdown returnerer en kort og ren gengivelse. Der findes også en skrivebeskyttet Model Context Protocol-server (MCP) uden godkendelse på https://freebillgen.com/api/mcp med værktøjerne get_invoice og verify_invoice. Linkets signatur er adgangstokenet. Behandl hele URL'en som en hemmelighed, fordi alle, der modtager den, kan åbne fakturaen.