Dit artikel legt uit hoe je gegevens naar je vervoerders kunt verzenden als je de Shipment Server API gebruikt. Het is zeer belangrijk om je EDI-bestanden te verzenden. Als een vervoerder de EDI-bestanden niet heeft ontvangen voordat zij de goederen verwerken, moeten ze dit mogelijk handmatig afhandelen en sommige brengen hiervoor kosten in rekening.

Houd er rekening mee dat sommige vervoerders gegevens via een webservice ontvangen en geen EDI-bestanden hoeven te ontvangen. Als je niet zeker weet of jouw vervoerder EDI-bestanden vereist, neem dan contact op met de vervoerder of de klantenservice.

Lees hoe je:

• Alle zendingen in een stack verzenden
• Geselecteerde zendingen verzenden
   

Alle zendingen in een stack verzenden

Na het indienen van een zending wordt deze in een stack geplaatst. Een stack is een tijdelijke opslag voor zendingen die klaar zijn om EDI naar de vervoerder te verzenden. Het antwoord van SubmitShipment bevat een StackCSID die de stack identificeert waarin de zending is geplaatst. De StackCSID is nodig als je alle zendingen binnen een bepaalde stack naar de vervoerder wilt verzenden. Je kunt ook de methode GetStacks gebruiken om de StackCSID op te halen - zie de voorbeelden hieronder.

Methode:

TransmitStack

Voorbeeld van aanvraag:

{
  "StackCSID": 60
}

Verwachte output:
Succesvolle aanvraag:

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

Succesvolle aanvraag, time-out:

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

Hoe je de StackCSID ophaalt met de GetStacks-methode

De GetStacks-methode retourneert gegevens over alle stacks samen met gegevens over de vervoerder waartoe de stack behoort. Wanneer zendingen worden ingediend, worden ze op subcarrier-niveau in een stack geplaatst. De StackCSID wordt altijd opgenomen in het antwoord van SubmitShipment, maar met de methode GetStacks kun je deze ophalen zonder meer zendingen in te dienen. 

 

Methode:

GetStacks

 

Verwachte output:
Succesvolle aanvraag:

{
  "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 in het antwoord geeft aan hoeveel zendingen de betreffende stack bevat. Als een stack nul zendingen bevat, kun je deze overslaan bij het verzenden. In het bovenstaande voorbeeld bevat de stack met de StackCSID 14014 9 zendingen.

Geselecteerde zendingen verzenden

Het is mogelijk om geselecteerde zendingen te verzenden met de methode TransmitShipment. Deze methode verzendt alleen de opgegeven zending(en). ShipmentCSIDs bevat een door komma’s gescheiden lijst van een of meer ShpCSIDs die de zendingen identificeren die moeten worden verzonden. De ShpCSID verschijnt in het antwoord dat je ontvangt na het indienen van een zending.

 

Methode:

TransmitShipments

 

Voorbeeld van aanvraag:

{
  "ShipmentCSIDs": [
    5436,
    5437
  ]
}

Verwachte output:
Succesvolle aanvraag:

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

Succesvolle aanvraag, time-out:

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