Tämän artikkelin sisältö:
Mikä on TimeSlots
Yhä useammat loppuasiakkaat odottavat voivansa valita useiden toimitusvaihtoehtojen välillä, ja mahdollisuus valita tietty toimitusaikaväli on jotain, mitä jotkut kuljetusyritykset alkavat tarjota.
nShiftissä olemme kehittäneet ratkaisun, joka tukee aikavälien varaamista. Sen avulla voit näyttää verkkokaupassasi aikavälejä tukevat tuotteet ja antaa loppuasiakkaan valita itselleen sopivan aikavälin.
Aikavälipalvelut vaihtelevat kuljetusyrityksittäin. Niitä voidaan käyttää toimitukseen tai noutoon, ja jotkut kuljetusyritykset veloittavat näiden palveluiden käytöstä lisämaksuja. Kysy lisätietoja kuljetusyritykseltäsi.
Huomautus: Tällä hetkellä (syyskuu 2020) tuemme Airmee- ja Porterbuddy-aikavälipalveluita. Lisää on kehitteillä.
Miten se toimii
Riippuen siitä, mitä haluat tehdä, menetelmät tulee suorittaa tietyssä järjestyksessä:
Jos haluat luoda toimituksen
1. GetShipAdvise
Poimi valitusta tuotteesta Token ja TimeSlotToken
Katso esimerkki täältä tai dokumentaatiosta
2. AllocateTimeSlot
Lisää Token ja TimeSlotToken pyyntöobjektin options-kohteeseen.
Poimi vastauksesta AllocatedTimeSlotToken
Katso esimerkki täältä tai dokumentaatiosta
3. SubmitShipment
Lisää Token ja AllocatedTimeSlotToken pyyntöobjektin options-kohteeseen
Katso esimerkki täältä tai dokumentaatiosta
4. TransmitShipment
Katso tämä artikkeli tai dokumentaatio
Jos haluat peruuttaa toimituksen
1. DeleteShipment
Katso dokumentaatio
2. VoidTimeSlot
Lisää AllocatedTimeSlotToken pyyntöobjektin options-kohteeseen.
Katso esimerkki täältä tai dokumentaatiosta
Pyyntöesimerkkejä
Huomautus: Shipment Server odottaa pyyntöjen olevan koodattuja muodossa form-data tai x-www-form-urlencoded
...
GetShipAdvise - Pyyntörunko
{
"data": {
"Kind": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "Test Name1",
"Street1": "Test Address 1",
"PostCode": "11825",
"City": "Stockholm",
"Phone": "004612341234",
"Mobile": "004612341234",
"Email": "noreply@nshift.com",
"Attention": "Test Attention",
"CountryCode": "SE"
}
],
"Lines": [
{
"Number": 1,
"PkgWeight": 1000,
"Height": 100,
"Length": 100,
"Width": 100,
"References": [
{
"Kind": 23,
"Value": "Test Content"
}
]
}
]
},
"options": {
"ServiceLevel": "default",
"EarliestPickup": "2020-09-22T06:00",
"LatestPickup": "2020-09-22T21:00",
"PickupWindowCount": 1,
"TimeSlots": 1,
"TimeLog": 1
},
"key": "sample",
"actor": "134",
"command": "GetShipAdvise"
}Vastausrunko
{
"Products": [
{
"ProdConceptID": 5599,
"ProdCSID": 1632,
"ProdName": "Airmee - Airmee",
"Token": "_-1_0_1603_5799_1632_5599_0_0__0__30/12/1899_30/12/1899___",
"SupportsDropPoint": 0,
"TimeSlots": [
{
"Start": "2020-09-11T17:00:00",
"End": "2020-09-11T22:00:00",
"TimeSlotToken": "eyJzdGFydCI6IjIwMjAtMDktMTFUMTc6MD...",
"Expires": ""
}
]
},
{
"ProdConceptID": 675,
"ProdCSID": 1029,
"ProdName": "UPS - UPS Standard®",
"Services": [
{
"serviceid": 60041,
"name": "Delivery to UPS Access Point"
}
],
"Token": "60041_2_0_1603_5799_1029_675_0_0__0__30/12/1899_30/12/1899___",
"SupportsDropPoint": 1
}
],
"Log": []
],
"Status": 8,
"CSRMessage": "Success : List of valid products returned",
"TimeLog": []
}...
AllocateTimeSlot - Pyyntörunko
{
"data": {},
"options": {
"TimeSlotToken": "eyJzdGFydCI6IjIwMjAtMDktMTFUM...",
"Token": "_-1_0_1603_5799_1632_5599_0_0__0__30/12/1899_30/12/1899___"
},
"key": "sample",
"actor": "134",
"command": "AllocateTimeSlot"
}Vastausrunko
{
"Result": "Success",
"AllocatedTimeSlotToken": "YXRzdDtmZjIxYTlkMi1mM2ZhLTExZWEtYjY3...",
"Information": ""
}...
SubmitShipment - Pyyntörunko
{
"data": {
"Kind": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "Test Name1",
"Street1": "Test Address 1",
"PostCode": "11825",
"City": "Stockholm",
"Phone": "004612341234",
"Mobile": "004612341234",
"Email": "noreply@nshift.com",
"Attention": "Test Attention",
"CountryCode": "SE"
}
],
"Lines": [
{
"PkgWeight": 1000,
"Height": 100,
"Length": 100,
"Width": 100,
"Number": 1,
"References": [
{
"Kind": 23,
"Value": "Test Content"
}
]
}
]
},
"options": {
"AllocatedTimeSlotToken": "YXRzdDtmZjIxYTlkMi1mM2ZhLTExZWEtYjY3N...",
"Labels": "ZPLGK",
"Token": "_-1_0_1603_5799_1632_5599_0_0__0__30/12/1899_30/12/1899___"
},
"key": "sample",
"actor": "134",
"command": "SubmitShipment"
}Vastausrunko
{
"ShpCSID": 5238,
"ShpESID": ...,
"ShpTag": "...",
"InstallationID": "...",
"Kind": 1,
"ShpNo": "...",
"PickupDt": "2020-09-11T00:00:00",
"LabelPrintDt": "2020-09-11T08:58:54",
"SubmitDt": "2020-09-11T08:58:55",
"Weight": 1000,
"ActorCSID": 134,
"Temperature": 1,
"CarriagePayer": 1,
"CarrierConceptID": 658,
"CarrierCSID": 75,
"SubcarrierConceptID": 1388,
"SubcarrierCSID": 275,
"ProdConceptID": 5599,
"ProdCSID": 1632,
"StackCSID": 294,
"Addresses": [
{
"Kind": 1,
"Name1": "Test Name1",
"Street1": "Test Address 1",
"PostCode": "11825",
"City": "Stockholm",
"Phone": "004612341234",
"Mobile": "004612341234",
"Email": "noreply@nshift.com",
"Attention": "Test Attention",
"CountryCode": "SE"
},
{
"Kind": 2,
"Name1": "Test Name1",
"Street1": "Test Address 1",
"PostCode": "11825",
"City": "Stockholm",
"Phone": "004612345678",
"Mobile": "004612345678",
"Email": "noreply@nshift.com",
"Attention": "Test Sender Attention",
"CountryCode": "SE"
}
],
"Amounts": [...],
"References": [...],
"Messages": [...],
"CSEvents": [...],
"Lines": [
{
"LineCSID": 5937,
"LineTag": "A6DE8AB7-292E-4CAA-B5AC-6C8B5F374E32",
"LineWeight": 1000,
"PkgWeight": 1000,
"Height": 100,
"Length": 100,
"Width": 100,
"Pkgs": [...]
}
],
"References": [...]
}
],
"Labels": [
{
"Content": "....",
"Type": 13,
"Copies": 1,
"PkgCSID": 8886,
"PkgNo": "..."
}
]
}...
VoidTimeSlot - Pyyntörunko
{
"data": {},
"options": {
"AllocatedTimeSlotToken": "YXRzdDtmZjIxYTlkMi1mM2ZhLTExZWEtYjY3N..."
},
"key": "sample",
"actor": "134",
"command": "VoidTimeSlot"
}Vastausrunko
{
"Result": "Success",
"Information": ""
}
Usein kysytyt kysymykset
-
Teekö SubmitShipment-kutsussa käytetty AllocatedTimeSlotToken muuta kuin päivittää toimituspäivän kenttiä lähetyksessä?
Riippuu kuljetusyrityksestä
- -
Vanheneeko TimeSlotToken?
Riippuu kuljetusyrityksestä
- -
Maksako asiakas aikavälin varaamisesta?
Riippuu kuljetusyrityksestä
-
-
Aktivoituuko AllocatedTimeSlot vain, kun teen SubmitShipment-kutsun sen kanssa?
Ei, sen pitäisi aktivoitua jo AllocateTimeSlot-metodia kutsuttaessa
- -
Mitä tapahtuu, jos varaat aikavälin, mutta et koskaan kutsu VoidTimeSlot-metodia, vaikka et enää tarvitse sitä?
Riippuu kuljetusyrityksestä
- -
Miten tiedän, kuinka monta aikaväliä olen varannut?
Asiakasohjelman tulee pitää kirjaa
- -
Jos olet käyttänyt AllocatedTimeSlotTokenia SubmitShipment-kutsussa, kutsuuko DeleteShipment-metodi VoidTimeSlot-metodia vai tarvitsemmeko tehdä tämän erikseen?
Riippuu kuljetusyrityksen toteutuksesta.