API updates

Starting 15 March 2023, a new version of the Norwegian cargo waybill with a separate Dangerous Goods Specification page incl. calculated ADR points is launched. API requests for dangerous goods service with the invalid unNumber and/or null weightInGrams/volumeInLitres will not be accepted.

More details on how dangerous goods information should be sent is found here API service portfolio – Bring Developer

Yesterday a new pickup point type for Sweden was launched (type “39”), but it was incorrectly named as “iBoxen paketbox”. The correct name is “Bring paketbox”, while the name “iBoxen paketbox” refers to the existing type “38”.

Sorry about the confusion.

A new pickup point type “39” (iBoxen paketbox) is now supported for Sweden

A new postal code API is now available. The postal code API hosted under /pickuppoint/api/postalCode has been deprecated.

From 19 January 2023, APIs hosted on api-new.bring.com will stop working. It was already mentioned in dns bring updates. Please start using api.bring.com instead of api-new.bring.com.

For more queries contact to integrasjon.norge@bring.com (Norway) or edi@bring.com (outside Norway).

Starting 1 February 2023, minimum shipment weight for 5300 Partigods til bedrift (Partload) will be set to 3500 kg. API requests for 5300 service with a lower total shipment weight will not be accepted. This API update is aligned with service terms and conditions described in our Transport Guide

Starting 1 February 2023, minimum shipment weight for 5300 Partigods til bedrift (Partload) will be set to 3500 kg. API requests for 5300 service with a lower total shipment weight will not be accepted. This API update is aligned with service terms and conditions described in our Transport Guide

Starting 1 February 2023, maximum weight for a pickup order for cargo shipments in Norway will be set to 9999 kg chargeable weight. This limit corresponds to the existing chargeable weight limit for a groupage shipment. Shipments above 9999kg are handled as a door-to-door direct transport service (partload) and, hence, are not eligible for the pickup order service. More information about our service terms and conditions can be found in our Transport Guide

A new address suggestion API is available. The API provides address suggestions matching the provided query string, including house numbers and letters. There are now 2 suggestion APIs available:

• Street or place suggestions (existing)
• Address suggestions (new)

More details here

For services 4850 and 5000, pickup point type 37 (locker/pakkeboks) cannot be requested.

The Same day delivery VAS (2012) allows shipments to be delivered same or next-day, depending on when the shipment is booked. By default, SG API returns the full service coverage area for Same day delivery.

The “sortingAreas” tag allows the web shop to reduce the delivery area to the area they currently choose to provide the service.

The “routeInformation” tag ontains information about the sorting area for a specific parcel. Intended use is to aid pre-sorting of same day parcels.

For more information read https://developer.bring.com/api/shipping-guide_2/#sorting-area-for-same-day-delivery-2012

Pakkeboks pickup points (unit type: 37) in Norway now shows photos of the location. This can be used to assist the end user to find the placement of the pakkeboks at the address.

Important: We’ll soon stop supporting API access on the https://www.mybring.com/booking/api base URL. Please use https://api.bring.com/booking/api instead, if you aren’t already.

Lead time does not only depend on the recipient’s postal code, but also the address itself.

For example, two different addresses on the same postal code can have different lead time. We have therefore added an addressLine field, which allows lead time to be calculated based on both postal code and street address. For this to work, it is important that recipients fill out a valid street address.

By using our Address API, the address the recipients fill inn can be pre-validated, which will ensure more accurate lead times.We therefore recommend using the Address API in combination with Shipping Guide API.

There are several services that are affected by this new field: 1000, 1988, 3500, 5000, 1736, 5600, 0330, 0332, 0349, 3570, 3584

<ns:AddressLine>Testsvingen 12</ns:AddressLine>

      "addressLine":"Testsvingen 12"

The event statuses ARRIVED_COLLECTION and ARRIVED_DELIVERY are not valid anymore, and therefore have been removed from the Tracking API.

Starting 1 August 2022, Tracking API version v1 will be deprecated and the requests will be automatically forwarded to the latest version, v2. It is not a breaking change. In the new version you will have access to many more fields.

For customers requesting environmental data in Shipping Guide API, a link to an environmental logo that can be used in checkout is now being returned in the guiInformation part of the response. Note that the WithGuiInformation field must therefore be set to true. The environmental data description text has also been extended to cover 5800 Pakke til hentested and 0340 Pickup Parcel/0342 Pickup Parcel Bulk when sent to Norway.

PIP services are now visible in Mybring Delivery quality report for Parcel Norway domestic.

New report Complete status including freight cost for Parcel Norway domestic added to Mybring.

Invoice and reports API will use main customer number to get invoice and reports data for parcel international customers.

Address API now supports post office box address queries and validation

Country code SJ (Svalbard and Jan Mayen) has been added to the list of supported country codes

As an increased security measure, we have hidden the pickup code from the open Tracking API. The logged in Tracking API will still contain the pickup code.

Courier bicycle services are currently not supported in Norway.

The tracking link in the response from booking API is changed from http to https.

For estimated arrival times for Norwegian parcels going to pickup points, it is now possible to get arrival date specific arrival times at pickup point when requesting alternate delivery days. The number of expected working days is also returned. For arrival times at pickup points, the ExpectedDelivery response element normally used for lead time information is not returned. In stead a list of EstimatedDeliveryTimes is available.

Read more about estimated arrival times here

Bring’s applications and infrastructure are going through bigger changes, as part of modernizing our infrastructure. One of these changes, is update of our load balancing component, and that will affect services running on api.bring.com. Be sure to verify your integration before the change to ensure no service disruption.

The Tracking API now includes the details of the expected pickup point, where an item is expected to arrive. It contains expected pickup-point-unit id, name and URL(a link to detailed information of pickup point like location, opening hours, etc).

Environmental data including electric and fossil free transportation used during last mile transport leg, is now available for selected Norwegian domestic and Nordic parcel services.

Posten/Bring logo URL is now returned when WithGuiInformation is requested.

When booking parcel services from Finland, weight and dimensions are mandatory to set in the request.

Driving time to returned pickup points is now available in response

Total number of zones used as basis for returned price, is now available for revised groupage and Norwegian domestic parcel services

When requesting 5600 or PÅ_DOREN, the requested shipping date cannot be more than 10 days away if alternate delivery days are requested (via numberOfAlternativeDeliveryDates)

It is now possible to book Nordic parcels with Limited Quantities (0003) additional service

When booking BUSINESS_PARCEL or PICKUP_PARCEL export from Norway, it is now possible to pass an IOSS number as an iossNumber element.

Icelandic postal codes are now supported

The Shipping guide API now includes estimated arrival time window of delivery for selected domestic Norway cargo services.

When booking BUSINESS_PARCEL or PICKUP_PARCEL export from Norway, the customs declaration field CountryOfOrigin is now mandatory. In addition, the recipient email address or phone number has to be provided.

Exposed two new endpoints for listing all available postal codes for supported countries.

Version 1.0 was decommissioned.

For 5800 Pakke til hentested and Servicepakke, leadtime responses (i.e requests with WithExpectedDelivery flag set to true) are now returning an expected delivery date based on historical data (ETA) instead of static calculations.

New versions of the documents Appendix2 Available Services and Appendix 2A Instructions for service Implementation

The Pickup Point API now provides max parcel dimensions for Pakkeboks (parcel lockers in Norway).

The Tracking API now includes estimated arrival time window of delivery for supported shipments.

The Pickup Point API requires authentication for all.

Extended leadtime information is available for Bedriftspakke (BPAKKE_DOR-DOR) and Pakke til bedrift (5000). Both services will now include the shipment’s estimated arrival time in addition to date.

For Norwegian parcel services, unique alternative delivery dates can now be requested.

For Pickup Parcel (0340) and Pickup Parcel Bulk (0342) sent to Sweden and Denmark, Flex Delivery (0041) is no longer applicable as an additional service.

For Pickup Parcel (0340) and Pickup Parcel Bulk (0342) sent to Sweden and Denmark, Flex Delivery (0041) is no longer applicable as an additional service.

Updated maximum length limit for header, also added the maximum length information for id, authenticator, content type and URL.

INDOOR_LIGHT will be decomissioned from schema 11 and 12. Customers requesting this service in our Shipping Guide API must instead use 3332 as ID (note: only available in our latest version - schema 12)

Added support to get estimated arrival time for requested pickup points in Shipping Guide API. On request of these new parameters (for REST API- estimateddeliverytime, pickuppoints and for SOAP V2- WithEstimatedDeliveryTime, PickupPoints), response will contain ’estimatedDeliveryTimes’, representing the estimated time of a parcel`s arrival at the respective pickup point(s).

Added support for Green Delivery as a new tag in Shipping Guide response. Customers requesting Home Delivery services in our Shipping Guide API will get to know whether delivery to a specific postal code is green/fossil free or not.

Added mandatory weight validation for cargo norway bookings along with mandatory atleast one of Volume, Load meters, Dimensions, Pallets

Added mandatory weight validation for cargo norway bookings along with mandatory atleast one of Volume, Load meters, Dimensions, Pallets

Added support for booking parcel services without measurements.

Added support for new request parameter limit. This can be used to limit the number of latest webhooks returned.

Decomissioned version 8 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Added support for new request parameter addressLine. Lead times for Bedriftspakke, 5000, På døren and 5600 will be calculated based on postal code + street address from July 07 2020.

Updated Reports API with APIs used to get reports overview statistics and count of shipments by key events.

Decommissioned the API. Mailbox parcel services must be booked via the Booking API from the same date.

Added support for sending booking confirmation e-mail if e-mail is specified in request. Can be applied to sender’s e-mail for outgoing services, and both sender’s/recipient’s e-mail for return services. Note that e-mail is optional and can at any time be skipped from the request.

Added InvoiceSource in metadata section of the response when specified invoice report is generated.

Decommissioned Courier 6H for Norway from Booking API and Shipping Guide API.

Decommissioned Courier 6H for Norway from Booking API and Shipping Guide API.

Decommissioned Home Delivery Mailbox from Shipping Guide API.

Released Event Cast API, an API for getting event updates pushed instead of polling tracking.

Decommissioned Småpakker from Shipping Guide API.

Added new attributes fromDate and toDate to specify period for fetching invoices.

Decommissioned version 9 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Decommissioned version 7 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

It is now possible to pass customs declaration information that will be sent electronically to the destination country, using the field ediCustomsDeclarations.

Added support for bagOnDoor, a delivery alternative for parcels that cannot be delivered to the mailbox.

Added new syntax for requesting pickup. Both ways are still supported, but they can’t be combined.

Added new attribute OrderItem/ArticleMonetaryAmounts that contains the article unit sales price.

Added new syntax for requesting additional services. Both ways are still supported, but they can’t be combined.

Decommissioned version 1 and 2 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Released Modify Delivery API, an API used to modify a shipment currently on its way.

Decommissioned version 10 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Decommissioned version 3 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Decommissioned version 4, 5 and 6 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

The Order Management API split out of the Warehousing API. These will now continue as two separate APIs.