Postbacks er automatiske beskeder, som GelatoConnect sender til eksterne systemer, hver gang en ordrestatus ændrer sig. De er vigtige for at holde Print Service Providers (PSP’er) og kunder opdateret om deres ordrer i realtid – helt uden at du skal gøre noget manuelt.
Postbacks giver dig mulighed for at:
Giv kunderne automatisk besked, når deres ordrestatus ændrer sig (f.eks. modtaget, afsendt, leveret).
Giv dit team besked om ordrer, der kræver opmærksomhed (fejlede ordrer).
Opdatér dine lagerstyringssystemer, når ordrer er gennemført.
Følg din ordre hele vejen gennem din Fulfillment-proces.
Disse notifikationer kan sendes via Webhook (URL) eller e-mail, alt efter hvad der passer bedst til din integration.
Forudsætninger for at opsætte postbacks
Før du opretter postbacks, skal du sikre dig, at du har:
Kunder, der får besked, bliver sat op i kundesektionen i GelatoConnect.
URL-endpoints er klar til at modtage Webhook-data (hvis du bruger URL-leveringsmetoden).
Et grundlæggende kendskab til skabeloner og udløsere.
Kendskab til ordrestatus-flowet i GelatoConnect.
Trin-for-trin guide til at sætte postbacks op
1. Opret en postback-skabelon
Skabeloner bestemmer, hvordan dine postback-notifikationer ser ud og hvad de indeholder. Du kan lave dem på to måder:
Mulighed A: Gennem skabelonsektionen
Gå til Workflow > Order Intake > Skabeloner
Klik på Tilføj skabelon
Vælg skabelontypen:
Trigger: Webhook – Til at sende JSON- eller XML-data til eksterne systemer
Trigger: Email – Til at sende e-mailnotifikationer
Vælg det format, der passer bedst (JSON eller XML)
Mulighed B: Via kundeprofilen
Gå til din kundes profil
Gå til fanen Triggers, og klik på Tilføj Trigger
Du kan lave skabelonen direkte, når du sætter triggeren op
Hvis du vil have en grundig guide til at lave skabeloner, så tjek Sådan laver du skabeloner til Order Intake.
2. Opsæt en trigger
Triggers bestemmer, hvornår postbacks sendes, og hvor de bliver leveret:
Giv din trigger et beskrivende navn (f.eks. "Ordre afsendt notifikation")
Vælg den begivenhed, der skal sætte triggeren i gang:
Bestilling modtaget
Ordren mislykkedes
Ordre annulleret
Ordren returneret
Ordre sat i produktion
Ordre leveret
Ordren afsendt
Bestilling i transit
Vælg din leveringsmetode:
URL (webhook): Sender data til en angivet destination
Email: Sender beskeder via e-mail
For levering via URL skal du konfigurere:
Den URL, hvor notifikationer bliver sendt hen
Sæt metoden til POST (anbefales)
Du kan vælge JSON eller XML som dataformat
Aktivér "Prøv igen ved fejl" for at gøre det mere stabilt
For at få leveret via e-mail, skal du indtaste modtagerens e-mailadresse.
3. Tilføj en skabelon
Din skabelon gør GelatoConnects interne data nemme at bruge i både dine egne og dine kunders systemer.
Hvis du allerede har lavet en skabelon, kan du vælge den, når du sætter triggeren op – ellers skal du lave en ny.
Giv din skabelon et tydeligt navn (fx "OrderShippedNotification")
Brug de eksempler på payloads, der passer til den valgte begivenhedstype
Brug Template Mapper til at matche dine inputdatafelter med det outputformat, du ønsker
Eksempel på skabelon til "Order Shipped"-begivenhed:
{ "event": "Ordre sendt", "orderId": "##{{ orderId }}", "orderReferenceId": "##{{ orderReferenceId }}", "timestamp": "##{{ created }}", "status": "##{{ fulfillmentStatus }}", "trackingInfo": { {% for item in items %} {% for fulfillment in item.fulfillments %} "trackingCode": "##{{ fulfillment.trackingCode }}", "trackingUrl": "##{{ fulfillment.trackingUrl }}", "carrier": "##{{ fulfillment.carrierName }}" {% endfor %} {% endfor %} }}Brug knappen "Render" for at se, hvordan dit resultat kommer til at se ud
Test skabelonen for at sikre, at den giver det resultat, du forventer
For flere eksempler på skabeloner, tjek Template Mapper-eksempler.
4. Test og aktiver
Før du går live med din postback, så send et par test for at sikre, at alt fungerer som det skal. Bagefter kan du ændre status på din trigger og skabelon til aktiv.
Når du har fulgt disse trin, sender systemet en besked til den angivne URL eller e-mailadresse med de relevante ordreoplysninger, hver gang den valgte ordrehandling sker.
Avancerede postback-teknikker
Sådan bruger du opslag i dine skabeloner
Opslag er smarte, når du vil gøre interne værdier nemme at forstå for dine kunder:
{% set carrier = lookups({"shipmentMethodUid": fulfillment.carrierUid}, strict=False, default="") %}"carrier": "##{{ carrier }}"Dette omdanner interne GelatoConnect-koder til mere forståelige værdier for dine kunder. Lær mere i Sådan opsætter du lookups.
Datafelter, der passer til den enkelte begivenhed
Forskellige begivenheder giver adgang til forskellige datafelter. Her er de vigtigste felter, du kan finde ved de mest almindelige begivenheder:
Ordre sendt/leveret: sporingskoder, fragtfirma, leveringsdatoer
Ordre mislykkedes/annulleret: fejlårsager, tidsstempler
Ordre modtaget: ordredetaljer, vareinformation
For at få det fulde overblik over disse felter, kan du læse Introduktion til Template Mappers i GelatoConnect.
Få styr på problemer med postbacks
Hvis dine postbacks driller:
Tjek, at destinationsadressen er korrekt og tilgængelig
Tjek om der er fejl i skabelonens syntaks
Tjek, at triggeren er sat rigtigt op til den rigtige begivenhed
Tjek om der er forkerte datatyper eller manglende felter
Prøv skabelonen af med eksempler, før du aktiverer den
Specifikt for e-mail postbacks:
Tjek, at dine SMTP-serveroplysninger er korrekte (hvis du har sat det op)
Tjek, at afsenderens e-mailadresse er skrevet korrekt
Sørg for, at din SMTP-server giver GelatoConnect lov til at oprette forbindelse
Tjek om dine loginoplysninger (brugernavn og adgangskode) er korrekte
Hvis du vil have flere gode råd til fejlfinding, så tjek afsnittet "Fejlfinding" i Oprettelse af skabeloner til ordreindtastning.
Sådan sætter du din mailserver op til postbacks
Som Print Service Provider kan du sætte GelatoConnect op til at sende e-mail-postbacks via din egen e-mailserver. Det betyder, at modtagerne ser e-mails, der kommer fra dit domæne i stedet for fra GelatoConnect – så din brandidentitet altid er i top.
Sådan indstiller du dine e-mailserverindstillinger:
Gå til Workflow-sektionen i venstre sidepanel
Find afsnittet Configuration og vælg Work Settings
Find afsnittet Indstillinger for udgående mails
Indtast følgende oplysninger:
Afsenderens e-mailadresse: Den e-mailadresse, der vises i "Fra"-feltet
Afsendernavn: Navnet, der vises sammen med e-mailadressen
SMTP-server: Din e-mailserveradresse (fx smtp.ditfirma.com)
SMTP-port: Porten din mailserver bruger (typisk 587 eller 465)
SMTP-brugernavn: Dit brugernavn til at logge ind på din SMTP-server
SMTP-adgangskode: Adgangskoden til din SMTP-server
Brug TLS: Slå dette til, hvis din SMTP-server kræver TLS-kryptering (anbefales)
Gem din opsætning
Når du har sat det op, bliver alle e-mail-postbacks sendt via din egen e-mailserver. Det sikrer, at dit brand altid står stærkt, og at dine kunder får dine beskeder hver gang.
Hvad sker der nu?
Når du har sat dine postbacks op:
Hold øje med, om leveringerne går som de skal, på siden Anmodninger under Ordreindtag.
Tjek med dine kunder, om de får beskederne, som de skal
Når du får et stærkt postback-system op at køre, giver du dine kunder en bedre oplevelse med opdateringer på deres ordrer i realtid – og du slipper for en masse manuelt bøvl.