Den här artikeln förklarar hur du överför data till dina transportörer om du använder Shipment Server API. Det är mycket viktigt att överföra dina EDI-filer. Om en transportör inte har tagit emot EDI-filerna innan de hanterar varorna kan de behöva hantera det manuellt, och vissa tar ut en avgift för detta.

Observera att vissa transportörer tar emot data via en webbtjänst och inte behöver ta emot EDI-filer. Om du är osäker på om din transportör kräver EDI-filer, kontakta transportören eller kundtjänst.

Läs om hur du:

• Överför alla sändningar i en stack
• Överför valda sändningar
   

Överför alla sändningar i en stack

Efter att en sändning har skickats in placeras den i en stack. En stack är en platshållare för sändningar som är redo att överföra EDI till transportören. Svaret från SubmitShipment innehåller en StackCSID som identifierar den stack där sändningen har placerats. StackCSID behövs om du vill överföra alla sändningar inom en viss stack till transportören. Du kan också använda metoden GetStacks för att hämta StackCSID – se exemplen nedan.

Metod:

TransmitStack

Exempel på begäran:

{
  "StackCSID": 60
}

Förväntat resultat:
Lyckad begäran:

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

Lyckad begäran, timeout:

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

Hur du hämtar StackCSID med metoden GetStacks

Metoden GetStacks returnerar data om alla stackar tillsammans med data om transportören som stacken tillhör. När sändningar skickas in placeras de i en stack på undertransportörnivå. StackCSID ingår alltid i svaret från SubmitShipment, men genom att använda metoden GetStacks kan du hämta den utan att skicka in fler sändningar. 

 

Metod:

GetStacks

 

Förväntat resultat:
Lyckad begäran:

{
  "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 anger hur många sändningar den aktuella stacken innehåller. Om en stack innehåller noll sändningar kan du hoppa över den vid överföring. I exemplet ovan innehåller stacken med StackCSID 14014 9 sändningar.

Överför valda sändningar

Det är möjligt att överföra valda sändningar med metoden TransmitShipment. Denna metod överför endast de angivna sändningarna. ShipmentCSIDs innehåller en kommaseparerad lista med en eller flera ShpCSIDs som identifierar de sändningar som ska överföras. ShpCSID visas i svaret du får efter att ha skickat in en sändning.

 

Metod:

TransmitShipments

 

Exempel på begäran:

{
  "ShipmentCSIDs": [
    5436,
    5437
  ]
}

Förväntat resultat:
Lyckad begäran:

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

Lyckad begäran, timeout:

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