Tässä artikkelissa kerrotaan, miten Delivery Checkoutin konfigurointi Transsmartin kanssa käytettäessä eroaa vakiokonfiguraatiosta.

Artikkelin osiot:

• Luo Delivery Checkout Transsmartin kanssa käytettäväksi
• Varaa ja tulosta Transsmartin avulla
• DeliveryCheckout API

Luo Delivery Checkout Transsmartin kanssa käytettäväksi

Jos olet uusi Delivery Checkout -käyttäjä, suosittelemme aloittamaan lukemalla nämä artikkelit:

• Checkoutin käytön aloittaminen
• Delivery Checkoutin määrittäminen
   

1. Varmista ennen asennuksen aloittamista, että sinulla on vähintään yksi lähettäjä osoitekirjassasi. Katso Lisää uusi lähettäjä, Osoitekirja API:n kautta tai Tuo osoitekirja.
    
2. Sinun on myös syötettävä Transsmart-tilinumerosi, käyttäjätunnuksesi ja salasanasi osioon Transsmart details nShift Deliveryn sivulla Sender.
    
3. Seuraa sen jälkeen ohjeessa kuvattuja vaiheita: Luo Delivery Checkout

Katso muita artikkeleitamme aiheista

• Checkoutin määritys
• Toimitusehdot

Delivery Checkout -työnkulku Transsmartin kanssa:

Varaa ja tulosta Transsmartin avulla

Voit varata ja tulostaa lähetyksiä Transsmartin avulla API:n, MyTranssmartin tai suoran linkin kautta.

 

API:n kautta

Lähetysten varaamiseen ja tulostamiseen Transsmart API:n kautta käytetään prepare ID:tä viitteenä BOOK- tai PRINT-toiminnon suorittamiseen. PRINT-vaihtoehdon käyttäminen myös varaa lähetyksen. Lähetystä varattaessa on lisättävä puuttuvat pakolliset lähetystiedot, kuten pakettitiedot.

MyTranssmart-kojelaudassa voit myös määrittää oletusasetuksia, joita käytetään tämän jälkeen automaattisesti.

Lue Transsmart Developer Documentation suorittaaksesi varauksen ja tulostuksen sähköinen kaupankäynti-, ERP- tai WMS-järjestelmästäsi täältä.

 

Hallitse oletusasetuksia Transsmartin kautta täältä.

 

MyTransssmartin kautta

Voit myös varata ja tulostaa lähetyksen MyTransssmart-käyttöliittymässä.

Siirry kohtaan Varaa ja tulosta MyTransssmartissa.


 

Suoran linkin kautta

Jos haluat siirtyä suoraan lähetykseen varataksesi ja tulostaaksesi, käytät URL-osoitetta.

https://api.transsmart.com/v2/direct/details?key=<transsmart key>&reference=<prepareId>

• Korvaa <transsmart key> Transsmartin avaimellasi.
• Korvaa <prepareId> Delivery Checkoutin prepare ID:llä.

Hanki Transsmart-avaimesi täältä.

DeliveryCheckoutAPI

DeliveryCheckout API on integrointipalvelu Delivery Checkoutin ja verkkokauppasi väliseen viestintään. DeliveryCheckout API käyttää REST API -kehystä viestintään JSON:ia tietojen välittäjänä ja tarjoaa useita toimintoja.

Kaikki yleinen dokumentaatio DeliveryCheckoutAPI:sta löytyy täältä.

Transsmartin kanssa käytettäessä on muutamia erityistilanteita, joita käsittelemme alla.

Luo osittainen lähetys

POST /delivery-checkouts/{deliveryCheckoutId}/shipments

Luo osittaisen lähetyksen sen toimitustavan perusteella, jonka kuluttaja on valinnut verkkokaupassa.

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

URI-parametrit

Esimerkki bodysta

{
  "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": "TS",
  "serviceId": "TS:BPO:TAXIPOST24H",
  "optionTitle": "BPost taxipost 24h pickup point delivery",
  "serviceCaption": "BPost taxipost 24h pickup point delivery"
}

Ominaisuuksien kuvauksen osalta katso Ominaisuusviiteopas.

Skeeman ja testauksen osalta katso https://api.unifaun.com/rs-docs/ ja siirry kohtaan /delivery-checkouts/{deliveryCheckoutId}/shipments POST.

Hae osittainen lähetys

GET /delivery-checkout-shipments/{prepareId}

Hakee aiemmin luodun osittaisen lähetyksen.

 

URI-parametrit

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 osalta katso Ominaisuusviiteopas.

Skeeman ja testauksen osalta katso https://api.unifaun.com/rs-docs/ ja 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:tä voidaan käyttää uudelleen uusille osittaisille lähetyksille.

URI-parametrit

Vastaustekstiä ei palauteta, kun osittainen lähetys on poistettu onnistuneesti.

Ominaisuuksien kuvauksen osalta katso Ominaisuusviiteopas.

Skeeman ja testauksen osalta katso https://api.unifaun.com/rs-docs/ ja 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 ja Delivery Checkout -konfiguraatio sisältää vaihtoehtoja useista lähdejärjestelmistä peräisin olevilla palveluilla.

URI-parametrit

Ominaisuuksien kuvauksen osalta katso Ominaisuusviiteopas.

Skeeman ja testauksen osalta katso https://api.unifaun.com/rs-docs/ ja siirry kohtaan /delivery-checkout-shipments/{prepareId}/source-system GET.