Mandag morgen kl. 08:12. e-conomic-integration holder op med at virke. Ordrer hentes ikke. Fakturakladder oprettes ikke. årsag: Grant Token invalideret. Hvorfor? Den medarbejder der autoriserede integrationen for 18 måneder siden er stoppet. IT slettede hendes e-conomic-konto fredag eftermiddag. Token invalideret øjeblikkeligt. Ingen advarsel.
Hvad er e-conomic integration?
e-conomic-WMS-integration dækker typisk:
e-conomic til WMS:
- Ordrer hentes fra e-conomic (typisk B2B-ordrer oprettet manuelt i e-conomic)
- Kundeoplysninger og leveringsadresser
- Varenumre og priser
WMS til e-conomic:
- Fakturakladde oprettes ved pakning
- Beholdningsopdatering
- Eventuelt: automatisk fakturagodkendelse og afsendelse til kunden
Autentificering: Grant Token
e-conomic bruger ikke OAuth2 eller API-nøgler som de fleste moderne systemer. Det bruger en Grant Token, et persistent autoriseringstoken, der genereres ved en engangs-autorisationsproces.
Sådan fungerer det:
- En e-conomic-bruger med rettigheder autoriserer din applikation i e-conomic (via e-conomics Developer Portal)
- Autorisationsprocessen genererer et Grant Token, en lang tekststreng
- Grant Token gemmes i WMS-konfigurationen
- WMS bruger Grant Token + App Secret Key til alle API-kald
Grant Token udløber ikke automatisk. Men det invalideres, hvis brugeren der autoriserede slettes i e-conomic, eller administratoren trækker applikationens adgang tilbage.
Det kritiske scenarie: En medarbejder fratræder. IT-afdelingen sletter brugerens e-conomic-konto. Grant Token invalideres øjeblikkeligt. e-conomic-integration holder op med at virke, næste morgen, midt i en arbejdsdag, uden varsel. Løsning: Brug altid en dedikeret systembruger til Grant Token-autorisering. Aldrig en personlig bruger.
Hvad koster Grant Token-invalidering?
| Downtime-varighed | Tabte ordrer | Direkte tab | LTV-tab | Total omkostning |
|---|---|---|---|---|
| 4 timer (opdages hurtigt) | 0 (ordrer venter i e-conomic) | 0 kr. | Forsinkelse: ~5.000 kr. | 5.000 kr. |
| 1 dag (opdages næste morgen) | 0 (ordrer venter) | 0 kr. | Tabt salg: ~20.000 kr. | 20.000 kr. |
| 1 uge (opdages ved månedsafslutning) | 0 (ordrer venter) | Fakturaer mangler: ~140.000 kr. | Cashflow-tab: ukvantificerbar | 140.000 kr.+ |
👉 Har du tekniske integrationsproblemer? Se SmartPacks integrationer
Ordrehentning , hvert 5. minut
e-conomic-ordrer hentes via polling (ikke webhook). SmartPack og de fleste WMS-systemer poller e-conomic API hvert 5. minut for nye ordrer.
GET /invoices/drafts?skippages=0&pagesize=25
X-AppSecretToken: {app_secret}
X-AgreementGrantToken: {grant_token}e-conomic returnerer fakturakladder med status "draft", det er ordrer klar til behandling.
Fakturakladde ved pakning
En central del af e-conomic-integrationen: WMS opretter fakturakladde i e-conomic ved pakning, ikke ved ordremodtagelse, ikke ved afsendelse, men ved det præcise tidspunkt, pakken forsegles.
Hvorfor ved pakning? Det er det tidspunkt, du ved præcist, hvad der er med i forsendelsen (delvis pakning, substitutioner). Det stemmer overens med regnskabsprincipper: varen forlader lageret og transaktion oprettes.
Workflow:
- Plukker plukker varer og ankommer til pakkestation
- Pakker bekræfter indhold og pakker
- WMS opretter fakturakladde i e-conomic via API med præcist indhold
- Fragtlabel genereres, pakke forsegles og afsendes
- Fakturakladden kan evt. godkendes automatisk til endelig faktura
Typiske fejl
- Grant Token autoriseret af personlig bruger. Fratræder medarbejderen, invalideres token. Brug altid servicebruger.
- Fakturakladde oprettes ved ordremodtagelse. Varen er måske ikke pakket endnu. Delvis pakning eller substitution er ikke reflekteret. Vent til pakningstidspunktet.
- Varenummer matcher ikke. e-conomic varenumre skal matche WMS varenumre præcist.
Sådan gør du det rigtigt
- Brug servicebruger til Grant Token: Opret en dedikeret e-conomic-bruger (f.eks. "WMS Service") udelukkende til integration. Sørg for, at den bruger aldrig slettes.
- Dokumentér Grant Token og App Secret Key sikkert: Gem dem i password manager med noter om, hvem der har adgang og hvilken e-conomic-bruger der autoriserede.
- Opsæt alert ved e-conomic API-fejl: Fejler hentning af ordrer fra e-conomic 3 gange i træk, sendes alert til driftsansvarlig.
Tjekliste
- Er Grant Token autoriseret af servicebruger (ikke personlig)?
- Er App Secret Key og Grant Token gemt sikkert?
- Oprettes fakturakladde ved pakning (ikke ordremodtagelse)?
- Er varenumre synkroniserede mellem WMS og e-conomic?
- Er alert konfigureret ved API-fejl?
SmartPack understøttelse
SmartPack henter ordrer fra e-conomic hvert 5. minut via polling. Grant Token og App Secret Key konfigureres i SmartPack admin. Fakturakladde oprettes automatisk ved pakning med præcist indhold. SmartPack sender alert, hvis e-conomic API fejler gentagne gange. Integration testes med e-conomic demo-miljø inden go-live.