Spring videre til hovedindholdet

🔗 Webhook-integration – Send returdata til dit eget system

Jeppe Oestergaard Hansen avatar
Skrevet af Jeppe Oestergaard Hansen
Opdateret for over 2 måneder siden

Returnflows’ webhook-integration giver dig mulighed for at sende hændelser om returneringer og forsendelser direkte til din egen løsning – fx ERP-system, data warehouse eller til intern notifikation.

🧰 Hvad er en webhook?

En webhook er en real-time datakrog, der sender information fra Returnflows til en specifik URL, du selv vælger.
Når en bestemt hændelse sker, sender vi et struktureret payload (JSON) til den valgte adresse.

Du kan f.eks. opdatere din ordrestatus i ERP, oprette retur i økonomisystem eller trigge interne alerts.

✅ Sådan aktiverer du integrationen

  1. Gå til Settings → Integrations

  2. Find Webhook og klik på Install
    ​

🛠 Webhook Setup

Du vil nu se følgende felter og muligheder:

Webhook URL

Indtast den endpoint-URL, du vil sende data til
→ Fx: https://erp.eksempel.dk/return-updates

Secret Key

Indtast en valgfri nøgle, som vil blive brugt til at signere payloads
→ Bruges til at validere, at data kommer fra Returnflows

🔔 Understøttede events (dansk)

Når du bruger webhook-integration i Returnflows, kan du abonnere på følgende hændelser:

Event

Beskrivelse

return.created

Retur er oprettet af kunden

return.completed

Returen er oprettet og klar til behandling

return.processed

Returen er oprettet og processeret internt

return.canceled

Returen er aflyst

return.paused

Returen eller ordre er sat på pause

return.resumed

Returen er genoptaget (unpaused)

return.closed

Returen er lukket og færdigbehandlet

return.instant_exchange

Ombytning er frigivet pga. “Instant Exchange”

return.reset

Returen er nulstillet

return.label_generated

En returlabel er genereret

return.auto_close_initiated

Auto-close er igangsat og nedtælling starter

return.auto_close_cancelled

Auto-close blev annulleret (fx manglende tracking)

return.auto_close_completed

Returen er auto-closed

return.auto_close_failed

Auto-close fejlede (fx refund-fejl)

shipment.event.in_transit

Pakken er i transit hos fragtudbyder

shipment.event.delivered

Pakken er leveret

🧪 Format og signering

  • Payload sendes som JSON

  • Headers inkluderer en signatur baseret på Secret Key

  • Du kan validere med standard HMAC-metoder (SHA256)

🔄 Retry-logik

Hvis din server ikke svarer med 200 OK, vil Returnflows automatisk forsøge igen (med eksponentiel backoff).

💡 Anvendelsesmuligheder

  • Opret retur i ERP/CRM

  • Opdater ordrestatus i internt system

  • Gem hændelser i BI/data warehouse

  • Send intern Slack-notifikation

🙋 Brug for hjælp?

Er du i tvivl om hvordan du bygger dit endpoint, validerer payloads eller tester integrationen?

💬 Kontakt os – vi hjælper gerne med opsætning og test.

Besvarede dette dit spørgsmål?