Booking API

Introduction

The Bring Booking API is a logged-in service that lets Mybring users (customers of Mybring) programatically create a booking by invoking a Web Service over SOAP or by posting XML/JSON over HTTP. The API uses the same backend as Mybring Booking and the same PDF labels.

We support two types of integration with the Booking API. XML/JSON over HTTP and SOAP (over HTTP).

Booking uses Shipping Guide as the source for price and availability for the different products. We advise clients of the Booking API to use Shipping Guide API for getting the list price and checking availability before sending a booking request. Note that invoice payment is the only available payment option for the Booking API. This means that the Mybring user ID used in the booking request must have access to the customer number specified as payer of the booking.

Versioning strategy

Each request has a schemaVersion element indicating which release of the schema is being used in the request and expected schema format in the response. 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 thus not crash when unknown elements are encountered. Note that this requirement excludes the (old, but still widely used) Apache Axis 1.x Web Service client framework.

Authentication

The Booking API requires authentication for all its endpoints. See the getting started guide on authentication if you’re not sure what this means.

Authorization

In addition to authentication, you need to be authorized with the booking right in order to perform bookings. This is done in customer administration in Mybring:

Authorized for booking

To perform a booking, you must specify which customer number to use. For your convenience, there is an API for getting the customer numbers associated with your API user. The Customer Number API also links customer numbers with the products the customer number is valid for.

Making labels

The Booking API generates and sends all necessary EDI messages to carry out the shipment. A URL to a PDF label is returned in responses. This label must be printed and be attached to the shipment. A URL that points to tracking information is also returned.

A GET request to the label URL will result in a HTTP 302 redirect to the concrete storage facility (e.g. redirect to Amazon S3). Ensure that your client follows these redirects.

Performance

Different product groups have different response times in booking:

  • Parcels and courier products
    • A booking will typically take < 2 seconds
  • Express UPS products and Cargo
    • A booking will typically take < 3 seconds
  • Express Nordic SameDay
    • A booking will typically take < 10 seconds (query in flight schedules). We are working on improving the response times for QuickPack SameDay, making popular city-pairs much faster.

Overview of endpoints

Base URL

https://api.bring.com/booking/api
Method Endpoint Usage
GET /customers{mediaTypeExtension} List customer numbers and products
POST /booking Make a booking
GET /errors{mediaTypeExtension}
POST /pickupOrder Order a pickup
POST /ws SOAP

List customer numbers

The customer numbers are prefixed with the specialist, followed by the number. For Courier and Bring Express-products, we use a UUID to identify users.

The customer API will return for each specialist a list with the products that you can order through the booking API.

You can also get the API customer numbers from this page in Mybring.

Specialist Example products Example customer number
Bring Parcels, Norway BPAKKE_DOR-DOR, PA_DOREN, EKSPRESS09 PARCELS_NORWAY-10001123123
Bring Cargo, Norway CARGO_GROUPAGE CARGO_NORWAY-10001123123
Bring Cargo, International CARGO_INTERNATIONAL CARGO-803739
Bring Express, Norway COURIER_4H, EXPRESS_NORDIC_SAME_DAY, EXPRESS_INTERNATIONAL EXPRESS_NORWAY-2caedf20-27da-012f-3858-58b0357c4f66
Bring Express, Sweden COURIER_4H, EXPRESS_NORDIC_SAME_DAY, EXPRESS_INTERNATIONAL EXPRESS_SWEDEN-406077f0-27da-012f-3859-58b0357c4f66
Oil Express, Norway OIL_EXPRESS SYSPED_NORWAY-12345
Frigo, Norway FRIGO FRIGO-123456

Check out this page to see the whole list of products for each customer type.

URL

https://api.bring.com/booking/api/customers.json
https://api.bring.com/booking/api/customers.xml

Response

List of available customers and products (200)

{
  "customers": [
    {
      "name": "Testkunde (00012341234)",
      "customerNumber": "PARCELS_NORWAY-00012341234",
      "countryCode": "NO",
      "products": [
        "SERVICEPAKKE",
        "EKSPRESS09",
        "BEDRIFTSPAKKE",
        "BPAKKE_DOR-DOR",
        "PA_DOREN",
        "BPAKKE_DOR-DOR_RETURSERVICE",
        "EKSPRESS09_RETURSERVICE",
        "SERVICEPAKKE_RETURSERVICE",
        "MINIPAKKE",
        "BUSINESS_PARCEL",
        "PICKUP_PARCEL",
        "BUSINESS_PALLET",
        "BUSINESS_PARCEL_HALFPALLET",
        "BUSINESS_PARCEL_QUARTERPALLET",
        "BUSINESS_PARCEL_BULK",
        "EXPRESS_NORDIC_0900_BULK",
        "PICKUP_PARCEL_BULK",
        "HOME_DELIVERY_PARCEL",
        "HOME_DELIVERY_MAILBOX"
      ]
    },
    {
      "name": "Testkund (TEST-112)",
      "customerNumber": "EXPRESS_SWEDEN-f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "countryCode": "SE",
      "products": [
        "COURIER_VIP",
        "COURIER_1H",
        "COURIER_2H",
        "COURIER_4H",
        "COURIER_6H",
        "COURIER_LONG_DISTANCE",
        "COURIER_BICYCLE_VIP",
        "COURIER_BICYCLE_1H",
        "COURIER_BICYCLE_2H",
        "COURIER_BICYCLE_4H",
        "EXPRESS_NORDIC_SAME_DAY",
        "EXPRESS_INTERNATIONAL_0900",
        "EXPRESS_INTERNATIONAL_1200",
        "EXPRESS_INTERNATIONAL",
        "EXPRESS_ECONOMY"
      ]
    }
  ]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<customersResponse xmlns="http://www.bring.no/booking/">
  <customers>
    <customer>
      <name>Testkunde (00012341234)</name>
      <customerNumber>PARCELS_NORWAY-00012341234</customerNumber>
      <countryCode>NO</countryCode>
      <products>
        <product>SERVICEPAKKE</product>
        <product>EKSPRESS09</product>
        <product>BEDRIFTSPAKKE</product>
        <product>BPAKKE_DOR-DOR</product>
        <product>PA_DOREN</product>
        <product>BPAKKE_DOR-DOR_RETURSERVICE</product>
        <product>EKSPRESS09_RETURSERVICE</product>
        <product>SERVICEPAKKE_RETURSERVICE</product>
        <product>MINIPAKKE</product>
        <product>BUSINESS_PARCEL</product>
        <product>PICKUP_PARCEL</product>
        <product>BUSINESS_PALLET</product>
        <product>BUSINESS_PARCEL_HALFPALLET</product>
        <product>BUSINESS_PARCEL_QUARTERPALLET</product>
        <product>BUSINESS_PARCEL_BULK</product>
        <product>EXPRESS_NORDIC_0900_BULK</product>
        <product>PICKUP_PARCEL_BULK</product>
        <product>HOME_DELIVERY_PARCEL</product>
        <product>HOME_DELIVERY_MAILBOX</product>
      </products>
    </customer>
    <customer>
      <name>Testkund (TEST-112)</name>
      <customerNumber>EXPRESS_SWEDEN-f47ac10b-58cc-4372-a567-0e02b2c3d479</customerNumber>
      <countryCode>SE</countryCode>
      <products>
        <product>COURIER_VIP</product>
        <product>COURIER_1H</product>
        <product>COURIER_2H</product>
        <product>COURIER_4H</product>
        <product>COURIER_6H</product>
        <product>COURIER_LONG_DISTANCE</product>
        <product>COURIER_BICYCLE_VIP</product>
        <product>COURIER_BICYCLE_1H</product>
        <product>COURIER_BICYCLE_2H</product>
        <product>COURIER_BICYCLE_4H</product>
        <product>EXPRESS_NORDIC_SAME_DAY</product>
        <product>EXPRESS_INTERNATIONAL_0900</product>
        <product>EXPRESS_INTERNATIONAL_1200</product>
        <product>EXPRESS_INTERNATIONAL</product>
        <product>EXPRESS_ECONOMY</product>
      </products>
    </customer>
  </customers>
</customersResponse>

Book shipments

This is the endpoint where you can book a shipment and get a printable label in return.

Additional services

The following products have available additional services:

Product Additional services
SERVICEPAKKE cashOnDelivery, recipientNotification, socialControl
BPAKKE_DOR-DOR recipientNotification, simpleDelivery, deliveryOption
PA_DOREN recipientNotification, simpleDelivery
EKSPRESS09 recipientNotification, saturdayDelivery
PICKUP_PARCEL cashOnDelivery, flexDelivery, recipientNotification, deliveryOption
PICKUP_PARCEL_BULK cashOnDelivery, flexDelivery, recipientNotification, deliveryOption
HOME_DELIVERY_PARCEL cashOnDelivery, flexDelivery, recipientNotification
BUSINESS_PARCEL cashOnDelivery, flexDelivery, recipientNotification, phonenotification, deliveryIndoors
BUSINESS_PARCEL_BULK cashOnDelivery, flexDelivery, recipientNotification, phonenotification, deliveryIndoors
EXPRESS_NORDIC_0900_BULK cashOnDelivery, flexDelivery, recipientNotification, phonenotification, deliveryIndoors
BUSINESS_PALLET flexDelivery, recipientNotification, phonenotification, deliveryIndoors
BUSINESS_PARCEL_HALFPALLET flexDelivery, recipientNotification, phonenotification, deliveryIndoors
BUSINESS_PARCEL_QUARTERPALLET flexDelivery, recipientNotification, phonenotification, deliveryIndoors
EXPRESS_NORDIC_0900 flexDelivery, recipientNotification, phonenotification, deliveryIndoors

See the “More examples” section below to see examples on how to use additional services.

Error handling

If an error occurs, the following will be provided:

  • uniqueId: A unique log ID (UUID) that can be used as a reference for the error
  • code: An error code describing the error
  • message: Internationalized messages (with elements). First version will be with lang=”en” (English) only.

See the error codes below to get an overview of error codes and what they mean.

Testing

This service will send actual production orders unless it is set to testing mode.

To use the test mode, you need to set the testIndicator flag to true on the root node.

Note that the examples below use testIndicator=true, so remove this when implementing the Booking API in your production system.

URL

https://api.bring.com/booking/api/booking

Request params

Header name Type Description
Content-Type string

Required. Specify request format (application/json, application/xml)

Possible values
  • application/json
  • application/xml
Accept string

Optional. Specify response format (application/json, application/xml)

Possible values
  • application/json
  • application/xml

Default value: same as Content-Type
Query parameter Type Description
testIndicator boolean

Required. It is true for test orders.

schemaVersion integer

Required. Currently, it is 1


Example: 1
shippingDateTime dateTime

Required. The date and time when an order is ready to be transported. The label generated against a booking will be valid for 52 weeks when Bring receives the request for an order.


Example: 2016-07-26 11:54:09 +0530
customerNumber string

Required. Specify API customer number. This parameter can be maximum 35 character long.


Example: PARCELS_NORWAY-demo0000026303
addressLine string

Required. Specify address. This parameter can be maximum 35 character long.


Example: Testsvingen 12
addressLine2 string

Optional. Specify address line 2. This parameter can be 35 character long.

customsDeclarationType string

Required. Declaration for customs clarance usage

Possible values
  • OTHER
  • REPAIR_OR_RETURN
  • DOCUMENTS
  • COMMERCIAL_SAMPLE
  • TEMPORARY_EXP
  • GIFT

Example: COMMERCIAL_SAMPLE
customsDeclarationText string

Optional. Describe good inside the package for custom clearance. This parameter can be maximum 35 character long.


Example: Sample for verification
purchaseOrderNumber string

Optional. Specify when there is any purchase orders associated with the booking. This parameter can be maximum 35 character long.

weightInKg double

Required. Specify weight in kilograms


Example: 15.2
goodsDescription string

Optional. Describe what is inside the package. This parameter can be maximum 35 character long.

heightInCm integer

Required. Specify height in cm. Dimension is optional when volumeInDm3 is specified in the request for cargo.


Example: 100
widthInCm integer

Required. Specify width in cm. Dimension is optional when volumeInDm3 is specified in the request for cargo.


Example: 100
lengthInCm integer

Required. Specify length in cm. Dimension is optional when volumeInDm3 is specified in the request for cargo.


Example: 100
numberOfItems integer

Required. Specify number of items within a package


Example: 5
volumeInDm3 decimal

Required. Specify volume in cubic decimeter. This is optional when dimension is specified in the request for cargo.

whoPaysInvoice string

Optional. Specify which party will pay the invoice for the booking. This parameter can be maximum 35 character long.

Possible values
  • sender
  • recipient
  • thirdParty
accountNumber string

Required. Specify account number for cash on delivery. This parameter can be maximum 35 character long.


Example: 12345678903
accountType string

Optional. Specify account type. This parameter can be maximum 35 character long.

Possible values
  • bankgiro
  • plusgiro
amount double

Optional. Specify amount

currencyCode string

Optional. Specify currency code


Example: NOK
correlationId string

Optional. Specify something to correlate packages which belong to same order

containerId string

Optional. Specify the container identification in which dangerous good is packed. This parameter can be maximum 35 character long.


Example: 1236
unNumber string

Required. Specify UN number of dangerous good. This parameter can be maximum 35 character long.


Example: 1560
commodity string

Required. Specify name of the dangerous good. This parameter can be maximum 35 character long.


Example: ARSENTRIKLORID
dangerClass string

Required. Specify the class of dangerous good. This parameter can be maximum 35 character long.


Example: 1
postalCode string

Required. Specify the postal code. This parameter can be maximum 35 character long.

city string

Required. Specify the city. This parameter can be maximum 35 character long.

countryCode string

Required. Specify the country code. This parameter can be maximum 35 character long.

reference string

Optional. Specify shipper or consignee reference. This parameter can be maximum 35 character long.

additionalAddressInfo string

Optional. Pickup instruction and delivery instruction. This parameter can be maximum 35 character long.

vatNumber string

Optional. Specify organisation number. This parameter can be maximum 35 character long.

email string

Optional. Specify email address. This parameter can be maximum 35 character long.


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

Optional. Specify phone number.

messageForRecipient string

Optional. Specify message to recipient . This parameter can be maximum 35 character long.

Request body

{
  "testIndicator": true,
  "schemaVersion": 1,
  "consignments": [
    {
      "shippingDateTime": "2015-12-04T13:37:00",
      "parties": {
        "sender": {
          "name": "Ola Nordmann",
          "addressLine": "Testsvingen 12",
          "addressLine2": null,
          "postalCode": "0263",
          "city": "OSLO",
          "countryCode": "no",
          "reference": "1234",
          "additionalAddressInfo": "Hentes på baksiden etter klokken to",
          "contact": {
            "name": "Trond Nordmann",
            "email": "trond@nordmanntest.no",
            "phoneNumber": "99999999"
          }
        },
        "recipient": {
          "name": "Tore Mottaker",
          "addressLine": "Mottakerveien 14",
          "addressLine2": "c/o Tina Mottaker",
          "postalCode": "0659",
          "city": "OSLO",
          "countryCode": "no",
          "reference": "43242",
          "additionalAddressInfo": "Bruk ringeklokken",
          "contact": {
            "name": "Tore mottaker",
            "email": "tore@mottakertest.no",
            "phoneNumber": "88888888"
          }
        },
        "pickupPoint": null
      },
      "product": {
        "id": "SERVICEPAKKE",
        "customerNumber": "PARCELS_NORWAY-10005540322",
        "services": null,
        "customsDeclaration": null
      },
      "purchaseOrder": null,
      "correlationId": "INTERNAL-123456",
      "packages": [
        {
          "weightInKg": 1.1,
          "goodsDescription": "Testing equipment",
          "dimensions": {
            "heightInCm": 13,
            "widthInCm": 23,
            "lengthInCm": 10
          },
          "containerId": null,
          "packageType": null,
          "numberOfItems": null,
          "correlationId": "PACKAGE-123"
        }
      ]
    }
  ]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
  <schemaVersion>1</schemaVersion>
  <consignments>
    <consignment correlationId="INTERNAL-123456">
      <shippingDateTime>2015-07-07T21:31:33.007+02:00</shippingDateTime>
      <parties>
        <sender>
          <name>Ola Nordmann</name>
          <addressLine>Testsvingen 12</addressLine>
          <postalCode>0263</postalCode>
          <city>OSLO</city>
          <countryCode>no</countryCode>
          <reference>1234</reference>
          <additionalAddressInfo>Hentes på baksiden etter klokken to</additionalAddressInfo>
          <contact>
            <name>Trond Nordmann</name>
            <email>trond@nordmanntest.no</email>
            <phoneNumber>99999999</phoneNumber>
          </contact>
        </sender>
        <recipient>
          <name>Tore Mottaker</name>
          <addressLine>Mottakerveien 14</addressLine>
          <addressLine2>c/o Tina Mottaker</addressLine2>
          <postalCode>0659</postalCode>
          <city>OSLO</city>
          <countryCode>no</countryCode>
          <reference>43242</reference>
          <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
          <contact>
            <name>Tore mottaker</name>
            <email>tore@mottakertest.no</email>
            <phoneNumber>88888888</phoneNumber>
          </contact>
        </recipient>
      </parties>
      <product>
        <id>SERVICEPAKKE</id>
        <customerNumber>PARCELS_NORWAY-10005540322</customerNumber>
      </product>
      <packages>
        <package correlationId="PACKAGE-123">
          <weightInKg>1.1</weightInKg>
          <goodsDescription>Testing equipment</goodsDescription>
          <dimensions>
            <heightInCm>13</heightInCm>
            <widthInCm>23</widthInCm>
            <lengthInCm>10</lengthInCm>
          </dimensions>
        </package>
      </packages>
    </consignment>
  </consignments>
</bookingRequest>

Response

Successful booking (200)

On a successful request, the response gives information about the booking. Most importantly it contains a link to the label for the shipment.

{
  "consignments": [
    {
      "confirmation": {
        "consignmentNumber": "70438101268018539",
        "productSpecificData": null,
        "links": {
          "labels": "https://www.mybring.com/booking/labels/2968466?auth-token=5cf1dcee-4f01-4c9a-9870-3ba6d9ba050b",
          "waybill": null,
          "tracking": "http://sporing.bring.no/sporing.html?q=70438101268018539"
        },
        "dateAndTimes": {
          "earliestPickup": null,
          "expectedDelivery": 1436295739676
        },
        "packages": [
          {
            "packageNumber": "370438101268058536",
            "correlationId": "PACKAGE-123"
          }
        ]
      },
      "errors": null,
      "correlationId": "INTERNAL-123456"
    }
  ]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bookingResponse xmlns="http://www.bring.no/booking/">
  <consignments>
    <consignment correlationId="INTERNAL-123456">
      <confirmation>
        <consignmentNumber>70438101268018539</consignmentNumber>
        <links>
          <labels>https://www.mybring.com/booking/labels/2968466?auth-token=5cf1dcee-4f01-4c9a-9870-3ba6d9ba050b</labels>
          <tracking>http://sporing.bring.no/sporing.html?q=70438101268018539</tracking>
        </links>
        <dateAndTimes>
          <expectedDelivery>2015-07-07T21:33:10.900+02:00</expectedDelivery>
        </dateAndTimes>
        <packages>
          <package correlationId="PACKAGE-123">
            <packageNumber>370438101268058536</packageNumber>
          </package>
        </packages>
      </confirmation>
    </consignment>
  </consignments>
</bookingResponse>

More examples

  • Recipient Notification

    The recipientNotification attribute/element must be set for all products that allow electronic notification, in order for the recipient to receive electronic notification. This element must contain the recipient’s mobile phone number and/or e-mail address.

    {
      "schemaVersion": 1,
      "consignments": [
        {
          "shippingDateTime": 1447424420243,
          "parties": {
            "sender": {
              "name": "Ola Nordmann",
              "addressLine": "Testsvingen 12",
              "addressLine2": null,
              "postalCode": "0263",
              "city": "OSLO",
              "countryCode": "NO",
              "reference": "1234",
              "additionalAddressInfo": "Hentes p\u00e5 baksiden etter klokken to",
              "contact": {
                "name": "Trond Nordmann",
                "email": "trond@nordmanntest.no",
                "phoneNumber": "99999999"
              }
            },
            "recipient": {
              "name": "Tore Mottaker",
              "addressLine": "Mottakerveien 14",
              "addressLine2": "c\/o Tina Mottaker",
              "postalCode": "0659",
              "city": "OSLO",
              "countryCode": "NO",
              "reference": "43242",
              "additionalAddressInfo": "Bruk ringeklokken",
              "contact": {
                "name": "Tore mottaker",
                "email": "tore@mottakertest.no",
                "phoneNumber": "+46700000000"
              }
            },
            "pickupPoint": null
          },
          "product": {
            "id": "SERVICEPAKKE",
            "customerNumber": "PARCELS_NORWAY-10005540322",
            "services": {
              "recipientNotification": {
                "email": "recipient@recipient.com",
                "mobile": "97777777"
              },
              "quickPackEnvelope": null,
              "cashOnDelivery": null,
              "deliveryOption": null,
              "flexDelivery": null,
              "deliveryIndoors": null,
              "nonFreeze": null,
              "dangerousGoods": null,
              "express": null,
              "eveDelivery": null,
              "advisering": null,
              "simpleDelivery": null
            },
            "customsDeclaration": null,
            "messageForRecipient": null
          },
          "purchaseOrder": null,
          "correlationId": "INTERNAL-123456",
          "packages": [
            {
              "weightInKg": 1.1,
              "goodsDescription": "Testing equipment",
              "dimensions": {
                "heightInCm": 13,
                "widthInCm": 23,
                "lengthInCm": 10
              },
              "containerId": null,
              "packageType": null,
              "numberOfItems": null,
              "correlationId": "PACKAGE-123"
            }
          ]
        }
      ],
      "testIndicator": true
    }
    
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
    <schemaVersion>1</schemaVersion>
    <consignments>
        <consignment correlationId="INTERNAL-123456">
            <shippingDateTime>2015-11-13T15:25:22.346+01:00</shippingDateTime>
            <parties>
                <sender>
                    <name>Ola Nordmann</name>
                    <addressLine>Testsvingen 12</addressLine>
                    <postalCode>0263</postalCode>
                    <city>OSLO</city>
                    <countryCode>NO</countryCode>
                    <reference>1234</reference>
                    <additionalAddressInfo>Hentes på baksiden etter klokken to</additionalAddressInfo>
                    <contact>
                        <name>Trond Nordmann</name>
                        <email>trond@nordmanntest.no</email>
                        <phoneNumber>99999999</phoneNumber>
                    </contact>
                </sender>
                <recipient>
                    <name>Tore Mottaker</name>
                    <addressLine>Mottakerveien 14</addressLine>
                    <addressLine2>c/o Tina Mottaker</addressLine2>
                    <postalCode>0659</postalCode>
                    <city>OSLO</city>
                    <countryCode>NO</countryCode>
                    <reference>43242</reference>
                    <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
                    <contact>
                        <name>Tore mottaker</name>
                        <email>tore@mottakertest.no</email>
                        <phoneNumber>+46700000000</phoneNumber>
                    </contact>
                </recipient>
            </parties>
            <product>
                <id>SERVICEPAKKE</id>
                <customerNumber>PARCELS_NORWAY-10005540322</customerNumber>
                <services>
                    <recipientNotification>
                        <email>recipient@recipient.com</email>
                        <mobile>97777777</mobile>
                    </recipientNotification>
                </services>
            </product>
            <packages>
                <package correlationId="PACKAGE-123">
                    <weightInKg>1.1</weightInKg>
                    <goodsDescription>Testing equipment</goodsDescription>
                    <dimensions>
                        <heightInCm>13</heightInCm>
                        <widthInCm>23</widthInCm>
                        <lengthInCm>10</lengthInCm>
                    </dimensions>
                </package>
            </packages>
        </consignment>
    </consignments>
    </bookingRequest>
    
  • Cash On Delivery

    The cashOnDelivery element/attribute can be set for products that allow cash on delivery. This element must contain the account number, the amount, the currency code and a kid, which is a customer identification number.

    Amount field only accepts numeric values without comma in it and with two decimal places.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1447751168645,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "0659",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": null
                },
                "product": {
                    "id": "SERVICEPAKKE",
                    "customerNumber": "PARCELS_NORWAY-10005540322",
                    "services": {
                        "recipientNotification": null,
                        "quickPackEnvelope": null,
                        "cashOnDelivery": {
                            "accountNumber": "12345678903",
                            "accountType": null,
                            "amount": 1000,
                            "currencyCode": "NOK",
                            "message": {
                                "value": "A valid customer identification number",
                                "type": "kid"
                            }
                        },
                        "deliveryOption": null,
                        "flexDelivery": null,
                        "deliveryIndoors": null,
                        "nonFreeze": null,
                        "dangerousGoods": null,
                        "express": null,
                        "eveDelivery": null,
                        "advisering": null,
                        "simpleDelivery": null
                    },
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-17T10:06:08.541+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            0263
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            0659
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                </parties>
                <product>
                    <id>
                        SERVICEPAKKE
                    </id>
                    <customerNumber>
                        PARCELS_NORWAY-10005540322
                    </customerNumber>
                    <services>
                        <cashOnDelivery>
                            <accountNumber>
                                12345678903
                            </accountNumber>
                            <amount>
                                1000.0
                            </amount>
                            <currencyCode>
                                NOK
                            </currencyCode>
                            <message>
                                <value>
                                    A valid customer identification number
                                </value>
                                <type>
                                    kid
                                </type>
                            </message>
                        </cashOnDelivery>
                    </services>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • QuickPack Envelope

    The quickPackEnvelope element/attribute is of type boolean, and can be set for products that allow quickpack envelope shipment. We recommend using the weight and measurements shown in the example, for correct mapping.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1447751168650,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "0659",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": null
                },
                "product": {
                    "id": "EXPRESS_INTERNATIONAL",
                    "customerNumber": "EXPRESS_NORWAY-2caedf20-27da-012f-3858-58b0357c4f66",
                    "services": {
                        "recipientNotification": null,
                        "quickPackEnvelope": "TRUE",
                        "cashOnDelivery": null,
                        "deliveryOption": null,
                        "flexDelivery": null,
                        "deliveryIndoors": null,
                        "nonFreeze": null,
                        "dangerousGoods": null,
                        "express": null,
                        "eveDelivery": null,
                        "advisering": null,
                        "simpleDelivery": null
                    },
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 2,
                            "widthInCm": 35,
                            "lengthInCm": 24
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": null
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-17T10:06:08.543+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            0263
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            0659
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                </parties>
                <product>
                    <id>
                        EXPRESS_INTERNATIONAL
                    </id>
                    <customerNumber>
                        EXPRESS_NORWAY-2caedf20-27da-012f-3858-58b0357c4f66
                    </customerNumber>
                    <services>
                        <quickPackEnvelope>
                            TRUE
                        </quickPackEnvelope>
                    </services>
                </product>
                <packages>
                    <package>
                        <weightInKg>
                            1.0
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                2
                            </heightInCm>
                            <widthInCm>
                                35
                            </widthInCm>
                            <lengthInCm>
                                24
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Delivery Option

    Attempted delivery

    If a sender want their package delivered to the door, and it cannot be delivered (i.e. Business closed or recipient is not present), then you can now choose what will happen with your package.

    If this option is not set, then the default behaviour is TWO_DELIVERIES_THEN_RETURN.

    If you want Bring to try deliver only once and/or deliver package to nearest PiB, then you must tell us by setting this option. These options cost extra money but the customer/sender will only be charged if the event happen.

    Example:

    You send a package to a business with the deliveryOption=TWO_DELIVERIES_THEN_PIB.

    • If Bring manage to deliver the package to the recipient on first try, then no extra charges is made.
    • If first attempt to deliver fails, then Bring will do a second attempt. The customer/sender will be charged extra.
    • If the second attempt also fails, then the package will be delivered to nearest PiB. The customer/sender will be charged extra.

    Possible options:

    • Not set = TWO_DELIVERIES_THEN_RETURN
    • ONE_DELIVERY_THEN_PIB
    • TWO_DELIVERIES_THEN_PIB
    • TWO_DELIVERIES_THEN_RETURN
    {
        "schemaVersion": null,
        "consignments": [
            {
                "shippingDateTime": 1447751818780,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "0659",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": null
                },
                "product": {
                    "id": "BPAKKE_DOR-DOR",
                    "customerNumber": "PARCELS_NORWAY-10005540322",
                    "services": {
                        "recipientNotification": null,
                        "quickPackEnvelope": null,
                        "cashOnDelivery": null,
                        "deliveryOption": "TWO_DELIVERIES_THEN_PIB",
                        "flexDelivery": null,
                        "deliveryIndoors": null,
                        "nonFreeze": null,
                        "dangerousGoods": null,
                        "express": null,
                        "eveDelivery": null,
                        "advisering": null,
                        "simpleDelivery": null
                    },
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456"
            }
        ],
        "testIndicator": null
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="null">
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-17T10:06:08.563+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            0263
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            0659
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                </parties>
                <product>
                    <id>
                        BPAKKE_DOR-DOR
                    </id>
                    <customerNumber>
                        PARCELS_NORWAY-10005540322
                    </customerNumber>
                    <services>
                        <deliveryOption>
                            TWO_DELIVERIES_THEN_PIB
                        </deliveryOption>
                    </services>
                </product>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Flex Delivery

    The flexDelivery element/attribute can be set for products that allow flex delivery. This element must contain an instruction message for the driver.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1447751818783,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "0659",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": null
                },
                "product": {
                    "id": "BUSINESS_PARCEL",
                    "customerNumber": "PARCELS_NORWAY-00040067266",
                    "services": {
                        "recipientNotification": null,
                        "quickPackEnvelope": null,
                        "cashOnDelivery": null,
                        "deliveryOption": null,
                        "flexDelivery": {
                            "message": "Legg pakken i garasjen."
                        },
                        "nonFreeze": null,
                        "deliveryIndoors": null,
                        "dangerousGoods": null,
                        "express": null,
                        "eveDelivery": null,
                        "advisering": null,
                        "simpleDelivery": null
                    },
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-17T10:06:08.571+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            0263
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            0659
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                </parties>
                <product>
                    <id>
                        BUSINESS_PARCEL
                    </id>
                    <customerNumber>
                        PARCELS_NORWAY-00040067266
                    </customerNumber>
                    <services>
                        <flexDelivery>
                            <message>
                                Legg pakken i garasjen.
                            </message>
                        </flexDelivery>
                    </services>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Select Pickup Point in Norway

    You can specify pickup point Id in request for SERVICEPAKKE and PICKUP_PARCEL_BULK products for delivery of parcels within Norway and to Norway from other countries. Use Pickup Point API to get list of nearest pickup points.

    The parcel will be delivered to the pickup point specified in the request with SMS/Email notification. Pickup point delivery requires that the recipient has email and/or phone number set, so that he can receive notification when the package arrives at the pickup point.

    Pickup point id and country code has to be specified under pickupPoint within parties as shown below.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1447751818806,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "0659",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": {
                        "id": "736431",
                        "countryCode": "NO"
                    }
                },
                "product": {
                    "id": "SERVICEPAKKE",
                    "customerNumber": "PARCELS_NORWAY-123456",
                    "services": null,
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-17T10:06:08.556+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            0263
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            0659
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                    <pickupPoint>
                        <id>
                            736431
                        </id>
                        <countryCode>
                            NO
                        </countryCode>
                    </pickupPoint>
                </parties>
                <product>
                    <id>
                        SERVICEPAKKE
                    </id>
                    <customerNumber>
                        PARCELS_NORWAY-123456
                    </customerNumber>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Select Pickup Point in Sweden

    You can specify pickup point Id in request for PICKUP_PARCEL_BULK products for delivery of parcels within Sweden and to Sweden from other countries. Use Pickup Point API to get list of nearest pickup points.

    The parcel will be delivered to the pickup point specified in the request with SMS/Email notification. Pickup point delivery requires that the recipient has email and/or phone number set, so that he can receive notification when the package arrives at the pickup point.

    Pickup point id and country code has to be specified under pickupPoint in parties as shown below.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1448632597111,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "12000",
                        "city": "Stockholm",
                        "countryCode": "SE",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "41100",
                        "city": "Göteborg",
                        "countryCode": "SE",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": {
                        "id": "736431",
                        "countryCode": "SE"
                    }
                },
                "product": {
                    "id": "PICKUP_PARCEL_BULK",
                    "customerNumber": "PARCELS_SWEDEN-123456",
                    "services": null,
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-27T14:56:43.392+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            2000
                        </postalCode>
                        <city>
                            Fredriksberg
                        </city>
                        <countryCode>
                            DK
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            2600
                        </postalCode>
                        <city>
                            Glostrup
                        </city>
                        <countryCode>
                            DK
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                    <pickupPoint>
                        <id>
                            736431
                        </id>
                        <countryCode>
                            DK
                        </countryCode>
                    </pickupPoint>
                </parties>
                <product>
                    <id>
                        PICKUP_PARCEL
                    </id>
                    <customerNumber>
                        PARCELS_DK-10005540322
                    </customerNumber>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Select Pickup Point in Denmark

    The products PICKUP_PARCEL and PICKUP_PARCEL_BULK support the deliveryOption=PICKUP_POINT for shipments within Denmark and to Denmark, respectively. The parcel will be delivered to the pickup point closest to the recipient address and the recipient will receive a notification when the parcel arrives. If you do not specify a delivery option for these products in Denmark, the package will be delivered to the door.

    You can also specify a pickup point id to get the package delivered at a specific pickup point. Use Pickup Point API to get list of nearest pickup points. Pickup point id and country code has to be specified under pickupPoint within parties as shown below.

    pickupPoint is optional but both id and countryCode inside it are mandatory. This element has precedence over deliveryOption=PICKUP_POINT i.e. if this element is present then pickup point specified in it will be selected irrespective of value set in deliveryOption.

    Pickup point delivery requires that the recipient has email and/or phone number set, so that he can receive notification when the package arrives at the pickup point.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1448632597117,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "2000",
                        "city": "Fredriksberg",
                        "countryCode": "DK",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "2600",
                        "city": "Glostrup",
                        "countryCode": "DK",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": {
                        "id": "736431",
                        "countryCode": "DK"
                    }
                },
                "product": {
                    "id": "PICKUP_PARCEL",
                    "customerNumber": "PARCELS_DK-10005540322",
                    "services": null,
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-27T14:56:43.392+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            2000
                        </postalCode>
                        <city>
                            Fredriksberg
                        </city>
                        <countryCode>
                            DK
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            2600
                        </postalCode>
                        <city>
                            Glostrup
                        </city>
                        <countryCode>
                            DK
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                    <pickupPoint>
                        <id>
                            736431
                        </id>
                        <countryCode>
                            DK
                        </countryCode>
                    </pickupPoint>
                </parties>
                <product>
                    <id>
                        PICKUP_PARCEL
                    </id>
                    <customerNumber>
                        PARCELS_DK-10005540322
                    </customerNumber>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Select Pickup Point in Finland

    You can specify pickup point Id in request for PICKUP_PARCEL_BULK products for delivery of parcels to Finland from other countries. Use Pickup Point API to get list of nearest pickup points.

    The parcel will be delivered to the pickup point specified in the request with SMS/Email notification. Pickup point delivery requires that the recipient has email and/or phone number set, so that he can receive notification when the package arrives at the pickup point.

    Pickup point id and country code has to be specified under pickupPoint within parties as shown below.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1448632597124,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "12000",
                        "city": "Stockholm",
                        "countryCode": "SE",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "21200",
                        "city": "Raisio",
                        "countryCode": "FI",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": {
                        "id": "736431",
                        "countryCode": "FI"
                    }
                },
                "product": {
                    "id": "PICKUP_PARCEL_BULK",
                    "customerNumber": "PARCELS_SWEDEN-123456",
                    "services": null,
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>
            1
        </schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-27T14:56:43.405+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            12000
                        </postalCode>
                        <city>
                            Stockholm
                        </city>
                        <countryCode>
                            SE
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            21200
                        </postalCode>
                        <city>
                            Raisio
                        </city>
                        <countryCode>
                            FI
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                    <pickupPoint>
                        <id>
                            736431
                        </id>
                        <countryCode>
                            FI
                        </countryCode>
                    </pickupPoint>
                </parties>
                <product>
                    <id>
                        PICKUP_PARCEL_BULK
                    </id>
                    <customerNumber>
                        PARCELS_SWEDEN-123456
                    </customerNumber>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Express

    Express service for Oil Express

    You can use Express service if you want to send your goods urgently (this service is applicable only for Oil Express product). In case of express delivery, goods are picked up as soon as possible and delivered to its destination.

    For using Express service send true value in express as shown in below example.

    {
        "schemaVersion": null,
        "consignments": [
            {
                "shippingDateTime": 1448632597122,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "0659",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": null
                },
                "product": {
                    "id": "OIL_EXPRESS",
                    "customerNumber": "SYSPED_NORWAY-17931",
                    "services": {
                        "recipientNotification": null,
                        "quickPackEnvelope": null,
                        "cashOnDelivery": null,
                        "deliveryOption": null,
                        "flexDelivery": null,
                        "deliveryIndoors": null,
                        "phoneNotification": null,
                        "nonFreeze": null,
                        "dangerousGoods": null,
                        "express": "TRUE",
                        "eveDelivery": null,
                        "advisering": null,
                        "simpleDelivery": null
                    },
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": "123",
                        "packageType": "ox_container",
                        "numberOfItems": 1,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": null
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="null">
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>
                    2015-11-27T14:56:43.424+01:00
                </shippingDateTime>
                <parties>
                    <sender>
                        <name>
                            Ola Nordmann
                        </name>
                        <addressLine>
                            Testsvingen 12
                        </addressLine>
                        <postalCode>
                            0263
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            1234
                        </reference>
                        <additionalAddressInfo>
                            Hentes på baksiden etter klokken to
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Trond Nordmann
                            </name>
                            <email>
                                trond@nordmanntest.no
                            </email>
                            <phoneNumber>
                                99999999
                            </phoneNumber>
                        </contact>
                    </sender>
                    <recipient>
                        <name>
                            Tore Mottaker
                        </name>
                        <addressLine>
                            Mottakerveien 14
                        </addressLine>
                        <addressLine2>
                            c/o Tina Mottaker
                        </addressLine2>
                        <postalCode>
                            0659
                        </postalCode>
                        <city>
                            OSLO
                        </city>
                        <countryCode>
                            NO
                        </countryCode>
                        <reference>
                            43242
                        </reference>
                        <additionalAddressInfo>
                            Bruk ringeklokken
                        </additionalAddressInfo>
                        <contact>
                            <name>
                                Tore mottaker
                            </name>
                            <email>
                                tore@mottakertest.no
                            </email>
                            <phoneNumber>
                                +46700000000
                            </phoneNumber>
                        </contact>
                    </recipient>
                </parties>
                <product>
                    <id>
                        OIL_EXPRESS
                    </id>
                    <customerNumber>
                        SYSPED_NORWAY-17931
                    </customerNumber>
                    <services>
                        <express>
                            TRUE
                        </express>
                    </services>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>
                            1.1
                        </weightInKg>
                        <goodsDescription>
                            Testing equipment
                        </goodsDescription>
                        <dimensions>
                            <heightInCm>
                                13
                            </heightInCm>
                            <widthInCm>
                                23
                            </widthInCm>
                            <lengthInCm>
                                10
                            </lengthInCm>
                        </dimensions>
                        <containerId>
                            123
                        </containerId>
                        <packageType>
                            ox_container
                        </packageType>
                        <numberOfItems>
                            1
                        </numberOfItems>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
    
  • Delivery Indoors

    The deliveryIndoors element/attribute can be set for products that allow delivery indoors. This element must contain an instruction message for the driver.

    {
        "schemaVersion": 1,
        "consignments": [
            {
                "shippingDateTime": 1447751818783,
                "parties": {
                    "sender": {
                        "name": "Ola Nordmann",
                        "addressLine": "Testsvingen 12",
                        "addressLine2": null,
                        "postalCode": "0263",
                        "city": "OSLO",
                        "countryCode": "NO",
                        "reference": "1234",
                        "additionalAddressInfo": "Hentes på baksiden etter klokken to",
                        "contact": {
                            "name": "Trond Nordmann",
                            "email": "trond@nordmanntest.no",
                            "phoneNumber": "99999999"
                        }
                    },
                    "recipient": {
                        "name": "Tore Mottaker",
                        "addressLine": "Mottakerveien 14",
                        "addressLine2": "c/o Tina Mottaker",
                        "postalCode": "10005",
                        "city": "STOCKHOLM",
                        "countryCode": "SE",
                        "reference": "43242",
                        "additionalAddressInfo": "Bruk ringeklokken",
                        "contact": {
                            "name": "Tore mottaker",
                            "email": "tore@mottakertest.no",
                            "phoneNumber": "+46700000000"
                        }
                    },
                    "pickupPoint": null
                },
                "product": {
                    "id": "BUSINESS_PARCEL",
                    "customerNumber": "PARCELS_NORWAY-00040067266",
                    "services": {
                        "recipientNotification": null,
                        "quickPackEnvelope": null,
                        "cashOnDelivery": null,
                        "deliveryOption": null,
                        "deliveryIndoors": {
                            "message": "Legg pakken i garasjen."
                        },
                        "nonFreeze": null,
                        "flexDelivery": null,
                        "dangerousGoods": null,
                        "express": null,
                        "eveDelivery": null,
                        "advisering": null,
                        "simpleDelivery": null
                    },
                    "customsDeclaration": null,
                    "messageForRecipient": null
                },
                "purchaseOrder": null,
                "correlationId": "INTERNAL-123456",
                "packages": [
                    {
                        "weightInKg": 1.1,
                        "goodsDescription": "Testing equipment",
                        "dimensions": {
                            "heightInCm": 13,
                            "widthInCm": 23,
                            "lengthInCm": 10
                        },
                        "containerId": null,
                        "packageType": null,
                        "numberOfItems": null,
                        "correlationId": "PACKAGE-123"
                    }
                ]
            }
        ],
        "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
      <schemaVersion>
        1
      </schemaVersion>
      <consignments>
        <consignment correlationId="INTERNAL-123456">
          <shippingDateTime>
            2015-12-22T20:04:33.131+01:00
          </shippingDateTime>
          <parties>
            <sender>
              <name>
                Ola Nordmann
              </name>
              <addressLine>
                Testsvingen 12
              </addressLine>
              <postalCode>
                0263
              </postalCode>
              <city>
                OSLO
              </city>
              <countryCode>
                NO
              </countryCode>
              <reference>
                1234
              </reference>
              <additionalAddressInfo>
                Hentes på baksiden etter klokken to
              </additionalAddressInfo>
              <contact>
                <name>
                  Trond Nordmann
                </name>
                <email>
                  trond@nordmanntest.no
                </email>
                <phoneNumber>
                  99999999
                </phoneNumber>
              </contact>
            </sender>
            <recipient>
              <name>
                Tore Mottaker
              </name>
              <addressLine>
                Mottakerveien 14
              </addressLine>
              <addressLine2>
                c/o Tina Mottaker
              </addressLine2>
              <postalCode>
                10005
              </postalCode>
              <city>
                STOCKHOLM
              </city>
              <countryCode>
                SE
              </countryCode>
              <reference>
                43242
              </reference>
              <additionalAddressInfo>
                Bruk ringeklokken
              </additionalAddressInfo>
              <contact>
                <name>
                  Tore mottaker
                </name>
                <email>
                  tore@mottakertest.no
                </email>
                <phoneNumber>
                  +46700000000
                </phoneNumber>
              </contact>
            </recipient>
          </parties>
          <product>
            <id>
              BUSINESS_PARCEL
            </id>
            <customerNumber>PARCELS_NORWAY-00096060397</customerNumber>
            <services>
              <deliveryIndoors>
                <message>
                  Legg pakken i garasjen.
                </message>
              </deliveryIndoors>
            </services>
          </product>
          <packages>
            <package correlationId="PACKAGE-123">
              <weightInKg>
                1.1
              </weightInKg>
              <goodsDescription>
                Testing equipment
              </goodsDescription>
              <dimensions>
                <heightInCm>
                  13
                </heightInCm>
                <widthInCm>
                  23
                </widthInCm>
                <lengthInCm>
                  10
                </lengthInCm>
              </dimensions>
            </package>
          </packages>
        </consignment>
      </consignments>
    </bookingRequest>
    
  • Temperature Zone

    The temperatureZone element/attribute can be set for Frigo product for the goods which requires temperature controlled environment. This element allows either of 4 values FROZEN, COOL, DRY and FISH.

    {
      "schemaVersion": 1,
      "consignments": [
        {
          "shippingDateTime": 1467840580196,
          "parties": {
            "sender": {
              "name": "Ola Nordmann",
              "addressLine": "Testsvingen 12",
              "addressLine2": null,
              "postalCode": "0263",
              "city": "OSLO",
              "countryCode": "no",
              "reference": "1234",
              "additionalAddressInfo": "Hentes påå baksiden etter klokken",
              "contact": {
                "name": "Trond Nordmann",
                "email": "trond@nordmanntest.no",
                "phoneNumber": "99999999"
              }
            },
            "recipient": {
              "name": "Tore Mottaker",
              "addressLine": "Mottakerveien 14",
              "addressLine2": "c/o Tina Mottaker",
              "postalCode": "0659",
              "city": "OSLO",
              "countryCode": "no",
              "reference": "43242",
              "additionalAddressInfo": "Bruk ringeklokken",
              "contact": {
                "name": "Tore mottaker",
                "email": "tore@mottakertest.no",
                "phoneNumber": "88888888"
              }
            },
            "pickupPoint": null
          },
          "product": {
            "id": "FRIGO",
            "customerNumber": "FRIGO-123456",
            "services": {
              "temperatureZone": "COOL"
            },
            "customsDeclaration": null
          },
          "purchaseOrder": null,
          "correlationId": "INTERNAL-123456",
          "packages": [
            {
              "weightInKg": 1.1,
              "goodsDescription": "Testing equipment",
              "dimensions": {
                "heightInCm": 120,
                "widthInCm": 80,
                "lengthInCm": 240
              },
              "containerId": null,
              "packageType": "frigo_whole",
              "numberOfItems": null,
              "correlationId": "PACKAGE-123"
            }
          ]
        }
      ],
      "testIndicator": true
    }
    
    <?xml version="1.0" encoding="UTF-8" ?>
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
      <schemaVersion>1</schemaVersion>
      <consignments>
        <consignment correlationId="INTERNAL-123456">
          <shippingDateTime>2016-07-01T16:37:00</shippingDateTime>
          <parties>
            <sender>
              <name>Ola Nordmann</name>
              <addressLine>Testsvingen 12</addressLine>
              <postalCode>0953</postalCode>
              <city>Stockholm</city>
              <countryCode>no</countryCode>
              <reference>1234</reference>
              <additionalAddressInfo>Hentes på baksiden etter klokken to</additionalAddressInfo>
              <contact>
                <name>Trond Nordmann</name>
                <email>trond@normanntest.no</email>
                <phoneNumber>99999999</phoneNumber>
              </contact>
            </sender>
            <recipient>
              <name>Tore Mottaker</name>
              <addressLine>Mottakerveien 14</addressLine>
              <addressLine2>c/o Tina Mottaker</addressLine2>
              <postalCode>0659</postalCode>
              <city>OSLO</city>
              <countryCode>no</countryCode>
              <reference>43242</reference>
              <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
              <contact>
                <name>Tore Mottaker</name>
                <email>tore@mottakertest.no</email>
                <phoneNumber>88888888</phoneNumber>
              </contact>
            </recipient>
          </parties>
          <product>
            <id>FRIGO</id>
            <customerNumber>FRIGO-123456</customerNumber>
            <services>
              <temperatureZone>COOL</temperatureZone>
            </services>
          </product>
          <packages>
            <package correlationId="PACKAGE-123">
              <goodsDescription>description</goodsDescription>
              <weightInKg>1000</weightInKg>
              <packageType>frigo_whole</packageType>
              <dimensions>
                <heightInCm>120</heightInCm>
                <widthInCm>80</widthInCm>
                <lengthInCm>240</lengthInCm>
              </dimensions>
            </package>
          </packages>
    
        </consignment>
      </consignments>
    </bookingRequest>
    
  • Cargo International - Incoterms

    The incotermRule element/attribute can be set for Cargo International product. This is a mandatory element while creating an order for Cargo International. API request will return error code i.e., BOOK-INPUT-065 in case of no IncotermRule is provided in request. This element allows either of 13 values DDP, DAP, FCA, FAS, FOB, CFR, CIF, CPT, CIP, DAT, DAF, DES and EXW.

    {
      "bookingRequest": {
        "-xmlns": "http://www.bring.no/booking/",
        "-testIndicator": "true",
        "schemaVersion": "1",
        "consignments": {
          "consignment": {
            "-correlationId": "INTERNAL-123456",
            "shippingDateTime": "2016-08-10T22:05:39.454+01:00",
            "parties": {
              "sender": {
                "name": "Ola Nordmann",
                "addressLine": "Testsvingen 12",
                "addressLine2": "Testsvingen 12",
                "postalCode": "0263",
                "city": "OSLO",
                "countryCode": "no",
                "reference": "1234",
                "additionalAddressInfo": "Hentes på baksiden etter",
                "contact": {
                  "name": "Trond Nordmann",
                  "email": "trond@normanntest.no",
                  "phoneNumber": "99999999"
                }
              },
              "consignor": {
                "name": "Ola Nordmann",
                "addressLine": "Testsvingen 12",
                "addressLine2": "Testsvingen 12",
                "postalCode": "0263",
                "city": "OSLO",
                "countryCode": "no",
                "reference": "1234",
                "additionalAddressInfo": "Hentes på baksiden etter to",
                "vatNumber": "1000-1028527",
                "contact": {
                  "name": "Trond Nordmann",
                  "email": "trond@normanntest.no",
                  "phoneNumber": "99999999"
                }
              },
              "recipient": {
                "name": "Tore Mottaker",
                "addressLine": "Mottakerveien 14",
                "addressLine2": "c/o Tina Mottaker",
                "postalCode": "10115",
                "city": "BERLIN",
                "countryCode": "DE",
                "reference": "43242",
                "additionalAddressInfo": "Bruk ringeklokken",
                "contact": {
                  "name": "Tore Mottaker",
                  "email": "tore@mottakertest.no",
                  "phoneNumber": "88888888"
                }
              },
              "consignee": {
                "name": "Tore Mottaker",
                "addressLine": "Mottakerveien 14",
                "addressLine2": "c/o Tina Mottaker",
                "postalCode": "10115",
                "city": "BERLIN",
                "countryCode": "DE",
                "reference": "43242",
                "additionalAddressInfo": "Bruk ringeklokken",
                "contact": {
                  "name": "Tore Mottaker",
                  "email": "tore@mottakertest.no",
                  "phoneNumber": "88888888"
                },
                "vatNumber": "1000-1028527"
              }
            },
            "product": {
              "id": "CARGO_INTERNATIONAL",
              "customerNumber": "CARGO-803739",
              "incotermRule": "DDP"
            },
            "packages": {
              "package": {
                "-correlationId": "PACKAGE-123",
                "weightInKg": "1.1",
                "dimensions": {
                  "heightInCm": "10",
                  "widthInCm": "10",
                  "lengthInCm": "10"
                }
              }
            }
          }
        }
      }
    }
    <?xml version="1.0" encoding="UTF-8" ?>
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>1</schemaVersion>
        <consignments>
            <consignment correlationId="INTERNAL-123456">
                <shippingDateTime>2016-08-10T22:05:39.454+01:00</shippingDateTime>
                <parties>
                    <sender>
                        <name>Ola Nordmann</name>
                        <addressLine>Testsvingen 12</addressLine>
                        <addressLine2>Testsvingen 12</addressLine2>
                        <postalCode>0263</postalCode>
                        <city>OSLO</city>
                        <countryCode>no</countryCode>
                        <reference>1234</reference>
                        <additionalAddressInfo>Hentes på baksiden etter</additionalAddressInfo>
                        <contact>
                            <name>Trond Nordmann</name>
                            <email>trond@normanntest.no</email>
                            <phoneNumber>99999999</phoneNumber>
                        </contact>
                    </sender>
                    <consignor>
                        <name>Ola Nordmann</name>
                        <addressLine>Testsvingen 12</addressLine>
                        <addressLine2>Testsvingen 12</addressLine2>
                        <postalCode>0263</postalCode>
                        <city>OSLO</city>
                        <countryCode>no</countryCode>
                        <reference>1234</reference>
                        <additionalAddressInfo>Hentes på baksiden etter to</additionalAddressInfo>
                        <vatNumber>1000-1028527</vatNumber>
                        <contact>
                            <name>Trond Nordmann</name>
                            <email>trond@normanntest.no</email>
                            <phoneNumber>99999999</phoneNumber>
                        </contact>
                    </consignor>
                    <recipient>
                        <name>Tore Mottaker</name>
                        <addressLine>Mottakerveien 14</addressLine>
                        <addressLine2>c/o Tina Mottaker</addressLine2>
                        <postalCode>10115</postalCode>
                        <city>BERLIN</city>
                        <countryCode>DE</countryCode>
                        <reference>43242</reference>
                        <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
                        <contact>
                            <name>Tore Mottaker</name>
                            <email>tore@mottakertest.no</email>
                            <phoneNumber>88888888</phoneNumber>
                        </contact>
                    </recipient>
                    <consignee>
                        <name>Tore Mottaker</name>
                        <addressLine>Mottakerveien 14</addressLine>
                        <addressLine2>c/o Tina Mottaker</addressLine2>
                        <postalCode>10115</postalCode>
                        <city>BERLIN</city>
                        <countryCode>DE</countryCode>
                        <reference>43242</reference>
                        <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
                        <contact>
                            <name>Tore Mottaker</name>
                            <email>tore@mottakertest.no</email>
                            <phoneNumber>88888888</phoneNumber>
                        </contact>
                        <vatNumber>1000-1028527</vatNumber>
                    </consignee>
                </parties>
                <product>
                    <id>CARGO_INTERNATIONAL</id>
                    <customerNumber>CARGO-803739</customerNumber>
                    <incotermRule>DDP</incotermRule>
                </product>
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>1.1</weightInKg>
                        <dimensions>
                            <heightInCm>10</heightInCm>
                            <widthInCm>10</widthInCm>
                            <lengthInCm>10</lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
  • Cargo International - Dangerous Goods

    The dangerousGoods attribute/element block should be there in request for Cargo International to create an order with dangerous goods.

    {
      "bookingRequest": {
        "-xmlns": "http://www.bring.no/booking/",
        "-testIndicator": "true",
        "schemaVersion": "1",
        "consignments": {
          "consignment": {
            "-correlationId": "INTERNAL-123456",
            "shippingDateTime": "2016-08-05T22:05:39.454+01:00",
            "parties": {
              "sender": {
                "name": "Ola Nordmann",
                "addressLine": "Testsvingen 12",
                "addressLine2": "Testsvingen 12",
                "postalCode": "0263",
                "city": "OSLO",
                "countryCode": "no",
                "reference": "1234",
                "additionalAddressInfo": "Hentes på baksiden etter",
                "contact": {
                  "name": "Trond Nordmann",
                  "email": "trond@normanntest.no",
                  "phoneNumber": "99999999"
                }
              },
              "consignor": {
                "name": "Ola Nordmann",
                "addressLine": "Testsvingen 12",
                "addressLine2": "Testsvingen 12",
                "postalCode": "0263",
                "city": "OSLO",
                "countryCode": "no",
                "reference": "1234",
                "additionalAddressInfo": "Hentes på baksiden etter to",
                "vatNumber": "1000-1028527",
                "contact": {
                  "name": "Trond Nordmann",
                  "email": "trond@normanntest.no",
                  "phoneNumber": "99999999"
                }
              },
              "recipient": {
                "name": "Tore Mottaker",
                "addressLine": "Mottakerveien 14",
                "addressLine2": "c/o Tina Mottaker",
                "postalCode": "10115",
                "city": "BERLIN",
                "countryCode": "DE",
                "reference": "43242",
                "additionalAddressInfo": "Bruk ringeklokken",
                "contact": {
                  "name": "Tore Mottaker",
                  "email": "tore@mottakertest.no",
                  "phoneNumber": "88888888"
                }
              },
              "consignee": {
                "name": "Tore Mottaker",
                "addressLine": "Mottakerveien 14",
                "addressLine2": "c/o Tina Mottaker",
                "postalCode": "10115",
                "city": "BERLIN",
                "countryCode": "DE",
                "reference": "43242",
                "additionalAddressInfo": "Bruk ringeklokken",
                "contact": {
                  "name": "Tore Mottaker",
                  "email": "tore@mottakertest.no",
                  "phoneNumber": "88888888"
                },
                "vatNumber": "1000-1028527"
              }
            },
            "product": {
              "id": "CARGO_INTERNATIONAL",
              "customerNumber": "CARGO-803739",
              "incotermRule": "DDP",
              "services": {
                "dangerousGoods": {
                  "containerId": "1236",
                  "weightInGrams": "500000",
                  "unNumber": "1560",
                  "commodity": "ARSENTRIKLORID",
                  "packingGroup": "I",
                  "dangerClass": "1",
                  "safetyMarkCode": "6.1"
                }
              }
            },
            "packages": {
              "package": {
                "-correlationId": "PACKAGE-123",
                "weightInKg": "1.1",
                "dimensions": {
                  "heightInCm": "10",
                  "widthInCm": "10",
                  "lengthInCm": "10"
                }
              }
            }
          }
        }
      }
    }
    <?xml version="1.0" encoding="UTF-8" ?>
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>1</schemaVersion>
    
        <consignments>
    
            <consignment correlationId="INTERNAL-123456">
    
                <shippingDateTime>2016-08-05T22:05:39.454+01:00</shippingDateTime>
    
                <parties>
                    <sender>
                        <name>Ola Nordmann</name>
                        <addressLine>Testsvingen 12</addressLine>
                        <addressLine2>Testsvingen 12</addressLine2>
                        <postalCode>0263</postalCode>
                        <city>OSLO</city>
                        <countryCode>no</countryCode>
                        <reference>1234</reference>
                        <additionalAddressInfo>Hentes på baksiden etter</additionalAddressInfo>
                        <contact>
                            <name>Trond Nordmann</name>
                            <email>trond@normanntest.no</email>
                            <phoneNumber>99999999</phoneNumber>
                        </contact>
                    </sender>
                    <consignor>
                        <name>Ola Nordmann</name>
                        <addressLine>Testsvingen 12</addressLine>
                        <addressLine2>Testsvingen 12</addressLine2>
                        <postalCode>0263</postalCode>
                        <city>OSLO</city>
                        <countryCode>no</countryCode>
                        <reference>1234</reference>
                        <additionalAddressInfo>Hentes på baksiden etter to</additionalAddressInfo>
                        <vatNumber>1000-1028527</vatNumber>
                        <contact>
                            <name>Trond Nordmann</name>
                            <email>trond@normanntest.no</email>
                            <phoneNumber>99999999</phoneNumber>
                        </contact>
                    </consignor>
    
                    <recipient>
                        <name>Tore Mottaker</name>
                        <addressLine>Mottakerveien 14</addressLine>
                        <addressLine2>c/o Tina Mottaker</addressLine2>
                        <postalCode>10115</postalCode>
                        <city>BERLIN</city>
                        <countryCode>DE</countryCode>
                        <reference>43242</reference>
                        <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
                        <contact>
                            <name>Tore Mottaker</name>
                            <email>tore@mottakertest.no</email>
                            <phoneNumber>88888888</phoneNumber>
                        </contact>
                    </recipient>
                    <consignee>
                        <name>Tore Mottaker</name>
                        <addressLine>Mottakerveien 14</addressLine>
                        <addressLine2>c/o Tina Mottaker</addressLine2>
                        <postalCode>10115</postalCode>
                        <city>BERLIN</city>
                        <countryCode>DE</countryCode>
                        <reference>43242</reference>
                        <additionalAddressInfo>Bruk ringeklokken</additionalAddressInfo>
                        <contact>
                            <name>Tore Mottaker</name>
                            <email>tore@mottakertest.no</email>
                            <phoneNumber>88888888</phoneNumber>
                        </contact>
                        <vatNumber>1000-1028527</vatNumber>
                    </consignee>
                </parties>
    
                <product>
                    <id>CARGO_INTERNATIONAL</id>
                    <customerNumber>CARGO-803739</customerNumber>
                    <incotermRule>DDP</incotermRule>
                    <services>
                        <dangerousGoods>
                            <containerId>1236</containerId>
                            <weightInGrams>500000</weightInGrams>
                            <unNumber>1560</unNumber>
                            <commodity>ARSENTRIKLORID</commodity>
                            <packingGroup>I</packingGroup>
                            <dangerClass>1</dangerClass>
                            <tunnelRestrictionCode></tunnelRestrictionCode>
                            <safetyMarkCode>6.1</safetyMarkCode>
                            <factor></factor>
                        </dangerousGoods>
                    </services>
                </product>
    
    
    
                <packages>
                    <package correlationId="PACKAGE-123">
                        <weightInKg>1.1</weightInKg>
                        <dimensions>
                            <heightInCm>10</heightInCm>
                            <widthInCm>10</widthInCm>
                            <lengthInCm>10</lengthInCm>
                        </dimensions>
                    </package>
                </packages>
    
            </consignment>
        </consignments>
    </bookingRequest>
  • Cargo Norway - Dangerous Goods

    The dangerousGoods attribute/element block should be there in request for Cargo Norway to create an order with dangerous goods.

    {
      "bookingRequest": {
        "-xmlns": "http://www.bring.no/booking/",
        "-testIndicator": "true",
        "schemaVersion": "1",
        "consignments": {
          "consignment": {
            "-correlationId": "123456",
            "shippingDateTime": "2016-08-05T06:24:09",
            "parties": {
              "sender": {
                "name": "Ola Danske",
                "addressLine": "Testsvingen 12",
                "postalCode": "4010",
                "city": "Fredriksberg",
                "countryCode": "NO",
                "additionalAddressInfo": "Some pickup info",
                "contact": {
                  "name": "Trond Nordmann",
                  "email": "trond@normanntest.no",
                  "phoneNumber": "99999999"
                }
              },
              "recipient": {
                "name": "Tore Recipient",
                "addressLine": "Mottakerveien 14",
                "addressLine2": "c/o Tina Recipient",
                "postalCode": "5954",
                "city": "Glostrup",
                "countryCode": "NO",
                "contact": {
                  "name": "Tore Recipient",
                  "email": "tore@mottakertest.no",
                  "phoneNumber": "88888888"
                }
              }
            },
            "product": {
              "id": "CARGO_GROUPAGE",
              "customerNumber": "CARGO-803739",
              "services": {
                "dangerousGoods": {
                  "containerId": "1236",
                  "weightInGrams": "500000",
                  "unNumber": "1560",
                  "commodity": "ARSENTRIKLORID",
                  "packingGroup": "I",
                  "dangerClass": "1",
                  "safetyMarkCode": "6.1"
                }
              }
            },
            "packages": {
              "package": {
                "-correlationId": "123",
                "weightInKg": "50",
                "dimensions": {
                  "heightInCm": "200",
                  "widthInCm": "100",
                  "lengthInCm": "100"
                }
              }
            }
          }
        }
      }
    }
    <?xml version="1.0" encoding="UTF-8" ?>
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <schemaVersion>1</schemaVersion>
    
        <consignments>
    
            <consignment correlationId="123456">
    
                <shippingDateTime>2016-08-05T06:24:09</shippingDateTime>
    
                <parties>
                    <sender>
                        <name>Ola Danske</name>
                        <addressLine>Testsvingen 12</addressLine>
                        <postalCode>4010</postalCode>
                        <city>Fredriksberg</city>
                        <countryCode>NO</countryCode>
                        <additionalAddressInfo>Some pickup info</additionalAddressInfo>
                        <contact>
                            <name>Trond Nordmann</name>
                            <email>trond@normanntest.no</email>
                            <phoneNumber>99999999</phoneNumber>
                        </contact>
                    </sender>
    
                    <recipient>
                        <name>Tore Recipient</name>
                        <addressLine>Mottakerveien 14</addressLine>
                        <addressLine2>c/o Tina Recipient</addressLine2>
                        <postalCode>5954</postalCode>
                        <city>Glostrup</city>
                        <countryCode>NO</countryCode>
                        <contact>
                            <name>Tore Recipient</name>
                            <email>tore@mottakertest.no</email>
                            <phoneNumber>88888888</phoneNumber>
                        </contact>
                    </recipient>
                </parties>
    
                <product>
                    <id>CARGO_GROUPAGE</id>
                    <customerNumber>CARGO-803739</customerNumber>
                    <services>
                        <dangerousGoods>
                            <containerId>1236</containerId>
                            <weightInGrams>500000</weightInGrams>
                            <unNumber>1560</unNumber>
                            <commodity>ARSENTRIKLORID</commodity>
                            <packingGroup>I</packingGroup>
                            <dangerClass>1</dangerClass>
                            <tunnelRestrictionCode></tunnelRestrictionCode>
                            <safetyMarkCode>6.1</safetyMarkCode>
                            <factor></factor>
                        </dangerousGoods>
                    </services>
                </product>
    
                <packages>
                    <package correlationId="123">
                        <weightInKg>50</weightInKg>
                        <dimensions>
                            <heightInCm>200</heightInCm>
                            <widthInCm>100</widthInCm>
                            <lengthInCm>100</lengthInCm>
                        </dimensions>
                    </package>
                </packages>
            </consignment>
        </consignments>
    </bookingRequest>
  • Simple Delivery

    The simpleDelivery element/attribute can be set for products that allow simple delivery.

    {
      "schemaVersion": 1,
      "consignments": [
        {
          "shippingDateTime": 1479547018000,
          "parties": {
            "sender": {
              "name": "Ola Nordmann",
              "addressLine": "Testsvingen 12",
              "addressLine2": null,
              "postalCode": "0263",
              "city": "OSLO",
              "countryCode": "NO",
              "reference": "1234",
              "additionalAddressInfo": "Hentes på baksiden etter klokken to",
              "contact": {
                "name": "Trond Nordmann",
                "email": "trond@nordmanntest.no",
                "phoneNumber": "99999999"
              }
            },
            "recipient": {
              "name": "Tore Mottaker",
              "addressLine": "Mottakerveien 14",
              "addressLine2": "c/o Tina Mottaker",
              "postalCode": "0659",
              "city": "OSLO",
              "countryCode": "NO",
              "reference": "43242",
              "additionalAddressInfo": "Bruk ringeklokken",
              "contact": {
                "name": "Tore mottaker",
                "email": "tore@mottakertest.no",
                "phoneNumber": "+46700000000"
              }
            },
            "pickupPoint": null
          },
          "product": {
            "id": "BPAKKE_DOR-DOR",
            "customerNumber": "PARCELS_NORWAY-01002197015",
            "services": {
    
              "simpleDelivery": true
            },
            "customsDeclaration": null,
            "messageForRecipient": null
          },
          "purchaseOrder": null,
          "correlationId": "INTERNAL-123456",
          "packages": [
            {
              "weightInKg": 1.1,
              "goodsDescription": "Testing equipment",
              "dimensions": {
                "heightInCm": 13,
                "widthInCm": 23,
                "lengthInCm": 10
              },
              "containerId": null,
              "packageType": null,
              "numberOfItems": null,
              "correlationId": "PACKAGE-123"
            }
          ]
        }
      ],
      "testIndicator": true
    }
    
    <bookingRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
      <schemaVersion>1</schemaVersion>
      <consignments>
        <consignment correlationId="INTERNAL-123456">
          <shippingDateTime>2016-11-17T14:54:33.208+01:00</shippingDateTime>
          <parties>
            <sender>
              <name>Stian Mathiassen</name>
              <addressLine>Testsvingen 12</addressLine>
              <postalCode>0373</postalCode>
              <city>OSLO</city>
              <countryCode>no</countryCode>
              <reference>1234</reference>
              <additionalAddressInfo>Hentes på baksiden etter klokken to</additionalAddressInfo>
              <contact>
                <name>Test Testessen</name>
                <email>test.testessen@some12.no</email>
                <phoneNumber>95791102</phoneNumber>
              </contact>
            </sender>
            <recipient>
              <name>Komfortshop Skandinavia</name>
              <addressLine>Avstikkeren 7</addressLine>
              <addressLine2>c/o Tina Mottaker</addressLine2>
              <postalCode>1156</postalCode>
              <city>Oslo</city>
              <countryCode>NO</countryCode>
              <reference>Slavko Kozarac</reference>
              <additionalAddressInfo></additionalAddressInfo>
              <contact>
                <name>Komfortshop Skandinavia</name>
                <email>komfortshop.skandinavia@gmail.com</email>
                <phoneNumber>92488435</phoneNumber>
              </contact>
            </recipient>
          </parties>
          <product>
            <id>BPAKKE_DOR-DOR</id>
            <customerNumber>PARCELS_NORWAY-01002197015</customerNumber>
            <services>
              <simpleDelivery>true</simpleDelivery>
            </services>
          </product>
          <packages>
            <package correlationId="PACKAGE-123">
              <weightInKg>1.1</weightInKg>
              <goodsDescription>Testing equipment</goodsDescription>
              <dimensions>
                <heightInCm>31</heightInCm>
                <widthInCm>21</widthInCm>
                <lengthInCm>6</lengthInCm>
              </dimensions>
            </package>
          </packages>
        </consignment>
      </consignments>
    </bookingRequest>
    

Error codes

Programming is hard. Something will always go wrong. See below for the current enumeration of error codes. A value of “true” for the attribute “suffixable” means that the error code is suffixed with “-SENDER” if the error is for the sending party data and “-RECIPIENT” if the error is for the recipient party data.

URL

https://api.bring.com/booking/api/errors.json
https://api.bring.com/booking/api/errors.xml

Request body

{
  "errorTypes": [
    {
      "code": "BOOK-INPUT-001",
      "message": "Bad request",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-002",
      "message": "Weight is required",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-003",
      "message": "Schema version must be present",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-004",
      "message": "At least one consignment must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-005",
      "message": "Multiple consignments in one booking is not supported",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-006",
      "message": "Sender must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-007",
      "message": "Recipient must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-008",
      "message": "Product must be set",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-009",
      "message": "Package or Package Group must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-011",
      "message": "Multiple packages in one booking is not supported",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-012",
      "message": "Shipping date and time must be provided",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-013",
      "message": "Package dimensions must be provided",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-014",
      "message": "Name must be provided",
      "suffixable": true
    },
    {
      "code": "BOOK-INPUT-015",
      "message": "Address must be provided",
      "suffixable": true
    },
    {
      "code": "BOOK-INPUT-016",
      "message": "City must be provided",
      "suffixable": true
    },
    {
      "code": "BOOK-INPUT-017",
      "message": "ISO Country code must be provided",
      "suffixable": true
    },
    {
      "code": "BOOK-INPUT-018",
      "message": "Product ID must be provided",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-019",
      "message": "Customer number must be provided",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-020",
      "message": "Invalid product ID",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-021",
      "message": "Invalid customer number",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-022",
      "message": "Illegal product for country",
      "suffixable": true
    },
    {
      "code": "BOOK-INPUT-023",
      "message": "The shipment is too big to send with the given product",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-024",
      "message": "The product is not available between the given addresses (outside coverage)",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-025",
      "message": "The product is not available between the given countries",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-027",
      "message": "Failed because of product specific requirements",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-028",
      "message": "Invalid country code",
      "suffixable": true
    },
    {
      "code": "BOOK-INPUT-029",
      "message": "Invalid customer number for sender country and product",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-030",
      "message": "Please set the testIndicator attribute on the request (true = test booking, false = production booking)",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-031",
      "message": "You must specify number of packages (pieces) included in the package group",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-032",
      "message": "Multiple packages are not supported for this product",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-033",
      "message": "Package groups are not supported for this product",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-034",
      "message": "Multiple package groups are not supported for this product",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-035",
      "message": "Invalid value for QuickPack Envelope. Must be boolean lower case.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-036",
      "message": "Invalid currency code, use ISO 4217 currency code",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-037",
      "message": "Missing required input for cash on delivery. amount, currency and account are required.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-038",
      "message": "Invalid message type for cash on delivery.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-039",
      "message": "Delivery option is invalid.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-040",
      "message": "Delivery option is not applicable for this product.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-041",
      "message": "Invalid purchase order number",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-043",
      "message": "The customer does not have a return agreement for that country/product.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-044",
      "message": "Missing required input for cash on delivery. account type is required for Sweden.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-045",
      "message": "Could not find a pickup point for the provided recipient",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-046",
      "message": "Non freeze should be lowercase true or false.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-047",
      "message": "Pickup point delivery method is only available for PICKUP_PARCEL from other countries than Norway to Denmark and Sweden, PICKUP_PARCEL_BULK to Denmark, Norway, Sweden, Finland and for SERVICEPAKKE within NORWAY.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-048",
      "message": "Missing required UNNumber for Dangerous goods.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-049",
      "message": "Missing required Commodity for Dangerous goods.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-050",
      "message": "Missing required Weight for Dangerous goods.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-051",
      "message": "Missing required Danger class for Dangerous goods.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-052",
      "message": "Missing required Container Id for Oil Express Product",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-053",
      "message": "Dangerous Goods Container Id should match with one of the container Id in Package List",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-054",
      "message": "Invalid amount for Cash On Delivery, use amount with two decimal places only",
      "suffixable": false
    },
    {
      "code": "BOOK_INPUT-055",
      "message": "Dangerous Goods is not supported for given product",
      "suffixable": false
    },
    {
      "code": "BOOK_INPUT-056",
      "message": "Evening Delivery is not supported for given product",
      "suffixable": false
    },
    {
      "code": "BOOK_INPUT-057",
      "message": "Invalid postal Code",
      "suffixable": true
    },
    {
      "code": "BOOK_INPUT-058",
      "message": "Guided booking is currently allowed only in Norway.",
      "suffixable": false
    },
    {
      "code": "BOOK_INPUT-059",
      "message": "Invalid input provided. Not able to parse the input successfully.",
      "suffixable": false
    },
    {
      "code": "BOOK_INPUT-060",
      "message": "Missing booking request",
      "suffixable": false
    },
    {
      "code": "BOOK_INPUT-061",
      "message": "Maximum 400 characters are allowed in Message For Recipient field.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-062",
      "message": "Missing required message input for delivery indoor",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-063",
      "message": "Consignor must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-064",
      "message": "Consignee must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-065",
      "message": "Incoterm must be specified",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-066",
      "message": "Valid temperature zones are: frozen, cool, dry, fish",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-067",
      "message": "Option isStackable must be specified for Frigo HALF_PALLET",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-068",
      "message": "Package type must be specified for Frigo product.",
      "suffixable": false
    },
    {
      "code": "BOOK-INPUT-069",
      "message": "Invalid package type for Frigo product. Available options: 'frigo_whole', 'frigo_half', 'frigo_import', 'frigo_bison', 'frigo_flower', 'frigo_single'",
      "suffixable": false
    },
    {
      "code": "BOOK-AUTHORIZATION-001",
      "message": "Your user is not authorized to perform this action",
      "suffixable": false
    },
    {
      "code": "BOOK-VALIDATION-001",
      "message": "Unexpected business validation rule failure",
      "suffixable": false
    },
    {
      "code": "BOOK_VALIDATION-002",
      "message": "A valid mobile phone number or email address is required for eVarsling",
      "suffixable": false
    },
    {
      "code": "BOOK_VALIDATION-003",
      "message": "Country is not a member of Universal Postal Union",
      "suffixable": true
    },
    {
      "code": "BOOK_VALIDATION-004",
      "message": "Phone Notification is available in Sweden only.",
      "suffixable": false
    },
    {
      "code": "BOOK_VALIDATION-005",
      "message": "Phone Notification should be true.",
      "suffixable": false
    },
    {
      "code": "BOOK_VALIDATION-006",
      "message": "Phone Notification requires recipient number to be present.",
      "suffixable": false
    },
    {
      "code": "BOOK_VALIDATION-007",
      "message": "Delivery indoor is available in Sweden and Denmark only.",
      "suffixable": false
    },
    {
      "code": "BOOK-INTERNAL-001",
      "message": "An unexpected error occured",
      "suffixable": false
    },
    {
      "code": "BOOK-INTERNAL-002",
      "message": "A required external service is unavailable",
      "suffixable": false
    },
    {
      "code": "PICKUP-INTERNAL-001",
      "message": "An unexpected error occured",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-001",
      "message": "Error with input in pickupOrder",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-002",
      "message": "Postal code must be given and be valid",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-003",
      "message": "Cargo customer must provide cargoInformation element. Parcel customer must provide parcelsInformation element",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-004",
      "message": "This customer number cannot be used to order Pickup",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-005",
      "message": "You must specify pickupIsReadyAtTime element HH:mm:ss",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-006",
      "message": "You must specify pickupDate element yyyy-MM-dd",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-007",
      "message": "Pickup date must be in the future",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-008",
      "message": "weightInGrams is required, and must be an integer larger than zero",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-009",
      "message": "Must be an integer larger than zero",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-010",
      "message": "Country code is required",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-011",
      "message": "Both Pickup Point ID and Country Code is Required",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-012",
      "message": "Selected pickup point should be in recipient country",
      "suffixable": false
    },
    {
      "code": "PICKUP-INPUT-013",
      "message": "Combination pickupIsReadyAtTime and pickupDate must be in the future",
      "suffixable": false
    },
    {
      "code": "NETS_TRANSACTION_INPUT-001",
      "message": "Missing Nets transaction request",
      "suffixable": false
    },
    {
      "code": "NETS_TRANSACTION_INPUT-002",
      "message": "Missing Nets transaction id",
      "suffixable": false
    },
    {
      "code": "NETS_TRANSACTION_INPUT-003",
      "message": "Missing Bring consignment number",
      "suffixable": false
    },
    {
      "code": "NETS_TRANSACTION_INPUT-004",
      "message": "Missing customer number",
      "suffixable": false
    }
  ]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<errorTypeList xmlns="http://www.bring.no/booking/">
  <errorTypes>
    <errorType>
      <code>BOOK-INPUT-001</code>
      <message>Bad request</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-002</code>
      <message>Weight is required</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-003</code>
      <message>Schema version must be present</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-004</code>
      <message>At least one consignment must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-005</code>
      <message>Multiple consignments in one booking is not supported</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-006</code>
      <message>Sender must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-007</code>
      <message>Recipient must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-008</code>
      <message>Product must be set</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-009</code>
      <message>Package or Package Group must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-011</code>
      <message>Multiple packages in one booking is not supported</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-012</code>
      <message>Shipping date and time must be provided</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-013</code>
      <message>Package dimensions must be provided</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-014</code>
      <message>Name must be provided</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-015</code>
      <message>Address must be provided</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-016</code>
      <message>City must be provided</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-017</code>
      <message>ISO Country code must be provided</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-018</code>
      <message>Product ID must be provided</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-019</code>
      <message>Customer number must be provided</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-020</code>
      <message>Invalid product ID</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-021</code>
      <message>Invalid customer number</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-022</code>
      <message>Illegal product for country</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-023</code>
      <message>The shipment is too big to send with the given product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-024</code>
      <message>The product is not available between the given addresses (outside coverage)</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-025</code>
      <message>The product is not available between the given countries</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-027</code>
      <message>Failed because of product specific requirements</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-028</code>
      <message>Invalid country code</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-029</code>
      <message>Invalid customer number for sender country and product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-030</code>
      <message>Please set the testIndicator attribute on the request (true = test booking, false = production booking)</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-031</code>
      <message>You must specify number of packages (pieces) included in the package group</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-032</code>
      <message>Multiple packages are not supported for this product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-033</code>
      <message>Package groups are not supported for this product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-034</code>
      <message>Multiple package groups are not supported for this product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-035</code>
      <message>Invalid value for QuickPack Envelope. Must be boolean lower case.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-036</code>
      <message>Invalid currency code, use ISO 4217 currency code</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-037</code>
      <message>Missing required input for cash on delivery. amount, currency and account are required.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-038</code>
      <message>Invalid message type for cash on delivery.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-039</code>
      <message>Delivery option is invalid.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-040</code>
      <message>Delivery option is not applicable for this product.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-041</code>
      <message>Invalid purchase order number</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-043</code>
      <message>The customer does not have a return agreement for that country/product.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-044</code>
      <message>Missing required input for cash on delivery. account type is required for Sweden.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-045</code>
      <message>Could not find a pickup point for the provided recipient</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-046</code>
      <message>Non freeze should be lowercase true or false.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-047</code>
      <message>Pickup point delivery method is only available for PICKUP_PARCEL from other countries than Norway to Denmark and Sweden, PICKUP_PARCEL_BULK to Denmark, Norway, Sweden, Finland and for SERVICEPAKKE within NORWAY.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-048</code>
      <message>Missing required UNNumber for Dangerous goods.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-049</code>
      <message>Missing required Commodity for Dangerous goods.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-050</code>
      <message>Missing required Weight for Dangerous goods.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-051</code>
      <message>Missing required Danger class for Dangerous goods.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-052</code>
      <message>Missing required Container Id for Oil Express Product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-053</code>
      <message>Dangerous Goods Container Id should match with one of the container Id in Package List</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-054</code>
      <message>Invalid amount for Cash On Delivery, use amount with two decimal places only</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-055</code>
      <message>Dangerous Goods is not supported for given product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-056</code>
      <message>Evening Delivery is not supported for given product</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-057</code>
      <message>Invalid postal Code</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-058</code>
      <message>Guided booking is currently allowed only in Norway.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-059</code>
      <message>Invalid input provided. Not able to parse the input successfully.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-060</code>
      <message>Missing booking request</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_INPUT-061</code>
      <message>Maximum 400 characters are allowed in Message For Recipient field.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-062</code>
      <message>Missing required message input for delivery indoor</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-063</code>
      <message>Consignor must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-064</code>
      <message>Consignee must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-065</code>
      <message>Incoterm must be specified</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-066</code>
      <message>Valid temperature zones are: frozen, cool, dry, fish</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-067</code>
      <message>Option isStackable must be specified for Frigo HALF_PALLET</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-068</code>
      <message>Package type must be specified for Frigo product.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INPUT-069</code>
      <message>Invalid package type for Frigo product. Available options: 'frigo_whole', 'frigo_half', 'frigo_import', 'frigo_bison', 'frigo_flower', 'frigo_single'</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-AUTHORIZATION-001</code>
      <message>Your user is not authorized to perform this action</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-VALIDATION-001</code>
      <message>Unexpected business validation rule failure</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_VALIDATION-002</code>
      <message>A valid mobile phone number or email address is required for eVarsling</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_VALIDATION-003</code>
      <message>Country is not a member of Universal Postal Union</message>
      <suffixable>true</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_VALIDATION-004</code>
      <message>Phone Notification is available in Sweden only.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_VALIDATION-005</code>
      <message>Phone Notification should be true.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_VALIDATION-006</code>
      <message>Phone Notification requires recipient number to be present.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK_VALIDATION-007</code>
      <message>Delivery indoor is available in Sweden and Denmark only.</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INTERNAL-001</code>
      <message>An unexpected error occured</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>BOOK-INTERNAL-002</code>
      <message>A required external service is unavailable</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INTERNAL-001</code>
      <message>An unexpected error occured</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-001</code>
      <message>Error with input in pickupOrder</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-002</code>
      <message>Postal code must be given and be valid</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-003</code>
      <message>Cargo customer must provide cargoInformation element. Parcel customer must provide parcelsInformation element</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-004</code>
      <message>This customer number cannot be used to order Pickup</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-005</code>
      <message>You must specify pickupIsReadyAtTime element HH:mm:ss</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-006</code>
      <message>You must specify pickupDate element yyyy-MM-dd</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-007</code>
      <message>Pickup date must be in the future</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-008</code>
      <message>weightInGrams is required, and must be an integer larger than zero</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-009</code>
      <message>Must be an integer larger than zero</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-010</code>
      <message>Country code is required</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-011</code>
      <message>Both Pickup Point ID and Country Code is Required</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-012</code>
      <message>Selected pickup point should be in recipient country</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>PICKUP-INPUT-013</code>
      <message>Combination pickupIsReadyAtTime and pickupDate must be in the future</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>NETS_TRANSACTION_INPUT-001</code>
      <message>Missing Nets transaction request</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>NETS_TRANSACTION_INPUT-002</code>
      <message>Missing Nets transaction id</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>NETS_TRANSACTION_INPUT-003</code>
      <message>Missing Bring consignment number</message>
      <suffixable>false</suffixable>
    </errorType>
    <errorType>
      <code>NETS_TRANSACTION_INPUT-004</code>
      <message>Missing customer number</message>
      <suffixable>false</suffixable>
    </errorType>
  </errorTypes>
</errorTypeList>

Order pickups

The Pickup Order Api is for ordering a single pickup at a particular address.

Parcels Norway, Parcels Sweden, Parcels Denmark and Cargo Customers with a Mybring user ID can use this service. Customer numbers in this API is the same as to booking API, obtained either through your Mybring profile or the customer number API.

Pickup in the different countries requires different customer numbers:

Customer number prefix Pickup in country Required information element
PARCELS_NORWAY Norway (parcels) parcelsInformation
CARGO Norway (cargo) cargoInformation
PARCELS_NORWAY_INTERNATIONAL, PARCELS_SWEDEN, PARCELS_DENMARK, PARCELS_FINLAND Sweden, Denmark parcelsInternationalInformation

Pickup ordered by default with product CARGO_GROUPAGE from Bring Cargo

A pickup order is necessary to get the goods collected for transportation by Bring Cargo but you don’t have to worry about it when ordering with the API .

A pickup will be automatically ordered together with the shipment when ordering a CARGO_GROUPAGE shipment.

If you order many shipments the pickups will be aggregated by Bring Cargo to one pickup by place and date.

URL

https://api.bring.com/booking/api/pickupOrder

Request body

{
    "customerInformation": {
        "customerNumber": "PARCELS_NORWAY-12340056789",
        "companyName": "Norsk Bedrift AS"
    },
    "pickupAddress": {
        "street": "Testsvingen 12",
        "postalCode": "0263",
        "city": "OSLO",
        "email": "norsk.bedrift@example.com",
        "phoneNumber": "99999999",
        "message": "Hentes på baksiden"
    },
    "pickupDate": "2015-12-03",
    "pickupIsReadyAtTime": null,
    "countryCode": "NO",
    "parcelsInformation": {
        "numberOfPackages": 2,
        "numberOfPostContainers": 0,
        "numberOfPallets": 1
    },
    "cargoInformation": null,
    "parcelsInternationalInformation": null,
    "testIndicator": true
}
<pickupOrderRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
    <customerInformation>
        <customerNumber>
            PARCELS_NORWAY-12340056789
        </customerNumber>
        <companyName>
            Norsk Bedrift AS
        </companyName>
    </customerInformation>
    <pickupAddress>
        <street>
            Testsvingen 12
        </street>
        <postalCode>
            0263
        </postalCode>
        <email>
            norsk.bedrift@example.com
        </email>
        <phoneNumber>
            99999999
        </phoneNumber>
        <city>
            OSLO
        </city>
        <messageToDriver>
            Hentes på baksiden
        </messageToDriver>
    </pickupAddress>
    <pickupDate>
        2015-12-04
    </pickupDate>
    <parcelsInformation>
        <numberOfPackages>
            2
        </numberOfPackages>
        <numberOfPostContainers>
            0
        </numberOfPostContainers>
        <numberOfPallets>
            1
        </numberOfPallets>
    </parcelsInformation>
    <countryCode>
        NO
    </countryCode>
</pickupOrderRequest>

Response

Successful pickup order (200)

{
    "pickupConfirmation": {
        "status": "OK",
        "earliestPickupDate": 1449097200000,
        "latestPickupDate": 1449183600000
    },
    "errors": null
}
<pickupOrderResponse xmlns="http://www.bring.no/booking/">
    <pickupConfirmation>
        <status>
            OK
        </status>
        <earliestPickupDate>
            2015-12-04T00:00:00+01:00
        </earliestPickupDate>
        <latestPickupDate>
            2015-12-05T00:00:00+01:00
        </latestPickupDate>
    </pickupConfirmation>
</pickupOrderResponse>

More examples

  • Parcels Sweden request
    {
        "customerInformation": {
            "customerNumber": "PARCELS_SWEDEN-12340056789",
            "companyName": "Svensk Bedrift AS"
        },
        "pickupAddress": {
            "street": "Testsvingen 12",
            "postalCode": "11234",
            "city": "Stockholm",
            "email": "svensk.bedrift@example.com",
            "phoneNumber": "99999999",
            "message": "Hentes på baksiden"
        },
        "pickupDate": "2015-12-03",
        "pickupIsReadyAtTime": null,
        "countryCode": "SV",
        "parcelsInformation": null,
        "cargoInformation": null,
        "parcelsInternationalInformation": {
            "numberOfPackages": 2,
            "numberOfPallets": 1,
            "weightInGrams": 2
        },
        "testIndicator": true
    }
    
    <pickupOrderRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <customerInformation>
            <customerNumber>
                PARCELS_SWEDEN-12340056789
            </customerNumber>
            <companyName>
                Svensk Bedrift AS
            </companyName>
        </customerInformation>
        <pickupAddress>
            <street>
                Testsvingen 12
            </street>
            <postalCode>
                11234
            </postalCode>
            <email>
                svensk.bedrift@example.com
            </email>
            <phoneNumber>
                99999999
            </phoneNumber>
            <city>
                Stockholm
            </city>
            <messageToDriver>
                Hentes på baksiden
            </messageToDriver>
        </pickupAddress>
        <pickupDate>
            2015-12-04
        </pickupDate>
        <countryCode>
            SV
        </countryCode>
        <parcelsInternationalInformation>
            <numberOfPackages>
                2
            </numberOfPackages>
            <numberOfPallets>
                1
            </numberOfPallets>
            <weightInGrams>
                2
            </weightInGrams>
        </parcelsInternationalInformation>
    </pickupOrderRequest>
    
  • Cargo request
    {
        "customerInformation": {
            "customerNumber": "CARGO-123456",
            "companyName": "Norsk Bedrift AS"
        },
        "pickupAddress": {
            "street": "Testsvingen 12",
            "postalCode": "0263",
            "city": "OSLO",
            "email": "norsk.bedrift@example.com",
            "phoneNumber": "99999999",
            "message": "Hentes på baksiden"
        },
        "pickupDate": "2015-12-03",
        "pickupIsReadyAtTime": "14:26",
        "countryCode": "NO",
        "parcelsInformation": null,
        "cargoInformation": {
            "numberOfPackages": 1,
            "weightInGrams": 70000,
            "volumeInDm3": 40
        },
        "parcelsInternationalInformation": null,
        "testIndicator": true
    }
    
    <pickupOrderRequest xmlns="http://www.bring.no/booking/" testIndicator="true">
        <customerInformation>
            <customerNumber>
                CARGO-123456
            </customerNumber>
            <companyName>
                Norsk Bedrift AS
            </companyName>
        </customerInformation>
        <pickupAddress>
            <street>
                Testsvingen 12
            </street>
            <postalCode>
                0263
            </postalCode>
            <email>
                norsk.bedrift@example.com
            </email>
            <phoneNumber>
                99999999
            </phoneNumber>
            <city>
                OSLO
            </city>
            <messageToDriver>
                Hentes på baksiden
            </messageToDriver>
        </pickupAddress>
        <pickupDate>
            2015-12-04
        </pickupDate>
        <pickupIsReadyAtTime>
            12:28
        </pickupIsReadyAtTime>
        <countryCode>
            NO
        </countryCode>
        <cargoInformation>
            <numberOfPackages>
                1
            </numberOfPackages>
            <weightInGrams>
                70000
            </weightInGrams>
            <volumeInDm3>
                40
            </volumeInDm3>
        </cargoInformation>
    </pickupOrderRequest>
    

SOAP

The SOAP Body follows the same XML Schema Definition (XSD) as the XML API.

The SOAP endpoint has the same operations as the endpoints listed above:

  • list customers
  • book shipments
  • order pikcups

WSDL

https://api.bring.com/booking/api/ws/booking-v1.wsdl

XSD

https://api.bring.com/booking/api/schema/booking-v1.xsd

URL

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