Skip to main content
developer

Shipping Guide API

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

Overview of endpoints

Base URL

https://api.bring.com/shippingguide
Method Endpoint Usage
POST /v2/products Get shipment prices and leadtime
GET /v2/products Get shipment prices and leadtime
GET /v2/products/price Use this endpoint to get price. The request parameters are the same as for [Get shipment prices and estimated delivery](/api/shipping-guide_v2/#get-shipment-prices-and-estimated-delivery)
GET /v2/products/expectedDelivery Get estimated delivery time
POST /api/ws Use this endpoint to get same information as above REST API

Get shipment prices and estimated delivery

Use this endpoint to get expected delivery, service categories and additional information.

Measurements

For cargo services(5100, 5300, 9100, CARGO), Weight is mandatory and one of the Volume / Load Meter / Dimensions / Number of Pallets is mandatory.

Note: The prices for our revised services depends on volumetric weight: 5000, 5100, 5300, 5600, 5800, 4850 plus return services 9000, 9100, 9300 or 9600. For these services, dimensions (L/W/H) is needed to calculate the expected price correctly. Dimensions are also used to decide if handling fee or specialgoods fee will apply to the shipment. You might leave dimensions empty in your request, but be aware that returned prices might be incorrect.

REST POST vs GET

There is both a POST and a GET endpoint for REST. We recommend using the POST endpoint over the GET one, as this is more likely to get all new features.

URL

                          POST
                          https://api.bring.com/shippingguide/v2/products
                        

Request parameters

HTTP header Type Description
Content-Type string Required application/json
X-MyBring-API-Key string Required Your user’s API key
X-MyBring-API-Uid string Required Your Mybring login ID

Request body

{
  "consignments": [
    {
      "id": 1,
      "products": [
        {
          "id": "5000",
          "customerNumber": "XXXXXXXXX"
        }
      ],
      "packages": [
        {
          "length": 21,
          "width": 12,
          "height": 12,
          "grossWeight": 1000,
          "volumeInDm3": 1,
          "id": 1
        }
      ],
      "fromCountryCode": "NO",
      "fromPostalCode": "0120",
      "toCountryCode": "NO",
      "toPostalCode": "2003",
      "additionalServices": [
        "SIMPLE_DELiVERY"
      ],
      "shippingDate": {
        "year": "2021",
        "month": "01",
        "day": "13",
        "hour": "06",
        "minute": "54"
      }
    }
  ],
  "withPrice": true,
  "withExpectedDelivery": true,
  "withGuiInformation": false,
  "edi": true,
  "trace": true
}

Responses

HTTP status code 200

{
  "traceMessages": [],
  "consignments": [
    {
      "products": [
        {
          "id": "5000",
          "customerNumber": "XXXXXXXXX",
          "productionCode": "5000",
          "price": {
            "listPrice": {
              "priceWithoutAdditionalServices": {
                "amountWithoutVAT": "145.75",
                "vat": "36.44",
                "amountWithVAT": "182.19"
              },
              "priceWithAdditionalServices": {
                "amountWithoutVAT": "145.75",
                "vat": "36.44",
                "amountWithVAT": "182.19"
              },
              "currencyCode": "NOK"
            },
            "netPrice": {
              "priceWithoutAdditionalServices": {
                "amountWithoutVAT": "145.75",
                "vat": "36.44",
                "amountWithVAT": "182.19"
              },
              "priceWithAdditionalServices": {
                "amountWithoutVAT": "145.75",
                "vat": "36.44",
                "amountWithVAT": "182.19"
              },
              "currencyCode": "NOK"
            }
          },
          "expectedDelivery": {
            "workingDays": "1",
            "userMessage": "",
            "formattedExpectedDeliveryDate": "14.01.2021",
            "expectedDeliveryDate": {
              "year": "2021",
              "month": "1",
              "day": "14"
            },
            "alternativeDeliveryDates": []
          }
        }
      ]
    }
  ],
  "uniqueId": "cedb345a-759a-4892-9ee8-3672f5a5ebf5"
}

URL

                          GET
                          https://api.bring.com/shippingguide/v2/products
                        

Request parameters

HTTP header Type Description
Accept string Required Specify request format (application/json, application/xml)
X-MyBring-API-Key string Required Your user’s API key
X-MyBring-API-Uid string Required Your Mybring login ID
Query param Type Description
additionalservice string Optional Additional service. Multiple value added services can be requested by repeating this parameter
addressline string Optional Specify address. This parameter can be maximum 35 character long. It will be for Bedriftspakke and På døren only.
Example: Testsvingen 12
customernumber string Optional Lets you specify which customer number to use in the request. If specified and service is not supplied with delimited customer number, then it will be applied on all request services. Required if estimateddeliverytime is set to true.
Example: CARGO-123456
date string Optional Shipping date
Example: 2018-11-18
edi boolean Optional Tells if the parcel will be registered using EDI when being booked. It may affect price and which services are available
Default value: true
estimateddeliverytime boolean Optional True if you want estimated delivery time of input pickup points. Eligible services are 5800 and SERVICEPAKKE.
fromcountry string Required Sender country code in valid ISO Alpha-2 format.
Example: NO
frompostalcode string Required Sender country code in valid ISO Alpha-2 format.
Example: NO
height integer Optional Package height in cm
incoterms string Optional Terms of delivery
language string Optional Language used for the service texts
Default value: no
length integer Optional Package length in cm
loadingmeter double Optional Package loading meters
nonstackable boolean Optional Set to true if you know that pallet would be non-stackable
nonstandardcourierservice string Required Specify service code for customize courier services in the request. It will be for NonStandard Courier only.
Example: CDA
numberofdeliverydates integer Optional Number of alternative delivery dates to be suggested by API for request
numberofpallets integer Optional Number of pallets.
payer string Optional Payer type. Possible values are SENDER, RECEIVER or THIRD_PARTY
pickuppoints string Optional If pickup points are specified then estimated delivery time will be added in the response for them, when estimateddeliverytime' flag is True. If it is not specified, then default pickup point(s) for receiver’s postal code will be used. Eligible services are 5800 and SERVICEPAKKE. However we recommend to always specify pickup points for optimum results.
Example: 171102,124518
postingatpostoffice boolean Optional Tells whether the parcel is delivered at a post office when it is shipped. A surcharge will be applied for SERVICEPAKKE and BPAKKE_DOR-DOR
product string Required List of services requested. Multiple services can be requested in a single request. Requested service can also be specified with a customer number separated with : (colon) as delimiter. For example CARGO:CARGO-123456
time string Optional Shipping time
Example: 12:30
tocountry string Required Receiver country code in valid ISO Alpha-2 format.
Example: NO
topostalcode string Required Receiver country code in valid ISO Alpha-2 format.
Example: NO
uniqueAlternateDeliveryDates boolean Optional True if you want unique expected delivery dates when requested with numberofdeliverydates.
unnumber integer Optional Code for dangerous goods
volumeSpecial boolean Optional True if the package has a shape that requires special handling
volumeindm3 integer Optional Package volume in dm3
weight integer Optional Package weight in grams
width integer Optional Package width in cm

Responses

HTTP status code 200

Example Request
https://api.bring.com/shippingguide/v2/products?fromcountry=NO&tocountry=NO&customernumber=PARCELS_NORWAY-1234567890&frompostalcode=0165&topostalcode=1234&product=5000&product=5800:PARCELS_NORWAY-1234567990&weight=200
A successful response

HTTP status code 400

This can mean that a required field or parameter has not been provided, the value supplied is invalid, or the combination of provided fields is invalid.

HTTP status code 401

A failed response when the request is unauthenticated

Get shipment prices

Use this endpoint to get prices. The request parameters are the same as for Get shipment prices and estimated delivery

URL

                          GET
                          https://api.bring.com/shippingguide/v2/products/price
                        

Get expected delivery times

Use this endpoint to get expected delivery. The request parameters are the same as for Get shipment prices and estimated delivery

URL

                          GET
                          https://api.bring.com/shippingguide/v2/products/expectedDelivery
                        

SOAP

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

Estimated delivery times

To get estimated delivery times in the response, set WithExpectedDelivery and WithEstimatedDeliveryTime to true in the request along with specifying PickupPoints

Request and response structure

If you request shipping alternatives via the API your request and response will have to comply with the following schemas:

https://api.bring.com/shippingguide/api/ws/shipping-guide-20.xsd

https://api.bring.com/shippingguide/api/ws/shippingguide-20.wsdl

URL

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

Request parameters

HTTP header Type Description
Accept string Required Specify request format (application/xml)
X-MyBring-API-Key string Required Your user’s API key
X-MyBring-API-Uid string Required Your Mybring login ID

Request body

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.bring.no/logistics/shippingguide/2.0">
<soapenv:Header/>
<soapenv:Body>
  <ns:ShippingGuideRequest>
    <ns:Language>en</ns:Language>
    <ns:WithPrice>true</ns:WithPrice>
    <ns:WithExpectedDelivery>true</ns:WithExpectedDelivery>
    <ns:WithGuiInformation>true</ns:WithGuiInformation>
    <ns:NumberOfAlternativeDeliveryDates>0</ns:NumberOfAlternativeDeliveryDates>
    <ns:EDI>true</ns:EDI>
    <ns:Trace>true</ns:Trace>
    <ns:PostingAtPostoffice>true</ns:PostingAtPostoffice>
    <ns:WithEstimatedDeliveryTime>true</ns:WithEstimatedDeliveryTime>
    <ns:Consignments>
      <ns:Consignment id="101">
        <ns:Products>
          <ns:Product>
            <ns:Id>SERVICEPAKKE</ns:Id>
            <ns:CustomerNumber>PARCELS_NORWAY-00000000001</ns:CustomerNumber>
          </ns:Product>
        </ns:Products>
        <ns:FromCountryCode>NO</ns:FromCountryCode>
        <ns:FromPostalCode>0150</ns:FromPostalCode>
        <ns:ToCountryCode>NO</ns:ToCountryCode>
        <ns:ToPostalCode>0550</ns:ToPostalCode>
        <ns:ShippingDate>
          <ns:Year>2020</ns:Year>
          <ns:Month>09</ns:Month>
          <ns:Day>10</ns:Day>
          <ns:Hour>15</ns:Hour>
          <ns:Minute>00</ns:Minute>
        </ns:ShippingDate>
        <ns:Packages>
          <ns:Package id="10">
            <ns:Height>10</ns:Height>
            <ns:Width>10</ns:Width>
            <ns:Length>10</ns:Length>
            <ns:GrossWeight>50</ns:GrossWeight>
          </ns:Package>
        </ns:Packages>
        <ns:AdditionalServices>
          <ns:AdditionalService>
            <ns:Id>EVARSLING</ns:Id>
          </ns:AdditionalService>
        </ns:AdditionalServices>
        <ns:PickupPoints>
          <ns:PickupPoint>
            <ns:Id>124518</ns:Id>
          </ns:PickupPoint>
        </ns:PickupPoints>
      </ns:Consignment>
    </ns:Consignments>
  </ns:ShippingGuideRequest>
</soapenv:Body>
</soapenv:Envelope>

Responses

HTTP status code 200

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <ns2:ShippingGuideResponse xmlns:ns2="http://www.bring.no/logistics/shippingguide/2.0" uniqueId="a13c3fce-80a6-4e77-9497-0ca880deb93d">
      <ns2:TraceMessages/>
      <ns2:Consignments>
        <ns2:Consignment consignmentId="101">
          <ns2:Products>
            <ns2:Product>
              <ns2:Id>SERVICEPAKKE</ns2:Id>
              <ns2:CustomerNumber>PARCELS_NORWAY-00000000001</ns2:CustomerNumber>
              <ns2:ProductionCode>1202</ns2:ProductionCode>
              <ns2:GuiInformation>
                <ns2:SortOrder>11</ns2:SortOrder>
                <ns2:MainDisplayCategory>Parcels</ns2:MainDisplayCategory>
                <ns2:SubDisplayCategory>To private customers</ns2:SubDisplayCategory>
                <ns2:DisplayName>Climate-neutral Service Parcel</ns2:DisplayName>
                <ns2:ProductName>Climate-neutral Service Parcel</ns2:ProductName>
                <ns2:DescriptionText>The parcel can be tracked and is delivered to your local pickup point.</ns2:DescriptionText>
                <ns2:HelpText>Climate-neutral Service Parcel is delivered to the recipient's local pickup point (post office or post-in-shop). The recipient can choose to collect the shipment at a different pickup point than the local. The recipient is notified that the shipment has arrived via SMS, e-mail or letter notification in the mailbox. The shipment can be tracked by its tracking number.</ns2:HelpText>
                <ns2:ShortName>Climate-neutral Service Parcel</ns2:ShortName>
                <ns2:ProductURL>http://www.bring.no/english/sending/parcels/private-in-norway/to-be-collected-at-the-post-office</ns2:ProductURL>
                <ns2:DeliveryType>Pickup point</ns2:DeliveryType>
                <ns2:MaxWeightInKgs>35</ns2:MaxWeightInKgs>
              </ns2:GuiInformation>
              <ns2:Price>
                <ns2:ListPrice currencyCode="NOK">
                  <ns2:PriceWithoutAdditionalServices>
                    <ns2:AmountWithoutVAT>224.69</ns2:AmountWithoutVAT>
                    <ns2:VAT>56.17</ns2:VAT>
                    <ns2:AmountWithVAT>280.86</ns2:AmountWithVAT>
                  </ns2:PriceWithoutAdditionalServices>
                  <ns2:PriceWithAdditionalServices>
                    <ns2:AmountWithoutVAT>224.69</ns2:AmountWithoutVAT>
                    <ns2:VAT>56.17</ns2:VAT>
                    <ns2:AmountWithVAT>280.86</ns2:AmountWithVAT>
                  </ns2:PriceWithAdditionalServices>
                  <ns2:AdditionalServicePrices>
                    <ns2:AdditionalService>
                      <ns2:AdditionalServiceId>EVARSLING</ns2:AdditionalServiceId>
                      <ns2:AdditionalServiceDescription/>
                      <ns2:AdditionalServicePrice>
                        <ns2:AmountWithoutVAT>0.00</ns2:AmountWithoutVAT>
                        <ns2:VAT>0.00</ns2:VAT>
                        <ns2:AmountWithVAT>0.00</ns2:AmountWithVAT>
                      </ns2:AdditionalServicePrice>
                      <ns2:AdditionalServiceCodeFromProductionSystem>1091</ns2:AdditionalServiceCodeFromProductionSystem>
                    </ns2:AdditionalService>
                  </ns2:AdditionalServicePrices>
                </ns2:ListPrice>
                <ns2:NetPrice currencyCode="NOK">
                  <ns2:PriceWithoutAdditionalServices>
                    <ns2:AmountWithoutVAT>224.69</ns2:AmountWithoutVAT>
                    <ns2:VAT>56.17</ns2:VAT>
                    <ns2:AmountWithVAT>280.86</ns2:AmountWithVAT>
                  </ns2:PriceWithoutAdditionalServices>
                  <ns2:PriceWithAdditionalServices>
                    <ns2:AmountWithoutVAT>224.69</ns2:AmountWithoutVAT>
                    <ns2:VAT>56.17</ns2:VAT>
                    <ns2:AmountWithVAT>280.86</ns2:AmountWithVAT>
                  </ns2:PriceWithAdditionalServices>
                  <ns2:AdditionalServicePrices>
                    <ns2:AdditionalService>
                      <ns2:AdditionalServiceId>EVARSLING</ns2:AdditionalServiceId>
                      <ns2:AdditionalServiceDescription/>
                      <ns2:AdditionalServicePrice>
                        <ns2:AmountWithoutVAT>0.00</ns2:AmountWithoutVAT>
                        <ns2:VAT>0.00</ns2:VAT>
                        <ns2:AmountWithVAT>0.00</ns2:AmountWithVAT>
                      </ns2:AdditionalServicePrice>
                      <ns2:AdditionalServiceCodeFromProductionSystem>1091</ns2:AdditionalServiceCodeFromProductionSystem>
                    </ns2:AdditionalService>
                  </ns2:AdditionalServicePrices>
                </ns2:NetPrice>
              </ns2:Price>
              <ns2:ExpectedDelivery>
                <ns2:WorkingDays>1</ns2:WorkingDays>
                <ns2:UserMessage/>
                <ns2:FormattedExpectedDeliveryDate>11.09.2020</ns2:FormattedExpectedDeliveryDate>
                <ns2:ExpectedDeliveryDate>
                  <ns2:Year>2020</ns2:Year>
                  <ns2:Month>9</ns2:Month>
                  <ns2:Day>11</ns2:Day>
                </ns2:ExpectedDeliveryDate>
                <ns2:AlternativeDeliveryDates/>
              </ns2:ExpectedDelivery>
              <ns2:EstimatedDeliveryTimes>
                <ns2:EstimatedDeliveryTime>
                  <ns2:PickupPointId>124518</ns2:PickupPointId>
                  <ns2:DeliveryStartTime>10:00</ns2:DeliveryStartTime>
                  <ns2:DeliveryEndTime>13:00</ns2:DeliveryEndTime>
                  <ns2:FormattedExpectedDeliveryDate>11.09.2020</ns2:FormattedExpectedDeliveryDate>
                </ns2:EstimatedDeliveryTime>
              </ns2:EstimatedDeliveryTimes>
            </ns2:Product>
          </ns2:Products>
        </ns2:Consignment>
      </ns2:Consignments>
    </ns2:ShippingGuideResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>