Du kan forberede forsendelser i Transsmart. Hovedforskjellen fra booking er at det er færre valideringer for en forberedt forsendelse. For eksempel, ved booking med en transportør er transportørkode og servicenivå påkrevde felter, men for en forberedt forsendelse er disse feltene ennå ikke obligatoriske. Dette betyr at du kan forberede en forsendelse først og senere fullføre den med all nødvendig informasjon før du booker, eller booker og skriver ut forsendelsen direkte.
Kallet til create en forberedt forsendelse i Transsmart:
POST request to /v2/shipments/{{account}}/CREATE to prepare a shipment (status NONE)
Mer informasjon: https://devdocs.transsmart.com/#_2_1_shipment_booking
Request body må inneholde minst en forsendelsesreferanse. For å fullføre en korrekt booking må du også oppgi tilleggsdetaljer som avsenders adresse, mottakers adresse, pakkeinformasjon og fraktdetaljer som carrier code, service level og pickup date.
[{
"reference": "{{reference}}"
}]
Du kan fortsette å sende denne CREATE-kallet for samme forsendelsesreferanse så mange ganger du trenger. Bare husk én viktig detalj: når vi prosesserer opprettelsen av forsendelsen, hvis vi finner en eksisterende forsendelse med samme referanse, sletter vi først den gamle forsendelsen og CREATE deretter en ny ved å bruke dataene du sender. Så hvis du ikke inkluderer alle feltene som allerede var en del av forsendelsen i systemet vårt, vil disse manglende feltene bli slettet.
Hvis du ikke har alle feltene som tidligere i flyten ble sendt inn av en applikasjon, er det derfor viktig at du først gjør et GET-kall for forsendelsen, for å GET alle feltene i den forberedte forsendelsen, lagre dem (midlertidig / i minnet), og sende hele forsendelsesbodyen med CREATE-kallet.
Kallet for å get alle felter i en forberedt forsendelse:
GET request to /v2/shipments/{{account}}/{{reference}}
Mer informasjon: https://devdocs.transsmart.com/#_single_shipment_retrieval
Du kan fortsette å gjøre dette kallet hver gang før du sender et nytt CREATE-kall. Når den forberedte forsendelsen er klar, kan du deretter booke eller booke og print ved å bruke ett av disse kallene:
POST request to /v2/shipments/{{account}}/BOOK to book a shipment (status NEW or BOOK)
or
POST request to /v2/shipments/{{account}}/PRINT to book a shipment and directly PRINT a label (status LABL)
Samme informasjon som CREATE-kallet, men da med action BOOK eller PRINT:
https://devdocs.transsmart.com/#_action_parameter
Viktig påminnelse! I vår prosess for opprettelse og booking av forsendelser, dersom vi oppdager en eksisterende shipment reference, vil vi slette den nåværende forsendelsen og create en ny ved å bruke den oppdaterte informasjonen du gir. Dette betyr at hvis du ikke inkluderer alle feltene som allerede var en del av forsendelsen i vårt system, vil disse feltene bli tømt.