Tässä artikkelissa kerrotaan, miten voit lähettää tietoja kuljetusliikkeille, jos käytät Shipment Server APIa. On erittäin tärkeää lähettää EDI-tiedostot. Jos kuljetusliike ei ole vastaanottanut EDI-tiedostoja ennen tavaroiden käsittelyä, ne saatetaan joutua käsittelemään manuaalisesti, ja jotkut veloittavat tästä maksun.

Huomaa, että jotkut kuljetusliikkeet vastaanottavat tiedot web-palvelun kautta eivätkä tarvitse EDI-tiedostoja. Jos et ole varma, vaatiiko kuljetusliikkeesi EDI-tiedostoja, ota yhteyttä kuljetusliikkeeseen tai asiakaspalveluun.

Lue, miten:

• Lähetät kaikki lähetykset yhdessä stackissa
• Lähetät valitut lähetykset
   

Lähetä kaikki lähetykset yhdessä stackissa

Lähetyksen lähettämisen jälkeen se sijoitetaan stackiin. Stack on väliaikainen säilytyspaikka lähetyksille, jotka ovat valmiita EDI:n lähettämiseen kuljetusliikkeelle. SubmitShipment-vastauksessa on mukana StackCSID, joka tunnistaa stackin, johon lähetys on sijoitettu. StackCSID tarvitaan, jos haluat lähettää kaikki tietyn stackin lähetykset kuljetusliikkeelle. Voit myös käyttää GetStacks-menetelmää hakeaksesi StackCSID-tunnuksen – katso esimerkit alla.

Menetelmä:

TransmitStack

Esimerkkipyyntö:

{
  "StackCSID": 60
}

Odotettu tulos:
Onnistunut pyyntö:

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

Onnistunut pyyntö, aikakatkaisu:

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

Kuinka hakea StackCSID käyttämällä GetStacks-menetelmää

GetStacks-menetelmä palauttaa tiedot kaikista stackeista sekä tiedot kuljetusliikkeestä, johon stack kuuluu. Kun lähetyksiä lähetetään, ne sijoitetaan stackiin alikuljetusliiketasolla. StackCSID sisältyy aina SubmitShipment-vastaukseen, mutta GetStacks-menetelmällä voit hakea sen ilman uusien lähetysten lähettämistä. 

 

Menetelmä:

GetStacks

 

Odotettu tulos:
Onnistunut pyyntö:

{
  "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 vastauksessa kertoo, kuinka monta lähetystä kyseinen stack sisältää. Jos stack sisältää nolla lähetystä, voit ohittaa sen lähetyksessä. Yllä olevassa esimerkissä stack, jonka StackCSID on 14014, sisältää 9 lähetystä.

Lähetä valitut lähetykset

Valittuja lähetyksiä on mahdollista lähettää käyttämällä TransmitShipment-menetelmää. Tämä menetelmä lähettää vain määritellyt lähetykset. ShipmentCSIDs sisältää pilkuilla erotetun listan yhdestä tai useammasta ShpCSIDs-tunnuksesta, jotka tunnistavat lähetettävät lähetykset. ShpCSID näkyy vastauksessa, jonka saat lähetyksen lähettämisen jälkeen.

 

Menetelmä:

TransmitShipments

 

Esimerkkipyyntö:

{
  "ShipmentCSIDs": [
    5436,
    5437
  ]
}

Odotettu tulos:
Onnistunut pyyntö:

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

Onnistunut pyyntö, aikakatkaisu:

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