Einige Produkte erfordern die Auswahl einer Abgabestelle für die Sendung. Eine Abgabestelle ist die Adresse eines Servicepunkts oder Paketshops, an dem die Kunden die Lieferung abholen können.
Wenn die Adresse der Abgabestelle in der Anfrage ausgelassen wird und das Produkt eine Abgabestelle erfordert, kann der Shipment Server basierend auf der Empfängeradresse eine Abgabestelle auswählen. Es gibt auch Produkte, die mit einem Service kombiniert werden müssen, um Abgabestellen nutzen zu können.
Erfahren Sie mehr über:
- Abrufen von Abgabestellen mit der Methode GetDropPoints
- Einfügen einer Abgabestellenadresse in eine Sendung
- Abfrage einer Abgabestelle anhand der ID
-
Beispielanfragen von verschiedenen Versanddienstleistern
Abrufen von Abgabestellen mit der Methode GetDropPoints
Mit der Methode GetDropPoints können Sie Abgabestellen für ein bestimmtes Produkt abrufen, sofern das Produkt dies unterstützt.
Beispielanfrage:
{
"ProdConceptID": 60,
"ResultCount": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "John Doe",
"Street1": "Test address 1",
"PostCode": "0580",
"City": "OSLO",
"CountryCode": "NO"
}
]
}
Erwartete Ausgabe:
Erfolgreiche Anfrage:
{
"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
},
]
}
Nicht unterstützt beim Produkt:
{
"ErrorMessages": [
"DropPoint selection not supported for this product."
]
}
Bedingungen nicht erfüllt:
{
"ErrorMessages": [
"Cannot use DropPoint service, conditions not met."
]
}„Bedingungen nicht erfüllt“ bedeutet in der Regel, dass ein Service erforderlich ist, um Abgabestellen für das Produkt zu nutzen. Einige Produkte können sowohl mit als auch ohne Abgabestellen verwendet werden, weshalb es verpflichtend sein kann, einen Abgabestellen-Service einzubeziehen, wenn eine Abgabestellenadresse in der Anfrage enthalten ist. Bei diesen Produkttypen stellt die Validierung sicher, dass eine Abgabestellenadresse niemals ohne den korrekten Servicecode erlaubt ist.
Einfügen einer Abgabestellenadresse in eine Sendung
Die Adresse der Abgabestelle wird im Sendungsobjekt im Abschnitt für Adressen mit dem Kind auf 10 definiert. Das folgende Beispiel zeigt eine SubmitShipment-Anfrage, die eine Abgabestellenadresse enthält.
{
"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
}
]
}
]
}
Abfrage der Abgabestelle anhand der ID
Einige Versanddienstleister unterstützen die Abfrage anhand der Abgabestellen-ID. Verwenden Sie die Variable CustNo und fügen Sie die Abgabestellen-ID ein. Der Shipment Server führt dann eine Abfrage dieser ID durch und füllt die Adresse der Abgabestelle aus. Diese Lösung ist relevant, wenn Sie in Ihrem Webshop eine Auswahl der Abgabestelle anbieten.
{
"Kind":10,
"CustNo": "3535747"
}Wenn die Abgabestellen-ID bei uns nicht übereinstimmt, antwortet der Shipment Server mit einem Fehler, und Sie müssen diesen korrigieren, um die Sendung absenden zu können.
Wenn Sie in Ihrer Anfrage Abgabestellendaten angeben, führt der Shipment Server keine Abfrage durch, sondern verwendet die bereitgestellten Daten – auch wenn diese beim Versanddienstleister ungültig sind. Im folgenden Beispiel werden die Daten verwendet und keine Abfrage durchgeführt.
{
"Kind":10,
"CustNo": "3535747",
"Name1": "RIMI SINSEN AVD 3821"
"Street1": "SINSENV 55",
"Postcode": "0585",
"City": "OSLO",
"CountryCode": "NO"
}
Beispielanfragen von verschiedenen Versanddienstleistern
Die folgende Tabelle zeigt einige Beispiele für Produkte, die Abgabestellen unterstützen. Wenn die Spalten für Service und Service-ID ausgefüllt sind, bedeutet dies, dass das Produkt mit einem Service kombiniert werden muss, um Abgabestellen nutzen zu können.
| Name des Versanddienstleisters | ProdName | ProdConceptID | Service | Service-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 |
Mit der Methode GetProducts erhalten Sie eine Liste aller Produkte und Services in Ihrem Shipment Server-Konto. Wenn ein Produkt einen Service mit einem Namen unterstützt, der darauf hinweist, dass es sich um einen Abgabestellen-Service handelt (Servicepoint, Paketshop usw.), bedeutet dies in der Regel, dass dieser Service enthalten sein muss, um Abgabestellen nutzen zu können.
Beispielanfragen
In den folgenden Beispielen von Bring und PostNord wird der Shipment Server eine Abgabestelle abfragen, da ein Abgabestellen-Service ausgewählt wurde. Wenn Sie nicht möchten, dass der Shipment Server eine Abgabestelle abfragt, müssen Sie die Abgabestellenadresse wie im Beispiel von DB Schenker einfügen.
Bring (NO): Produkt „Klimanøytral servicepakke“ einschließlich des Services „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): Produkt „MyPack“ einschließlich des Services „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): Produkt „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
}
]
}
]
}