Sommige producten vereisen dat er een afleverlocatie wordt geselecteerd bij de zending. Een afleverlocatie is het adres van een servicepunt of pakketshop waar klanten de levering kunnen ophalen.
Als het afleverlocatieadres niet wordt opgegeven in het verzoek en het product vereist een afleverlocatie, kan de Shipment Server een afleverlocatie selecteren op basis van het ontvangeradres. Er zijn ook producten die gecombineerd moeten worden met een service om afleverlocaties te kunnen gebruiken.
Lees meer over:
- Het ophalen van afleverlocaties met behulp van de GetDropPoints-methode
- Een afleverlocatieadres toevoegen aan een zending
- Afleverlocatie opzoeken via ID
-
Voorbeeldverzoeken van verschillende vervoerders
Afleverlocaties ophalen met de GetDropPoints-methode
Met de GetDropPoints-methode kunt u afleverlocaties ophalen voor een bepaald product als het product dit ondersteunt.
Voorbeeld van een verzoek:
{
"ProdConceptID": 60,
"ResultCount": 1,
"Addresses": [
{
"Kind": 1,
"Name1": "John Doe",
"Street1": "Test address 1",
"PostCode": "0580",
"City": "OSLO",
"CountryCode": "NO"
}
]
}
Verwachte uitvoer:
Succesvol verzoek:
{
"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
},
]
}
Niet ondersteund voor product:
{
"ErrorMessages": [
"Selectie van afleverlocatie wordt niet ondersteund voor dit product."
]
}
Voorwaarden niet voldaan:
{
"ErrorMessages": [
"Afleverlocatie-service kan niet worden gebruikt, voorwaarden niet voldaan."
]
}"Voorwaarden niet voldaan" betekent meestal dat er een service vereist is om afleverlocaties te gebruiken voor het product. Sommige producten kunnen zowel met als zonder afleverlocaties worden gebruikt, en daarom kan het verplicht zijn om een afleverlocatieservice op te nemen als een afleverlocatieadres wordt meegegeven in het verzoek. Bij dit soort producten zorgt de validatie ervoor dat een afleverlocatieadres nooit is toegestaan zonder de juiste servicecode.
Een afleverlocatieadres opnemen in een zending
Het afleverlocatieadres wordt gedefinieerd in het zendingobject in de sectie voor Adressen met de Soort ingesteld op 10. Het onderstaande voorbeeld toont een SubmitShipment-verzoek dat een afleverlocatieadres bevat.
{
"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
}
]
}
]
}
Afleverlocatie opzoeken via ID
Sommige vervoerders ondersteunen het opzoeken van afleverlocaties via ID. Gebruik de variabele CustNo en geef de afleverlocatie-ID op. Shipment Server zal dan deze ID opzoeken en het afleverlocatieadres invullen. Deze oplossing is relevant als u afleverlocatie-selectie aanbiedt in uw webshop.
{
"Kind":10,
"CustNo": "3535747"
}Als de afleverlocatie-ID niet overeenkomt aan onze kant, zal Shipment Server reageren met een foutmelding en moet u deze corrigeren om de zending te kunnen indienen.
Als u afleverlocatiegegevens meegeeft in uw verzoek, zal Shipment Server geen lookup uitvoeren, maar de meegegeven gegevens gebruiken - zelfs als deze niet geldig zijn bij de vervoerder. In het onderstaande voorbeeld worden de gegevens gebruikt en wordt er geen lookup uitgevoerd.
{
"Kind":10,
"CustNo": "3535747",
"Name1": "RIMI SINSEN AVD 3821"
"Street1": "SINSENV 55",
"Postcode": "0585",
"City": "OSLO",
"CountryCode": "NO"
}
Voorbeeldverzoeken van verschillende vervoerders
De onderstaande tabel toont enkele voorbeelden van producten die afleverlocaties ondersteunen. Als de kolommen service en service-ID zijn ingevuld, betekent dit dat het product gecombineerd moet worden met een service om afleverlocaties te kunnen gebruiken.
| Naam vervoerder | ProdNaam | 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 |
Door de methode GetProducts te gebruiken, krijgt u een lijst van alle producten en services op uw Shipment Server-account. Als een product een service ondersteunt met een naam die aangeeft dat het een afleverlocatieservice is (servicepunt, pakketshop, enz.), betekent dit meestal dat deze service moet worden opgenomen om afleverlocaties te kunnen gebruiken.
Voorbeeldverzoeken
In de onderstaande voorbeelden van Bring en PostNord zal Shipment Server een afleverlocatie opzoeken omdat een afleverlocatieservice is geselecteerd. Als u niet wilt dat Shipment Server een afleverlocatie opzoekt, moet u het afleverlocatieadres opnemen zoals in het voorbeeld van DB Schenker.
Bring (NO): Product "Klimanøytral servicepakke" inclusief de service "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): Product "MyPack" inclusief de service "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): Product "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
}
]
}
]
}