Skip to main content

Pakke levert hjemHome delivery

Service codes

Service nameService 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

POST
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

POST
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

All elements for Home delivery

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 value

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