Du kan forberede forsendelser i Transsmart. Den primære forskel i forhold til booking er, at der er færre valideringer for en forberedt forsendelse. For eksempel, ved booking med en carrier, er carrier code og service level obligatoriske felter, men for en forberedt forsendelse er disse felter endnu ikke påkrævet. Det betyder, at du først kan forberede en forsendelse og senere færdiggøre den med alle de nødvendige oplysninger, før du booker, eller booker og printer forsendelsen direkte.
Kaldet til at create en forberedt forsendelse i Transsmart:
POST request til /v2/shipments/{{account}}/CREATE for at forberede en forsendelse (status NONE)
Mere information: https://devdocs.transsmart.com/#_2_1_shipment_booking
Request body skal som minimum indeholde en forsendelsesreference. For at gennemføre en korrekt booking skal du også angive yderligere oplysninger såsom afsenders adresse, modtagers adresse, pakkeinformation og forsendelsesdetaljer som carrier code, service level og afhentningsdato.
[{
"reference": "{{reference}}"
}]
Du kan fortsætte med at sende dette CREATE kald for den samme forsendelsesreference så mange gange, du har brug for. Vær blot opmærksom på én vigtig detalje: når vi behandler oprettelsen af forsendelsen, og vi finder en eksisterende forsendelse med samme reference, sletter vi først den gamle forsendelse og CREATE derefter en ny ved hjælp af de data, du sender. Så hvis du ikke medtager alle de felter, der allerede var en del af forsendelsen i vores system, vil disse manglende felter blive ryddet.
Hvis du ikke har alle de felter, der tidligere i flowet blev sendt ind af en applikation, er det derfor vigtigt, at du først laver et GET shipment kald for at GET alle felter for den forberedte forsendelse, gemme dem (midlertidigt / i hukommelsen) og sende den komplette shipment body med CREATE kaldet.
Kaldet til at get alle felter for en forberedt forsendelse:
GET request to /v2/shipments/{{account}}/{{reference}}
Mere information: https://devdocs.transsmart.com/#_single_shipment_retrieval
Du kan fortsætte med at lave dette kald hver gang, før du sender et nyt CREATE kald. Når den forberedte forsendelse er klar, kan du derefter booke eller booke og print ved at bruge et af disse kald:
POST request to /v2/shipments/{{account}}/BOOK to book a shipment (status NEW or BOOK)
eller
POST request to /v2/shipments/{{account}}/PRINT to book a shipment and directly PRINT a label (status LABL)
Samme information som CREATE-kaldet, men med action BOOK eller PRINT:
https://devdocs.transsmart.com/#_action_parameter
Vigtig påmindelse! I vores forsendelsesoprettelses- og bookingproces, hvis vi registrerer en eksisterende shipment reference, vil vi slette den aktuelle forsendelse og create en ny ved hjælp af de opdaterede oplysninger, du angiver. Det betyder, at hvis du ikke medtager alle de felter, der allerede var en del af forsendelsen i vores system, vil disse felter blive ryddet.