Pakke til hentestedPickup parcel
Service codes
| Service name | Service group | Size limit | Service code | API ID | Value added services | |
|---|---|---|---|---|---|---|
| Code | Description | |||||
| Klimanøytral ServicepakkeClimate neutral service parcel | Parcels Norway |
35 kg 240 cm long L+W+H: 360 cm |
1202 |
SERVICEPAKKE
| 1091 | E-varslingRecipient notification over SMS or email |
| 1036 | Valgfritt hentestedOptional pickup point | |||||
| 1000 | PostoppkravCash On Delivery (COD) | |||||
| 1133 | LegitimasjonspliktID verification | |||||
| 1134 | Personlig utleveringIndividual verification | |||||
| 1082 | Sosial kontrollSocial control | |||||
| 1229 | AlderskontrollAge control | |||||
| 1083 | TermoThermo | |||||
| Pakke til hentestedPickup Parcel | Parcels Norway |
35 kg 240 cm long L+W+H: 360 cm |
5800 |
5800
| 1036 | Valgfritt hentestedOptional pickup point |
| 1000 | PostoppkravCash On Delivery (COD) | |||||
| 1133 | LegitimasjonspliktID verification | |||||
| 1134 | Personlig utleveringIndividual verification | |||||
| 1082 | Sosial kontrollSocial control | |||||
| 1229 | AlderskontrollAge control | |||||
| 0068 | TilleggsforsikringOptional insurance | |||||
| 2086 | Varsling per brevNotification by letter | |||||
| 1083 | TermoThermo | |||||
| Pickup Parcel | Parcels Nordic |
20 kg 150 cm long L+W+H: 300 cm |
PICKUP_PARCEL
| 1091 | E-varslingRecipient notification over SMS or email | |
| 1000 | PostoppkravCash On Delivery (COD) | |||||
| 0068 | TilleggsforsikringOptional insurance | |||||
| PickUp Parcel Bulk | Parcels Nordic |
20 kg 150 cm long L+W+H: 300 cm |
PICKUP_PARCEL_BULK
| 1091 | E-varslingRecipient notification over SMS or email | |
| 1000 | PostoppkravCash On Delivery (COD) | |||||
| 1133 | LegitimasjonspliktID verification | |||||
| 0068 | TilleggsforsikringOptional insurance | |||||
Examples
Get delivery options with prices and lead time
Endpoint
https://api.bring.com/shippingguide/v2/products
Request
The request will return information needed to present a basic best practice checkout to the end user. This includes Pakke i postkassen (Mailbox parcel), Pakke til hentested (Pickup parcel) and Pakke levert hjem (Home delivery) with price and lead time on each service, and alternative delivery dates for home delivery.
https://api.bring.com/shippingguide/v2/products?fromcountry=NO&tocountry=NO&frompostalcode=0469&topostalcode=6050&product=5800&product=5600&product=3584&weight=500&addressLine=Ladeberget 2&numberofdeliverydates=3
var params = {
fromcountry: 'NO',
tocountry: 'NO',
frompostalcode: '0469',
topostalcode: '6050',
product: '5800',
product: '5600',
product: '3584',
weight: 500,
adressLine: 'Ladeberget 2', // recommended for best ETA response
numberofdeliverydates: 3 // only needed to provides alternative delivery dates for home delivery
}Response
{
"traceMessages": [],
"consignments": [
{
"products": [
{
"id": "3584",
"productionCode": "3584",
"guiInformation": {
"sortOrder": "114",
"mainDisplayCategory": "Pakke",
"subDisplayCategory": "Til privatpersoner",
"displayName": "Pakke i postkassen",
"productName": "Pakke i postkassen",
"descriptionText": "Pakken leveres i din postkasse.",
"helpText": "Pakke i postkassen leveres i mottakers postkasse, og er egnet for små og lette sendinger (maks. 5 kg). Dersom postkassen er låst eller full, blir pakken sendt til mottakers lokale hentested.",
"shortName": "Pakke i postkassen",
"productURL": "http://www.bring.no/sende/pakker/private-i-norge/pakke-i-postkassen",
"deliveryType": "Postkasse",
"maxWeightInKgs": "5"
},
"price": {
"listPrice": {
"priceWithoutAdditionalServices": {
"amountWithoutVAT": "35.00",
"vat": "8.75",
"amountWithVAT": "43.75"
},
"priceWithAdditionalServices": {
"amountWithoutVAT": "35.00",
"vat": "8.75",
"amountWithVAT": "43.75"
},
"currencyCode": "NOK"
}
},
"expectedDelivery": {
"workingDays": "2",
"userMessage": "",
"formattedExpectedDeliveryDate": "11.01.2021 23:59",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "11",
"hour": "23",
"minute": "59"
},
"alternativeDeliveryDates": [
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "7"
},
"formattedExpectedDeliveryDate": "11.01.2021 23:59",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "11",
"hour": "23",
"minute": "59"
}
},
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "8"
},
"formattedExpectedDeliveryDate": "13.01.2021 23:59",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "13",
"hour": "23",
"minute": "59"
}
},
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "9"
},
"formattedExpectedDeliveryDate": "13.01.2021 23:59",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "13",
"hour": "23",
"minute": "59"
}
}
]
}
},
{
"id": "5800",
"productionCode": "5800",
"guiInformation": {
"sortOrder": "222",
"mainDisplayCategory": "Pakke",
"subDisplayCategory": "Til private",
"displayName": "Pakke til hentested",
"productName": "Pakke til hentested",
"descriptionText": "Pakken kan spores og utleveres på ditt lokale hentested.",
"helpText": "Pakke til hentested leveres til mottakers lokale hentested (postkontor eller Post i Butikk). Mottaker kan velge å hente sendingen på et annet hentested enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingsnummeret.",
"shortName": "Pakke til hentested",
"productURL": "",
"deliveryType": "Hentested",
"maxWeightInKgs": "35"
},
"price": {
"listPrice": {
"priceWithoutAdditionalServices": {
"amountWithoutVAT": "136.34",
"vat": "34.09",
"amountWithVAT": "170.43"
},
"priceWithAdditionalServices": {
"amountWithoutVAT": "136.34",
"vat": "34.09",
"amountWithVAT": "170.43"
},
"currencyCode": "NOK"
}
},
"expectedDelivery": {
"workingDays": "2",
"userMessage": "",
"formattedExpectedDeliveryDate": "08.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "8"
},
"alternativeDeliveryDates": [
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "7"
},
"formattedExpectedDeliveryDate": "11.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "11"
}
},
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "8"
},
"formattedExpectedDeliveryDate": "12.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "12"
}
},
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "9"
},
"formattedExpectedDeliveryDate": "13.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "13"
}
}
]
}
},
{
"id": "5600",
"productionCode": "5600",
"guiInformation": {
"sortOrder": "222",
"mainDisplayCategory": "Pakke",
"subDisplayCategory": "Til private",
"displayName": "Pakke levert hjem",
"productName": "Pakke levert hjem",
"descriptionText": "Pakken kan spores og leveres hjem til deg mellom kl. 08-17 eller 15-22 avhengig av ditt postnummer. Vi varsler deg før levering.",
"helpText": "Pakke levert hjem leveres til mottaker mellom kl. 08-17 eller 15-22 avhengig av mottakers postnummer. Mottaker varsles i god tid om forventet utleveringsdag via SMS eller e-post, i tillegg til nytt varsel når sendingen er lastet på bil for utkjøring samme dag. Mottaker kan gi Posten fullmakt til at pakken settes igjen ved døren eller et angitt sted hvis mottaker ikke er hjemme. Sjåføren varsler deg før levering på kveldstid. Mottaker kan endre leveringsdag når pakken spores (gjelder ikke lokalpakker). Dersom sendingen ikke kan leveres, blir den sendt til mottakers lokale hentested (postkontor eller Post i Butikk). Sendingen kan spores ved hjelp av sporingsnummeret.",
"shortName": "Pakke levert hjem",
"productURL": "",
"deliveryType": "Dør",
"maxWeightInKgs": "35"
},
"price": {
"listPrice": {
"priceWithoutAdditionalServices": {
"amountWithoutVAT": "216.76",
"vat": "54.19",
"amountWithVAT": "270.95"
},
"priceWithAdditionalServices": {
"amountWithoutVAT": "216.76",
"vat": "54.19",
"amountWithVAT": "270.95"
},
"currencyCode": "NOK"
}
},
"expectedDelivery": {
"workingDays": "2",
"userMessage": "",
"formattedExpectedDeliveryDate": "08.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "8",
"timeSlots": [
{
"startTime": {
"hour": "8",
"minute": "0"
},
"endTime": {
"hour": "17",
"minute": "0"
}
}
]
},
"alternativeDeliveryDates": [
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "7"
},
"formattedExpectedDeliveryDate": "11.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "11",
"timeSlots": [
{
"startTime": {
"hour": "8",
"minute": "0"
},
"endTime": {
"hour": "17",
"minute": "0"
}
}
]
}
},
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "8"
},
"formattedExpectedDeliveryDate": "12.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "12",
"timeSlots": [
{
"startTime": {
"hour": "8",
"minute": "0"
},
"endTime": {
"hour": "17",
"minute": "0"
}
}
]
}
},
{
"shippingDate": {
"year": "2021",
"month": "1",
"day": "9"
},
"formattedExpectedDeliveryDate": "12.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "12",
"timeSlots": [
{
"startTime": {
"hour": "8",
"minute": "0"
},
"endTime": {
"hour": "17",
"minute": "0"
}
}
]
}
}
]
}
}
]
}
],
"uniqueId": "586b30d6-d440-4c35-bbc1-de6eca68152b"
}Book Pakke til hentested
Endpoint
https://api.bring.com/booking/api/booking
Request
Pakke til hentested (5800) med Valgfritt hentested (1036), Legitimasjonsplikt (1333) og fri retur av pakken. Pickup parcel with Optional pickup point, ID verification and free return of parcel.
{
"schemaVersion": 1,
"consignments": [
{
"shippingDateTime": 2021-06-09T10:49:47.389+02:00,
"parties": {
"sender": {
"name": "Ola Nordmann",
"addressLine": "Testsvingen 12",
"addressLine2": "Postboks 123",
"postalCode": "0263",
"city": "OSLO",
"countryCode": "NO",
"reference": "12345",
"additionalAddressInfo": null,
"contact": {
"name": "Trond Nordmann",
"email": "trond@nordmanntest.no",
"phoneNumber": "99999999"
}
},
"recipient": {
"name": "Tore Mottaker",
"addressLine": "Mottakerveien 14",
"addressLine2": null,
"postalCode": "9011",
"city": "TROMSØ",
"countryCode": "NO",
"reference": null,
"additionalAddressInfo": "Bruk ringeklokken",
"contact": {
"name": "Tore mottaker",
"email": "tore@mottakertest.no",
"phoneNumber": "+4791234567"
}
},
"pickupPoint": {
"id": "122594",
"countryCode": "NO"
}
},
"product": {
"id": "5800",
"customerNumber": "**********",
"additionalServices": [
{
"id": "1133"
}
]
},
"returnProduct": {
"id": "9300",
"additionalServices": null
},
"packages": {
"correlationId": "PACKAGE-123"
"weightInKg": 1.1,
"goodsDescription": "Testing equipment",
"dimensions": {
"heightInCm": 13,
"widthInCm": 23,
"lengthInCm": 10
},
}
]
}
],
"testIndicator": false
}Response
The Booking API generates and sends all necessary EDI messages to carry out the shipment. A URL to a PDF label is returned in the response. The label must be printed and attached to the shipment. A URL for the tracking information is also returned.
A GET request to the label URL will result in a HTTP 302 redirect to the concrete storage facility (e.g. redirect to Amazon S3). Ensure that your client follows these redirects.
{
"consignments": [
{
"confirmation": {
"consignmentNumber": "70438103433585280",
"returnConsignmentNumber": "70438103433585297",
"links": {
"labels": "https://www.mybring.com/booking/labels/1234567?auth-token=5cf1dcee-4f01-4c9a-9870-12345678950b",
"waybill": null,
"tracking": "http://sporing.bring.no/sporing.html?q=70438103433585280"
},
"dateAndTimes": {
"earliestPickup": "2021-06-09T10:49:00+02:00",
"expectedDelivery": "2021-06-14T00:00:00+02:00"
},
"packages": [
{
"packageNumber": "370438101268058536",
"correlationId": "PACKAGE-123"
}
]
},
"errors": null,
"correlationId": "INTERNAL-123456"
}
]
}Relevant API documentation
Pakke til hentested in checkout
1 Delivery option Pakke til hentested
With more than 1700 pickup point locations across Norway, and an increasing number of package boxes being placed around the country (3000 will be in service by the end of 2021), your customers have a wide range of options for where to pick up their package. It is a flexible and safe delivery method.
We recommend using [displayName] from the shipping guide
as the delivery option label.
2 Estimated delivery
Estimated delivery is the combination of your internal lead time and Posten / Bring lead time. For delivery to pickup point, estimated time is available in addition to the estimated date.
You have some options for presentation depending on your shipping
routines. For more detailed information, see
Implement estimated delivery
| Case | Norwegian text in checkout | English text in checkout |
|---|---|---|
| If internal lead time is firm |
Kan hentes på expectedDeliveryDate etter
deliveryEndTime
|
Can be picked up on expectedDeliveryDate after
deliveryEndTime
|
| If internal lead time is variable |
Kan hentes om [min. internal lead time +
workingDays] - [max. internal lead time +
workingDays] dager
|
Can be picked up in [min. internal lead time +
workingDays] - [max. internal leadtime +
workingDays] days
|
3 Description text
A short line giving more information about the delivery method. The most useful information for the end user is the name of the default pickup point.
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Description text |
Til
pickupPointName
|
To pickupPointName |
4 Choose pickup location
If the user selects Pickup point parcel, the best practice is to expand and show a drop down list for pickup points. See the illustration of the dropdown for pickup points, it should display 5–7 closest pickup points. An additional best practice is to allow the user to search based on a postal code, as some users might want to pick up their package in a different location than near their home.
Query with area code and street address
We recommend querying the pickup point API with both area code and full street address to ensure that the returned pickup locations are the most relevant for the end user. A query with only area code will get pickup locations based on the geographic center point of the area.
Package box
If the user choose package box (Type 37), let them know that they need
the Posten app, and if the package is too big it will go to nearest
pickup point. Package box can be identified by
PickupPointType = Type 37
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Label | Velg hentested | Select pickup point |
| Dropdown | namevisitingAddress |
namevisitingAddress |
5 Map
Showing a map is optional, but it may help the user see where the nearest pickup point is.