e-conomic API: sådan kobler du e-conomic på andre systemer

Kort svar: e-conomic API er den åbne adgang, der lader andre systemer læse og skrive data i e-conomic, fx kunder, varer, ordrer, fakturaer og kassekladder. Du kan koble e-conomic på din webshop, dit CRM eller dit betalingssystem på tre måder: med en færdig app fra e-conomics appunivers, med et værktøj som Make eller med en egen integration bygget direkte mod API'et. Det vigtigste at vide før du går i gang: Med pakken Basis kan integrationer kun hente data, ikke skrive dem, bortset fra lønsystemer og årsafslutningsværktøjer.

Hvad er e-conomic API?

Ifølge e-conomic selv kan en app i deres appunivers nå mere end 250.000 kunder (e-conomic). API'et er døren ind til dem alle. Det gør det muligt for din webshop, dit CRM eller dit tidsregistreringssystem at oprette kunder, lægge ordrer ind, bogføre fakturaer og hente regnskabstal, uden at nogen taster det samme to gange.

Teknisk er der tale om REST-API'er, der taler JSON. Det ældre REST API ligger på restapi.e-conomic.com, og alle lister kan filtreres med en filter-parameter og hentes sidevis med op til 1.000 poster pr. side (e-conomic REST API).

OpenAPI, REST eller SOAP?

Her skiller e-conomic sig ud fra de fleste andre regnskabsprogrammer: Der findes flere API'er side om side, og det er let at vælge forkert.

OpenAPI og REST bruger samme login, så én integration kan sagtens bruge begge på samme tid (e-conomic Developer). SOAP-API'et har været frosset siden 2018, og e-conomic har lukket metoderne gradvist med 90 dages varsel (e-conomic). Har I en gammel integration bygget på SOAP, er det den, der bør flyttes først.

Typiske integrationer med e-conomic API

Eksemplerne er hentet fra e-conomics egen appoversigt, hvor der også findes integrationer til lønsystemer, kassesystemer og lagerstyring (e-conomic). Hvilke data en integration kan nå, afhænger af den rolle, appen har fået, fx SuperUser, Bookkeeping, Sales eller ProjectEmployee, og af hvilke moduler kunden har (e-conomic REST API).

Sådan fungerer adgang og tokens

e-conomic bruger ikke OAuth med udløbende tokens. I stedet sendes to faste tokens med i hvert kald:

• X-AppSecretToken identificerer din app. Du opretter den i en gratis udvikleraftale, og den vises kun én gang, så gem den med det samme.
• X-AgreementGrantToken identificerer kundens regnskab. Den opstår, når en bruger åbner appens installations-URL og giver adgang til sin aftale.

Udvikleraftalen indeholder ingen regnskabsdata, så til test opretter du en gratis demoaftale med data (e-conomic Developer). Vil du bare se, hvordan svarene ser ud, kan du sende værdien demo i begge headers. Det giver læseadgang til en demoaftale, men kun GET-kald (e-conomic REST API).

GET https://restapi.e-conomic.com/customers?pagesize=100&skippages=0
X-AppSecretToken: <din app-token>
X-AgreementGrantToken: <kundens grant-token>
Content-Type: application/json

Fordi tokens ikke udløber af sig selv, er det jeres ansvar at gemme dem krypteret og at nulstille app-tokenet, hvis det slipper ud.

Hvilken e-conomic-pakke kræver API'et?

Dette er det punkt, flest overser. Ifølge e-conomics prisside følger "fri adgang til integrationer og apps" med pakkerne Plus, Smart og Komplet. Med Basis er adgangen begrænset: Kun lønsystemer og årsafslutningsværktøjer må aflevere data til e-conomic, fx oprette posteringer eller fakturaer. Integrationer, der kun henter data ud, fx rapporteringsværktøjer, må gerne bruges på Basis (e-conomic).

Skal din webshop altså oprette fakturaer i e-conomic, kræver det mindst Plus. Prisen på selve integrationen afhænger af leverandøren, og som udvikler er udvikleraftalen gratis (e-conomic Developer).

Grænser og webhooks

Token bucket i stedet for et fast antal kald

e-conomic begrænser trafikken med en token bucket pr. app og aftale. Spanden har en kapacitet, fx 2.000 tokens, og fyldes op med en fast hastighed, fx 30 tokens i sekundet. Hvert kald koster tokens efter, hvor tungt det er: Et enkelt konto-opslag koster omkring 1, mens en bogført faktura koster omkring 13. Svaret viser forbruget i headerne X-CallCost og X-RateLimiting, og når spanden er tom, får du fejlkode 429 med en Retry-After-header. e-conomic anbefaler at sende kald ét ad gangen frem for parallelt (e-copedia).

Idempotency-Key mod dubletter

Du kan sende en Idempotency-Key med skrivende kald. Gentager du kaldet med samme nøgle inden for en time, får du det gemte svar i stedet for en ny faktura (e-conomic REST API). Et genkendt kald koster desuden 0 tokens (e-copedia).

Webhooks

I stedet for at spørge e-conomic om ændringer hele tiden kan integrationen abonnere på webhooks, som oprettes og styres via Webhooks API'et. Et mislykket kald prøves igen op til fem gange med stigende pauser fra 1 sekund til 20 minutter, og fejler mere end 250 kald til samme URL på et døgn, slås webhooken fra, og hændelserne går tabt. e-conomic anbefaler derfor en natlig synkronisering som sikkerhedsnet (e-conomic Developer).

Byg selv eller brug en færdig app?

Make har en e-conomic-app, der forbindes med de samme to tokens (Make). Læs mere om værktøjer til automatisering i Hvad er n8n?

En egen integration giver mening, når flowet er unikt: flere lagre, kundespecifikke priser, særlige momsregler eller flere systemer, der skal spille sammen. Se hvordan vi arbejder med e-conomic-integration, systemintegration og AI-automatisering generelt. Bruger I et andet regnskabsprogram, så læs om Dinero API eller Billy API.

Typiske faldgruber

• Forkert pakke. Integrationen virker i test, men kunden har Basis, og skrivende kald bliver afvist. Tjek pakken før I bygger.
• Bygget på det forkerte API. Ny kode på SOAP eller på REST, hvor OpenAPI allerede dækker behovet, skal skrives om senere.
• Parallelle kald. Mange samtidige kald tømmer token-spanden hurtigt. Læg kaldene i kø.
• Dubletter. Brug Idempotency-Key på alle kald, der opretter noget.
• Kun webhooks. En slået-fra webhook taber hændelser. Byg en natlig synkronisering ved siden af.
• Moms og konti. Lad bogholderen godkende kontoplan og momskoder, før I går live.