Pakke i postkassenMailbox parcel
Service codes
| Service name | When to use | Service group | Size limit | Service code | API ID | Value added services | |
|---|---|---|---|---|---|---|---|
| Code | Description | ||||||
| Pakke i postkassenMailbox parcel | If you do not have an RFID printer | Parcels Norway |
5 kg 45 cm long L+W+H: 90 cm |
3584 |
3584
| 1081 | Pose på dørSimplified delivery |
| Pakke i postkassen med RFID*Mailbox parcel with RFID | If you have an RFID printer | Parcels Norway |
5 kg 45 cm long L+W+H: 90 cm |
3570 |
3570
| 1081 | Pose på dørSimplified delivery |
* Tracking with RFID adds additional scanning points for tracking (require RFID printer)
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 i postkassen
Endpoint
https://api.bring.com/booking/api/booking
Request
Pakke i Postkassen (3584) med Pose på døren (1081) og fri retur av pakkenMailbox Parcel with Bag on door 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": "123456",
"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": "3584",
"customerNumber": "*************",
"additionalServices": [
{
"id": "1081"
}
]
},
"returnProduct":
{
"id": "9650",
"additionalServices": null
},
"packages": [
{
"weightInKg": 0.1,
"goodsDescription": "Testing equipment",
"dimensions": {
"heightInCm": 1,
"widthInCm": 9,
"lengthInCm": 14
},
"correlationId": "PACKAGE-123"
}
]
}
],
"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": "70438103433585242",
"returnConsignmentNumber": "70438103433585259",
"links": {
"labels": "https://www.mybring.com/booking/labels/1234567?auth-token=5cf1dcee-4f01-4c9a-9870-12345678950b",
"tracking": "http://sporing.bring.no/sporing.html?q=70438103433585242"
},
"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-11T23:59:00+02:00"
},
"packages": [
{
"packageNumber": "LA591729055NO",
"correlationId": "PACKAGE-123"
}
]
},
"correlationId": "INTERNAL-123456"
}
]
}Pakke i Postkassen med RFID / Mailbox Parcel with RFID (3584)
This requires an RFID printer (Zebra R410 or Zebra 500R). Zebra Programming Language (ZPL) labels are printed. The labels contains instructions for programming the passive RFID antenna in the printer’s labels with package numbers. The ZPL code also contains instructions for rendering the rest of the label (addresses, icons, barcode, etc.).
Relevant API documentation
Pakke i postkassen in checkout
1 Delivery option Pakke i Postkassen
Pakke i postkassen is the recommended default shipping option for small, lower value shipments, as it is the preferred delivery method for recipients for these kind of items.
Mailbox Parcel is slower than Pickup Parcel and Home Delivery. It is uninsured and does not support ID control, age / social control, cooling or other additional services. For deliveries requiring such services, use Home Delivery or Pickup Parcel.
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Delivery option label | [displayName] ex: I postkassen |
To mailbox |
2 Estimated delivery
Estimated delivery depends on your lead time. You have two options depending on your shipping routines.
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Text If internal lead time is firm | Leveres på [expectedDeliveryDate] |
To mailbox |
| Text 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 Description text
A short line providing more information about the delivery method.
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Description text |
[descriptionText] ex: Du får beskjed når pakken er
levert
|
You will get notified when the parcel is delivered |
4 Pose på dør
As mailboxes vary in sizes, the maximum size of Mailbox Parcel will not fit in every mailbox. To accommodate this, it is recommended to provide an option in checkout for the additional service Delivery to doorstep, as a fallback solution.
If the user ticks off and then agrees to terms, the mail carrier can leave packages that do not fit in the mailbox in a bag at the door, instead of sending it to the nearest pickup point. When the mail carrier activates bag on door, an additional charge will be added to the delivery. However, this is still cheaper and faster than re-routing to the pickup point.
Delivery to doorstep should also include a textarea to provide an apartment number or description helping the mail carrier make sure the package is left in a bag at the correct door.
Add the property unit number on the label
Adding the property unit number to the label will help ensure that the package will be delivered as a bag on door. We recommend adding this information to the label, either in the second address line, or in the additional information section (additionalAdressInfo).
| Norwegian text in checkout | English text in checkout | |
|---|---|---|
| Checkbox label | Sett pakken ved døren min om det ikke er plass i postkassen | Leave parcel by the door if the mailbox is too small |
| Checkbox help text | Når du velger å få pakken satt igjen … … kan det ikke være mer enn 250 m fra postkasse til dør. Husnummer må komme tydelig frem, og døren må være merket med navn. Dersom du bor i leilighet, legg inn informasjon om ditt bruksenhetsnummer/etasjenummer. Om Posten ikke har tilgang til døren, blir pakken levert til ditt nærmeste hentested. | If you want to have the parcel left by the door … … it cannot be more than 250 m from mailbox to door. A house number and name sign must be visible. If you live in an apartment, include the apartment number/floor. If Posten does not have access to the door, the parcel will be delivered to nearest pickup point. |
| Text input label | Bruksenhetsnummer eller etasje (hvis du bor i leilighet) | Apartment or floor |
| Text input placeholder | eks. H0301 | example: H0301 |
| Text input help text | Bruksenhetsnummer … … sier hvilken leilighet i bygningen du bor i. Bokstaven forteller om du bor i U (Underetasje), K (Kjeller), H (Hovedetasje) eller L (Loft). De første to sifrene er etasje, eks: 03, de neste to sifrene forteller hvilket nummer leiligheten din har i denne etasjen. H0301 betyr eksempelvis at boligen ligger i tredje etasje (03), første dør fra venstre (01). Eneboliger med kun én boligenhet har alltid bruksenhetsnummer H0101. | Property unit number … … the unit number indicates which flat in the building you live in. The letter indicates if you live on U (the lower floor), K (basement), H (main floor) or L (top floor). Combined with the letter, the first two numbers indicate which floor you live on. The subsequent two numbers indicate your flat number on this floor. For example, H0301 means that the property is on the third floor (03), first door to the left (01). Detached houses with only one residential unit always have unit number H0101. |