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.
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.