Basis-URL
https://freebillgen.com/api/v1Autentificering
Hver anmodning bruger et Bearer-token. Opret et under Indstillinger → API-nøgler, giv det de læse-/skrivetilladelser pr. ressource, det har brug for, angiv en valgfri udløbsdato, og send det med hver anmodning:
Authorization: Bearer <your-api-key>Anmodninger autentificeres mod den konto, der oprettede nøglen, og kontrolleres mod de tildelte tilladelser. Hold tokenet hemmeligt, og tilbagekald det, hvis det bliver eksponeret eller ikke længere er nødvendigt.
Hvad du kan gøre
- Læs fakturaer, kunder, virksomheder, betalinger og tilbagevendende planer
- Opret og opdater dem (skrive-API - Pro)
- Hent moms- og forfaldsrapporter som JSON
- Læs den samme begrænsede Næste handlinger-kø, der bruges af dashboardet
- Læs leverandørens e-fakturafiler, du manuelt har uploadet til Indbakken (ikke et Peppol-/e-mailmodtagelsespunkt)
- Download generiske OASIS UBL- og UN/CEFACT CII-kortlægninger til gennemgang (ikke profilvalideret)
- Registrer webhook-slutpunkter for faktura- og betalingshændelser (Pro)
- Idempotency-Key ved understøttede skriveoperationer - ændrede anmodningsdata under samme nøgle returnerer 409
- Markørpaginering via links.next, justerbar med per_page (maks. 100)
- Lad AI-agenter læse enhver delt faktura - schema.org/Invoice JSON-LD samt Accept: application/json eller text/markdown på hvert signeret delingslink
- Uden autentificering, skrivebeskyttet MCP-server på https://freebillgen.com/api/mcp (get_invoice, verify_invoice) til AI-agenter
Konventioner
- Idempotens
- Ved understøttede oprettelses- og handlingskald skal du sende en unik Idempotency-Key. Forsøg med identiske anmodningsdata afspiller den oprindelige succes; ændrede anmodningsdata returnerer 409.
- Paginering
- Gemte ressourcelister er markørpaginerede - følg links.next (eller angiv ?cursor=...), og juster ?per_page= (maks. 100). Det begrænsede handlingsfeed rapporterer sin begrænsning og sin afkortede tilstand.
- Beløb
- Valutabeløb er præcise JSON-strenge formateret til valutaens ISO 4217-skala, fx "121.00" for EUR eller "500" for JPY. Enhedspriser kan bevare yderligere indtastningspræcision.
- ID'er
- Hver ressource adresseres med et uigennemsigtigt id, aldrig et sekventielt nummer.
Eksempel: Vis dine fakturaer
curl https://freebillgen.com/api/v1/invoices \
-H "Authorization: Bearer $FREEBILLGEN_API_KEY"Åbn den fulde interaktive API-reference →
Spørgsmål om faktura-API'en
Er faktura-API'en gratis?
Ja - læse-API'en er inkluderet i det gratis niveau uden beregning. Skrive-API'en og udgående webhooks er inkluderet i Lifetime Pro til 49 € inkl. skatter og afgifter: én betaling uden månedligt gebyr eller årlig fornyelse.
Hvordan autentificerer jeg mig?
Opret et Bearer-token under Indstillinger -> API-nøgler, tildel det læse-/skriverettigheder pr. ressource, og send det som en Authorization: Bearer-header i hver anmodning. Nøgler er begrænset til din egen konto og kan tilbagekaldes eller udløbe.
Kan jeg oprette fakturaer programmatisk?
Ja, via skrive-API'en, som er en del af Pro-tilføjelsen. Den genererer de samme professionelle fakturaer som webappen, med sekventiel nummerering og konfigurerbar momsbehandling, som anvendes serverside. API'en certificerer ikke overensstemmelse med lokal lovgivning.
Hvordan undgår jeg at oprette dubletfakturaer ved genforsøg?
Send en unik Idempotency-Key ved oprettelseskaldet. Genforsøg med identiske anmodningsdata og samme nøgle returnerer det oprindelige resultat. Genbruges nøglen med ændrede anmodningsdata, returneres 409 i stedet for at returnere en anden faktura uden at gøre opmærksom på det.
Kan jeg læse de fakturaer, jeg har modtaget?
Ja, gratis. GET /api/v1/inbox viser understøttede UBL/CII-leverandørfiler, som du manuelt har uploadet, og som FreeBillGen har analyseret, med originalen bevaret til revision; GET /api/v1/inbox/{id} returnerer én. Syntaksgenkendelse er ikke profilvalidering, og disse endpoints gør ikke FreeBillGen til et Peppol-, offentligt-netværks- eller e-mailmodtagelsesendpoint.
Kan en AI-agent læse en faktura uden en konto?
Ja. Hver faktura, du deler via det signerede offentlige link, kan læses af en agent på samme URL: siden indlejrer schema.org/Invoice JSON-LD, og hvis Accept: application/json sendes, returneres en struktureret faktura (parter, linjeposter, totaler, forfaldent beløb, betalingsmuligheder), mens Accept: text/markdown returnerer en ren, tokenbesparende gengivelse. Der findes også en godkendelsesfri, skrivebeskyttet Model Context Protocol (MCP)-server på https://freebillgen.com/api/mcp med værktøjerne get_invoice og verify_invoice. Linksignaturen er adgangstokenet. Behandl hele URL'en som en hemmelighed, da alle, der modtager den, kan åbne fakturaen.