Pakke levert hjemHome delivery
Service codes
| Service name | Service group | Size limit | Service code | API ID | Value added services | |
|---|---|---|---|---|---|---|
| Code | Description | |||||
| Pakke levert hjemHome Delivery | Parcel Norway |
35 kg 200 cm long L+W+H: 300 cm |
5600 |
5600
| 0041 | Forenklet utleveringSimplified delivery |
| 1133 | LegitimasjonspliktID verification | |||||
| 1134 | Personlig utleveringIndividual verification | |||||
| 1082 | Sosial kontrollSocial control | |||||
| 1229 | AlderskontrollAge control | |||||
| 1283 | To utkjøringsforsøk, så returTwo delivery attempts, then return to sender | |||||
| 1179 | To utkjøringsforsøk, så hentestedTwo delivery attempts, then to pickup point | |||||
| 1083 | TermoThermo | |||||
| 1280 | Reservation against simplified delivery | |||||
| 1082 | Sosial kontrollSocial control | |||||
| Pakke på dørenHome Delivery | Parcel Norway |
35 kg 200 cm long L+W+H: 300 cm |
1736 |
PA_DOREN
| 1081 | Forenklet utleveringSimplified delivery |
| 1133 | LegitimasjonspliktID verification | |||||
| 1134 | Personlig utleveringIndividual verification | |||||
| 1082 | Sosial kontrollSocial control | |||||
| 1229 | AlderskontrollAge control | |||||
| 1283 | To utkjøringsforsøk, så returTwo delivery attempts, then return to sender | |||||
| 1179 | To utkjøringsforsøk, så hentestedTwo delivery attempts, then to pickup point | |||||
| 1083 | TermoThermo | |||||
| 1280 | Reservation against simplified delivery | |||||
| Home Delivery Parcel | Parcel Nordic |
35 kg 200 cm long L+W+H: 300 cm |
HOME_DELIVERY_PARCEL
| 1091 | E-varslingRecipient notification over SMS or email | |
| 1081 | Forenklet utleveringSimplified delivery | |||||
| 1133 | LegitimasjonspliktID verification | |||||
| 1134 | Personlig utleveringIndividual verification | |||||
| 0068 | TilleggsforsikringOptional insurance | |||||
| 1280 | Reservation against simplified delivery | |||||
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 levert hjem
Endpoint
https://api.bring.com/booking/api/booking
Request
Pakke levert hjem (5600) med Forenklet utlevering (0041), valgfri leveringsdag og fri retur av pakken. Home Delivery with Flex delivery, customer specified delivery time 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": null,
"postalCode": "0263",
"city": "OSLO",
"countryCode": "NO",
"reference": "1234",
"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",
"additionalAddressInfo": null,
"contact": {
"name": "Tore mottaker",
"email": "tore@mottakertest.no",
"phoneNumber": "+4791234567"
}
}
},
"product": {
"id": "5600",
"customerNumber": "***********"
"additionalServices": [
{
"id": "SIMPLE_DELIVERY"
}
]
},
"returnProduct":
{
"id": "9000"
},
"packages": [
{
"weightInKg": 0.1,
"goodsDescription": "Testing equipment",
"dimensions": {
"heightInCm": 1,
"widthInCm": 13,
"lengthInCm": 23
},
"correlationId": "PACKAGE-123"
}
],
"customerSpecifiedDeliveryDateTime": "2021-06-10T17:17:25+02:00"
}
],
"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 be 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": "70438103433585051",
"returnConsignmentNumber": "70438103433585068",
"links": {
"labels": "https://www.mybring.com/booking/labels/1234567?auth-token=5cf1dcee-4f01-4c9a-9870-12345678950b",
"tracking": "http://sporing.bring.no/sporing.html?q=70438103433585051"
},
"returnLinks":
{
"labels": "https://www.qa.mybring.com/booking/labels/7654321/return?auth-token=bb7752fc-5815-4e5e-a7a7-123456789477",
"tracking": "http://sporing.bring.no/sporing.html?q=70438103433585259"
},
"dateAndTimes": {
"earliestPickup": "2021-06-09T10:49:00+02:00",
"expectedDelivery": "2021-06-10T00:00:00+02:00"
},
"packages": [
{
"packageNumber": "370438103696484710",
"correlationId": "PACKAGE-123"
}
]
},
"correlationId": "INTERNAL-123456"
}
]
}Relevant API documentation
1 Delivery option Pakke levert hjem
Home delivery is one of the most convenient delivery methods for consumers, allowing them to get the product right on their doorstep. Posten goes a step further than some competitors by delivering to the doorstep even in apartment buildings.
Items up to 35 kg can be delivered using the service. It is especially recommended for products that are either heavy, expensive or time-sensitive for the consumer.
Insured, quick and delivered personally to recipients, it is a flexible and safe delivery method for both sender and recipient.
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. 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, and you offer optional delivery day | Velg levering fra [expectedDeliveryDate] |
Choose delivery from [expectedDeliveryDate] |
| If internal lead time is firm, without optional delivery day | Leveres på [expectedDeliveryDate] |
Delivered on [expectedDeliveryDate] |
| If internal lead time is variable |
Leveres om [min. internal lead time + workingDays]
- [max. internal lead time + workingDays] dager
|
Delivered in [min. internal lead time +
workingDays] - [max. internal leadtime +
workingDays] days
|
3 Optional delivery day
For home delivery, is possible to let users order a specific delivery date. You should add internal lead-time to the response by providing a date that the shipment will be sent to Bring to ensure that the customer does not choose a date that is impossible to deliver at.
Use the following parameters to retrieve alternative delivery dates for home delivery in Shipping Guide:
"numberOfAlternativeDeliveryDates": 5 // recommended valueNote that if the package is delivered too late to Bring, or an invalid date is requested, the recipient will get a notification that the package can not be delivered at their ordered date, and that it will be delivered on the first possible date instead.
Recipients may also change the delivery date through Posten recipient apps.
Some postal areas are split into several delivery zones, which impacts the delivery estimates. See Implementing estimated delivery for more information.
Delivery time windows vary based on location, you should therefore use
the [startTime] and [endTime] values from
shipping guide for this display.
4 Description text
A short line that give more information about the delivery method.
We recommend using the value returned in
descriptionText from Shipping Guide instead of a
hardcoded text, as there might be different information for different
area codes.
5 Hensetting (simplified delivery)
The customer can choose to have the package left outside or inside. If they choose outside, they can enter a description for the delivery person.
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Checkbox label | Sett igjen pakken | Leave package outside |
| Text input label | Beskrivelse til budet | Apartment |
| Text input help text | Når du velger at pakken settes igjen ... ... betyr det at budet setter pakken utenfor døren din. Om du bor i leilighet blir pakken satt igjen utenfor boligblokken da de ikke har nøkkel til boligblokken | When you select that the package should be left outside ... ... it means that the delivery person leave your parcel outside your door. Your parcel will be placed outside the first locked door, since the delivery person does not have access to apartment buildings |
| Text area placeholder | eks. på dørmatta | example: on the doormat |
| Text area help text | Beskriv gjerne hvor pakken skal settes ... ... spesielt om du har et lett tilgjengelig gjemmested som en putekasse, åpen garasje eller lignende. | Describe where you want your parcel to be placed ... ... especially if you have a good hiding place with easy access like pillow box, open garage etc. |