Du kan förbereda försändelser i Transsmart. Den största skillnaden jämfört med bokning är att det görs färre valideringar för en förberedd försändelse. Till exempel, vid bokning med en transportör är carrier code och service level obligatoriska fält, men för en förberedd försändelse är dessa fält ännu inte obligatoriska. Detta innebär att du först kan förbereda en försändelse och senare komplettera den med all nödvändig information innan du bokar, eller boka och skriva ut försändelsen direkt.

Anropet för att skapa en förberedd försändelse i Transsmart:

POST-anrop till /v2/shipments/{{account}}/CREATE för att förbereda en försändelse (status NONE)

Mer information: https://devdocs.transsmart.com/#_2_1_shipment_booking

Request body ska åtminstone innehålla en shipment reference. För att genomföra en korrekt bokning behöver du också ange ytterligare uppgifter, till exempel avsändarens adress, mottagarens adress, paketinformation och fraktuppgifter som carrier code, service level och pickup date.

[{
    "reference": "{{reference}}"
}]

Du kan fortsätta att skicka detta CREATE-anrop för samma shipment reference så många gånger du behöver. Tänk bara på en viktig detalj: när vi behandlar skapandet av shipment, om vi hittar en befintlig shipment med samma reference, tar vi först bort den gamla shipment och skapar sedan en ny med hjälp av den data du skickar. Om du därför inte inkluderar alla fält som redan var en del av shipment i vårt system, kommer de saknade fälten att tas bort.

Om du inte har alla fält som skickades in av en applikation tidigare i flödet är det viktigt att du först gör ett GET shipment-anrop för att hämta alla fält för den förberedda shipment, lagra dem (tillfälligt / i minnet) och skicka hela shipment body med CREATE-anropet.

Anropet för att hämta alla fält för en förberedd shipment:

GET request till /v2/shipments/{{account}}/{{reference}}

Mer information: https://devdocs.transsmart.com/#_single_shipment_retrieval

Du kan fortsätta att göra det anropet varje gång innan du skickar ett nytt CREATE-anrop. När den förberedda shipment är klar kan du sedan boka eller boka och skriva ut genom att använda ett av följande anrop:

POST request till /v2/shipments/{{account}}/BOOK för att boka en shipment (status NEW eller BOOK)

eller 

POST request till /v2/shipments/{{account}}/PRINT för att boka en shipment och direkt skriva ut en etikett (status LABL)

Samma information som vid CREATE-anropet, men då med action BOOK eller PRINT:

https://devdocs.transsmart.com/#_action_parameter

Important reminder! I vår process för skapande och bokning av shipment, om vi upptäcker en befintlig shipment reference kommer vi att radera den nuvarande shipment och skapa en ny med hjälp av den uppdaterade information du tillhandahåller. Detta innebär att om du inte inkluderar alla fält som redan ingick i shipment i vårt system, kommer dessa fält att rensas.