Skip to main content

Integrasjonsmønstre

Integrasjoner mot Utleggsappen følger ofte noen få gjennomgående mønstre.

Vanlige integrasjonsmønstre​

  • redirect- eller stegvis onboarding for å koble en organisasjon til et eksternt system
  • webhooker for hendelsesdrevet oppdatering
  • planlagt synkronisering for strukturdata og status
  • service accounts eller tilsvarende maskinbrukere for sikre maskin-til-maskin-kall
  • import eller eksport av filer når det ikke finnes direkte API-kobling

Typisk livsløp​

  1. Organisasjonen oppretter eller starter en integrasjon fra Utleggsappen.
  2. Integrasjonen autentiseres og får nødvendig tilgang.
  3. Oppsett, mapping og kildesystem blir definert.
  4. Webhooker, polling eller eksportflyt flytter data videre i riktig retning.

Webhook-forsøk og deduplisering​

Webhooks (i dag invoice.created til integrasjonens webhook-URL) sendes med Standard Webhooks-headerne webhook-id, webhook-timestamp og webhook-signature (HMAC-SHA256 over <webhook-id>.<timestamp>.<body>). For eldre mottakere sendes også headerne X-Signature, X-Timestamp, X-Event-Id, X-Webhook-Attempt og X-Webhook-Max-Attempts. Du kan få samme melding mer enn én gang. Det skjer når Utleggsappen prøver leveringen på nytt, eller spiller av meldingen på nytt. Meldingen har da samme webhook-id som første gang. Ta vare på webhook-id for meldinger du har behandlet, og hopp over meldinger med en webhook-id du allerede har sett. X-Webhook-Attempt og X-Webhook-Max-Attempts inngår ikke i signaturen og skal ikke brukes til autorisasjon – bare til logging.

Service accounts og sikkerhet​

Integrasjonene bør ikke opptre som vanlige sluttbrukere. Derfor brukes service accounts og relaterte tokens for å gi minst mulig, men tilstrekkelig tilgang.

Eksempler på integrasjoner​

  • PowerOffice for onboarding og økonomiflyt
  • Unimicro med synkronisering og lønnshåndtering
  • CSV-eksport med feltkonfigurasjon og planlagte uttrekk
  • AirPlus (tidligere Eurocard for bedrifter) for hendelsesdrevet innkommende kortdata

Se også​

Nerdehjørnet

Velg ett tydelig integrasjonsmønster per kobling og dokumenter kilden til sannhet, retry-strategi, idempotens og tokenrotasjon tidlig. De fleste problemer i produksjon skyldes ikke første vellykkede kall, men hva som skjer når data kommer i feil rekkefølge, en webhook gjentas eller mappingen endres over tid.