Find nearby service points
Learn how to retrieve the 3 closest service points to a given address, using the Nearby Service Points endpoint.
Information
The nearby service point API will respond with the 3 closest Service points for the given address. These locations can be used to:
-
Show service point locations at e-commerce checkout.
-
Show service point locations on a returns page.
-
Book a parcel delivery/return to a service point.
Example of a service point selection at checkout
Tips:
-
To have the most accurate results, include streetaddress.
-
Works with only zipCode and countryCode, although less accurate.
Service point filtering for rural areas and small towns.
If there are many service points close to the address, in for example a densely populated area, the API will respond with the 3 closest service points, calculated by air distance from the coordinates of the address. In less populated areas, if there are no service points within 5km of the coordinates, the API will respond with a single closest service point.
Which transport solutions to use
The Helthjem network primarily uses Helthjem service points. For some remote locations Helthjem uses Postnord as a subcontractor. This ensures 100% coverage over all of Norway. Depending on the desired Transport Solution, you will get different networks:
-
Using
transportSolutionId:"86", will respond with exclusively Helthjem. -
Using
transportSolutionId:"62", will respond with both networks.
Response will contain one of the following options:
-
"freightProductId": "55"(Helthjem service point) -
"freightProductId": "3"(Postnord Service point)
Example
In the example below, we will show a basic flow to:
-
Find nearby service points for a given address.
-
Show service points on a 3rd-party map.
-
Book a parcel using one of these service points.
Example request - Nearby service points
{
"shopId": 1,
"transportSolutionId": 86,
"streetAddress": "Kongsberggata 18",
"zipCode": 0468,
"postalName": "Oslo",
"countryCode": "NO"
}Response
{
"freightProducts": [
{
"transporterId": 86,
"transporterName": "Helthjem AS",
"freightProductId": 55,
"freightName": "Helthjem Hentepakke",
"freightTitle": "Hentepakke",
"freightDescription": "Utlevering av pakke i Helthjem butikk.",
"servicePoints": [
{
"servicePointExternalId": "40467",
"servicePointName": "Joker Bjølsen",
"visitingAddress": {
"postalCode": "0468",
"countryCode": "NO",
"streetNumber": "3",
"streetName": "BERGENSGATA",
"postalName": "OSLO"
},
"deliveryAddress": {
"postalCode": "0468",
"countryCode": "NO",
"streetNumber": "3",
"streetName": "BERGENSGATA",
"postalName": "OSLO"
},
"routingCode": null,
"eligibleParcelOutlet": true,
"openingHours": [
{
"from1": "07:00",
"to1": "00:00",
"day": "MONDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "TUESDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "WEDNESDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "THURSDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "FRIDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "SATURDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "SUNDAY"
}
],
"servicePointCoordinates": [
{
"northing": 59.940547943115234,
"easting": 10.75981616973877
}
]
},
{
"servicePointExternalId": "57491",
"servicePointName": "JOKER MARIDALSVEIEN",
"visitingAddress": {
"postalCode": "0469",
"countryCode": "NO",
"streetNumber": "169",
"streetName": "MARIDALSVEIEN",
"postalName": "OSLO"
},
"deliveryAddress": {
"postalCode": "0469",
"countryCode": "NO",
"streetNumber": "169",
"streetName": "MARIDALSVEIEN",
"postalName": "OSLO"
},
"routingCode": null,
"eligibleParcelOutlet": true,
"openingHours": [
{
"from1": "07:00",
"to1": "00:00",
"day": "MONDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "TUESDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "WEDNESDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "THURSDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "FRIDAY"
},
{
"from1": "07:00",
"to1": "00:00",
"day": "SATURDAY"
},
{
"from1": "09:00",
"to1": "00:00",
"day": "SUNDAY"
}
],
"servicePointCoordinates": [
{
"northing": 59.93974304199219,
"easting": 10.759597778320312
}
]
},
{
"servicePointExternalId": "136838",
"servicePointName": "REMA 1000 Bjølsen",
"visitingAddress": {
"postalCode": "0468",
"countryCode": "NO",
"streetNumber": "41",
"streetName": "BERGENSGATA",
"postalName": "OSLO"
},
"deliveryAddress": {
"postalCode": "0468",
"countryCode": "NO",
"streetNumber": "41",
"streetName": "BERGENSGATA",
"postalName": "OSLO"
},
"routingCode": null,
"eligibleParcelOutlet": true,
"openingHours": [
{
"from1": "06:00",
"to1": "00:00",
"day": "MONDAY"
},
{
"from1": "06:00",
"to1": "00:00",
"day": "TUESDAY"
},
{
"from1": "06:00",
"to1": "00:00",
"day": "WEDNESDAY"
},
{
"from1": "06:00",
"to1": "00:00",
"day": "THURSDAY"
},
{
"from1": "06:00",
"to1": "00:00",
"day": "FRIDAY"
},
{
"from1": "06:00",
"to1": "00:00",
"day": "SATURDAY"
}
],
"servicePointCoordinates": [
{
"northing": 59.94405746459961,
"easting": 10.760120391845703
}
]
}
],
"properties": {}
}
]
}The response contains locations of service points which can be presented on a map and selected.
Using the service point as a party.
Use the service point id, countryCode and “type”: “servicePoint” as party when booking the parcel:
{
"type": "servicePoint",
"id": "40467",
"countryCode": "NO"
}Now that we know the service point details, we can append it to the booking request using the Parcel booking API:
Example booking request
{
"shopId": 1,
"transportSolutionId": 86,
"shipmentId": "",
"parties": [
{
"type": "consignee",
"name": "Ola Nordmann",
"countryCode": "NO",
"postalName": "Oslo",
"zipCode": "0468",
"address": "Kongsberggata 18",
"phone1": "12345678",
"email": "test@gmail.com",
"reference": "cust_ref",
"contact": "contact2"
},
{
"type": "consignor",
"id": null,
"name": "Test shop",
"countryCode": "NO",
"postalName": "Oslo",
"zipCode": "0480",
"address": "Sandakerveien 121",
"phone1": "12345678",
"phone2": null,
"email": "",
"reference": "shop_ref",
"contact": "contact1",
"coaddress": null
},
{
"type": "servicePoint",
"id": "40467",
"countryCode": "NO"
}
],
"items": [
{
"itemNumber": 1,
"trackingReference": "",
"weight": 1000,
"width": 12,
"height": 12,
"length": 12,
"contents": "test item"
}
]
}Response
{
"shipmentId": "(401)70724763243781797",
"freightProductId": 55,
"parties": [
{
"type": "consignee",
"id": null,
"name": "Ola Nordmann",
"countryCode": "NO",
"postalName": "Oslo",
"zipCode": "0468",
"address": "Kongsberggata 18",
"detailedAddress": null,
"phone1": "12345678",
"phone2": null,
"email": "test@gmail.com",
"reference": "cust_ref",
"contact": "contact2",
"coaddress": null
},
{
"type": "consignor",
"id": null,
"name": "Test shop",
"countryCode": "NO",
"postalName": "Oslo",
"zipCode": "0480",
"address": "Sandakerveien 121",
"detailedAddress": null,
"phone1": "12345678",
"phone2": null,
"email": "",
"reference": "shop_ref",
"contact": "contact1",
"coaddress": null
},
{
"type": "servicePoint",
"id": "40467",
"name": "Joker Bjølsen",
"countryCode": "NO",
"postalName": "OSLO",
"zipCode": "0468",
"address": "BERGENSGATA 3",
"detailedAddress": null,
"phone1": null,
"phone2": null,
"email": null,
"reference": null,
"contact": null,
"coaddress": null
}
],
"items": [
{
"itemId": null,
"itemNumber": 1,
"trackingReference": "(00)370724763243781804",
"returnCode": null,
"linkedParcelType": null,
"linkedTrackingReference": null,
"weight": 1000,
"volume": null,
"length": 12,
"height": 12,
"width": 12,
"contentValue": null,
"externalSupplierId": null,
"contents": "test item",
"properties": {
"shortItemIdentifier": "...1804"
},
"articles": [],
"externalOrderId": null
}
],
"properties": {
"areaId": null,
"deliveryPointCarId": "9604",
"distributionDate": "20251015",
"freightProductName": "Helthjem Hentepakke",
"mainCarNumber": "112",
"pickupZipString": "",
"productName": "Hentepakke",
"regionId": null,
"retailerId": "40467",
"routeAddress": "BERGENSGATA 3",
"routeDescription": null,
"routeName": "",
"routeSeq": "",
"routeZipAndCity": null,
"routing": "112-0",
"routingDescription": " ",
"routingDetailed": "112",
"shopName": "Testbutikken",
"transportNetId": "204"
},
"additionalServices": [],
"orderId": 199756334
}The parcel is now booked to the service point. The next step is to use the "shipmentId": "(401)70724763243781797" to generate a label from the label endpoint.