Toimituspisteiden käsittely Shipment Serverissä

Jotkut tuotteet vaativat toimituspisteen valitsemista lähetykselle. Toimituspiste on palvelupisteen tai pakettikaupan osoite, josta asiakkaat voivat noutaa toimituksen. 

Jos toimituspisteen osoite jätetään pois pyynnöstä ja tuote vaatii toimituspisteen, lähetyspalvelin saattaa valita toimituspisteen vastaanottajan osoitteen perusteella. On myös joitakin tuotteita, jotka on yhdistettävä palveluun, jotta toimituspisteitä voidaan käyttää.

Lue lisää aiheesta:

• Toimituspisteiden hakeminen GetDropPoints-menetelmällä
• Toimituspisteen osoitteen lisääminen lähetykseen
• Toimituspisteen hakeminen ID:n avulla
• Esimerkkipyyntöjä eri kuljetusyrityksiltä 
  
   

Toimituspisteiden hakeminen GetDropPoints-menetelmällä

GetDropPoints-menetelmällä voit hakea toimituspisteitä tietylle tuotteelle, jos tuote tukee tätä. 

Pyyntöesimerkki:
 

{
  "ProdConceptID": 60,
  "ResultCount": 1,
  "Addresses": [
    {
      "Kind": 1,
      "Name1": "John Doe",
      "Street1": "Testiosoite 1",
      "PostCode": "0580",
      "City": "OSLO",
      "CountryCode": "NO"
    }
  ]
}

Odotettu vastaus:
Onnistunut pyyntö:

{
  "DropPoints": [
 {
  "OriginalID": "3807542",
  "RoutingCode": "ALF",
  "Name1": "POSTNORD PICK UP POINT",
  "Street1": "HARALDRUDV 11",
  "PostCode": "0581",
  "City": "OSLO",
  "CountryCode": "NO",
  "Distance": 0.891,
  "Latitude": 59.9303385682,
  "Longitude": 10.8246658266
 },
  ]
}

Tuote ei tue tätä:

{
  "ErrorMessages": [
    "Toimituspisteen valinta ei ole tuettu tässä tuotteessa."
  ]
}

Ehdot eivät täyty:

{
  "ErrorMessages": [
    "Toimituspisteen palvelua ei voi käyttää, ehdot eivät täyty."
  ]
}

"Ehdot eivät täyty" tarkoittaa yleensä, että toimituspisteiden käyttöön tuotteessa vaaditaan palvelu. Joitakin tuotteita voi käyttää sekä toimituspisteiden kanssa että ilman, ja tästä syystä voi olla pakollista sisällyttää toimituspistepalvelu, jos pyyntöön sisältyy toimituspisteen osoite. Näissä tuotteissa validointi varmistaa, että toimituspisteen osoite ei koskaan ole sallittu ilman oikeaa palvelukoodia.

Toimituspisteen osoitteen lisääminen lähetykseen

Toimituspisteen osoite määritellään lähetyskohteessa Addresses-osiossa, jossa Kind on asetettu arvoon 10. Alla oleva esimerkki näyttää SubmitShipment-pyynnön, joka sisältää toimituspisteen osoitteen. 

{
  "Kind": 1,
  "ActorCSID": 63,
  "ProdConceptID": 296,
  "Addresses": [
    {
      "Kind": 2,
      "Name1": "Testilähettäjä",
      "Street1": "Testiosoite",
      "PostCode": "51162",
      "City": "SKENE",
      "Mobile": "04799999999",
      "Attention": "testi",
      "CountryCode": "SE"
    },
    {
      "Kind": 1,
      "Name1": "Jane Doe",
      "Street1": "Testvägen 10",
      "PostCode": "64551",
      "City": "STRÄNGNÄS",
      "CountryCode": "SE"
    },
    {
      "Kind": 10,
      "Name1": "ULFHÄLLSKIOSKEN",
      "Street1": "MARIEFREDSVÄGEN 36",
      "PostCode": "64540",
      "City": "STRÄNGNÄS",
      "CountryCode": "SE"
    }
  ],
  "Lines": [
    {
      "PkgWeight": 5000,
      "GoodsTypeKey1": "XP",
      "Pkgs": [
        {
          "ItemNo": 1
        }
      ]
    }
  ]
}

Toimituspisteen haku ID:n perusteella

Jotkut kuljetusyritykset tukevat toimituspisteen haun ID:n perusteella. Käytä muuttujaa CustNo ja sisällytä toimituspisteen ID. Shipment Server tekee sitten haun tämän ID:n perusteella ja täyttää toimituspisteen osoitteen. Tämä ratkaisu on relevantti, jos tarjoat toimituspisteen valinnan verkkokaupassasi.

{
   "Kind":10,
   "CustNo": "3535747"
}

Jos toimituspisteen ID ei vastaa tietojamme, Shipment Server vastaa virheellä, ja sinun on korjattava se lähetyksen lähettämiseksi.

Jos toimituspisteen tietoja annetaan pyynnössä, Shipment Server ei tee hakua, vaan käyttää annettuja tietoja – vaikka ne eivät olisikaan kelvollisia kuljetusyrityksellä. Alla olevassa esimerkissä tiedot käytetään, eikä hakua tehdä.

{
   "Kind":10,
   "CustNo": "3535747",
   "Name1": "RIMI SINSEN AVD 3821",
   "Street1": "SINSENV 55",
   "Postcode": "0585",
   "City": "OSLO",
   "CountryCode": "NO"
}

Esimerkkipyynnöt eri kuljetusyrityksiltä

Alla oleva taulukko näyttää esimerkkejä tuotteista, jotka tukevat toimituspisteitä. Jos palvelu- ja palvelu-ID -sarakkeet on täytetty, se tarkoittaa, että tuotteen on oltava yhdistettynä palveluun, jotta toimituspisteitä voidaan käyttää.

Käyttämällä menetelmää GetProducts saat listan kaikista tuotteista ja palveluista Shipment Server -tililläsi. Jos tuote tukee palvelua, jonka nimi viittaa siihen, että se on toimituspistepalvelu (palvelupiste, pakettikauppa jne.), se tarkoittaa yleensä, että tämä palvelu on sisällytettävä toimituspisteiden käyttämiseksi.  

Esimerkkipyynnöt

Alla Bringin ja PostNordin esimerkeissä Shipment Server hakee toimituspisteen, koska toimituspistepalvelu on valittu. Jos et halua, että Shipment Server hakee toimituspistettä, sinun on sisällytettävä toimituspisteen osoite kuten DB Schenkerin esimerkissä.

Bring (NO): Tuote "Klimanøytral servicepakke" sisältäen palvelun "Valgfritt Postkontor":

{
    "ProdConceptID": 1041,
    "ResultCount": 1,
    "Addresses": [
        {
            "Kind": 1,
            "Name1": "John Doe",
            "Street1": "Testiosoite 1",
            "PostCode": "0580",
            "City": "OSLO",
            "CountryCode": "NO"
        }
    ],
    "Services": [
        142002
    ]
}

PostNord (DK): Tuote "MyPack" sisältäen palvelun "Servicepoint":

{
  "ProdConceptID": 92,
  "ResultCount": 1,
  "Addresses": [
    {
      "Kind": 1,
      "Name1": "John Doe",
      "Street1": "Vestergade 1",
      "PostCode": "8000",
      "City": "AARHUS",
      "CountryCode": "DK"
    }
  ],
  "Services": [
    9081
  ]
}

DB Schenker (SE): Tuote "Parcel Ombud":

{
  "Kind": 1,
  "ActorCSID": 63,
  "ProdConceptID": 296,
  "Addresses": [
    {
      "Kind": 2,
      "Name1": "Testilähettäjä",
      "Street1": "Testiosoite",
      "PostCode": "51162",
      "City": "SKENE",
      "Mobile": "04799999999",
      "Attention": "testi",
      "CountryCode": "SE"
    },
    {
      "Kind": 1,
      "Name1": "Jane Doe",
      "Street1": "Testvägen 10",
      "PostCode": "64551",
      "City": "STRÄNGNÄS",
      "CountryCode": "SE"
    },
    {
      "Kind": 10,
      "Name1": "ULFHÄLLSKIOSKEN",
      "Street1": "MARIEFREDSVÄGEN 36",
      "PostCode": "64540",
      "City": "STRÄNGNÄS",
      "CountryCode": "SE"
    }
  ],
  "Lines": [
    {
      "PkgWeight": 5000,
      "GoodsTypeKey1": "XP",
      "Pkgs": [
        {
          "ItemNo": 1
        }
      ]
    }
  ]
}