Faktura-API til dit eget system
Bygger du en bookingside, en webshop eller et internt system, der skal sende danske fakturaer? Med Tallyx' API opretter du kunden, udsteder fakturaen med fortløbende nummer og korrekt moms, sender den pr. e-mail og henter den som PDF — uden selv at bygge fakturamotoren.
API'et er det samme, som Tallyx' egen brugerflade bruger, og det bruges i dag af vores egen bookingside, som udsteder en faktura, hver gang en kunde bestiller.
Hvad API'et kan
- Kunder: oprette, hente og rette kunder.
- Fakturaer: oprette en kladde, rette og slette kladden, udstede fakturaen, sende den pr. e-mail, hente den som PDF, se indbetalinger og nøgletal.
- Varer: oprette, hente og rette varer og ydelser.
- Afsenderprofiler: hente og oprette profiler, hvis du fakturerer under flere navne.
En API-nøgle kan ikke bruges til bogføring, bank, løn, brugere, abonnement eller dataeksport. De dele er lukket for API-nøgler, uanset hvilke rettigheder nøglen har.
Godkendelse med API-nøgler
- Ejer eller administrator opretter en nøgle under Indstillinger → API-nøgler. Nøglen begynder med
txk_live_og vises kun én gang. - Send den i hvert kald:
Authorization: Bearer txk_live_… - Hver nøgle får kun de rettigheder, du vælger:
customers:read,customers:write,invoices:read,invoices:write,invoices:issue,invoices:send,products:read,products:write,brand_profiles:read,brand_profiles:write. - Gem nøglen som en hemmelighed på din server. Læg den aldrig i en browser eller en app.
API-nøgler er med fra og med Pro-planen (199 kr. pr. måned inkl. moms, 159,20 kr. ekskl. moms). Se priser.
Eksempel: fra bestilling til sendt faktura
Fem kald. Beløb er altid heltal i øre, så der ikke opstår afrundingsfejl.
1. Opret kunden
curl -X POST https://tallyx.dk/api/v1/customers \
-H "Authorization: Bearer $TALLYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Eksempel Kunde",
"customer_type": "private",
"email": "[email protected]",
"address_line1": "Eksempelvej 1",
"postal_code": "5000",
"city": "Odense C",
"default_payment_terms_days": 14
}'
# Svar: 201 med kunden — gem "id".customer_type er private, dk_company, eu_company eller non_eu_company. For en dansk virksomhed sender du cvr (8 cifre) med.
2. Opret fakturakladden
curl -X POST https://tallyx.dk/api/v1/invoices \
-H "Authorization: Bearer $TALLYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "<kundens id>",
"payment_terms_days": 14,
"lines": [
{
"description": "Booking 12. december",
"quantity_milli": 1000,
"unit": "stk",
"unit_price_minor": 80000,
"vat_rate_bp": 2500
}
]
}'
# Svar: 201 med en fakturaKLADDE — gem "id".
# quantity_milli: antal × 1000 (1000 = 1 stk).
# unit_price_minor: stykpris i øre ekskl. moms (80000 = 800,00 kr.).
# vat_rate_bp: momssats i basispoint (2500 = 25 %).3. Udsted fakturaen
curl -X POST https://tallyx.dk/api/v1/invoices/<fakturaens id>/issue \
-H "Authorization: Bearer $TALLYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
# Fakturaen får sit fortløbende nummer og bogføres. Det kan ikke fortrydes —
# en fejl rettes med en kreditnota.4. Send den til kunden
curl -X POST https://tallyx.dk/api/v1/invoices/<fakturaens id>/send-email \
-H "Authorization: Bearer $TALLYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "to_email": "[email protected]" }'5. Hent PDF'en
curl https://tallyx.dk/api/v1/invoices/<fakturaens id>/pdf \
-H "Authorization: Bearer $TALLYX_API_KEY" \
-o faktura.pdfDokumentation
Alle ruter, felter og svar står i den automatisk dannede dokumentation: tallyx.dk/api/docs (Swagger) og tallyx.dk/api/redoc. OpenAPI-beskrivelsen kan hentes på /api/openapi.json. Dokumentationen viser hele systemets API; en API-nøgle giver kun adgang til ruterne nævnt ovenfor.
Grænser og drift — det skal du vide
- Antal kald: der er i dag ingen fast grænse for antal kald pr. minut på kunde- og fakturaruterne. Brug API'et med omtanke; vi kan indføre en rimelig grænse og varsler den i så fald.
- Antal fakturaer: planens månedlige fakturagrænse gælder også for API'et. Er grænsen nået, svarer udstedelsen med HTTP 402.
- Fejl: svar med status 4xx har et
detail-felt med en forklaring på dansk. - Drift: Tallyx kører på én server i Danmark. Der er ingen oppetidsgaranti (SLA), så dit system bør kunne tåle, at et kald fejler, og prøve igen senere.
- E-faktura: API'et sender ikke e-fakturaer via Nemhandel/Peppol. Ruten
/oioublgiver en XML-eksport, som ikke er valideret mod Nemhandel. - Rykkere: automatiske rykkere er et tilvalg, som er slået fra, indtil du selv slår det til. De sendes kun for fakturaer, der er sendt til kunden fra Tallyx (
/send-email). En faktura, du kun udsteder via API'et og selv leverer til kunden, får aldrig en automatisk rykker.
Hvem er API'et til?
Udviklere og små bureauer, der selv bygger en løsning og har brug for en dansk faktura med fortløbende nummer, momsberegning, kreditnota og PDF. Du taler direkte med den, der har skrevet API'et: [email protected].
Bruger du allerede Stripe, Shopify eller WooCommerce, laver de selv kvitteringer og fakturaer — så har du næppe brug for Tallyx.
For dig som udvikler betyder det: Har den virksomhed, du bygger til, pligt til digital bogføring, skal dens bogføring og regnskabsmateriale ligge i et registreret bogføringssystem. Fakturaer udstedt gennem Tallyx' API skal i så fald også registreres dér.
Opret konto →Åbn API-dokumentationen
Ofte stillede spørgsmål
Hvad koster det at bruge API'et?+
API-nøgler er med fra og med Pro-planen til 199 kr. pr. måned inkl. moms. Der er ingen pris pr. kald eller pr. faktura, men planens grænse på 200 udstedte fakturaer pr. måned gælder også for fakturaer udstedt via API'et.
Kan jeg prøve API'et, før jeg betaler?+
Du kan oprette en gratis konto og læse hele dokumentationen på /api/docs. For at oprette en API-nøgle skal kontoen være på en plan med API-nøgler. Skriv til os, hvis du vil afprøve en integration først.
Kan API'et sende e-fakturaer til det offentlige (EAN/Nemhandel)?+
Nej. Tallyx kan ikke sende eller modtage e-fakturaer via Nemhandel eller Peppol. Der findes en XML-eksport af fakturaen, men den er ikke valideret mod Nemhandel.
Hvordan retter jeg en faktura, der er udstedt ved en fejl?+
En udstedt faktura kan ikke ændres eller slettes. Opret en kreditnota (invoice_type credit_note med feltet credit_of_invoice_id, der henviser til fakturaen), og udsted derefter en ny faktura.
Får jeg besked, når en faktura bliver betalt?+
Du kan hente fakturaens status og indbetalinger via API'et. Webhooks, der selv kalder dit system, findes på Enterprise-planen.