Shipping Guide API

Introduction

The Shipping Guide (Fraktguiden) is a free service from Bring that provides

  • price information,
  • service area (norwegian: dekningsområde), and
  • estimated delivery times.

With the Shipping Guide it is easy to offer different shipping alternatives to your end customers. Whether they want to

  • get delivery to the door (daytime or evening),
  • pick up the shipment at a post office, or
  • get the shipment delivered to the mailbox

The Shipping Guide returns the recommended way to present these shipping alternatives, as well as prices and delivery times.

Demo shipping alternatives form (Norwegian).

The demo shows that the Shipping Guide returns product categories for each request, making a shipping alternatives-page easy to set up. The focus is on delivery methods to the end customer, not product names.

The Shipping Guide has several interfaces (SOAP and XML/JSON). Choose the option that fits your needs best (see table below). The SOAP interface is the core interface with complete functionality. There are some limitations in the XML/JSON API, such as the inability to mark a parcel as a specialized goods.

There is also a Offline SOAP service for retrieving data for offline use (get complete prices, service area and delivery times based on a fixed sender postal code).

Psst! We also have a Java client library for the Shipping Guide API.

Available Products

The Shipping Guide API has a lot of various products and additional services. So many, in fact, that we decided to document them in a separate page.

See the whole list of products and additional services here.

General Guidelines

VAT

Shipping Guide specifies VAT related to senders country. It’s up to the client to decide if VAT is applicable to their situation of sale.

Additional services affecting price

Make sure you specify the correct additional services for a package when querying the Shipping Guide.

Especially the evarsling additional service for the Servicepakke product (recipient notification over SMS or E-Mail) will affect the base package price returned from the Shipping Guide, and should therefore be set according to what will be sent in the actual EDI message.

If evarsling is not specified in the request, Fraktguiden will from 2013-01-01 add a fee for paper based recipient notification to the base package price for Servicepakke. As of 2013-01-01 the fee is NOK 4,-

Error Handling Guidelines

When using the Shipping Guide, it is important to handle errors gracefully. Your web shop’s users should still be able to order, even if the Shipping Guide returns an error or a timeout occurs.

No products applicable

If there are no products applicable for the requested shipment, an empty resultset will be returned. This means that for the passed-in product list, no products can be used for the shipment. Either the shipment is too large or is outside of the coverage area of all the requested products. Your code should handle this case, i.e. an empty product list for the shipment.

One suggestion is to include more products in each request, e.g. a Cargo-product to handle large shipments. You should know how to send Cargo products before including it though.

General errors

When using the Shipping Guide, errors or service unavailability can occur, although we do our utmost to prevent any downtime. Thus it is important to use timeouts and other error handling techniques when making requests to the service.

How you handle errors depends on the nature of your application, but one strategy for handling such situations is by providing a failover if the shipping guide responds with an error or does not respond at all (timeout).

For instance your application can respond to an error by using prefetched offline data to calculate prices and delivery time estimates. Another alternative would be to use a a fixed standard price whenever an error occurs.

Error codes for rejected requests

Code Message in English Message in Norwegian
FG_INPUT_001 Shipping date must be set Innleveringsdato må være satt
FG_INPUT_002 Error with Postal code Feil i postnummer
FG_INPUT_003 Missing UserInformation element in request Mangler UserInformation element i request.
FG_INPUT_004 At least one product id must be set Minst et produkt må være valgt
FG_INPUT_005 Wrong date format Feil i datoformat
FG_INPUT_006 Error with volume Feil med volum
FG_INPUT_008 Missing Package element Mangler Package element
FG_INPUT_010 Error number of alternative deliverydates Feil antall alternative leveringsdager
FG_INPUT_011 Wrong weight unit code Feil vektkode
FG_INPUT_012 Invalid weight format Feil vekt format
FG_INPUT_013 Invalid volume format Feil volum format
FG_INPUT_014 Invalid volume unit code Feil volumkode
FG_INPUT_016 Invalid input dimensions Feil med dimensjoner
FG_INPUT_017 Invalid input dimensions unit code Feil dimensjonskode
FG_INPUT_018 Too many packages For mange pakker
FG_INPUT_019 Product id missing Produkt id mangler
FG_INPUT_020 Invalid offline from post number Feil offline fra postnummer
FG_INPUT_021 Non existing postalcode Postnummer eksisterer ikke
FG_INPUT_022 Missing weight or volume Mangler vekt eller volum
FG_INPUT_023 Unexpected parameter Ikke gyldig parameter
FG_INPUT_024 Invalid input price adjustment Feil input til prisjustering
FG_INPUT_025 Unknown public id Feil public id
FG_INPUT_027 Invalid country code Feil landkode
FG_INPUT_029 Wrong time format Feil tidsformat
FG_INPUT_030 Invalid request version Ugyldig request versjon
FG_INPUT_031 Request version missing Request versjon mangler
FG_INPUT_032 Mismatch in value in package and consignment. Mismatch i verdi i pakke i forhold til sending.
FG_INPUT_033 A consignment element must be specified when requesting a consignment-oriented product. Det må spesifiseres et consignment-element når det bes om et sendingsorientert produkt.
FG_INPUT_034 Error with City Feil i city
FG_INPUT_035 Shipping date must be current date or in the future when net prices are requested. Avtalepriser støtter ikke shipping date tilbake i tid.
FG_INPUT_036 Schema version 8 and newer does no longer support user code. Use Client URL instead. See XSD Schema documentation. Schema versjon 8 og nyere støtter ikke lenger user code. Bruk heller Client URL. Sjekk XSD Schema dokumentasjon.
FG_INPUT_037 Schema version 8 and newer requires Client URL element set. See XSD Schema documentation. Schema versjon 8 og nyere krever Client URL element set. Sjekk XSD Schema dokumentasjon.
FG_INPUT_038 Schema version 8 and newer requires that the api.bring.com/shippingguide endpoint is used. Check out developer.bring.com Schema versjon 8 og nyere krever at api.bring.com/shippingguide endpoint benyttes. Se developer.bring.com.
FG_INPUT_039 Endpoint at api.bring.com/shippingguide requires that schema version 8 or newer is used. Check out developer.bring.com Endpoint på api.bring.com/shippingguide krever at schema version 8 eller nyere benyttes. Se developer.bring.com.
FG_INPUT_040 Invalid UNNumber format. UNNumber must be a four digit string. Ex: 0030 Feil UNNumber format. UNNumber skal være en fire sifret streng. Eks: 0030
FG_INPUT_041 Oil express product requires a customer number set on the product element, because only contract prices are available. Oljeekspressproduktet krever et kundenummer. Kun avtalepris tilgjengelig.
FG_INPUT_042 Could not parse the input string to Betaler. Kunne ikke analysere strengen til påvirker betaler.
FG_INPUT_043 Invalid combination of additional services. Ugyldig kombinasjon av tilleggstjenester.
FG_INPUT_044 Missing Consignment Request element. Mangler Consignment Request element.
FG_PRODUCT_001 Product unknown Produkt ukjent
FG_PRODUCT_002 Product not available as offline data. Produkt ikke tilgjengelig i offline data-format.
FG_PRODUCT_003 Outside of coverage area for product. Utenfor dekningsområde for produkt.
FG_UNKNOWN_001 Unknown internal error Ukjent intern feil
FG_USER_002 Wrong usercode Feil identifiakasjonsstreng
FG_USER_007 Customer number specified, but user is not logged in. Please set the mybring authentication headers. Kundenummer angitt, men bruker er ikke innlogget. Vennligst sett mybring autentiseringsheadere.
FG_USER_008 Logged-in user does not have access to specified customer Pålogget bruker har ikke tilgang spesifisert kunde
FG_USER_009 Customer number is not applicable for specified produkt Kundenummer er ikke gyldig for spesifisert produktkode
FG_USER_010 Customer not found for super user. Kunde ikke funnet for superbruker
FG_USER_011 Customer does not have right access role for service Kunde har ikke riktig tilgangs rolle for tjenesten
FG_EXTERNAL_SERVICE_NO_PRICE An external system failed to return the cost for the actual shipping. Please check your input data. Et eksternt system returnerte ikke pris på selve frakten. Vennligst sjekk input data.

Offline data

Offline data lets you download a failover version of the data from the Shipping Guide.

By using the Offline Data Web Service (see WSDL) or Offline Data form you can download price lists, transport times and additional services designed for offline usage. Offline data is suitable as a failover solution if the Shipping Guide does not respond or responds with an error message, or if there are extreme demands on performance.

Important! With offline data, you have to deal with all the rules of special goods, shipping calculated weight (volume weight), and more. These rules are located on the respective product pages on bring.com. Remember to update the database at price changes!

The service is available free of charge, provided acceptance of the terms of use. Note that only registered users will receive notifications of changes in service!

For those who use the offline data, we recommend to get the updates automatically via Offline Data Web Service.

Useful XPaths when processing offline data

Get Price Zone (returns an empty answer if toPostalCode is outside the coverage area for the chosen product):

//Product[@productId='SERVICEPAKKE']//PriceZone[@toPostalCode='2000']/text()

Get Price based on Price Zone “2”:

//Product[@productId="SERVICEPAKKE"]//Price[@priceZone="2" and @weight="4000"]/text()

Get transport time:

//Product[@productId='SERVICEPAKKE']//WorkingDays[@toPostalCode="2000"]/text()

Additional information

If you are a Mybring user, you can authenticate requests to the Shipping Guide. Authenticated requests have the following benefits:

  • Agreement prices
  • Prices for additional services
  • Lead time
  • Coverage

The bad news is that you only get agreement prices for Norwegian customer numbers. Fixing this is on our todo list, though.

Overview of endpoints

Base URL

https://api.bring.com/shippingguide
Method Endpoint Usage
GET /products/price{mediaTypeExtension} Get shipment prices
GET /products/expectedDelivery{mediaTypeExtension} Get estimated delivery time
GET /products/all{mediaTypeExtension} Get shipment prices, estimated delivery and more
GET /api/ws SOAP

Get shipment prices

URL

https://api.bring.com/shippingguide/products/price.json
https://api.bring.com/shippingguide/products/price.xml

Request params

Query parameter Type Description
from string

Optional. From postal code.


Example: 7600
to string

Optional. To postal code.


Example: 1407
weightInGrams integer

Optional. Weight of package in grams.


Example: 1500
width integer

Optional. Package width in centimeters.


Example: 40
length integer

Optional. Package length in centimeters.


Example: 40
height integer

Optional. Package height in centimeters.


Example: 30
NonStackable boolean

Optional. Default false. Set to true if you know that pallet would be non-stackable.


Example: true
date date

Optional. Shipping date. Specifies which date the parcel will be delivered to Bring (within the time limit), and is used to calculate the delivery date. Date is specified in ISO format, YYYY-MM-DD.


Example: 2015-11-18
time date

Optional. Shipping time. Shipping time may be specified. Note that Bring’s courier products are the only one affected by this parameter. Time is specified in ISO format, HH:mm.


Example: 45000
clientUrl string

Optional. Client URL. To use the Shipping Guide you must specify a client url parameter. The client url should be set to the url of the web shop or application the end user is ordering from. The client url can be sent as a url parameter, clientUrl, or as a header, X-Bring-Client-URL.


Example: https://www.example.com/amazing-clothes/
edi boolean

Optional. EDI setting. Flag that tells if the parcel will be registred using EDI when it is shipped. Note that this flag may affect price and which products are available.

Possible values
  • true
  • false

Default value: true
postingAtPostOffice boolean

Optional. Flag that tells whether the parcel is delivered at a post office when it is shipped.

A surcharge will be applied for the following products:

  • SERVICEPAKKE
  • BPAKKE_DOR-DOR (Bedriftspakke)
Possible values
  • true
  • false
additional string

Optional. Additional services. Request additional services for the package. Specified by adding one or more additional parameters to the request, e.g. &additional=postoppkrav&additional=evarsling. See the additional services list. The Shipping Guide will match the additional service codes to the requested products and ignore product / additional service codes that are not applicable.


Example: evarsling
priceAdjustments string

Optional. Adjusts the price (w/o VAT) returned. The format of it is [<product code>_][p(lus)|m(inus)]factor[p(ercentage)]


Pattern: ^((\w*_)?(p|m|)\d*(\.\d|)|(\w*_)?(p|m)\d*(\.\d|)p)$
Example: m20p
pid string

Optional. Public ID. The last part (after the last dash) of your identification string (logged-in information for user of Shipping Guide). This makes the Shipping Guide know who performs the query, so we may contact the correct shipping guide user for potential follow ups.

product string

Optional. Products. This parameter lets you specify which products you want to return information about. If you omit this parameter, you get the default product list (not recommended for production usage). Product is specified by adding one or more product parameters, e.g. product=servicepakke&product=bpakke_dor-dor.


Example: bpakke_dor-dor
customerNumber string

Optional. Customer number. This parameter lets you specify which customer number to use to get additional information about the specified product(s). This parameter requires user authentication. If you are authenticated but omit this parameter, shipping guide will try to select an applicable customer number for you. If there is only one applicable customer number, it will automatically be selected, but if there are multiple matches you have to specify which to use by using this parameter.


Example: CARGO-123456
language string

Optional. Language. Which language the descriptive product texts should have. Supported languages are Swedish (se), Danish (da) and Norwegian (no). If no language is set, or text is not available in the requested language, norwegian text is returned.


Example: en
volumeSpecial boolean

Optional. Special volume. Flag to indicate if the package has a shape that may require ‘special handling fee’. product=servicepakke&product=bpakke_dor-dor.

Response

Successful response (200)

In this example, we’re querying for prices for Pickup Parcel and Pickup Parcel Business for a 2,5kg package from Sweden to Denmark.

Request: …&fromCountry=SE&from=11640&toCountry=DK&to=1440&product=pickup_parcel&product=business_parcel

{
   "@packageId": "0",
   "Product": [{
      "ProductId": "PICKUP_PARCEL",
      "ProductCodeInProductionSystem": "0340",
      "Price": {
         "@currencyIdentificationCode": "SEK",
         "PackagePriceWithoutAdditionalServices": {
            "AmountWithoutVAT": "293.90",
            "VAT": "73.47",
            "AmountWithVAT": "367.37"
         },
         "PackagePriceWithAdditionalServices": {
            "AmountWithoutVAT": "293.90",
            "VAT": "73.47",
            "AmountWithVAT": "367.37"
         }
      }
   }, {
      "ProductId": "BUSINESS_PARCEL",
      "ProductCodeInProductionSystem": "0330",
      "Price": {
         "@currencyIdentificationCode": "SEK",
         "PackagePriceWithoutAdditionalServices": {
            "AmountWithoutVAT": "335.00",
            "VAT": "83.75",
            "AmountWithVAT": "418.75"
         },
         "PackagePriceWithAdditionalServices": {
            "AmountWithoutVAT": "335.00",
            "VAT": "83.75",
            "AmountWithVAT": "418.75"
         }
      }
   }],
   "TraceMessages": {
      "Message": ["Using VAT rate of origin country and leaving it up to you as a client to decide whether or not VAT is applicable in the specific sales situation.", "Price for PICKUP_PARCEL is without fuel surcharge. This fee must be added manually by the client.", "Price for BUSINESS_PARCEL is without fuel surcharge. This fee must be added manually by the client."]
   }
}

<?xml version="1.0" encoding="UTF-8"?>
<Package packageId="0">
  <!--See service terms and conditions at http://developer.bring.com/-->
  <Product>
    <ProductId>PICKUP_PARCEL</ProductId>
    <ProductCodeInProductionSystem>0340</ProductCodeInProductionSystem>
    <Price currencyIdentificationCode="SEK">
      <PackagePriceWithoutAdditionalServices>
        <AmountWithoutVAT>293.90</AmountWithoutVAT>
        <VAT>73.47</VAT>
        <AmountWithVAT>367.37</AmountWithVAT>
      </PackagePriceWithoutAdditionalServices>
      <PackagePriceWithAdditionalServices>
        <AmountWithoutVAT>293.90</AmountWithoutVAT>
        <VAT>73.47</VAT>
        <AmountWithVAT>367.37</AmountWithVAT>
      </PackagePriceWithAdditionalServices>
    </Price>
  </Product>
  <Product>
    <ProductId>BUSINESS_PARCEL</ProductId>
    <ProductCodeInProductionSystem>0330</ProductCodeInProductionSystem>
    <Price currencyIdentificationCode="SEK">
      <PackagePriceWithoutAdditionalServices>
        <AmountWithoutVAT>335.00</AmountWithoutVAT>
        <VAT>83.75</VAT>
        <AmountWithVAT>418.75</AmountWithVAT>
      </PackagePriceWithoutAdditionalServices>
      <PackagePriceWithAdditionalServices>
        <AmountWithoutVAT>335.00</AmountWithoutVAT>
        <VAT>83.75</VAT>
        <AmountWithVAT>418.75</AmountWithVAT>
      </PackagePriceWithAdditionalServices>
    </Price>
  </Product>
  <TraceMessages>
    <Message>Using VAT rate of origin country and leaving it up to you as a client to decide whether or not VAT is applicable in the specific sales situation.</Message>
    <Message>Price for PICKUP_PARCEL is without fuel surcharge. This fee must be added manually by the client.</Message>
    <Message>Price for BUSINESS_PARCEL is without fuel surcharge. This fee must be added manually by the client.</Message>
  </TraceMessages>
</Package>

Get estimated delivery time

URL

https://api.bring.com/shippingguide/products/expectedDelivery.json
https://api.bring.com/shippingguide/products/expectedDelivery.xml

Request params

Query parameter Type Description
from string

Optional. From postal code.


Example: 7600
to string

Optional. To postal code.


Example: 1407
weightInGrams integer

Optional. Weight of package in grams.


Example: 1500
width integer

Optional. Package width in centimeters.


Example: 40
length integer

Optional. Package length in centimeters.


Example: 40
height integer

Optional. Package height in centimeters.


Example: 30
date date

Optional. Shipping date. Specifies which date the parcel will be delivered to Bring (within the time limit), and is used to calculate the delivery date. Date is specified in ISO format, YYYY-MM-DD.


Example: 2015-11-18
time date

Optional. Shipping time. Shipping time may be specified. Note that Bring’s courier products are the only one affected by this parameter. Time is specified in ISO format, HH:mm.


Example: 45000
clientUrl string

Optional. Client URL. To use the Shipping Guide you must specify a client url parameter. The client url should be set to the url of the web shop or application the end user is ordering from. The client url can be sent as a url parameter, clientUrl, or as a header, X-Bring-Client-URL.


Example: https://www.example.com/amazing-clothes/
edi boolean

Optional. EDI setting. Flag that tells if the parcel will be registred using EDI when it is shipped. Note that this flag may affect price and which products are available.


Default value: true
postingAtPostOffice boolean

Optional. Flag that tells whether the parcel is delivered at a post office when it is shipped.

A surcharge will be applied for the following products:

  • SERVICEPAKKE
  • BPAKKE_DOR-DOR (Bedriftspakke)
additional string

Optional. Additional services. Request additional services for the package. Specified by adding one or more additional parameters to the request, e.g. &additional=postoppkrav&additional=evarsling. See the additional services list. The Shipping Guide will match the additional service codes to the requested products and ignore product / additional service codes that are not applicable.


Example: evarsling
priceAdjustments string

Optional. Price adjustments. Adjusts the price (w/o VAT) returned. The format of it is [<product code>_][p(lus)|m(inus)]factor[p(ercentage)]


Pattern: ^((\w*_)?(p|m|)\d*(\.\d|)|(\w*_)?(p|m)\d*(\.\d|)p)$
Example: m20p
pid string

Optional. Public ID. The last part (after the last dash) of your identification string (logged-in information for user of Shipping Guide). This makes the Shipping Guide know who performs the query, so we may contact the correct shipping guide user for potential follow ups.

product string

Optional. Products. This parameter lets you specify which products you want to return information about. If you omit this parameter, you get the default product list (not recommended for production usage). Product is specified by adding one or more product parameters, e.g. product=servicepakke&product=bpakke_dor-dor.


Example: bpakke_dor-dor
language string

Optional. Language. Which language the descriptive product texts should have. Supported languages are English (en), Swedish (se), Finnish (fi), Danish (da) and Norwegian (no). If no language is set, or text is not available in the requested language, norwegian text is returned.


Example: en
volumeSpecial boolean

Optional. Special volume. Flag to indicate if the package has a shape that may require ‘special handling fee’. product=servicepakke&product=bpakke_dor-dor.

Response

Successful response (200)

In this example, we’re querying for expected delivery time for various products for a package from Sweden to Denmark.

Request: …fromCountry=SE&from=11640&toCountry=DK&to=1440&product=PICKUP_PARCEL&product=PICKUP_PARCEL_BULK&product=SERVICEPAKKE&product=BPAKKE_DOR-DOR

{
  "@packageId": "0",
  "Product": [{
    "ProductId": "PICKUP_PARCEL_BULK",
    "ProductCodeInProductionSystem": "0342",
    "ExpectedDelivery": {
      "WorkingDays": null,
      "UserMessage": "Fremsendingstider er ikke tilgjengelig for dette produktet.",
      "FormattedExpectedDeliveryDate": null,
      "FormattedEarliestPickupDate": null
    }
  }, {
    "ProductId": "PICKUP_PARCEL",
    "ProductCodeInProductionSystem": "0340",
    "ExpectedDelivery": {
      "WorkingDays": "1-2",
      "UserMessage": null,
      "AlternativeDeliveryDates": null
    }
  }],
  "TraceMessages": {
    "Message": ["Product SERVICEPAKKE can not be sent from country SWEDEN to country DENMARK ", "Product BPAKKE_DOR-DOR can not be sent from country SWEDEN to country DENMARK "]
  }
}

<?xml version="1.0" encoding="UTF-8"?>
<Package packageId="0">
  <!--See service terms and conditions at http://developer.bring.com/-->
  <Product>
    <ProductId>PICKUP_PARCEL_BULK</ProductId>
    <ProductCodeInProductionSystem>0342</ProductCodeInProductionSystem>
    <ExpectedDelivery>
      <WorkingDays/>
      <UserMessage>Fremsendingstider er ikke tilgjengelig for dette produktet.</UserMessage>
      <FormattedExpectedDeliveryDate/>
      <FormattedEarliestPickupDate/>
    </ExpectedDelivery>
  </Product>
  <Product>
    <ProductId>PICKUP_PARCEL</ProductId>
    <ProductCodeInProductionSystem>0340</ProductCodeInProductionSystem>
    <ExpectedDelivery>
      <WorkingDays>1-2</WorkingDays>
      <UserMessage/>
      <AlternativeDeliveryDates/>
    </ExpectedDelivery>
  </Product>
  <TraceMessages>
    <Message>Product SERVICEPAKKE can not be sent from country SWEDEN to country DENMARK</Message>
    <Message>Product BPAKKE_DOR-DOR can not be sent from country SWEDEN to country DENMARK</Message>
  </TraceMessages>
</Package>

Get shipment prices, estimated delivery and more

Use this endpoint to get price, expected delivery, product categories and additional information such as an indication of which alternative has the least environmental impact.

URL

https://api.bring.com/shippingguide/products/all.json
https://api.bring.com/shippingguide/products/all.xml

Request params

Query parameter Type Description
from string

Optional. From postal code.


Example: 7600
to string

Optional. To postal code.


Example: 1407
weightInGrams integer

Optional. Weight of package in grams.


Example: 1500
width integer

Optional. Package width in centimeters.


Example: 40
length integer

Optional. Package length in centimeters.


Example: 40
height integer

Optional. Package height in centimeters.


Example: 30
NonStackable boolean

Optional. Default false. Set to true if you know that pallet would be non-stackable.


Example: true
date date

Optional. Shipping date. Specifies which date the parcel will be delivered to Bring (within the time limit), and is used to calculate the delivery date. Date is specified in ISO format, YYYY-MM-DD.


Example: 2015-11-18
time date

Optional. Shipping time. Shipping time may be specified. Note that Bring’s courier products are the only one affected by this parameter. Time is specified in ISO format, HH:mm.


Example: 45000
clientUrl string

Optional. Client URL. To use the Shipping Guide you must specify a client url parameter. The client url should be set to the url of the web shop or application the end user is ordering from. The client url can be sent as a url parameter, clientUrl, or as a header, X-Bring-Client-URL.


Example: https://www.example.com/amazing-clothes/
edi boolean

Optional. EDI setting. Flag that tells if the parcel will be registred using EDI when it is shipped. Note that this flag may affect price and which products are available.


Default value: true
postingAtPostOffice boolean

Optional. Flag that tells whether the parcel is delivered at a post office when it is shipped.

A surcharge will be applied for the following products:

  • SERVICEPAKKE
  • BPAKKE_DOR-DOR (Bedriftspakke)
additional string

Optional. Additional services. Request additional services for the package. Specified by adding one or more additional parameters to the request, e.g. &additional=postoppkrav&additional=evarsling. See the additional services list. The Shipping Guide will match the additional service codes to the requested products and ignore product / additional service codes that are not applicable.


Example: evarsling
priceAdjustments string

Optional. Price adjustments. Adjusts the price (w/o VAT) returned. The format of it is [<product code>_][p(lus)|m(inus)]factor[p(ercentage)]


Pattern: ^((\w*_)?(p|m|)\d*(\.\d|)|(\w*_)?(p|m)\d*(\.\d|)p)$
Example: m20p
pid string

Optional. Public ID. The last part (after the last dash) of your identification string (logged-in information for user of Shipping Guide). This makes the Shipping Guide know who performs the query, so we may contact the correct shipping guide user for potential follow ups.

product string

Optional. Products. This parameter lets you specify which products you want to return information about. If you omit this parameter, you get the default product list (not recommended for production usage). Product is specified by adding one or more product parameters, e.g. product=servicepakke&product=bpakke_dor-dor.


Example: bpakke_dor-dor
customerNumber string

Optional. Customer number. This parameter lets you specify which customer number to use to get additional information about the specified product(s). This parameter requires user authentication. If you are authenticated but omit this parameter, shipping guide will try to select an applicable customer number for you. If there is only one applicable customer number, it will automatically be selected, but if there are multiple matches you have to specify which to use by using this parameter.


Example: CARGO-123456
language string

Optional. Language. Which language the descriptive product texts should have. Supported languages are English (en), Swedish (se), Finnish (fi), Danish (da) and Norwegian (no). If no language is set, or text is not available in the requested language, norwegian text is returned.


Example: en
volumeSpecial boolean

Optional. Special volume. Flag to indicate if the package has a shape that may require ‘special handling fee’. product=servicepakke&product=bpakke_dor-dor.

Response

Successful response (200)

For a given shipment from A to B, the core way to use the Shipping Guide is to query for all the products you know how to send (e.g. the products you have a customer agreement for). From that given set of products specified in the request, the Shipping Guide will return the products that are relevant for the shipment, based on product attributes (e.g. max package size and weight) and service area (norwegian: dekningsområde), e.g. not all products are offered to all postal codes.

Example: You have a package of 2,5 kilos from postal codes 0484 to 5600 that you want to send. Your webshop knows how to send (e.g. has a customer agreement) for sending the following Bring products:

  • Servicepakke
  • Bedriftspakke
  • Bedriftspakke Ekspress - Over Natten
  • På Døren
  • A-Post
  • B-Post

The Shipping Guide request should then be made for all the products (explicitly set using multiple product parameters), and the Shipping Guide will tell you which products are applicable. E.g. A-Post and B-Post are not applicable since the package is greater than 2 kg, and postal code 5600 is outside the service area for “På Døren”.

Request: ../all.json?clientUrl=insertYourClientUrlHere&weightInGrams=2500&from=0484&to=5600&product=servicepakke&product=bpakke_dor-dor&product=ekspress09&product=pa_doren&product=a-post&product=b-post

{
  "@packageId": "0",
  "Product": [{
    "ProductId": "SERVICEPAKKE",
    "ProductCodeInProductionSystem": "1202",
    "GuiInformation": {
      "SortOrder": "11",
      "MainDisplayCategory": "Hent varene selv",
      "SubDisplayCategory": null,
      "DisplayName": "På posten",
      "ProductName": "Klimanøytral Servicepakke",
      "DescriptionText": "Coop Prix Norheimsund. Åpningstider Man - Fre: 0800-2200, Lør: 0800-2000",
      "HelpText": "Sendingen er en Klimanøytral Servicepakke som blir levert til mottakers postkontor/ post i butikk. Mottaker kan velge å hente sendingen på et annet postkontor/post i butikk enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Transporttid er normalt 1-3 virkedager, avhengig av strekning. Sendingen kan spores ved hjelp av sporingsnummeret.",
      "Tip": "Minst miljøbelastende!",
      "MaxWeightInKgs": "35"
    },
    "Price": {
      "@currencyIdentificationCode": "NOK",
      "PackagePriceWithoutAdditionalServices": {
        "AmountWithoutVAT": "118.00",
        "VAT": "29.50",
        "AmountWithVAT": "147.50"
      },
      "PackagePriceWithAdditionalServices": {
        "AmountWithoutVAT": "118.00",
        "VAT": "29.50",
        "AmountWithVAT": "147.50"
      }
    },
    "ExpectedDelivery": {
      "WorkingDays": "2",
      "UserMessage": null,
      "AlternativeDeliveryDates": null
    }
  }, {
    "ProductId": "BPAKKE_DOR-DOR",
    "ProductCodeInProductionSystem": "1000",
    "GuiInformation": {
      "SortOrder": "42",
      "MainDisplayCategory": "Få varene levert",
      "SubDisplayCategory": "Til døren",
      "DisplayName": "På jobben, 08-16",
      "ProductName": "Bedriftspakke",
      "DescriptionText": "Leveres uten at sjåføren ringer først \n",
      "HelpText": "Sendingen er en Bedriftspakke som leveres til mottakers arbeidssted mellom klokken 08 og 16. Bestiller du varsling, vil mottaker varsles når sendingen er lastet på bil for uttkjøring, via SMS og/eller e-post. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk. Mottaker varsles om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingssnummeret.",
      "Tip": null,
      "MaxWeightInKgs": "35"
    },
    "Price": {
      "@currencyIdentificationCode": "NOK",
      "PackagePriceWithoutAdditionalServices": {
        "AmountWithoutVAT": "160.00",
        "VAT": "40.00",
        "AmountWithVAT": "200.00"
      },
      "PackagePriceWithAdditionalServices": {
        "AmountWithoutVAT": "160.00",
        "VAT": "40.00",
        "AmountWithVAT": "200.00"
      }
    },
    "ExpectedDelivery": {
      "WorkingDays": "1",
      "UserMessage": null,
      "AlternativeDeliveryDates": null
    }
  }, {
    "ProductId": "EKSPRESS09",
    "ProductCodeInProductionSystem": "1002",
    "GuiInformation": {
      "SortOrder": "44",
      "MainDisplayCategory": "Få sendingen levert",
      "SubDisplayCategory": "Til døren",
      "DisplayName": "Ekspress over natten",
      "ProductName": "Bedriftspakke Ekspress-Over natten",
      "DescriptionText": "Levering på dør vil skje påfølgende dag før kl 0900. På ditt postnummer vil noen adresser få levering innen kl 1600.",
      "HelpText": "Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.",
      "Tip": null,
      "MaxWeightInKgs": "35"
    },
    "Price": {
      "@currencyIdentificationCode": "NOK",
      "PackagePriceWithoutAdditionalServices": {
        "AmountWithoutVAT": "449.00",
        "VAT": "112.25",
        "AmountWithVAT": "561.25"
      },
      "PackagePriceWithAdditionalServices": {
        "AmountWithoutVAT": "449.00",
        "VAT": "112.25",
        "AmountWithVAT": "561.25"
      }
    },
    "ExpectedDelivery": {
      "WorkingDays": "1",
      "UserMessage": null,
      "AlternativeDeliveryDates": null
    }
  }],
  "TraceMessages": {
    "Message": ["Product PA_DOREN can not be sent between the given postal codes / countries ", "Added fee 'brev-varsling' (NOK 10.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.", "Package exceed maximum measurements for product B-POST ", "Package exceed maximum measurements for product A-POST "]
  }
}

<?xml version="1.0" encoding="UTF-8"?>
<Package packageId="0">
  <!--See service terms and conditions at http://developer.bring.com/-->
  <Product>
    <ProductId>SERVICEPAKKE</ProductId>
    <ProductCodeInProductionSystem>1202</ProductCodeInProductionSystem>
    <GuiInformation>
      <SortOrder>11</SortOrder>
      <MainDisplayCategory>Hent varene selv</MainDisplayCategory>
      <SubDisplayCategory/>
      <DisplayName>På posten</DisplayName>
      <ProductName>Klimanøytral Servicepakke</ProductName>
      <DescriptionText>Coop Prix Norheimsund. Åpningstider Man - Fre: 0800-2200, Lør: 0800-2000</DescriptionText>
      <HelpText>Sendingen er en Klimanøytral Servicepakke som blir levert til mottakers postkontor/ post i butikk. Mottaker kan velge å hente sendingen på et annet postkontor/post i butikk enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Transporttid er normalt 1-3 virkedager, avhengig av strekning. Sendingen kan spores ved hjelp av sporingsnummeret.</HelpText>
      <Tip>Minst miljøbelastende!</Tip>
      <MaxWeightInKgs>35</MaxWeightInKgs>
    </GuiInformation>
    <Price currencyIdentificationCode="NOK">
      <PackagePriceWithoutAdditionalServices>
        <AmountWithoutVAT>118.00</AmountWithoutVAT>
        <VAT>29.50</VAT>
        <AmountWithVAT>147.50</AmountWithVAT>
      </PackagePriceWithoutAdditionalServices>
      <PackagePriceWithAdditionalServices>
        <AmountWithoutVAT>118.00</AmountWithoutVAT>
        <VAT>29.50</VAT>
        <AmountWithVAT>147.50</AmountWithVAT>
      </PackagePriceWithAdditionalServices>
    </Price>
    <ExpectedDelivery>
      <WorkingDays>2</WorkingDays>
      <UserMessage/>
      <AlternativeDeliveryDates/>
    </ExpectedDelivery>
  </Product>
  <Product>
    <ProductId>BPAKKE_DOR-DOR</ProductId>
    <ProductCodeInProductionSystem>1000</ProductCodeInProductionSystem>
    <GuiInformation>
      <SortOrder>42</SortOrder>
      <MainDisplayCategory>Få varene levert</MainDisplayCategory>
      <SubDisplayCategory>Til døren</SubDisplayCategory>
      <DisplayName>På jobben, 08-16</DisplayName>
      <ProductName>Bedriftspakke</ProductName>
      <DescriptionText>Leveres uten at sjåføren ringer først</DescriptionText>
      <HelpText>Sendingen er en Bedriftspakke som leveres til mottakers arbeidssted mellom klokken 08 og 16. Bestiller du varsling, vil mottaker varsles når sendingen er lastet på bil for uttkjøring, via SMS og/eller e-post. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk. Mottaker varsles om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingssnummeret.</HelpText>
      <Tip/>
      <MaxWeightInKgs>35</MaxWeightInKgs>
    </GuiInformation>
    <Price currencyIdentificationCode="NOK">
      <PackagePriceWithoutAdditionalServices>
        <AmountWithoutVAT>160.00</AmountWithoutVAT>
        <VAT>40.00</VAT>
        <AmountWithVAT>200.00</AmountWithVAT>
      </PackagePriceWithoutAdditionalServices>
      <PackagePriceWithAdditionalServices>
        <AmountWithoutVAT>160.00</AmountWithoutVAT>
        <VAT>40.00</VAT>
        <AmountWithVAT>200.00</AmountWithVAT>
      </PackagePriceWithAdditionalServices>
    </Price>
    <ExpectedDelivery>
      <WorkingDays>1</WorkingDays>
      <UserMessage/>
      <AlternativeDeliveryDates/>
    </ExpectedDelivery>
  </Product>
  <Product>
    <ProductId>EKSPRESS09</ProductId>
    <ProductCodeInProductionSystem>1002</ProductCodeInProductionSystem>
    <GuiInformation>
      <SortOrder>44</SortOrder>
      <MainDisplayCategory>Få sendingen levert</MainDisplayCategory>
      <SubDisplayCategory>Til døren</SubDisplayCategory>
      <DisplayName>Ekspress over natten</DisplayName>
      <ProductName>Bedriftspakke Ekspress-Over natten</ProductName>
      <DescriptionText>Levering på dør vil skje påfølgende dag før kl 0900. På ditt postnummer vil noen adresser få levering innen kl 1600.</DescriptionText>
      <HelpText>Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.</HelpText>
      <Tip/>
      <MaxWeightInKgs>35</MaxWeightInKgs>
    </GuiInformation>
    <Price currencyIdentificationCode="NOK">
      <PackagePriceWithoutAdditionalServices>
        <AmountWithoutVAT>449.00</AmountWithoutVAT>
        <VAT>112.25</VAT>
        <AmountWithVAT>561.25</AmountWithVAT>
      </PackagePriceWithoutAdditionalServices>
      <PackagePriceWithAdditionalServices>
        <AmountWithoutVAT>449.00</AmountWithoutVAT>
        <VAT>112.25</VAT>
        <AmountWithVAT>561.25</AmountWithVAT>
      </PackagePriceWithAdditionalServices>
    </Price>
    <ExpectedDelivery>
      <WorkingDays>1</WorkingDays>
      <UserMessage/>
      <AlternativeDeliveryDates/>
    </ExpectedDelivery>
  </Product>
  <TraceMessages>
    <Message>Product PA_DOREN can not be sent between the given postal codes / countries</Message>
    <Message>Added fee 'brev-varsling' (NOK 10.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.</Message>
    <Message>Package exceed maximum measurements for product B-POST</Message>
    <Message>Package exceed maximum measurements for product A-POST</Message>
  </TraceMessages>
</Package>

More examples

  • Multiple parcels in one query

    It is also possible to combine weight, volume and dimensions for multiple parcels. Multiple parcels are specified by suffixing weightInGrams, volume or dimensions (length, width or height), with sequential numbers from 0.

    The data used in this example is:

    • from=7041
    • to=0558

    Parcels:

    1. weightInGrams0=1500
    2. volume1=33
    3. length2=10&width2=20&height2=30

    Example request

    {
        "@packageId": "consignment_0_1_2",
        "Product": [
            {
                "ProductId": "SERVICEPAKKE",
                "ProductCodeInProductionSystem": "1202",
                "GuiInformation": {
                    "SortOrder": "11",
                    "MainDisplayCategory": "Hent varene selv",
                    "SubDisplayCategory": null,
                    "DisplayName": "På posten",
                    "ProductName": "Klimanøytral Servicepakke",
                    "DescriptionText": "Rimi Trondheimsveien. Åpningstider Man - Lør: 0700-2300",
                    "HelpText": "Sendingen er en Klimanøytral Servicepakke som blir levert til mottakers postkontor/ post i butikk. Mottaker kan velge å hente sendingen på et annet postkontor/post i butikk enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Transporttid er normalt 1-3 virkedager, avhengig av strekning. Sendingen kan spores ved hjelp av sporingsnummeret.",
                    "Tip": "Billigst!",
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "299.00",
                        "VAT": "74.75",
                        "AmountWithVAT": "373.75"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "299.00",
                        "VAT": "74.75",
                        "AmountWithVAT": "373.75"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "AlternativeDeliveryDates": null
                }
            },
            {
                "ProductId": "PA_DOREN",
                "ProductCodeInProductionSystem": "1736",
                "GuiInformation": {
                    "SortOrder": "41",
                    "MainDisplayCategory": "Få varene levert",
                    "SubDisplayCategory": "Til døren",
                    "DisplayName": "Hjem på kvelden, 17-21",
                    "ProductName": "På Døren",
                    "DescriptionText": "Pakken leveres hjem til deg, sjåføren ringer 30 - 60 min. før ankomst
    ",
                    "HelpText": "Sendingen leveres hjem til deg mellom klokken 17 og 21. Du varsles i god tid om forventet utleveringsdag på sms og/eller e-post, i tillegg til nytt varsel når sendingen er lastet på bil for utkjøring samme kveld. Sjåfør ringer deg på mobiltelefon 30 - 60 minutter før levering. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk og du vil motta en varsel om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingsnummeret.",
                    "Tip": null,
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "346.00",
                        "VAT": "86.50",
                        "AmountWithVAT": "432.50"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "346.00",
                        "VAT": "86.50",
                        "AmountWithVAT": "432.50"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "AlternativeDeliveryDates": null
                }
            },
            {
                "ProductId": "BPAKKE_DOR-DOR",
                "ProductCodeInProductionSystem": "1000",
                "GuiInformation": {
                    "SortOrder": "42",
                    "MainDisplayCategory": "Få varene levert",
                    "SubDisplayCategory": "Til døren",
                    "DisplayName": "På jobben, 08-16",
                    "ProductName": "Bedriftspakke",
                    "DescriptionText": "Leveres uten at sjåføren ringer først 
    ",
                    "HelpText": "Sendingen er en Bedriftspakke som leveres til mottakers arbeidssted mellom klokken 08 og 16. Bestiller du varsling, vil mottaker varsles når sendingen er lastet på bil for uttkjøring, via SMS og/eller e-post. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk. Mottaker varsles om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingssnummeret.",
                    "Tip": null,
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "417.00",
                        "VAT": "104.25",
                        "AmountWithVAT": "521.25"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "417.00",
                        "VAT": "104.25",
                        "AmountWithVAT": "521.25"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "AlternativeDeliveryDates": null
                }
            },
            {
                "ProductId": "EKSPRESS09",
                "ProductCodeInProductionSystem": "1002",
                "GuiInformation": {
                    "SortOrder": "44",
                    "MainDisplayCategory": "Få varene levert",
                    "SubDisplayCategory": "Til døren",
                    "DisplayName": "På jobben innen 0900",
                    "ProductName": "Bedriftspakke Ekspress-Over natten",
                    "DescriptionText": "Levering på arbeidssted innen kl 0900",
                    "HelpText": "Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.",
                    "Tip": null,
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "896.00",
                        "VAT": "224.00",
                        "AmountWithVAT": "1120.00"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "896.00",
                        "VAT": "224.00",
                        "AmountWithVAT": "1120.00"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "AlternativeDeliveryDates": null
                }
            }
        ],
        "TraceMessages": {
            "Message": [
                "Some inconsistency in weight and volume input (not uniformly weight and/or volume set on all packages). All available data will be used for price calculation.",
                "Length, Width and Height is required for exact price calculation for product B-POST",
                "Length, Width and Height is required for exact price calculation for product A-POST",
                "Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.",
                "Package exceed maximum measurements for product B-POST ",
                "Package exceed maximum measurements for product A-POST ",
                "Product B-POST requires weight information ",
                "Product A-POST requires weight information "
            ]
        }
    }
    
    <Package packageId="consignment_0_1_2">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                SERVICEPAKKE
            </ProductId>
            <ProductCodeInProductionSystem>
                1202
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    11
                </SortOrder>
                <MainDisplayCategory>
                    Hent varene selv
                </MainDisplayCategory>
                <SubDisplayCategory>
                </SubDisplayCategory>
                <DisplayName>
                    På posten
                </DisplayName>
                <ProductName>
                    Klimanøytral Servicepakke
                </ProductName>
                <DescriptionText>
                    Rimi Trondheimsveien. Åpningstider Man - Lør: 0700-2300
                </DescriptionText>
                <HelpText>
                    Sendingen er en Klimanøytral Servicepakke som blir levert til mottakers postkontor/ post i butikk. Mottaker kan velge å hente sendingen på et annet postkontor/post i butikk enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Transporttid er normalt 1-3 virkedager, avhengig av strekning. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                    Billigst!
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        299.00
                    </AmountWithoutVAT>
                    <VAT>
                        74.75
                    </VAT>
                    <AmountWithVAT>
                        373.75
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        299.00
                    </AmountWithoutVAT>
                    <VAT>
                        74.75
                    </VAT>
                    <AmountWithVAT>
                        373.75
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <Product>
            <ProductId>
                PA_DOREN
            </ProductId>
            <ProductCodeInProductionSystem>
                1736
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    41
                </SortOrder>
                <MainDisplayCategory>
                    Få varene levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    Hjem på kvelden, 17-21
                </DisplayName>
                <ProductName>
                    På Døren
                </ProductName>
                <DescriptionText>
                    Pakken leveres hjem til deg, sjåføren ringer 30 - 60 min. før ankomst
                </DescriptionText>
                <HelpText>
                    Sendingen leveres hjem til deg mellom klokken 17 og 21. Du varsles i god tid om forventet utleveringsdag på sms og/eller e-post, i tillegg til nytt varsel når sendingen er lastet på bil for utkjøring samme kveld. Sjåfør ringer deg på mobiltelefon 30 - 60 minutter før levering. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk og du vil motta en varsel om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        346.00
                    </AmountWithoutVAT>
                    <VAT>
                        86.50
                    </VAT>
                    <AmountWithVAT>
                        432.50
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        346.00
                    </AmountWithoutVAT>
                    <VAT>
                        86.50
                    </VAT>
                    <AmountWithVAT>
                        432.50
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <Product>
            <ProductId>
                BPAKKE_DOR-DOR
            </ProductId>
            <ProductCodeInProductionSystem>
                1000
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    42
                </SortOrder>
                <MainDisplayCategory>
                    Få varene levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    På jobben, 08-16
                </DisplayName>
                <ProductName>
                    Bedriftspakke
                </ProductName>
                <DescriptionText>
                    Leveres uten at sjåføren ringer først
                </DescriptionText>
                <HelpText>
                    Sendingen er en Bedriftspakke som leveres til mottakers arbeidssted mellom klokken 08 og 16. Bestiller du varsling, vil mottaker varsles når sendingen er lastet på bil for uttkjøring, via SMS og/eller e-post. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk. Mottaker varsles om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingssnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        417.00
                    </AmountWithoutVAT>
                    <VAT>
                        104.25
                    </VAT>
                    <AmountWithVAT>
                        521.25
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        417.00
                    </AmountWithoutVAT>
                    <VAT>
                        104.25
                    </VAT>
                    <AmountWithVAT>
                        521.25
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <Product>
            <ProductId>
                EKSPRESS09
            </ProductId>
            <ProductCodeInProductionSystem>
                1002
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    44
                </SortOrder>
                <MainDisplayCategory>
                    Få varene levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    På jobben innen 0900
                </DisplayName>
                <ProductName>
                    Bedriftspakke Ekspress-Over natten
                </ProductName>
                <DescriptionText>
                    Levering på arbeidssted innen kl 0900
                </DescriptionText>
                <HelpText>
                    Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        896.00
                    </AmountWithoutVAT>
                    <VAT>
                        224.00
                    </VAT>
                    <AmountWithVAT>
                        1120.00
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        896.00
                    </AmountWithoutVAT>
                    <VAT>
                        224.00
                    </VAT>
                    <AmountWithVAT>
                        1120.00
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <TraceMessages>
            <Message>
                Some inconsistency in weight and volume input (not uniformly weight and/or volume set on all packages). All available data will be used for price calculation.
            </Message>
            <Message>
                Length, Width and Height is required for exact price calculation for product B-POST
            </Message>
            <Message>
                Length, Width and Height is required for exact price calculation for product A-POST
            </Message>
            <Message>
                Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.
            </Message>
            <Message>
                Package exceed maximum measurements for product B-POST
            </Message>
            <Message>
                Package exceed maximum measurements for product A-POST
            </Message>
            <Message>
                Product B-POST requires weight information
            </Message>
            <Message>
                Product A-POST requires weight information
            </Message>
        </TraceMessages>
    </Package>
    
  • International shipments

    Specified using fromCountry=NO&toCountry=DK.

    Country Codes are ISO-3166-1-alpha-2.

    Example request.

    {
        "@packageId": "0",
        "Product": {
            "ProductId": "PICKUP_PARCEL_NORWAY",
            "ProductCodeInProductionSystem": "0340",
            "ExpectedDelivery": {
                "WorkingDays": "3-5",
                "UserMessage": null,
                "AlternativeDeliveryDates": null
            }
        },
        "TraceMessages": null
    }
    
    <Package packageId="0">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                PICKUP_PARCEL
            </ProductId>
            <ProductCodeInProductionSystem>
                0340
            </ProductCodeInProductionSystem>
            <ExpectedDelivery>
                <WorkingDays>
                    3-5
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <TraceMessages>
        </TraceMessages>
    </Package>
    
  • International shipments to countries without postal codes

    In the example below, a parcel is sent from Norway to Dublin, Ireland. The parameters are:

    • ?fromCountry=NO
    • &toCountry=IE
    • &to=0
    • &toCity=Dublin

    To see both the expected delivery time and the price, we’ve added:

    • &weightInGrams=300, and
    • all.json

    Example request

    {
        "@packageId": "0",
        "Product": {
            "ProductId": "PICKUP_PARCEL_NORWAY",
            "ProductCodeInProductionSystem": "0340",
            "GuiInformation": {
                "SortOrder": "50",
                "MainDisplayCategory": "Pakke Utland",
                "SubDisplayCategory": "Homeshopping Utland",
                "DisplayName": "Til mottakers dør",
                "ProductName": "CarryOn Homeshopping Norge",
                "DescriptionText": "Pakke til privatperson i utlandet",
                "HelpText": "CarryOn Homeshopping er en enkel og effektiv måte å sende pakker til privatepersoner Norden og til resten av verden. Pakker hentes i henhold til avtale, og leveres til mottager mellom mandag -  fredag i kontortiden. I enkelte land leveres pakkene på mottakers Postkontor/PIB.",
                "Tip": null,
                "MaxWeightInKgs": "20"
            },
            "Price": {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices": {
                    "AmountWithoutVAT": "308.00",
                    "VAT": "77.00",
                    "AmountWithVAT": "385.00"
                },
                "PackagePriceWithAdditionalServices": {
                    "AmountWithoutVAT": "308.00",
                    "VAT": "77.00",
                    "AmountWithVAT": "385.00"
                }
            },
            "ExpectedDelivery": {
                "WorkingDays": "4",
                "UserMessage": null,
                "AlternativeDeliveryDates": null
            }
        },
        "TraceMessages": {
            "Message": [
                "Using VAT rate of origin country and leaving it up to you as a client to decide whether or not VAT is applicable in the specific sales situation.",
                "Price for PICKUP_PARCEL_NORWAY is without fuel surcharge. This fee must be added manually by the client."
            ]
        }
    }
    
    <Package packageId="0">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                PICKUP_PARCEL
            </ProductId>
            <ProductCodeInProductionSystem>
                0340
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    50
                </SortOrder>
                <MainDisplayCategory>
                    Pakke Utland
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Homeshopping Utland
                </SubDisplayCategory>
                <DisplayName>
                    Til mottakers dør
                </DisplayName>
                <ProductName>
                    CarryOn Homeshopping Norge
                </ProductName>
                <DescriptionText>
                    Pakke til privatperson i utlandet
                </DescriptionText>
                <HelpText>
                    CarryOn Homeshopping er en enkel og effektiv måte å sende pakker til privatepersoner Norden og til resten av verden. Pakker hentes i henhold til avtale, og leveres til mottager mellom mandag -  fredag i kontortiden. I enkelte land leveres pakkene på mottakers Postkontor/PIB.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    20
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        308.00
                    </AmountWithoutVAT>
                    <VAT>
                        77.00
                    </VAT>
                    <AmountWithVAT>
                        385.00
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        308.00
                    </AmountWithoutVAT>
                    <VAT>
                        77.00
                    </VAT>
                    <AmountWithVAT>
                        385.00
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    4
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <TraceMessages>
            <Message>
                Using VAT rate of origin country and leaving it up to you as a client to decide whether or not VAT is applicable in the specific sales situation.
            </Message>
            <Message>
                Price for PICKUP_PARCEL_NORWAY is without fuel surcharge. This fee must be added manually by the client.
            </Message>
        </TraceMessages>
    </Package>
    
  • Three ways to specify a package size

    Weight in grams

    Specified using weightInGrams=1500.

    Package dimensions

    Specified using length=30&width=40&height=40.

    Volume

    Instead of, or in addition to using the package’s weight and dimensions you can specify volume. This is relevant for non-rectangular hexahedron shaped packages, and depending on the volume, it could affect the set of available products. The unit is dm3.

    Specified using volume=33.

    
    {
       "@packageId": "0",
       "Product":    [
                {
             "ProductId": "PA_DOREN",
             "ProductCodeInProductionSystem": "1736",
             "Price":          {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices":             {
                   "AmountWithoutVAT": "174.00",
                   "VAT": "43.50",
                   "AmountWithVAT": "217.50"
                },
                "PackagePriceWithAdditionalServices":             {
                   "AmountWithoutVAT": "174.00",
                   "VAT": "43.50",
                   "AmountWithVAT": "217.50"
                }
             }
          },
                {
             "ProductId": "BPAKKE_DOR-DOR",
             "ProductCodeInProductionSystem": "1000",
             "Price":          {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices":             {
                   "AmountWithoutVAT": "197.00",
                   "VAT": "49.25",
                   "AmountWithVAT": "246.25"
                },
                "PackagePriceWithAdditionalServices":             {
                   "AmountWithoutVAT": "197.00",
                   "VAT": "49.25",
                   "AmountWithVAT": "246.25"
                }
             }
          },
                {
             "ProductId": "EKSPRESS09",
             "ProductCodeInProductionSystem": "1002",
             "Price":          {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices":             {
                   "AmountWithoutVAT": "596.00",
                   "VAT": "149.00",
                   "AmountWithVAT": "745.00"
                },
                "PackagePriceWithAdditionalServices":             {
                   "AmountWithoutVAT": "596.00",
                   "VAT": "149.00",
                   "AmountWithVAT": "745.00"
                }
             }
          },
                {
             "ProductId": "SERVICEPAKKE",
             "ProductCodeInProductionSystem": "1202",
             "Price":          {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices":             {
                   "AmountWithoutVAT": "155.00",
                   "VAT": "38.75",
                   "AmountWithVAT": "193.75"
                },
                "PackagePriceWithAdditionalServices":             {
                   "AmountWithoutVAT": "155.00",
                   "VAT": "38.75",
                   "AmountWithVAT": "193.75"
                }
             }
          }
       ],
       "TraceMessages": {"Message":    [
          "Package exceed maximum measurements for product B-POST ",
          "Package exceed maximum measurements for product A-POST ",
          "Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified."
       ]}
    }
    
    
    <?xml version="1.0" encoding="UTF-8"?>
    <Package packageId="0">
      <!--See service terms and conditions at http://developer.bring.com/-->
      <Product>
        <ProductId>PA_DOREN</ProductId>
        <ProductCodeInProductionSystem>1736</ProductCodeInProductionSystem>
        <Price currencyIdentificationCode="NOK">
          <PackagePriceWithoutAdditionalServices>
            <AmountWithoutVAT>174.00</AmountWithoutVAT>
            <VAT>43.50</VAT>
            <AmountWithVAT>217.50</AmountWithVAT>
          </PackagePriceWithoutAdditionalServices>
          <PackagePriceWithAdditionalServices>
            <AmountWithoutVAT>174.00</AmountWithoutVAT>
            <VAT>43.50</VAT>
            <AmountWithVAT>217.50</AmountWithVAT>
          </PackagePriceWithAdditionalServices>
        </Price>
      </Product>
      <Product>
        <ProductId>BPAKKE_DOR-DOR</ProductId>
        <ProductCodeInProductionSystem>1000</ProductCodeInProductionSystem>
        <Price currencyIdentificationCode="NOK">
          <PackagePriceWithoutAdditionalServices>
            <AmountWithoutVAT>197.00</AmountWithoutVAT>
            <VAT>49.25</VAT>
            <AmountWithVAT>246.25</AmountWithVAT>
          </PackagePriceWithoutAdditionalServices>
          <PackagePriceWithAdditionalServices>
            <AmountWithoutVAT>197.00</AmountWithoutVAT>
            <VAT>49.25</VAT>
            <AmountWithVAT>246.25</AmountWithVAT>
          </PackagePriceWithAdditionalServices>
        </Price>
      </Product>
      <Product>
        <ProductId>EKSPRESS09</ProductId>
        <ProductCodeInProductionSystem>1002</ProductCodeInProductionSystem>
        <Price currencyIdentificationCode="NOK">
          <PackagePriceWithoutAdditionalServices>
            <AmountWithoutVAT>596.00</AmountWithoutVAT>
            <VAT>149.00</VAT>
            <AmountWithVAT>745.00</AmountWithVAT>
          </PackagePriceWithoutAdditionalServices>
          <PackagePriceWithAdditionalServices>
            <AmountWithoutVAT>596.00</AmountWithoutVAT>
            <VAT>149.00</VAT>
            <AmountWithVAT>745.00</AmountWithVAT>
          </PackagePriceWithAdditionalServices>
        </Price>
      </Product>
      <Product>
        <ProductId>SERVICEPAKKE</ProductId>
        <ProductCodeInProductionSystem>1202</ProductCodeInProductionSystem>
        <Price currencyIdentificationCode="NOK">
          <PackagePriceWithoutAdditionalServices>
            <AmountWithoutVAT>155.00</AmountWithoutVAT>
            <VAT>38.75</VAT>
            <AmountWithVAT>193.75</AmountWithVAT>
          </PackagePriceWithoutAdditionalServices>
          <PackagePriceWithAdditionalServices>
            <AmountWithoutVAT>155.00</AmountWithoutVAT>
            <VAT>38.75</VAT>
            <AmountWithVAT>193.75</AmountWithVAT>
          </PackagePriceWithAdditionalServices>
        </Price>
      </Product>
      <TraceMessages>
        <Message>Package exceed maximum measurements for product B-POST</Message>
        <Message>Package exceed maximum measurements for product A-POST</Message>
        <Message>Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.</Message>
      </TraceMessages>
    </Package>
    
  • Get the expected delivery date

    Specifies the date the package is delivered to Bring. The parameter is used to calculate the expected delivery date.

    Specified using date=YYYY-MM-DD.

    If this parameter is specified, the response will include expected delivery date, in addition to expected number of working days.

    Example request

    {
        "@packageId": "0",
        "Product": {
            "ProductId": "EKSPRESS09",
            "ProductCodeInProductionSystem": "1002",
            "GuiInformation": {
                "SortOrder": "44",
                "MainDisplayCategory": "Få sendingen levert",
                "SubDisplayCategory": "Til døren",
                "DisplayName": "Ekspress over natten",
                "ProductName": "Bedriftspakke Ekspress-Over natten",
                "DescriptionText": "Levering på dør vil skje påfølgende dag innen kl 1600 for dette postnummeret.",
                "HelpText": "Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.",
                "Tip": null,
                "MaxWeightInKgs": "35"
            },
            "Price": {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices": {
                    "AmountWithoutVAT": "525.00",
                    "VAT": "131.25",
                    "AmountWithVAT": "656.25"
                },
                "PackagePriceWithAdditionalServices": {
                    "AmountWithoutVAT": "525.00",
                    "VAT": "131.25",
                    "AmountWithVAT": "656.25"
                }
            },
            "ExpectedDelivery": {
                "WorkingDays": "1",
                "UserMessage": null,
                "FormattedExpectedDeliveryDate": "30.11.2015 16:00",
                "ExpectedDeliveryDate": {
                    "Year": "2015",
                    "Month": "11",
                    "Day": "30",
                    "Hour": "16",
                    "Minute": "0"
                },
                "AlternativeDeliveryDates": null
            }
        },
        "TraceMessages": {
            "Message": "Defaulting to current time of day as no hour and minute component present in date time element."
        }
    }
    
    <Package packageId="0">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                EKSPRESS09
            </ProductId>
            <ProductCodeInProductionSystem>
                1002
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    44
                </SortOrder>
                <MainDisplayCategory>
                    Få sendingen levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    Ekspress over natten
                </DisplayName>
                <ProductName>
                    Bedriftspakke Ekspress-Over natten
                </ProductName>
                <DescriptionText>
                    Levering på dør vil skje påfølgende dag innen kl 1600 for dette postnummeret.
                </DescriptionText>
                <HelpText>
                    Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        525.00
                    </AmountWithoutVAT>
                    <VAT>
                        131.25
                    </VAT>
                    <AmountWithVAT>
                        656.25
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        525.00
                    </AmountWithoutVAT>
                    <VAT>
                        131.25
                    </VAT>
                    <AmountWithVAT>
                        656.25
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <FormattedExpectedDeliveryDate>
                    30.11.2015 16:00
                </FormattedExpectedDeliveryDate>
                <ExpectedDeliveryDate>
                    <Year>
                        2015
                    </Year>
                    <Month>
                        11
                    </Month>
                    <Day>
                        30
                    </Day>
                    <Hour>
                        16
                    </Hour>
                    <Minute>
                        0
                    </Minute>
                </ExpectedDeliveryDate>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <TraceMessages>
            <Message>
                Defaulting to current time of day as no hour and minute component present in date time element.
            </Message>
        </TraceMessages>
    </Package>
    
  • Specify the pickup time from the departure point

    Use this parameter if you would like to specify when during the day the package needs to be picked up from the departure point.

    This parameter is only considered for courier and express products.

    Specified using date=HHHH-YY-MM&time=mm:ss (date and time are required to use this option).

    Example request

    {
        "@packageId": "0",
        "Product": [
            {
                "ProductId": "SERVICEPAKKE",
                "ProductCodeInProductionSystem": "1202",
                "GuiInformation": {
                    "SortOrder": "11",
                    "MainDisplayCategory": "Hent varene selv",
                    "SubDisplayCategory": null,
                    "DisplayName": "På posten",
                    "ProductName": "Klimanøytral Servicepakke",
                    "DescriptionText": "Hentes på mottakers lokale postkontor/post i butikk.",
                    "HelpText": "Sendingen er en Klimanøytral Servicepakke som blir levert til mottakers postkontor/ post i butikk. Mottaker kan velge å hente sendingen på et annet postkontor/post i butikk enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Transporttid er normalt 1-3 virkedager, avhengig av strekning. Sendingen kan spores ved hjelp av sporingsnummeret.",
                    "Tip": "Raskest!",
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "132.00",
                        "VAT": "33.00",
                        "AmountWithVAT": "165.00"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "132.00",
                        "VAT": "33.00",
                        "AmountWithVAT": "165.00"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "FormattedExpectedDeliveryDate": "28.11.2015",
                    "ExpectedDeliveryDate": {
                        "Year": "2015",
                        "Month": "11",
                        "Day": "28"
                    },
                    "AlternativeDeliveryDates": null
                }
            },
            {
                "ProductId": "PA_DOREN",
                "ProductCodeInProductionSystem": "1736",
                "GuiInformation": {
                    "SortOrder": "41",
                    "MainDisplayCategory": "Få varene levert",
                    "SubDisplayCategory": "Til døren",
                    "DisplayName": "Hjem på kvelden, 17-21",
                    "ProductName": "På Døren",
                    "DescriptionText": "Pakken leveres hjem til deg, sjåføren ringer 30 - 60 min. før ankomst
    ",
                    "HelpText": "Sendingen leveres hjem til deg mellom klokken 17 og 21. Du varsles i god tid om forventet utleveringsdag på sms og/eller e-post, i tillegg til nytt varsel når sendingen er lastet på bil for utkjøring samme kveld. Sjåfør ringer deg på mobiltelefon 30 - 60 minutter før levering. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk og du vil motta en varsel om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingsnummeret.",
                    "Tip": null,
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "142.00",
                        "VAT": "35.50",
                        "AmountWithVAT": "177.50"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "142.00",
                        "VAT": "35.50",
                        "AmountWithVAT": "177.50"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "FormattedExpectedDeliveryDate": "30.11.2015",
                    "ExpectedDeliveryDate": {
                        "Year": "2015",
                        "Month": "11",
                        "Day": "30"
                    },
                    "AlternativeDeliveryDates": null
                }
            },
            {
                "ProductId": "BPAKKE_DOR-DOR",
                "ProductCodeInProductionSystem": "1000",
                "GuiInformation": {
                    "SortOrder": "42",
                    "MainDisplayCategory": "Få varene levert",
                    "SubDisplayCategory": "Til døren",
                    "DisplayName": "På jobben, 08-16",
                    "ProductName": "Bedriftspakke",
                    "DescriptionText": "Leveres uten at sjåføren ringer først 
    ",
                    "HelpText": "Sendingen er en Bedriftspakke som leveres til mottakers arbeidssted mellom klokken 08 og 16. Bestiller du varsling, vil mottaker varsles når sendingen er lastet på bil for uttkjøring, via SMS og/eller e-post. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk. Mottaker varsles om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingssnummeret.",
                    "Tip": null,
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "177.00",
                        "VAT": "44.25",
                        "AmountWithVAT": "221.25"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "177.00",
                        "VAT": "44.25",
                        "AmountWithVAT": "221.25"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "FormattedExpectedDeliveryDate": "30.11.2015",
                    "ExpectedDeliveryDate": {
                        "Year": "2015",
                        "Month": "11",
                        "Day": "30"
                    },
                    "AlternativeDeliveryDates": null
                }
            },
            {
                "ProductId": "EKSPRESS09",
                "ProductCodeInProductionSystem": "1002",
                "GuiInformation": {
                    "SortOrder": "44",
                    "MainDisplayCategory": "Få sendingen levert",
                    "SubDisplayCategory": "Til døren",
                    "DisplayName": "Ekspress over natten",
                    "ProductName": "Bedriftspakke Ekspress-Over natten",
                    "DescriptionText": "Levering på dør vil skje påfølgende dag innen kl 1600 for dette postnummeret.",
                    "HelpText": "Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.",
                    "Tip": null,
                    "MaxWeightInKgs": "35"
                },
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "525.00",
                        "VAT": "131.25",
                        "AmountWithVAT": "656.25"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "525.00",
                        "VAT": "131.25",
                        "AmountWithVAT": "656.25"
                    }
                },
                "ExpectedDelivery": {
                    "WorkingDays": "1",
                    "UserMessage": null,
                    "FormattedExpectedDeliveryDate": "30.11.2015 16:00",
                    "ExpectedDeliveryDate": {
                        "Year": "2015",
                        "Month": "11",
                        "Day": "30",
                        "Hour": "16",
                        "Minute": "0"
                    },
                    "AlternativeDeliveryDates": null
                }
            }
        ],
        "TraceMessages": {
            "Message": [
                "Package exceed maximum measurements for product B-POST ",
                "Package exceed maximum measurements for product A-POST ",
                "Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified."
            ]
        }
    }
    
    <Package packageId="0">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                SERVICEPAKKE
            </ProductId>
            <ProductCodeInProductionSystem>
                1202
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    11
                </SortOrder>
                <MainDisplayCategory>
                    Hent varene selv
                </MainDisplayCategory>
                <SubDisplayCategory>
                </SubDisplayCategory>
                <DisplayName>
                    På posten
                </DisplayName>
                <ProductName>
                    Klimanøytral Servicepakke
                </ProductName>
                <DescriptionText>
                    Hentes på mottakers lokale postkontor/post i butikk.
                </DescriptionText>
                <HelpText>
                    Sendingen er en Klimanøytral Servicepakke som blir levert til mottakers postkontor/ post i butikk. Mottaker kan velge å hente sendingen på et annet postkontor/post i butikk enn sitt lokale. Mottaker varsles om at sendingen er ankommet via SMS, e-post eller hentemelding i postkassen. Transporttid er normalt 1-3 virkedager, avhengig av strekning. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                    Raskest!
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        132.00
                    </AmountWithoutVAT>
                    <VAT>
                        33.00
                    </VAT>
                    <AmountWithVAT>
                        165.00
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        132.00
                    </AmountWithoutVAT>
                    <VAT>
                        33.00
                    </VAT>
                    <AmountWithVAT>
                        165.00
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <FormattedExpectedDeliveryDate>
                    28.11.2015
                </FormattedExpectedDeliveryDate>
                <ExpectedDeliveryDate>
                    <Year>
                        2015
                    </Year>
                    <Month>
                        11
                    </Month>
                    <Day>
                        28
                    </Day>
                </ExpectedDeliveryDate>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <Product>
            <ProductId>
                PA_DOREN
            </ProductId>
            <ProductCodeInProductionSystem>
                1736
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    41
                </SortOrder>
                <MainDisplayCategory>
                    Få varene levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    Hjem på kvelden, 17-21
                </DisplayName>
                <ProductName>
                    På Døren
                </ProductName>
                <DescriptionText>
                    Pakken leveres hjem til deg, sjåføren ringer 30 - 60 min. før ankomst
                </DescriptionText>
                <HelpText>
                    Sendingen leveres hjem til deg mellom klokken 17 og 21. Du varsles i god tid om forventet utleveringsdag på sms og/eller e-post, i tillegg til nytt varsel når sendingen er lastet på bil for utkjøring samme kveld. Sjåfør ringer deg på mobiltelefon 30 - 60 minutter før levering. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk og du vil motta en varsel om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        142.00
                    </AmountWithoutVAT>
                    <VAT>
                        35.50
                    </VAT>
                    <AmountWithVAT>
                        177.50
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        142.00
                    </AmountWithoutVAT>
                    <VAT>
                        35.50
                    </VAT>
                    <AmountWithVAT>
                        177.50
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <FormattedExpectedDeliveryDate>
                    30.11.2015
                </FormattedExpectedDeliveryDate>
                <ExpectedDeliveryDate>
                    <Year>
                        2015
                    </Year>
                    <Month>
                        11
                    </Month>
                    <Day>
                        30
                    </Day>
                </ExpectedDeliveryDate>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <Product>
            <ProductId>
                BPAKKE_DOR-DOR
            </ProductId>
            <ProductCodeInProductionSystem>
                1000
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    42
                </SortOrder>
                <MainDisplayCategory>
                    Få varene levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    På jobben, 08-16
                </DisplayName>
                <ProductName>
                    Bedriftspakke
                </ProductName>
                <DescriptionText>
                    Leveres uten at sjåføren ringer først
                </DescriptionText>
                <HelpText>
                    Sendingen er en Bedriftspakke som leveres til mottakers arbeidssted mellom klokken 08 og 16. Bestiller du varsling, vil mottaker varsles når sendingen er lastet på bil for uttkjøring, via SMS og/eller e-post. Dersom sendingen ikke kan leveres, blir den fraktet til lokalt postkontor/ post i butikk. Mottaker varsles om dette via SMS, e-post eller hentemelding i postkassen. Sendingen kan spores ved hjelp av sporingssnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        177.00
                    </AmountWithoutVAT>
                    <VAT>
                        44.25
                    </VAT>
                    <AmountWithVAT>
                        221.25
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        177.00
                    </AmountWithoutVAT>
                    <VAT>
                        44.25
                    </VAT>
                    <AmountWithVAT>
                        221.25
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <FormattedExpectedDeliveryDate>
                    30.11.2015
                </FormattedExpectedDeliveryDate>
                <ExpectedDeliveryDate>
                    <Year>
                        2015
                    </Year>
                    <Month>
                        11
                    </Month>
                    <Day>
                        30
                    </Day>
                </ExpectedDeliveryDate>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <Product>
            <ProductId>
                EKSPRESS09
            </ProductId>
            <ProductCodeInProductionSystem>
                1002
            </ProductCodeInProductionSystem>
            <GuiInformation>
                <SortOrder>
                    44
                </SortOrder>
                <MainDisplayCategory>
                    Få sendingen levert
                </MainDisplayCategory>
                <SubDisplayCategory>
                    Til døren
                </SubDisplayCategory>
                <DisplayName>
                    Ekspress over natten
                </DisplayName>
                <ProductName>
                    Bedriftspakke Ekspress-Over natten
                </ProductName>
                <DescriptionText>
                    Levering på dør vil skje påfølgende dag innen kl 1600 for dette postnummeret.
                </DescriptionText>
                <HelpText>
                    Levering hjem på dør før kl 0900 (til mindre steder normalt før kl 1600). Du kan varsles ved SMS/e-post, forutsatt at du har oppgitt telefonnummer/epostadresse ved bestilling. Sendingen kan spores ved hjelp av sporingsnummeret.
                </HelpText>
                <Tip>
                </Tip>
                <MaxWeightInKgs>
                    35
                </MaxWeightInKgs>
            </GuiInformation>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        525.00
                    </AmountWithoutVAT>
                    <VAT>
                        131.25
                    </VAT>
                    <AmountWithVAT>
                        656.25
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        525.00
                    </AmountWithoutVAT>
                    <VAT>
                        131.25
                    </VAT>
                    <AmountWithVAT>
                        656.25
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
            <ExpectedDelivery>
                <WorkingDays>
                    1
                </WorkingDays>
                <UserMessage>
                </UserMessage>
                <FormattedExpectedDeliveryDate>
                    30.11.2015 16:00
                </FormattedExpectedDeliveryDate>
                <ExpectedDeliveryDate>
                    <Year>
                        2015
                    </Year>
                    <Month>
                        11
                    </Month>
                    <Day>
                        30
                    </Day>
                    <Hour>
                        16
                    </Hour>
                    <Minute>
                        0
                    </Minute>
                </ExpectedDeliveryDate>
                <AlternativeDeliveryDates>
                </AlternativeDeliveryDates>
            </ExpectedDelivery>
        </Product>
        <TraceMessages>
            <Message>
                Package exceed maximum measurements for product B-POST
            </Message>
            <Message>
                Package exceed maximum measurements for product A-POST
            </Message>
            <Message>
                Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.
            </Message>
        </TraceMessages>
    </Package>
    
  • Specify whether or not the shipment has been pre-registered (EDI)

    Specify whether or not the shipment has been pre-registered (EDI).

    Specified using edi=false.

    This will affect response prices and might affect which products are available.

    Default: true

    Example request

    {
        "@packageId": "0",
        "Product": [
            {
                "ProductId": "B-POST",
                "ProductCodeInProductionSystem": null,
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "72.00",
                        "VAT": "18.00",
                        "AmountWithVAT": "90.00"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "72.00",
                        "VAT": "18.00",
                        "AmountWithVAT": "90.00"
                    }
                }
            },
            {
                "ProductId": "A-POST",
                "ProductCodeInProductionSystem": null,
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "80.00",
                        "VAT": "20.00",
                        "AmountWithVAT": "100.00"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "80.00",
                        "VAT": "20.00",
                        "AmountWithVAT": "100.00"
                    }
                }
            },
            {
                "ProductId": "SERVICEPAKKE",
                "ProductCodeInProductionSystem": "1202",
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "105.00",
                        "VAT": "26.25",
                        "AmountWithVAT": "131.25"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "105.00",
                        "VAT": "26.25",
                        "AmountWithVAT": "131.25"
                    }
                }
            },
            {
                "ProductId": "BPAKKE_DOR-DOR",
                "ProductCodeInProductionSystem": "1000",
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "147.00",
                        "VAT": "36.75",
                        "AmountWithVAT": "183.75"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "147.00",
                        "VAT": "36.75",
                        "AmountWithVAT": "183.75"
                    }
                }
            },
            {
                "ProductId": "EKSPRESS09",
                "ProductCodeInProductionSystem": "1002",
                "Price": {
                    "@currencyIdentificationCode": "NOK",
                    "PackagePriceWithoutAdditionalServices": {
                        "AmountWithoutVAT": "410.00",
                        "VAT": "102.50",
                        "AmountWithVAT": "512.50"
                    },
                    "PackagePriceWithAdditionalServices": {
                        "AmountWithoutVAT": "410.00",
                        "VAT": "102.50",
                        "AmountWithVAT": "512.50"
                    }
                }
            }
        ],
        "TraceMessages": {
            "Message": [
                "Length, Width and Height is required for exact price calculation for product B-POST",
                "Length, Width and Height is required for exact price calculation for product A-POST",
                "Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified."
            ]
        }
    }
    
    <Package packageId="0">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                B-POST
            </ProductId>
            <ProductCodeInProductionSystem>
            </ProductCodeInProductionSystem>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        72.00
                    </AmountWithoutVAT>
                    <VAT>
                        18.00
                    </VAT>
                    <AmountWithVAT>
                        90.00
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        72.00
                    </AmountWithoutVAT>
                    <VAT>
                        18.00
                    </VAT>
                    <AmountWithVAT>
                        90.00
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
        </Product>
        <Product>
            <ProductId>
                A-POST
            </ProductId>
            <ProductCodeInProductionSystem>
            </ProductCodeInProductionSystem>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        80.00
                    </AmountWithoutVAT>
                    <VAT>
                        20.00
                    </VAT>
                    <AmountWithVAT>
                        100.00
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        80.00
                    </AmountWithoutVAT>
                    <VAT>
                        20.00
                    </VAT>
                    <AmountWithVAT>
                        100.00
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
        </Product>
        <Product>
            <ProductId>
                SERVICEPAKKE
            </ProductId>
            <ProductCodeInProductionSystem>
                1202
            </ProductCodeInProductionSystem>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        105.00
                    </AmountWithoutVAT>
                    <VAT>
                        26.25
                    </VAT>
                    <AmountWithVAT>
                        131.25
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        105.00
                    </AmountWithoutVAT>
                    <VAT>
                        26.25
                    </VAT>
                    <AmountWithVAT>
                        131.25
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
        </Product>
        <Product>
            <ProductId>
                BPAKKE_DOR-DOR
            </ProductId>
            <ProductCodeInProductionSystem>
                1000
            </ProductCodeInProductionSystem>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        147.00
                    </AmountWithoutVAT>
                    <VAT>
                        36.75
                    </VAT>
                    <AmountWithVAT>
                        183.75
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        147.00
                    </AmountWithoutVAT>
                    <VAT>
                        36.75
                    </VAT>
                    <AmountWithVAT>
                        183.75
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
        </Product>
        <Product>
            <ProductId>
                EKSPRESS09
            </ProductId>
            <ProductCodeInProductionSystem>
                1002
            </ProductCodeInProductionSystem>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        410.00
                    </AmountWithoutVAT>
                    <VAT>
                        102.50
                    </VAT>
                    <AmountWithVAT>
                        512.50
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        410.00
                    </AmountWithoutVAT>
                    <VAT>
                        102.50
                    </VAT>
                    <AmountWithVAT>
                        512.50
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
        </Product>
        <TraceMessages>
            <Message>
                Length, Width and Height is required for exact price calculation for product B-POST
            </Message>
            <Message>
                Length, Width and Height is required for exact price calculation for product A-POST
            </Message>
            <Message>
                Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.
            </Message>
        </TraceMessages>
    </Package>
    
  • Specify if the package was shipped from a post office

    The response data may vary depending on whether or not Bring must collect the shipment, or if the customer delivers the shipment from a post office.

    This parameter specifies whether or not the package is delivered to a post office before shipping

    Specified using postingAtPostOffice=true

    Default: false

    Example request

    {
        "@packageId": "0",
        "Product": {
            "ProductId": "SERVICEPAKKE",
            "ProductCodeInProductionSystem": "1202",
            "Price": {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices": {
                    "AmountWithoutVAT": "119.00",
                    "VAT": "29.75",
                    "AmountWithVAT": "148.75"
                },
                "PackagePriceWithAdditionalServices": {
                    "AmountWithoutVAT": "119.00",
                    "VAT": "29.75",
                    "AmountWithVAT": "148.75"
                }
            }
        },
        "TraceMessages": {
            "Message": "Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified."
        }
    }
    
    <Package packageId="0">
    <!--See service terms and conditions at http://developer.bring.com/-->
        <Product>
            <ProductId>
                SERVICEPAKKE
            </ProductId>
            <ProductCodeInProductionSystem>
                1202
            </ProductCodeInProductionSystem>
            <Price currencyIdentificationCode="NOK">
                <PackagePriceWithoutAdditionalServices>
                    <AmountWithoutVAT>
                        119.00
                    </AmountWithoutVAT>
                    <VAT>
                        29.75
                    </VAT>
                    <AmountWithVAT>
                        148.75
                    </AmountWithVAT>
                </PackagePriceWithoutAdditionalServices>
                <PackagePriceWithAdditionalServices>
                    <AmountWithoutVAT>
                        119.00
                    </AmountWithoutVAT>
                    <VAT>
                        29.75
                    </VAT>
                    <AmountWithVAT>
                        148.75
                    </AmountWithVAT>
                </PackagePriceWithAdditionalServices>
            </Price>
        </Product>
        <TraceMessages>
            <Message>
                Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.
            </Message>
        </TraceMessages>
    </Package>
    
  • Adjust prices

    The Shipping Guide provides adjustment of prices shown.

    To adjust the price add e.g. &priceAdjustment=m20p to the query.

    The format of it is [<product code>_][p(lus)|m(inus)]factor[p(ercentage)] where parts inside square brackets are optional and parts inside parentheses are for informational purpose.

    produkt code_ optional Used if price adjustments are only made for a single product.
    p|m optional The operation to be performed. p is for adding to the price, m for subtracting, and if left out the price is replaced with the factorn
    factor The factor to be used in the price adjustment. This number can be a fixed amount or percentage to be added/subtracted, or a fixed price to be added/subtracted depending on other parameters.
    p optional Indicates that the operation should be done as a percentage calculation. Note that this is only valid for additions and subtractions and not fixed prices.
    Examples
    &priceAdjustment=10 Set price to 10
    &priceAdjustment=p20.5 Add 20.5 to the price
    &priceAdjustment=m20 Subtract 20 from the price
    &priceAdjustment=SERVICEPAKKE_79 Set fixed price of SERVICEPAKKE to 79
    &priceAdjustment=SERVICEPAKKE_p30p Add 30% to the price of SERVICEPAKKE
    &priceAdjustment=SERVICEPAKKE_79&priceAdjustment=EKSPRESS09_m20p Set fixed price of NOK 79 for SERVICEPAKKE and deduct 20% on Bedriftspakke Ekspress Over Night 09
    
    {
       "@packageId": "0",
       "Product":    [
                {
             "ProductId": "SERVICEPAKKE",
             "ProductCodeInProductionSystem": "1202",
             "Price":          {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices":             {
                   "AmountWithoutVAT": "79.00",
                   "VAT": "19.75",
                   "AmountWithVAT": "98.75"
                },
                "PackagePriceWithAdditionalServices":             {
                   "AmountWithoutVAT": "105.00",
                   "VAT": "26.25",
                   "AmountWithVAT": "131.25"
                }
             }
          },
                {
             "ProductId": "EKSPRESS09",
             "ProductCodeInProductionSystem": "1002",
             "Price":          {
                "@currencyIdentificationCode": "NOK",
                "PackagePriceWithoutAdditionalServices":             {
                   "AmountWithoutVAT": "328.00",
                   "VAT": "82.00",
                   "AmountWithVAT": "410.00"
                },
                "PackagePriceWithAdditionalServices":             {
                   "AmountWithoutVAT": "410.00",
                   "VAT": "102.50",
                   "AmountWithVAT": "512.50"
                }
             }
          }
       ],
       "TraceMessages": {"Message":    [
          "Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.",
          "Set price to 79 kr for product SERVICEPAKKE.",
          "Subtracted 20% from product EKSPRESS09."
       ]}
    }
    
    
    <?xml version="1.0" encoding="UTF-8"?>
    <Package packageId="0">
      <!--See service terms and conditions at http://developer.bring.com/-->
      <Product>
        <ProductId>SERVICEPAKKE</ProductId>
        <ProductCodeInProductionSystem>1202</ProductCodeInProductionSystem>
        <Price currencyIdentificationCode="NOK">
          <PackagePriceWithoutAdditionalServices>
            <AmountWithoutVAT>79.00</AmountWithoutVAT>
            <VAT>19.75</VAT>
            <AmountWithVAT>98.75</AmountWithVAT>
          </PackagePriceWithoutAdditionalServices>
          <PackagePriceWithAdditionalServices>
            <AmountWithoutVAT>105.00</AmountWithoutVAT>
            <VAT>26.25</VAT>
            <AmountWithVAT>131.25</AmountWithVAT>
          </PackagePriceWithAdditionalServices>
        </Price>
      </Product>
      <Product>
        <ProductId>EKSPRESS09</ProductId>
        <ProductCodeInProductionSystem>1002</ProductCodeInProductionSystem>
        <Price currencyIdentificationCode="NOK">
          <PackagePriceWithoutAdditionalServices>
            <AmountWithoutVAT>328.00</AmountWithoutVAT>
            <VAT>82.00</VAT>
            <AmountWithVAT>410.00</AmountWithVAT>
          </PackagePriceWithoutAdditionalServices>
          <PackagePriceWithAdditionalServices>
            <AmountWithoutVAT>410.00</AmountWithoutVAT>
            <VAT>102.50</VAT>
            <AmountWithVAT>512.50</AmountWithVAT>
          </PackagePriceWithAdditionalServices>
        </Price>
      </Product>
      <TraceMessages>
        <Message>Added fee 'brev-varsling' (NOK 7.00) to base price of SERVICEPAKKE since request did not have additional service 'eVarsling' specified.</Message>
        <Message>Set price to 79 kr for product SERVICEPAKKE.</Message>
        <Message>Subtracted 20% from product EKSPRESS09.</Message>
      </TraceMessages>
    </Package>
    

SOAP

The web service interface offers the most options when performing queries to the Shipping Guide.

Note that to use the SOAP service, you have to authenticate the requests.

WSDL

WSDL / schema versions: 1, 2, 3, 4, 5, 6, 7, 8, 9. The current version is 9.

Fraktguide XML Schema documentation

Versioning

The Shipping Guide makes an effort to always be backwards compatible regarding data format for requests and responses of the Web Service. To achieve this, a SchemaVersion element is used in the request, indicating which version the client is on and what data-format the client expects in the result.

Important: All clients must accept new (unknown) elements in the response. E.g. unknown elements should be ignored. The client framework used by client must not crash when unknown elements are encountered.

When incompatible changes in the schema are made (other than addition of new elements), the SchemaVersion is incremented by one. The new schema is used at the same endpoint URL as before and uses the same namespace for its XML elements. A TraceMessage element (info message) in the response is added to inform the client that its schema should be updated. Old schema versions might in the future be unsupported.

Regarding the XML/JSON API (not Web Services), an XML Schema is not used at all. Clients of the XML/JSON API are expected to handle new elements that appear. Nevertheless, the response will be backwards compatible in the sense that elements are not renamed.

Holidays and Home Delivery

There is no home delivery on bank holidays. It can also happen that Bring will not do home delivery on certain days during Christmas or Easter.

The service will not take this into account. This must be handled by clients. End-users should not get delivery dates for holidays.

URL

https://api.bring.com/shippingguide/api/ws