Integrationer
Det Covex taler med
Covex taler med økonomisystemet, kortet, indbakken og jeres egne systemer. Her står hvad der er klar, hvad der dannes som fil, og hvad der kræver en aftale hos tredjepart — uden at pynte på det.
Kunden, adressen og prisen tastes én gang i Covex. Integrationerne sørger for, at resten af jeres systemer får det samme — uden daglig eksport og uden dobbelt indtastning.
Hvordan kobles de på?
Alle integrationer følger samme mønster: en forbindelse med udbyder og status, referencer der kobler et Covex-objekt til udbyderens, så intet oprettes to gange, og en log med én hændelse pr. kørsel.
Hvor står nøglerne?
Aldrig i databasen. Forbindelsen peger på navnet på en miljøvariabel, og serveren læser nøglen derfra.
Hvad hvis noget fejler?
Loggen på integrationens side viser årsagerne, ikke kun antallet. Ens fejl samles, så 40 fejl bliver til én linje med antal og et par eksempler.
Forbindelser og status
| Område | Hvad | Status |
|---|---|---|
| Økonomisystem | e-conomic: fakturaer, kreditnotaer, betalingsstatus | Klar |
| E-faktura | UBL 2.1 og Peppol BIS Billing 3.0 til NemHandel | Filen dannes |
| Dokumenter ind | Bestillinger og fragtbreve fra mail, læst og matchet | Klar |
| Kort og ruteafstand | Mapbox, PTV eller OSRM | Klar |
| Kreditvurdering | Creditsafe, med automatisk spærring efter forfald | Kræver aftale |
| Telematik | Positioner, køre-hviletid og kørte km fra førerhuset | Kræver aftale |
| Åbent API | Ordrer, hændelser og leverandørfakturaer, plus webhooks | Klar |
Nogle integrationer kræver en aftale hos tredjepart, før de kan bruges: kreditbureau, telematik, færge- og afgiftsselskaber, EDI og elektronisk fragtbrev. Koden er bygget og testet mod deres dokumenterede grænseflader, men den kan først tændes, når aftalen er på plads. Under Integrationer står der ærligt ”ingen adapter” ved dem, der ikke er koblet på endnu.
Ærlig status
Klar, filen dannes eller kræver aftale — det står der, og det er det, der gælder.
Integrationer
Økonomisystem
e-conomic
KlarE-faktura
Peppol BIS 3.0
Filen dannesKort og ruteafstand
Mapbox, PTV, OSRM
KlarTelematik
Positioner og køretid
Kræver aftaleKreditvurdering
Spærring efter forfald
Kræver aftaleOmråde 1
Økonomi og e-faktura
Covex taler med e-conomic. Kunder oprettes der, hvis de mangler, og kobles til dem der findes. Udstedte fakturaer bliver til kladder med Covex-nummeret som reference, kreditnotaer til kladder med negative linjer. Når en faktura er bogført og betalt i e-conomic, står den som betalt i Covex.
E-fakturaen dannes som UBL 2.1 og Peppol BIS Billing 3.0 — det format NemHandel bruger.
ting holdes i takt med e-conomic: kunder, fakturaer og betalinger.
Faktura 2024-0412
Nordlys Møbler · 12.480 kr.
Økonomisystem
e-conomic
KlarE-faktura
UBL 2.1 · Peppol BIS 3.0
Filen dannes
”Kladder bogføres ikke fra Covex. Tallene i regnskabet skal være godkendt af et menneske.”
Sådan arbejder e-conomic-integrationen
Område 2
Dokumenter, kort og telematik
Bestillinger og fragtbreve fra mail bliver læst, matchet og lagt til gennemsyn som en kladde. Ruteafstande regnes med Mapbox, PTV eller OSRM.
Telematik giver positioner, køre- og hviletid og kørte kilometer fra førerhuset. Det kræver en aftale med udbyderen. Positioner kan også sendes ind gennem API'et; en position der er ældre end den nyeste på turen, overskriver ikke det nyeste billede.
kortudbydere at vælge imellem til ruteafstand: Mapbox, PTV eller OSRM.
Importér kunder
kunder.xlsx · 1.284 rækker
”Status sættes aldrig direkte af en integration. Der udløses en overgang, og den kan afvises.”
Et princip i Covex
Område 3
Åbent API og webhooks
Kundens eget system kan hente ordrer, oprette nye og sende hændelser: positioner, stophændelser, scanninger og statusskift. Ordrer der kommer udefra, oprettes som kladder, så et menneske ser dem, før de bliver til en aftale.
Transportører kan sende leverandørfakturaer, som Covex fordeler på ordrerne og matcher linje for linje mod aftalen. Webhooks sender hændelser fra ordren videre med en signatur, modtageren kan kontrollere.
kald i minuttet pr. API-nøgle, før Covex beder om at vente. Grænsen kan hæves pr. installation.
Webhook
https://erp.kolvand.example/covex
Seneste levering 14.47 · 200 OK
hændelser på ordren kan sendes som webhook — fra oprettet til faktureret.
nye forsøg på en webhook, efter 1, 2, 4, 8 og 16 minutter, hvis modtageren ikke svarer.
rettigheder en nøgle kan have: læse ordrer, oprette ordrer, læse sporing og sende hændelser.
Mangler I en integration?
Nogle integrationer kræver en aftale hos tredjepart, før de kan bruges. Koden er bygget og testet mod deres dokumenterede grænseflader, men den kan først tændes, når aftalen er på plads.
Fortæl os hvilket system I bruger, så vender vi tilbage med, hvor det står — ærligt.
Kontakt os
Kontakt os – e-mail følger snart