Denne artikkelen forklarer hvordan du overfører data til dine transportører hvis du bruker Shipment Server API. Det er svært viktig å overføre EDI-filene dine. Hvis en transportør ikke har mottatt EDI-filene før de håndterer varene, må de kanskje håndtere det manuelt, og noen vil kreve et gebyr for dette.

Merk at noen transportører mottar data via en webtjeneste og ikke trenger å motta EDI-filer. Hvis du er usikker på om din transportør krever EDI-filer, vennligst kontakt transportøren eller kundeservice.

Les om hvordan du:

• Overfører alle forsendelser i en stack
• Overfører valgte forsendelser
   

Overfør alle forsendelser i en stack

Etter at en forsendelse er sendt inn, blir den plassert i en stack. En stack er en plassholder for forsendelser som er klare til å overføre EDI til transportøren. Svaret fra SubmitShipment vil inneholde en StackCSID som identifiserer stacken som forsendelsen er plassert i. StackCSID er nødvendig hvis du vil overføre alle forsendelsene innenfor en gitt stack til transportøren. Du kan også bruke metoden GetStacks for å hente StackCSID – se eksemplene nedenfor.

Metode:

TransmitStack

Eksempel på forespørsel:

{
  "StackCSID": 60
}

Forventet resultat:
Vellykket forespørsel:

{
  "Messages": [
    "Job successful"
  ],
  "BatchCSID": 23003
}

Vellykket forespørsel, timeout:

{
  "Messages": [
    "Transmit job started"
  ]
}

Hvordan hente StackCSID ved hjelp av GetStacks-metoden

GetStacks-metoden returnerer data om alle stacker sammen med data om transportøren som stacken tilhører. Når forsendelser sendes inn, blir de plassert i en stack på undertransportørnivå. StackCSID er alltid inkludert i svaret fra SubmitShipment, men ved å bruke GetStacks-metoden kan du hente den uten å sende inn flere forsendelser. 

 

Metode:

GetStacks

 

Forventet resultat:
Vellykket forespørsel:

{
  "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 angir hvor mange forsendelser den aktuelle stacken inneholder. Hvis en stack inneholder null forsendelser, kan du hoppe over denne ved overføring. I eksempelet ovenfor inneholder stacken med StackCSID 14014 9 forsendelser.

Overfør valgte forsendelser

Det er mulig å overføre valgte forsendelser ved å bruke metoden TransmitShipment. Denne metoden vil kun overføre de angitte forsendelsene. ShipmentCSIDs inneholder en kommaseparert liste med én eller flere ShpCSIDs som identifiserer forsendelsene som skal overføres. ShpCSID vises i svaret du får etter å ha sendt inn en forsendelse.

 

Metode:

TransmitShipments

 

Eksempel på forespørsel:

{
  "ShipmentCSIDs": [
    5436,
    5437
  ]
}

Forventet resultat:
Vellykket forespørsel:

{
  "Messages": [
    "Job successful"
  ],
  "BatchCSID": 123
}

Vellykket forespørsel, timeout:

{
  "Messages": [
    "Transmit job started"
  ]
}