Skip to main content

Pakke til hentestedPickup parcel

Service codes

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

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 til hentested

Endpoint

POST
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

All elements for Pickup parcel Open select view for pickup points

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 name
visitingAddress
name
visitingAddress

5 Map

Showing a map is optional, but it may help the user see where the nearest pickup point is.