Postbacks er automatiske varsler som sendes fra GelatoConnect til eksterne systemer hver gang en ordrestatus endres. De er viktige for at trykktjenesteleverandører (PSP-er) og kunder skal holde seg oppdatert på ordrene sine i sanntid, uten at noen må oppdatere manuelt.

Postbacks lar deg gjøre dette:

Varsle kundene automatisk når statusen på bestillingen deres endres (for eksempel mottatt, sendt, levert).
Gi beskjed til teamet ditt om ordrer som trenger oppmerksomhet (mislykkede ordrer).
Oppdater lagerstyringssystemene dine når bestillinger er fullført.
Følg med på ordrestatus gjennom hele produksjonsprosessen.

Disse varslingene kan sendes via Webhook (URL) eller e-post, alt etter hva som passer best for integrasjonen din.

Dette må være på plass før du setter opp postbacks

Før du lager postbacks, må du sørge for at du har:

Kunder som får varsler, blir satt opp i kundedelen av GelatoConnect.
URL-endepunktene er klare til å ta imot data fra Webhook (hvis du bruker URL-leveringsmetoden).
En enkel forståelse av maler og utløsere.
Kjennskap til ordrestatusflyten i GelatoConnect.

Enkel steg-for-steg-guide for å sette opp postbacks

1. Lag en postback-mal

Maler bestemmer oppsettet og innholdet i postback-varslingene dine. Du kan lage dem på to måter:

Alternativ A: Via maler-delen

Gå til Workflow > Order Intake > Maler
Klikk på Legg til mal
Velg maltype:
- Trigger: Webhook – For å sende JSON- eller XML-data til eksterne systemer
- Utløser: E-post – For å sende e-postvarsler
Velg riktig format (JSON eller XML)

Alternativ B: Via kundeprofilen

Gå til kundens profil
Gå til Triggere-fanen og klikk på Legg til trigger
Du kan lage malen direkte når du setter opp utløseren

For en grundig veiledning om hvordan du lager maler, se Slik lager du maler for ordreinnhenting.

2. Sett opp en utløser

Utløsere bestemmer når tilbakemeldinger sendes og hvor de leveres:

Gi triggeren et beskrivende navn (for eksempel «Varsel om sendt bestilling»).
Velg hendelsen som skal starte utløseren:
- Bestillingen er mottatt
- Bestillingen mislyktes
- Ordre kansellert
- Bestillingen returnert
- Bestillingen er ferdig produsert
- Bestilling levert
- Bestilling sendt
- Bestilling under transport
Velg hvordan du vil få levert:
- URL (Webhook): Sender data til en valgt endepunkt
- E-post: Sender varsler på e-post
For å levere via URL, gjør følgende innstillinger:
- Destinasjonsadressen der varsler blir sendt
- Velg metoden POST (anbefalt)
- Du kan velge JSON eller XML som dataformat
- Slå på «Prøv igjen ved feil» for ekstra trygghet
For e-postlevering, legg inn mottakerens e-postadresse.

3. Legg til en mal

Malen din gjør om GelatoConnect sine interne data til et format som passer for deg og kundene dine.

Hvis du allerede har laget en mal, kan du velge den når du setter opp utløseren. Hvis ikke, må du lage en ny.

Gi malen din et tydelig navn (for eksempel «OrderShippedNotification»).
Bruk eksemplene på data som er gitt for hendelsestypen du har valgt
Koble sammen feltene fra inn-dataene med ønsket utdataformat ved hjelp av Template Mapper

Eksempelmal for «Ordre sendt»-hendelse:

{  "event": "Bestilling sendt",  "orderId": "##{{ orderId }}",  "orderReferenceId": "##{{ orderReferenceId }}",  "timestamp": "##{{ created }}",  "status": "##{{ produksjonStatus }}",  "trackingInfo": {    {% for item in items %}      {% for produksjon in item.fulfillments %}        "trackingCode": "##{{ fulfillment.trackingCode }}",        "trackingUrl": "##{{ fulfillment.trackingUrl }}",        "carrier": "##{{ fulfillment.carrierName }}"      {% endfor %}    {% endfor %}  }}

Bruk «Render»-knappen for å se hvordan resultatet ditt vil se ut
Test malen for å være sikker på at den gir det resultatet du ønsker

For flere eksempler på maler, se Eksempler på malmapper.

4. Test og aktiver

Før du går live med postbacken din, bør du teste for å sjekke at alt fungerer som det skal. Etterpå kan du endre statusen på utløseren og malen til aktiv.

Når du har fullført disse stegene, vil systemet sende en tilbakemelding til den angitte URL-en eller e-postadressen med relevant ordreinformasjon hver gang den valgte ordrehandlingen skjer.

Smartere måter å sende tilbakemeldinger på

Slik bruker du oppslag i malene dine

Oppslag er nyttige når du vil gjøre interne verdier om til noe som er lett å forstå for kundene:

{% set carrier = lookups({"shipmentMethodUid": fulfillment.carrierUid}, strict=False, default="") %}"carrier": "##{{ carrier }}"

Dette gjør om interne GelatoConnect-koder til mer forståelige verdier for kundene dine. Finn ut mer i Slik setter du opp oppslag.

Datafelter som er spesifikke for arrangementet

Ulike hendelser gir ulike datafelter. Her er de viktigste feltene du finner for vanlige hendelser:

Bestilling sendt/leveret: sporingskoder, fraktinformasjon, leveringsdatoer
Bestilling mislyktes/ble kansellert: feilmeldinger, tidspunkter
Bestilling mottatt: detaljer om bestillingen, informasjon om varen

For å få full oversikt over disse feltene, kan du lese «Introduksjon til mal-mappere i GelatoConnect» på denne siden.

Feilsøking av postbacks

Hvis postbackene dine ikke fungerer som de skal:

Sjekk at destinasjonsadressen er riktig og tilgjengelig
Sjekk om det er feil i malens syntaks
Sjekk at utløseren er riktig satt opp for det riktige hendelsen
Sjekk om det er ulike datatyper eller manglende felt
Test ut malen med eksempeldata før du aktiverer den

Spesielt for e-posttilbakemeldinger:

Sjekk at opplysningene om SMTP-serveren din er riktige (hvis du har satt det opp)
Sjekk at avsenderens e-postadresse er skrevet riktig
Sjekk at SMTP-serveren din godtar tilkobling fra GelatoConnect
Sjekk om innloggingsdetaljene (brukernavn og passord) er riktige

For grundigere tips om feilsøking, se «Feilsøking»-delen i Creating Templates for Order Intake.

Slik setter du opp e-postserveren din for tilbakemeldinger

Som en Print Service Provider kan du sette opp GelatoConnect til å sende e-postvarsler via din egen e-postserver. Da vil mottakerne se at e-postene kommer fra ditt eget domene, ikke fra GelatoConnect. Slik beholder du en helhetlig profil for merkevaren din.

Slik setter du opp e-postserverinnstillingene dine:

Gå til Workflow-delen i venstre sidemeny
Finn delen Konfigurasjon og velg Arbeidsinnstillinger
Finn delen for innstillinger for utgående e-postserver
Skriv inn disse detaljene:
- Avsenderens e-postadresse: E-postadressen som vises i «Fra»-feltet
- Avsendernavn: Navnet som vises sammen med e-postadressen
- SMTP-server: E-postserveradressen din (for eksempel smtp.dittfirma.com)
- SMTP-port: Porten e-postserveren din bruker (vanligvis 587 eller 465)
- SMTP-brukernavn: Brukernavnet du bruker for å logge inn på SMTP-serveren din
- SMTP-passord: Passordet til SMTP-serveren din
- Bruk TLS: Aktiver dette hvis SMTP-serveren din krever TLS-kryptering (anbefales)
Lagre innstillingene dine

Når du har satt det opp, vil alle e-posttilbakemeldinger sendes via din e-postserver. Det gir deg en jevn profil og gjør at e-postene lettere når frem til kundene dine.