Denne artikel forklarer, hvordan du overfører data til dine transportører, hvis du bruger Shipment Server API. Det er meget vigtigt at overføre dine EDI-filer. Hvis en transportør ikke har modtaget EDI-filerne, før de håndterer varerne, kan de blive nødt til at behandle dem manuelt, og nogle vil opkræve et gebyr for dette.
Bemærk, at nogle transportører modtager data via en webservice og ikke behøver at modtage EDI-filer. Hvis du er i tvivl om, hvorvidt din transportør kræver EDI-filer, bedes du kontakte transportøren eller kundeservice.
Læs om, hvordan du:
Overfør alle forsendelser i en stack
Efter afsendelse af en forsendelse placeres den i en stack. En stack fungerer som en plads til forsendelser, der er klar til overførsel af EDI til transportøren. Svaret fra SubmitShipment indeholder en StackCSID, som identificerer den stack, forsendelsen er placeret i. StackCSID er nødvendig, hvis du vil overføre alle forsendelser i en given stack til transportøren. Du kan også bruge metoden GetStacks til at hente StackCSID – se eksemplerne nedenfor.
Metode:
TransmitStack
Eksempel på forespørgsel:
{ "StackCSID": 60 }
Forventet output:
Gennemført forespørgsel:
{ "Messages": [ "Job successful" ], "BatchCSID": 23003 }
Gennemført forespørgsel, timeout:
{ "Messages": [ "Transmit job started" ] }
Sådan henter du StackCSID ved hjælp af GetStacks-metoden
Metoden GetStacks returnerer data om alle stacks sammen med data om den transportør, som stacken tilhører. Når forsendelser sendes, placeres de i en stack på subcarrier-niveau. StackCSID er altid inkluderet i svaret fra SubmitShipment, men ved at bruge metoden GetStacks kan du hente den uden at indsende flere forsendelser.
Metode:
GetStacks
Forventet output:
Gennemført forespørgsel:
{ "Carriers": [ { "CarrierCSID": "216", "CarrierConceptID": "221", "CarrierShortName": "DHL", "CarrierFullName": "DHL Express", "Subcarriers": [ { "SubcarrierCSID": "431", "SubcarrierConceptID": "434", "SubcarrierName": "DHL Express", "Stacks": [ { "StackCSID": "14014", "StackName": "Stack 1", "StackCount": "9" } ] } ] } ] } StackCount i svaret angiver, hvor mange forsendelser den tilsvarende stack indeholder. Hvis en stack indeholder nul forsendelser, kan du springe den over ved overførsel. I eksemplet ovenfor indeholder stacken med StackCSID 14014 9 forsendelser.
Overfør udvalgte forsendelser
Det er muligt at overføre udvalgte forsendelser ved hjælp af metoden TransmitShipment. Denne metode overfører kun de angivne forsendelser. ShipmentCSIDs indeholder en kommasepareret liste med en eller flere ShpCSIDs, som identificerer de forsendelser, der skal overføres. ShpCSID vises i svaret, du modtager efter afsendelse af en forsendelse.
Metode:
TransmitShipments
Eksempel på forespørgsel:
{ "ShipmentCSIDs": [ 5436, 5437 ] }
Forventet output:
Gennemført forespørgsel:
{ "Messages": [ "Job successful" ], "BatchCSID": 123 }
Gennemført forespørgsel, timeout:
{ "Messages": [ "Transmit job started" ] }