Postbacks är automatiska aviseringar som skickas från GelatoConnect till externa system så fort en orderstatus ändras. De är superviktiga för att tryckerier (PSP:er) och kunder ska kunna hålla koll på sina beställningar direkt, utan att behöva uppdatera något själva.
Postbacks gör att du kan:
Meddela kunder automatiskt när deras orderstatus ändras, till exempel när den är mottagen, skickad eller levererad.
Ge ditt team en heads up om ordrar som behöver extra kärlek (misslyckade ordrar).
Uppdatera dina lagersystem när beställningarna är klara.
Följ orderns framsteg genom hela din produktionsprocess.
Dessa meddelanden kan levereras via webhooks (URL) eller e-post, beroende på dina integrationsbehov.
Förutsättningar för att konfigurera postbacks
Innan du skapar postbacks, se till att du har:
Kunder som får notiser ställs in i kundsektionen i GelatoConnect.
URL-slutpunkter är redo att ta emot webhook-data (om du använder URL-leveransmetoden).
En grundläggande förståelse för mallar och utlösare.
Förtrogenhet med orderstatusflödet i GelatoConnect.
Enkel guide: Så sätter du upp postbacks steg för steg
1. Skapa en postback-mall
Mallar bestämmer hur dina postback-notiser ser ut och vad de innehåller. Du kan skapa dem på två sätt:
Alternativ A: Via mallsektionen
Gå till Workflow > Order Intake > Mallar
Klicka på Lägg till mall
Välj malltyp:
Trigger: Webhook – För att skicka JSON- eller XML-data till externa system
Trigger: Email – För att skicka e-postnotiser
Välj lämpligt format (JSON eller XML)
Alternativ B: Via kundprofilen
Gå till din kunds profil
Gå till fliken Triggers och klicka på Lägg till trigger
Du kan skapa mallen direkt när du sätter upp triggern
För en utförlig guide om hur du skapar mallar, kolla in Skapa mallar för orderintag.
2. Ställ in en trigger
Triggers bestämmer när postbacks skickas och vart de levereras:
Ge din trigger ett beskrivande namn (t.ex. "Order skickad-notis")
Välj händelsen som ska sätta igång triggern:
Beställning mottagen
Beställningen misslyckades
Beställning annullerad
Beställningen returnerad
Beställning producerad
Beställning levererad
Beställningen skickad
Beställning under transport
Välj din leveransmetod:
URL (webhook): Skickar data till en specifik slutpunkt
E-post: Skickar aviseringar via e-post
För leverans via URL, ställ in så här:
Webbadressen dit vi skickar dina notiser
Ställ in metoden till POST (rekommenderas)
Du kan välja JSON eller XML som dataformat
Aktivera \"Försök igen vid fel\" för tillförlitlighet
För e-postleverans, ställ in mottagarens e-postadress.
3. Lägg till en mall
Din mall gör om GelatoConnects interna data till ett format som funkar för dig och dina kunders system.
Om du redan har skapat en mall kan du välja den när du ställer in triggern, annars behöver du skapa en ny.
Ge din mall ett tydligt namn (t.ex. "OrderShippedNotification")
Använd de exempel-payloads som finns för den händelsetyp du har valt
Matcha dina indatafält med det format du vill ha med hjälp av Template Mapper
Exempelmall för "Order Shipped"-händelse:
{ "event": "Beställning skickad", "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 %} }}Klicka på "Render"-knappen för att se hur ditt resultat kommer att se ut
Testa mallen för att se till att den ger det resultat du vill ha
För fler exempel på mallar, kolla in exempel på Template Mapper.
4. Testa och aktivera
Innan du kör igång med din postback, testa gärna några gånger så att allt funkar som det ska. Sen kan du ändra status på din trigger och mall till aktiv.
När du har slutfört dessa steg kommer systemet att skicka en postback till den angivna URL:en eller e-postadressen med relevant orderinformation varje gång den specificerade orderhändelsen inträffar.
Smarta sätt att jobba med postback
Så använder du lookups i dina mallar
Uppslagningar är användbara för att koppla interna värden till kundvänliga format:
{% set carrier = lookups({\"shipmentMethodUid\": fulfillment.carrierUid}, strict=False, default=\"\") %}"carrier": "##{{ carrier }}"Detta konverterar interna GelatoConnect-koder till mer meningsfulla värden för dina kunder. Läs mer i Hur du konfigurerar uppslagningar.
Händelsespecifika datafält
Olika händelser ger olika typer av data. Här är de viktigaste fälten du hittar vid vanliga händelser:
Order skickad/levererad: spårningskoder, fraktbolag, leveransdatum
Beställning misslyckades/avbröts: felorsaker, tidsstämplar
Beställning mottagen: detaljer om beställningen, information om varan
För att få full koll på dessa fält, kolla in Introduktion till Template Mappers i GelatoConnect.
Felsökning av postbacks
Om dina postbacks inte funkar som de ska:
Dubbelkolla att destinationens URL är rätt och går att nå
Kontrollera mallsyntaxen för fel
Dubbelkolla att triggern är rätt inställd för det aktuella eventet
Kolla om det finns felaktiga datatyper eller saknade fält
Testa mallen med exempeldata innan du aktiverar den
Just för e-poståterkopplingar:
Dubbelkolla att dina SMTP-serveruppgifter stämmer (om du har ställt in det)
Kolla att avsändarens e-postadress är rätt formaterad
Se till att din SMTP-server tillåter anslutning från GelatoConnect
Kolla så att inloggningsuppgifterna (användarnamn/lösenord) stämmer
För fler smarta tips om hur du löser problem, kika på avsnittet "Felsökning" i Skapa mallar för orderintag.
Så här ställer du in din e-postserver för postbacks
Som printleverantör kan du ställa in GelatoConnect så att e-postmeddelanden skickas via din egen e-postserver. Då ser mottagarna att mejlen kommer från din domän istället för från GelatoConnect, vilket hjälper dig att hålla din varumärkesprofil konsekvent.
Så här ställer du in dina e-postserverinställningar:
Gå till avsnittet Workflow i sidomenyn till vänster
Hitta avsnittet Konfiguration och välj Arbetsinställningar
Hitta avsnittet Inställningar för utgående e-postserver
Fyll i följande uppgifter:
Avsändarens e-postadress: E-postadressen som visas i fältet "Från"
Avsändarnamn: Namnet som visas tillsammans med e-postadressen
SMTP-server: Din e-postserveradress (t.ex. smtp.yourcompany.com)
SMTP-port: Porten som din e-postserver använder (oftast 587 eller 465)
SMTP-användarnamn: Användarnamnet du använder för att logga in på din SMTP-server
SMTP-lösenord: Lösenordet för din SMTP-server
Använd TLS: Slå på det här om din SMTP-server kräver TLS-kryptering (rekommenderas)
Spara din inställning
När du har ställt in det skickas alla e-postmeddelanden via din e-postserver. Det ger en enhetlig känsla för ditt varumärke och ökar chansen att dina kunder får mejlen.
Vad händer nu?
När du har ställt in dina postbacks:
Håll koll på om leveransen lyckats på sidan för förfrågningar under orderintag.
Dubbelkolla med dina kunder att de får sina aviseringar som de ska
Genom att införa ett pålitligt postback-system ger du dina kunder en smidigare upplevelse med uppdateringar om deras beställningar i realtid – och slipper allt onödigt manuellt krångel.