Streamade statusar erbjuder ett sätt att snabbt få information om statusändringar för dina försändelser. Du behöver inte hämta med ett getStatus-anrop; vi levererar data till dig via en strömmande push‑mekanism. Du kan prenumerera på händelser och när en uppdatering sker kommer vi att posta statusdata till den URL du anger i MyTranssmart i menyn Manage account > Streamed Statuses.
Första steget är att kontakta vår supportavdelning för att aktivera detta åt dig. Vi aktiverar det först i vår Accept‑miljö så att du kan konfigurera och testa integrationen. När detta är lyckat aktiverar vi det i Production.
Konfiguration
Säkerställ först att du har en autentiserad endpoint som kan ta emot statusuppdateringar.
Nästa steg är att aktivera och slutföra konfigurationen på inställningssidan.
- URL = din endpoint
- Authentication = välj mellan None, Header eller Basic beroende på hur du vill konfigurera det.
- Status push method = välj mellan Package level (standard) eller Shipment level. Se förklaring nedan
Viktig anmärkning: (läs även uppdateringen från december 2024 nedan)
I din mappning, säkerställ att du läser statusvärdet från fältet genericStatusCode i shipmentLines och inte från shipmentStatus i shipment header. Anledningen är att vi för vissa transportörer inte får statusuppdateringen på shipment header‑nivå och genom en algoritm ändrar vi status på shipment header‑nivå efter att ha kontrollerat status per shipment line.
Exempel:
En försändelse har 3 rader:
Rad 1: package med status DONE
Rad 2: package med status TRNS
Rad 3: package med status TRNS
Shipment header‑statusen är TRNS
Vi tar emot statusuppdateringen för paketrad 2, som ändras till DONE. Eftersom det fortfarande finns ett paket med status TRNS på rad 3, ändrar inte algoritmen status för leveranshuvudet, så det förblir TRNS.
Vi tar emot statusuppdateringen för paketrad 3, som ändras till DONE. Eftersom det inte finns fler paket med status TRNS, ändrar algoritmen status för leveranshuvudet till DONE. Men vid den tidpunkt då vi tog emot statusuppdateringen hade vi redan skickat statusmeddelandet till din endpoint. Vid det tillfället var fältet shipmentStatus i huvudet fortfarande TRNS, medan genericStatusCode i shipmentLine hade status DONE. Om du skulle mappa mot leveranshuvudets status kommer leveransen därför att ligga kvar på TRNS i ditt system i stället för att ändras till DONE. Därför är det viktigt att mappa mot statusvärdet från fältet genericStatusCode i shipmentLines.
Uppdatering: i december 2024 lade vi till en inställning för att avgöra om meddelandet vi pushar ska triggas av paketraderna eller av försändelsehuvudet.
Standardinställningen är fortfarande per paketrad. Om du vill ändra det till försändelsehuvud, ändra inställningen. Du kommer att behöva göra detta om du inte kan mappa till fältet genericStatusCode i shipmentLines.
Den nya inställningen finns på konfigurationssidan under Manage account > Streamed Statuses
Meddelandformat
Payloaden som skickas i statusnotifieringen är densamma som svaret på status retrieval-förfrågningar, kapitel 5.1 i våra DevDocs: https://devdocs.transsmart.com/#_5_2_status_stream
isIncremental
Parametern isIncremental som används i Status Retrieval API endpoints påverkas inte av de meddelanden som pushas av vårt system. Om du fortfarande vill hämta statusförfrågningar till ditt eget system, eller kanske ett andra system, är det fortfarande möjligt.
Subkonton
Om du har en konfiguration med ett huvudkonto och ett eller flera subkonton beror det på endpoint-konfigurationen hur detta ska ställas in. Om du har en endpoint där du vill ta emot alla statusmeddelanden för alla konton räcker det att bara konfigurera den på huvudkontot. Inställningen kommer automatiskt att ärvas av alla subkonton.
Om du har en annan endpoint per subkonto kan du konfigurera det per subkonto.