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ä 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"
]
}