Je kunt zendingen voorbereiden in Transsmart. Het belangrijkste verschil met boeken is dat er minder validaties zijn voor een voorbereide zending. Wanneer je bijvoorbeeld boekt bij een vervoerder, zijn de carrier code en service level verplichte velden, maar voor een voorbereide zending zijn deze velden nog niet verplicht. Dit betekent dat je een zending eerst kunt voorbereiden en later kunt aanvullen met alle vereiste informatie, voordat je boekt of de zending direct boekt en afdrukt.
De call om create een voorbereide zending in Transsmart:
POST request naar /v2/shipments/{{account}}/CREATE om een zending voor te bereiden (status NONE)
Meer informatie: https://devdocs.transsmart.com/#_2_1_shipment_booking
De request body moet ten minste een zendreferentie bevatten. Om een correcte booking te voltooien, moet je ook extra gegevens aanleveren, zoals het adres van de afzender, het adres van de ontvanger, pakketinformatie en verzenddetails zoals carrier code, service level en ophaaldatum.
[{
"reference": "{{reference}}"
}]
U kunt deze CREATE call voor dezelfde zendingreferentie zo vaak als nodig blijven versturen. Houd alleen één belangrijk detail in gedachten: wanneer wij de zendingaanmaak verwerken en we vinden een bestaande zending met dezelfde referentie, dan verwijderen we eerst de oude zending en CREATE vervolgens een nieuwe met de gegevens die u verstuurt. Dus als u niet alle velden opneemt die al onderdeel waren van de zending in ons systeem, worden die ontbrekende velden leeggemaakt.
Als u niet alle velden hebt die eerder in de flow door een applicatie zijn verstuurd, is het belangrijk dat u eerst een GET shipment call uitvoert om alle velden van de voorbereide zending te GET, deze op te slaan (tijdelijk / in het geheugen) en vervolgens de volledige shipment body mee te sturen met de CREATE call.
De call om alle velden van een voorbereide zending te get:
GET request to /v2/shipments/{{account}}/{{reference}}
Meer informatie: https://devdocs.transsmart.com/#_single_shipment_retrieval
U kunt deze call telkens opnieuw uitvoeren vóórdat u een nieuwe CREATE call verstuurt. Zodra de voorbereide zending gereed is, kunt u boeken of boeken en print met een van deze calls:
POST request to /v2/shipments/{{account}}/BOOK to book a shipment (status NEW or BOOK)
of
POST request to /v2/shipments/{{account}}/PRINT to book a shipment and directly PRINT a label (status LABL)
Dezelfde informatie als de CREATE call, maar dan met action BOOK of PRINT:
https://devdocs.transsmart.com/#_action_parameter
Belangrijke herinnering! In ons proces voor het aanmaken en boeken van zendingen, als we een bestaande zendingreferentie detecteren, zullen we de huidige zending verwijderen en een nieuwe create met de bijgewerkte informatie die je aanlevert. Dit betekent dat als je niet alle velden opneemt die al onderdeel waren van de zending in ons systeem, deze velden zullen worden leeggemaakt.