Kirjaudu sisään
nShift Help Center

Delivery Checkout ja nShift Ship

Avatar
Malene Tidemann
Päivitetty

Delivery-checkout-label.png


Tässä artikkelissa selitetään, miten Delivery Checkoutin määritykset eroavat vakiomäärityksistä, kun sitä käytetään nShift Shipin kanssa. 

Tämän artikkelin osiot:

 

Luo Delivery Checkout käytettäväksi nShift Shipin kanssa

Jos Delivery Checkout on sinulle uusi, suosittelemme aloittamaan lukemalla nämä artikkelit:


Varmista ennen määrityksen aloittamista, että osoitekirjassasi on vähintään yksi lähettäjä. Katso lisätietoja kohdasta Osoitekirja – nShift Delivery Help Center


Sinun on myös syötettävä nShift Shipin Actor ID ja Key Ship details -osioon nShift Deliveryn Sender-kohdassa:

  1. Siirry kohtaan Maintenance > Senders.
     
  2. Hae lähettäjäsi tai lisää uusi lähettäjä.
     
  3. Syötä Actor ID ja Key Ship details -osioon.

    ship-checkout.png

Seuraa seuraavaksi tässä artikkelissa kuvattuja ohjeita: Luo Delivery Checkout

 

Katso myös muut artikkelimme aiheista

 

Delivery Checkoutin työnkulku nShift Shipin kanssa:

Checkout-Ship.png

 

 

Varaa ja tulosta nShift Shipillä

Voit varata ja tulostaa lähetyksiä Shipillä API:n tai tiedostotuonnin kautta.

 

API:n kautta

Kun varaat ja tulostat lähetyksiä Shipment Server API:n kautta, käytä prepare ID -tunnusta OrderId-viitteenä suorittaaksesi SubmitShipment-toiminnon.

Kun suoritat SubmitShipment-toiminnon, sinun on lisättävä puuttuvat pakolliset lähetystiedot, kuten paketin tiedot.

Lue lisää aiheesta StoreOrderin käyttäminen tilausten tallentamiseen tuontia varten

 

Tiedoston tuonti

Voit tuoda prepare ID -tunnuksen ja tuoda tämän arvon kohtaan References > ShipAdvisor Reference yhdessä pakollisten lähetystietojen, kuten paketin tietojen, kanssa.

 

Siirry Ship Help -ohjeisiin tästä.

 

 

DeliveryCheckoutAPI

DeliveryCheckout API on integrointipalvelu Delivery Checkoutin ja verkkokauppasi väliseen viestintään. DeliveryCheckout API käyttää viestintään REST API -kehystä, jossa tiedonsiirtomuotona on JSON ja joka tarjoaa useita toimintoja.

Kaikki DeliveryCheckoutAPI:n yleiset dokumentaatiot löytyvät täältä.

Kun palvelua käytetään yhdessä nShift Shipin kanssa, mukana on muutamia erityistilanteita, jotka käsitellään alla. 

 

Luo osittainen lähetys

POST /delivery-checkouts/{deliveryCheckoutId}/shipments

Luo osittaisen lähetyksen verkkokaupassa kuluttajan valitseman toimitusvaihtoehdon perusteella.

Tämä päätepiste on pakollinen. 
Käytä aina täydellistä Delivery Checkout ID -tunnusta, koska Delivery Checkoutin versio sisältyy tunnukseen.

 

URI-parametrit

deliveryCheckoutId string GET-pyynnössä palautettu Delivery Checkout ID Pakollinen
returnShipmentData boolean Lähetystiedot palautetaan vastauksessa. Valinnainen

 

Esimerkki rungosta

{
  "selectedOptionId": "3e01c458-b4fb-4a15-9468-f9179a516a0c",
  "language": "en",
  "orderNo": "order number 123",
  "prepareId": "test34",
  "receiver": {
    "name": "Testname",
    "address1": "Testaddress 1",
    "zipCode": "1080",
    "city": "Ixelles",
    "country": "BE",
    "mobile": "0733000000",
    "email": "email2@example.com"
  },
  "agent": {
    "quickId": "19172",
    "name": "DISTRIBUTEUR TRIBES BXL CN",
    "address1": "Avenue Louise 279",
    "address2": null,
    "zipCode": "1050",
    "city": "Bruxelles",
    "state": null,
    "country": "BE",
    "mapLongitude": 4.36706,
    "mapLatitude": 50.82386,
    "phone": null,
    "email": null
  }
}

 

Esimerkki vastauksesta

{
    "sourceSystem": "DH",
    "serviceId": "DH:7132",
    "optionTitle": "PostNord Varubrev 1:a klass (7132)",
    "serviceCaption": "PostNord Varubrev 1:a klass (7132)",
    "addons": []
}

Ominaisuuksien kuvauksen löydät ominaisuusoppaasta.

Kaavion ja testauksen löydät osoitteesta https://api.unifaun.com/rs-docs/. Siirry kohtaan /delivery-checkouts/{deliveryCheckoutId}/shipments POST.

 

Hae osittainen lähetys

GET /delivery-checkout-shipments/{prepareId}

Hakee aiemmin luodun osittaisen lähetyksen.

 

URI-parametrit

prepareId string Osittaisen lähetyksen tunniste. Pakollinen

 

Esimerkki vastauksesta

{
  "serviceId": "DCTEST",
  "serviceTitle": "Delivery Checkout Test Service",
  "sourceSystem": "UO",
  "orderNo": "order number 123",
  "prepareId": "123",
  "sender": {
    "quickId": "1",
    "name": "nShift AB",
    "address1": "Skeppsbron 5-6",
    "postalCode": "41121",
    "city": "GÖTEBORG",
    "country": "SE",
    "phone": "+46 31 725 35 00",
    "email": "email1@example.com"
  },
  "receiver": {
    "name": "nShift AB",
    "address1": "Tegnérgatan 34",
    "postalCode": "11359",
    "city": "STOCKHOLM",
    "country": "SE",
    "phone": "+46 8 34 35 15",
    "email": "email2@example.com"
  }
}

Ominaisuuksien kuvauksen löydät ominaisuusoppaasta.

Kaavion ja testauksen löydät osoitteesta https://api.unifaun.com/rs-docs/. Siirry kohtaan /delivery-checkout-shipments/{prepareId} GET.

 

 

Poista osittainen lähetys

DELETE /delivery-checkout-shipments/{prepareId}

Poistaa osittaisen lähetyksen.

Kun osittainen lähetys on poistettu, prepare ID -tunnusta voi käyttää uudelleen uusille osittaisille lähetyksille.

 

URI-parametrit

prepareId string Osittaisen lähetyksen tunniste Pakollinen

 

Onnistuneesti poistettaessa osittaista lähetystä vastausrunkoa ei palauteta.

Ominaisuuksien kuvauksen löydät ominaisuusoppaasta.

Kaavion ja testauksen löydät osoitteesta https://api.unifaun.com/rs-docs/. Siirry kohtaan /delivery-checkout-shipments/{prepareId} DELETE.

 

 

Hae palvelun lähdejärjestelmä

GET /delivery-checkout-shipments/{prepareId}/source-system

Hakee lähdejärjestelmän, josta osittaisen lähetyksen palvelu on peräisin.

Hyödyllinen, jos tiedossa on vain prepare ID -tunnus ja Delivery Checkout -määritys sisältää vaihtoehtoja, joiden palvelut ovat peräisin useista lähdejärjestelmistä.

 

URI-parametrit

prepareId string Osittaisen lähetyksen tunniste. Pakollinen


Ominaisuuksien kuvauksen löydät ominaisuusoppaasta.

Kaavion ja testauksen löydät osoitteesta https://api.unifaun.com/rs-docs/. Siirry kohtaan /delivery-checkout-shipments/{prepareId}/source-system GET.

Aiheeseen liittyvät artikkelit