Noen produkter krever at et hentepunkt velges på forsendelsen. Et hentepunkt er adressen til et servicested eller pakkebutikk hvor kundene kan hente leveransen. 

Hvis hentepunktadressen utelates i forespørselen og produktet krever et hentepunkt, kan Shipment Server velge et hentepunkt basert på mottakeradressen. Det finnes også noen produkter som må kombineres med en tjeneste for å bruke hentepunkter.

Les mer om:

• Hente hentepunkter ved bruk av GetDropPoints-metoden
• Inkludere en hentepunktadresse på en forsendelse
• Slå opp hentepunkt ved bruk av ID
• Eksempelforespørsler fra ulike transportører 
  
   

Hente hentepunkter ved bruk av GetDropPoints-metoden

Ved å bruke GetDropPoints-metoden kan du hente hentepunkter for et gitt produkt hvis produktet støtter det. 

Eksempel på forespørsel:
 

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

Forventet svar:
Vellykket forespørsel:

{
  "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
 },
  ]
}

Ikke støttet på produktet:

{
  "ErrorMessages": [
    "DropPoint selection not supported for this product."
  ]
}

Betingelser ikke oppfylt:

{
  "ErrorMessages": [
    "Cannot use DropPoint service, conditions not met."
  ]
}

"Betingelser ikke oppfylt" betyr vanligvis at en tjeneste kreves for å bruke hentepunkter på produktet. Noen produkter kan brukes både med og uten hentepunkt, og dette er grunnen til at det kan være obligatorisk å inkludere en hentepunktstjeneste hvis en hentepunktadresse er inkludert i forespørselen. På denne typen produkter sikrer valideringen at en hentepunktadresse aldri tillates uten riktig tjenestekode.

Inkludere en hentepunktadresse på en forsendelse

Hentepunktadressen defineres i forsendelsesobjektet i seksjonen for Addresses med Kind satt til 10. Eksempelet nedenfor viser en SubmitShipment-forespørsel som inkluderer en hentepunktadresse. 

{
  "Kind": 1,
  "ActorCSID": 63,
  "ProdConceptID": 296,
  "Addresses": [
    {
      "Kind": 2,
      "Name1": "Test sender",
      "Street1": "Test Address",
      "PostCode": "51162",
      "City": "SKENE",
      "Mobile": "04799999999",
      "Attention": "test",
      "CountryCode": "SE"
    },
    {
      "Kind": 1,
      "Name1": "Jane Doe",
      "Street1": "Testv\u00e4gen 10",
      "PostCode": "64551",
      "City": "STR\u00c4NGN\u00c4S",
      "CountryCode": "SE"
    },
    {
      "Kind": 10,
      "Name1": "ULFH\u00c4LLSKIOSKEN",
      "Street1": "MARIEFREDSV\u00c4GEN 36",
      "PostCode": "64540",
      "City": "STR\u00c4NGN\u00c4S",
      "CountryCode": "SE"
    }
  ],
  "Lines": [
    {
      "PkgWeight": 5000,
      "GoodsTypeKey1": "XP",
      "Pkgs": [
        {
          "ItemNo": 1
        }
      ]
    }
  ]
}

Slå opp hentepunkt ved bruk av ID

Noen transportører støtter oppslag på hentepunkt-ID. Bruk variabelen CustNo og inkluder hentepunkt-ID. Shipment Server vil da gjøre et oppslag på denne ID-en og fylle ut hentepunktadressen. Denne løsningen er relevant hvis du tilbyr valg av hentepunkt i nettbutikken din.

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

Hvis hentepunkt-ID-en ikke stemmer hos oss, vil Shipment Server svare med en feil, og du må rette den for å kunne sende inn forsendelsen.

Hvis du oppgir noen hentepunktdata i forespørselen din, vil ikke Shipment Server gjøre et oppslag, men bruke de oppgitte dataene – selv om de ikke er gyldige hos transportøren. I eksempelet nedenfor vil dataene bli brukt, og det vil ikke bli gjort noe oppslag.

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

Eksempelforespørsler fra ulike transportører

Tabellen nedenfor viser noen eksempler på produkter som støtter hentepunkter. Hvis kolonnene for tjeneste og tjeneste-ID er utfylt, indikerer det at produktet må kombineres med en tjeneste for å bruke hentepunkter.

Ved å bruke metoden GetProducts, vil du få en liste over alle produkter og tjenester på din Shipment Server-konto. Hvis et produkt støtter en tjeneste med et navn som indikerer at det er en hentepunktstjeneste (service point, pakkebutikk, osv.), betyr det vanligvis at denne tjenesten må inkluderes for å bruke hentepunkter.  

Eksempelforespørsler

I Bring- og PostNord-eksemplene nedenfor vil Shipment Server slå opp et hentepunkt fordi en hentepunktstjeneste er valgt. Hvis du ikke ønsker at Shipment Server skal slå opp et hentepunkt, må du inkludere hentepunktadressen slik som i DB Schenker-eksemplet.

Bring (NO): Produktet "Klimanøytral servicepakke" inkludert tjenesten "Valgfritt Postkontor":

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

PostNord (DK): Produktet "MyPack" inkludert tjenesten "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): Produktet "Parcel Ombud":

{
  "Kind": 1,
  "ActorCSID": 63,
  "ProdConceptID": 296,
  "Addresses": [
    {
      "Kind": 2,
      "Name1": "Test sender",
      "Street1": "Test Address",
      "PostCode": "51162",
      "City": "SKENE",
      "Mobile": "04799999999",
      "Attention": "test",
      "CountryCode": "SE"
    },
    {
      "Kind": 1,
      "Name1": "Jane Doe",
      "Street1": "Testv\u00e4gen 10",
      "PostCode": "64551",
      "City": "STR\u00c4NGN\u00c4S",
      "CountryCode": "SE"
    },
    {
      "Kind": 10,
      "Name1": "ULFH\u00c4LLSKIOSKEN",
      "Street1": "MARIEFREDSV\u00c4GEN 36",
      "PostCode": "64540",
      "City": "STR\u00c4NGN\u00c4S",
      "CountryCode": "SE"
    }
  ],
  "Lines": [
    {
      "PkgWeight": 5000,
      "GoodsTypeKey1": "XP",
      "Pkgs": [
        {
          "ItemNo": 1
        }
      ]
    }
  ]
}