Logga in

nShift Help Center

Hantera utlämningsställen i Shipment Server

Avatar
Malene Tidemann
Uppdaterad


Vissa produkter kräver att ett utlämningsställe väljs för försändelsen. Ett utlämningsställe är adressen till en serviceställe eller paketbutik där kunderna kan hämta ut leveransen. 

Om utlämningsställets adress utelämnas i förfrågan och produkten kräver ett utlämningsställe kan shipment server välja ett utlämningsställe baserat på mottagarens adress. Det finns också vissa produkter som måste kombineras med en tjänst för att använda utlämningsställen.


Läs mer om:

Hämta utlämningsställen med metoden GetDropPoints

Med metoden GetDropPoints kan du hämta utlämningsställen för en given produkt om produkten stödjer det. 

Exempel på förfrågan:
 

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


Förväntat svar:
Lyckad förfrågan:

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


Ej stöd för produkten:

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


Villkor inte uppfyllda:

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

"Villkor inte uppfyllda" betyder vanligtvis att en tjänst krävs för att använda utlämningsställen på produkten. Vissa produkter kan användas både med och utan utlämningsställen, och detta är anledningen till att det kan vara obligatoriskt att inkludera en utlämningsställetjänst om en utlämningsställeadress är inkluderad i förfrågan. På dessa typer av produkter säkerställer valideringen att en utlämningsställeadress aldrig tillåts utan korrekt tjänstekod.

 

Inkludera en utlämningsställeadress på en försändelse

Utlämningsställeadressen definieras i försändelseobjektet i avsnittet för Addresses med Kind satt till 10. Exemplet nedan visar en SubmitShipment-förfrågan som inkluderar en utlämningsställeadress. 

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

 

Utlämningsställeuppslagning med ID

Vissa transportörer stödjer uppslagning på utlämningsställe-ID. Använd variabeln CustNo och inkludera utlämningsställets ID. Shipment Server kommer då att göra en uppslagning på detta ID och fylla i utlämningsställeadressen. Denna lösning är relevant om du erbjuder val av utlämningsställe i din webbutik.

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

Om utlämningsställe-ID inte matchar hos oss kommer Shipment Server att svara med ett fel, och du måste rätta till det för att kunna skicka in försändelsen.

Om du lämnar någon utlämningsställdata i din förfrågan kommer Shipment Server inte att göra någon uppslagning utan använda den data som lämnats – även om den inte är giltig hos transportören. I exemplet nedan kommer datan att användas och ingen uppslagning görs.

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

 

Exempelförfrågningar från olika transportörer

Tabellen nedan visar några exempel på produkter som stödjer utlämningsställen. Om kolumnerna för tjänst och tjänst-ID är ifyllda innebär det att produkten måste kombineras med en tjänst för att använda utlämningsställen.

Transportörsnamn ProdName ProdConceptID  Tjänst Tjänst-ID
Bring (NO)  Bedriftspakke ekspress over natt 0900  1034 Valgfritt Postkontor 142002
Bring (NO) Klimanøytral servicepakke 1041 Valgfritt Postkontor 142002
PostNord (DK) MyPack (Indland) 92 Servicepoint 9081
PostNord (DK) MyPack Collect (Udland) 749 Servicepoint 9071
PostNord (DK) MyPack Collect Samsending 571 Servicepoint 9071
DB Schenker (SE) Parcel ombud 296    


Genom att använda metoden GetProducts får du en lista över alla produkter och tjänster på ditt Shipment Server-konto. Om en produkt stödjer en tjänst med ett namn som antyder att det är en utlämningsställetjänst (service point, paketbutik, etc.) betyder det vanligtvis att denna tjänst måste inkluderas för att använda utlämningsställen.  

 

Exempelförfrågningar

I exemplen från Bring och PostNord nedan kommer Shipment Server att slå upp ett utlämningsställe eftersom en utlämningsställetjänst har valts. Om du inte vill att Shipment Server ska slå upp ett utlämningsställe måste du inkludera utlämningsställeadressen som i DB Schenker-exemplet.

Bring (NO): Produkten "Klimanøytral servicepakke" inklusive tjänsten "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): Produkten "MyPack" inklusive tjänsten "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): Produkten "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
        }
      ]
    }
  ]
}

 

 

Relaterade artiklar