Skip to main content

Shipment API

Introduction

The Shipment API is a logged-in service that lets Mybring users (customers of Mybring) programatically create a instruction or a booking by invoking a Web Service by posting XML/JSON over HTTP.

The Shipment API uses Shipping Guide as the source for price and availability (when supported in the Shipping Guide) for the different products. We advise clients of the Shipment 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 Shipment 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.

We are continually rolling out support for more of Posten / Brings products and aim to support all available products in this API within a short time. In addition to the documentation on this pages feel free to check out our swagger page for this API.

This API has similarities with the Booking API, but there are differences. Read more about the differences between the Booking API and the Shipment API.

Authentication

To make API requests, you will need an API key from Mybring. Steps for getting a key and description of headers can be found on the general API Getting Started / Authentication page.

ShipmentAPI Instructions

A submission to ShipmentAPI must have a ShipmentType of one of the following

HealthCheck

This is simply to check if the service is available.

Unit Codes

A number of different unit codes are used throughout ShipmentAPI. Many of which are listed in the layouts below but the definative list is displayed here for ease of reference.

Cash On Delivery Account Type

  • Bank
  • Bankgiro
  • Plus
  • Post
  • Iban
  • Other

Cash On Delivery Transaction Identifier Type

  • PQ
  • SS

Cash On Delivery Type

  • CashOnDelivery
  • PrePaid
  • CreditCard

Length Unit Code

  • CMT
  • DMT
  • MTR

Party Role

  • DespatchParty
  • DeliveryParty
  • OrderingParty
  • FreightPayer
  • CashOnDeliveryPayee
  • GoodsReturnParty
  • NotifyParty
  • TransportCompany

Temperature Measure Unit Code

  • CEL
  • FAH

Volume Unit Code

  • DMQ
  • MTQ

Weight Unit Code

  • GRM
  • KGM

Dangerous Goods Flashpoint Unit Code

  • CEL
  • FAH

Dangerous Goods Restriction Type

  • Tunnel

Date And Times

  • DocumentDate
  • PickupRequested
  • PickupEarliest
  • PickupLatest
  • DeliveryRequested
  • DeliveryEarliest
  • DeliveryLatest

Delivery Terms Type

  • Incoterms
  • Freightterms
  • Combiterms
  • PrePaid
  • ThirdParty

Exchangeable Equipment Unit Type

  • EFP

Free Text Usage

  • PICKUP_INSTRUCTIONS
  • DELIVERY_INSTRUCTIONS
  • CARRIER_INSTRUCTIONS

Reference Type

  • DESPATCH_ADVICE_NUMBER
  • TRANSPORT_DOCUMENT_NUMBER
  • CUSTOMS_DECLARATION_NUMBER
  • ACCOUNT_NUMBER
  • PROJECT_NUMBER
  • SECONDARY_CUSTOMS_REFERENCE
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER
  • SENDERS_REFERENCE
  • AIR_WAYBILL
  • BILL_OF_LADIN
  • BOOKING_REFERENC
  • ROAD_CONSIGNMENT_NOTE
  • SHIPMENT_REFERENCE
  • TRANSPORT_INSTRUCTION
  • GOODS_NUMBE
  • MESSAGE_SENDERS_IDENTITY

Shipment Type

  • Instruction
  • Booking
  • Healthcheck

Tariff Reference

  • COOL_ABERRANT
  • GENERAL_CARGO
  • MINERAL_WATERCHILLED_0_4
  • TIRES
  • COOL_5_8
  • FISH_0_4
  • FROZEN_CARGO
  • FROST_FREE_CARGO
  • EARLY_DELIVERY
  • LATE_DELIVERY
  • SPECIAL_CARGO
  • COOL_0_2

Tariff Reference Values

  • CHLR
  • GNCG
  • BWRG
  • CHLL
  • DEKK
  • COOL
  • FISH
  • FRZE
  • WARM
  • GCED
  • GCLD
  • SPCL
  • CH02

Transport Company

  • BCI
  • BCN
  • BCS
  • BDD
  • BDF
  • BDS
  • BEF
  • BEX
  • BFN
  • BFS
  • BID
  • BPI
  • BPN
  • TIE
  • NPB

Express Sub Transport Company

  • ALY
  • QUI
  • GLW

Cargo Sub Transport Company

  • OXP

Valid Transport Companies

  • BEX
  • BCI
  • BCN

Valid Sub Transport Companies

  • ALY
  • GLW
  • OXP

Update Indicator

  • Original
  • Update
  • Replace
  • Delete

Overview of endpoints

Base URL

https://bapi.bring.com/shipment
Method Endpoint Usage
POST /sendshipment?shipmentId={createShipmentId}&packageIds={createPackageId} Request is used to either create, update or delete an instruction for Bring.
POST /sendbooking?shipmentId={createShipmentId}&packageIds={createPackageId} Request is used to either create, update or delete an instruction for Bring.

Create shipment

Sends a shipment consisting of one consignment, that must include at least one package, from one sender to one receiver.

The ShipmentType must be “Instruction” and must include a Shipment Header.

A Senders reference must be included and must have a value.

The LM Service Codes, in the Shipping Guide, must consist of valid codes (see Unit Codes below).

A valid combination of an additional party, with party type TransportCompany and a valid Transport company code as the partyId value and an optional subPartyId and service, is required. In addition there might be several value added services that can be added. Please refer to valid product codes/services and VASes.

If an included product requires an additional service, that additional service must be included.

Value Added Service Codes may only feature once in any Shipment.

The following Additional Services must be accompanied by the following additions

  • 1000 - must include a Cash on Delivery entry
  • 1036 - must include a SubClass of DeliveryParty entry
  • 1134 - Receiver.ContactName must have a value
  • 1142 - Receiver.ContactName and Receiver.MobilePhone must both have a value
  • 1150 - Receiver.Email must have a value
  • 1245 - must include a DangerousGoods entry

Conversely
When Cash on Delivery is specified, it must be a valid CashOnDelivery and an AdditionalService with value 1000 must be included
When a Goods Item is specified, it must be valid GoodsItem
When a DangerousGoods is specified, AdditionalService must be 1245
The ProductAndService specified must have a valid TariffReference
The Sender specified must be a valid GeneralParty
The Receiver specified, must be a valid GeneralParty
When an AdditionalParty is specified, it must be a valid AdditionalParty and must include a subClass of TransportCompany

If requested through the query parameters, the service will create a shipment ID (for the whole shipment) in addition to package IDs for each package. The package IDs will be returned in the order of the packages (i.e. package 1 in the input will have package ID 1 in returned array).

The structure and most of the content will be validated.

URL

                          POST
                          https://bapi.bring.com/shipment/sendshipment?shipmentId={createShipmentId}&packageIds={createPackageId}

Request parameters

URI param Type Description
createPackageId boolean Required If “true” the API will assign all package IDs for you and return them in the response.
createShipmentId boolean Required If “true” the API will assign a shipment ID for you and return it in the response.
HTTP header Type Description
Accept string Required Specify response format (application/json, application/xml)
Possible values:
  • application/json
  • application/xml
Content-Type string Required Specify request format (application/json, application/xml)
Possible values:
  • application/json
  • application/xml

Request body

Media type: application/json

CreateShipmentRequest
Field Type Description
RequestDate datetime RequiredDate and time for when the request was created
Example: 2018-11-22T08:58:52
RequestVersion number RequiredRequest version to use
Example: 1
Shipment object RequiredStructure for the shipment
Shipment
Field Type Description
AdditionalParty array RequiredAdditionalparties for the shipment, repeatable. Refer to detailed instructions
CashOnDelivery object OptionalCash on delivery for the shipment
DateAndTimes array RequiredDate and times for the message, repeatable structure. Several dates are required
DeliveryTerms object OptionalTerms of delivery
GoodsItem array RequiredInformation about the goods being shipped
ProductAndService object RequiredProduct and service codes in addition to value added service structures
Receiver object RequiredStructure to hold receiver information
Sender object RequiredStructure to hold sender information
ShipmentHeaders object RequiredStructure that handles information for the whole shipment
shipmentType string RequiredType of shipment
Possible values:
  • Instruction
  • Booking
  • Healthcheck

Example: Instruction
updateIndicator string RequiredIs this request an original, update or a deletion
Possible values:
  • Original
  • Update
  • Replace
  • Delete

Example: Original
ShipmentHeaders
Field Type Description
AdditionalReference array OptionalAdditional references for the shipment as indicated by referenceType
Dimensions object OptionalDimensions required for the whole shipment
ExchangableEquipment object OptionalEquipment that can be reused, ie. pallets
FreeText array OptionalFreetext elements
GrossVolume object OptionalGross volume for the whole shipment
GrossWeight object OptionalGross weight for the whole shipment
HazardPoints integer OptionalSum of hazard points for the shipment
Example: 22
LoadingMetres number OptionalHow many metres of loading space required of a truck’s length
Example: 12
NumberOfPackages string RequiredTotal number of packages for the whole shipment across all goodsitems.
Example: 3
PalletFootPrints integer OptionalHow many pallet footprints are needed for the shipment
Example: 3
ReceiversReference string OptionalReceivers reference for the shipment
Example: SOA-123222
SendersReference string RequiredSenders reference for the shipment
Example: SOA-123222
shipmentId string RequiredId for the whole shipment, can be retrieved by the API
Example: 70438101412575352
DateAndTimes
Field Type Description
DateTime datetime RequiredDate and Time
Example: 2018-11-22T08:58:52
subClass string RequiredType of datetime
Possible values:
  • DocumentDate
  • PickupRequested
  • PickupEarliest
  • PickupLatest
  • DeliveryRequested
  • DeliveryEarliest
  • DeliveryLatest

Example: DocumentDate
Sender
Field Type Description
Address object OptionalParty address
AddressLine array RequiredAddress lines. The first line will be mapped to primary address line
Example: Kong Oscars gate 12
CountryCode string RequiredCountry code. Use valid country codes
Example: NO
StateOrRegion string OptionalState or region, not in use in the nordic countries
Example: Washington DC
ContactName string OptionalContact name for the party
Example: Atle Thorstensen
Email string OptionalEmail
Example: mail@mail.com
Fax string OptionalFax
Example: +4712345678
MobilePhone string OptionalMobile phone
Example: +4712345678
Name string OptionalParty name
Example: Bring
Phone string OptionalPhone
Example: +4712345678
Reference array OptionalReference related to the party, can be used for account number of pallet system in Sweden for insatnce.
ReferenceValue string RequiredExtra Reference
Example: 4440/0189981/WEJ
referenceType string RequiredReferenceType
Possible values:
  • DESPATCH_ADVICE_NUMBER (AAK)
  • TRANSPORT_DOCUMENT_NUMBER (AAS)
  • CUSTOMS_DECLARATION_NUMBER (ABT)
  • ACCOUNT_NUMBER (ADE)
  • PROJECT_NUMBER (AEP)
  • SECONDARY_CUSTOMS_REFERENCE (AFM)
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER (AGM)
  • SENDERS_REFERENCE (AGO)
  • AIR_WAYBILL (AWB)
  • BILL_OF_LADING (BM)
  • BOOKING_REFERENCE (BN)
  • ROAD_CONSIGNMENT_NOTE (CMR)
  • SHIPMENT_REFERENCE (SRN)
  • TRANSPORT_INSTRUCTION (TIN)
  • GOODS_NUMBER (XC)
  • MESSAGE_SENDERS_IDENTITY (MS)

Example: TRANSPORT_DOCUMENT_NUMBER
partyId string OptionalIdentifier for the party
Example: BEX
subPartyId string OptionalFurther identification of the party
Example: GLW
Receiver
Field Type Description
Address object OptionalParty address
AddressLine array RequiredAddress lines. The first line will be mapped to primary address line
Example: Kong Oscars gate 12
CountryCode string RequiredCountry code. Use valid country codes
Example: NO
StateOrRegion string OptionalState or region, not in use in the nordic countries
Example: Washington DC
ContactName string OptionalContact name for the party
Example: Atle Thorstensen
Email string OptionalEmail
Example: mail@mail.com
Fax string OptionalFax
Example: +4712345678
MobilePhone string OptionalMobile phone
Example: +4712345678
Name string OptionalParty name
Example: Bring
Phone string OptionalPhone
Example: +4712345678
Reference array OptionalReference related to the party, can be used for account number of pallet system in Sweden for insatnce.
ReferenceValue string RequiredExtra Reference
Example: 4440/0189981/WEJ
referenceType string RequiredReferenceType
Possible values:
  • DESPATCH_ADVICE_NUMBER (AAK)
  • TRANSPORT_DOCUMENT_NUMBER (AAS)
  • CUSTOMS_DECLARATION_NUMBER (ABT)
  • ACCOUNT_NUMBER (ADE)
  • PROJECT_NUMBER (AEP)
  • SECONDARY_CUSTOMS_REFERENCE (AFM)
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER (AGM)
  • SENDERS_REFERENCE (AGO)
  • AIR_WAYBILL (AWB)
  • BILL_OF_LADING (BM)
  • BOOKING_REFERENCE (BN)
  • ROAD_CONSIGNMENT_NOTE (CMR)
  • SHIPMENT_REFERENCE (SRN)
  • TRANSPORT_INSTRUCTION (TIN)
  • GOODS_NUMBER (XC)
  • MESSAGE_SENDERS_IDENTITY (MS)

Example: TRANSPORT_DOCUMENT_NUMBER
partyId string OptionalIdentifier for the party
Example: BEX
subPartyId string OptionalFurther identification of the party
Example: GLW
AdditionalParty
Field Type Description
Address object OptionalParty address
AddressLine array RequiredAddress lines. The first line will be mapped to primary address line
Example: Kong Oscars gate 12
CountryCode string RequiredCountry code. Use valid country codes
Example: NO
StateOrRegion string OptionalState or region, not in use in the nordic countries
Example: Washington DC
ContactName string OptionalParty contact name
Example: Ola Nordmann
Email string OptionalEmail
Example: mail@mail.com
Fax string OptionalFax
Example: +4712345678
MobilePhone string OptionalMobile phone
Example: +4712345678
Name string OptionalParty name
Example: Rogers antistatiske overledninger
Phone string OptionalPhone
Example: +4712345678
Reference array OptionalFurther references related to the party
Example: SOA-121232332-AN
ReferenceValue string RequiredExtra Reference
Example: 4440/0189981/WEJ
referenceType string RequiredReferenceType
Possible values:
  • DESPATCH_ADVICE_NUMBER (AAK)
  • TRANSPORT_DOCUMENT_NUMBER (AAS)
  • CUSTOMS_DECLARATION_NUMBER (ABT)
  • ACCOUNT_NUMBER (ADE)
  • PROJECT_NUMBER (AEP)
  • SECONDARY_CUSTOMS_REFERENCE (AFM)
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER (AGM)
  • SENDERS_REFERENCE (AGO)
  • AIR_WAYBILL (AWB)
  • BILL_OF_LADING (BM)
  • BOOKING_REFERENCE (BN)
  • ROAD_CONSIGNMENT_NOTE (CMR)
  • SHIPMENT_REFERENCE (SRN)
  • TRANSPORT_INSTRUCTION (TIN)
  • GOODS_NUMBER (XC)
  • MESSAGE_SENDERS_IDENTITY (MS)

Example: TRANSPORT_DOCUMENT_NUMBER
partyId string RequiredIdentifier for the party
Example: BEX
subClass string RequiredType of Party
Possible values:
  • DespatchParty
  • DeliveryParty
  • OrderingParty
  • FreightPayer
  • CashOnDeliveryPayee
  • GoodsReturnParty
  • NotifyParty
  • TransportCompany

Example: DeliveryParty
subPartyId string OptionalFurther identification for the party
Example: GLW
ProductAndService
Field Type Description
AdditionalService array OptionalAdditional service codes
AdditionalServiceCode string RequiredThe additional service code for the product
Example: EVARSLING
ServiceRequirements array RequiredSome AdditionalServiceCodes / valueadded service might require extra information
NatureOfCargo string OptionalIndicates if the cargo is out of bound of general expected parameters, dangerous goods or out og gauge
Example: 11
ProductCode string RequiredProductcode for shipment, refer to documentation for valid productcodes for this service
Example: COURIER_1H
TariffReference string OptionalAdditional information about the price of the cargo in connection with the service
Possible values:
  • COOL_ABERRANT
  • GENERAL_CARGO
  • MINERAL_WATER
  • CHILLED_0_4
  • TIRES
  • COOL_5_8
  • FISH_0_4
  • FROZEN_CARGO
  • FROST_FREE_CARGO
  • EARLY_DELIVERY
  • LATE_DELIVERY
  • SPECIAL_CARGO
  • COOL_0_2

Example: GNCG
DeliveryTerms
Field Type Description
ConditionCode string RequiredThe actual terms for the chosen deliverytermstype
Example: EXW
Location object OptionalThe location where the given deliveryterms (condition) applies (to or from given conditioncode.)
City string RequiredCity where the deliveryterms are valid to or from
Example: Bergen
CountryCode string RequiredCountry where the deliveryterms ar valid to or from
Example: NO
termsType string RequiredTerms valid for this shipment
Possible values:
  • Incoterms
  • Freightterms
  • Combiterms
  • PrePaid
  • ThirdParty

Example: Incoterms
CashOnDelivery
Field Type Description
Amount object OptionalAmount expected on delivery
Example: 123450
currencyCode string RequiredCurrencycode, valid currency codes allowed
Example: NOK
ControlDigit integer OptionalControl digit for incoming amount when there is specified a KID number (Norwegian only)
Example: 8
DocumentId array OptionalDocumentIds for Cash on Delivery
Example: SA-46789
MonetaryAccount object OptionalDescription of where the money should be received
TransactionIdentifier object OptionalSenders identifier for the transaction
Value string RequiredThe value to identify where the money should be sent
Example: 1234.12.123456
accountType string RequiredTypeof account to receive payment
Possible values:
  • Bank
  • Bankgiro
  • Plus
  • Post
  • Iban
  • Other

Example: Bank
identifierType string RequiredType of cash on delivery
Possible values:
  • PQ
  • SS

Example: PQ
codType string RequiredType of cash on delivery
Possible values:
  • CashOnDelivery
  • PrePaid
  • CreditCard

Example: CashOnDelivery
GoodsItem
Field Type Description
CustomsDetails array OptionalList of Customs Details for goods being shipped
CountryOfOrigin string OptionalCountry of origin of the package
CustomsArticleNumber string OptionalCustoms Article Number of the package
GoodsDescription string OptionalGoods Description of the package
NetWeight number OptionalNet weight of the package
Quantity number OptionalQuantity of packages
TariffLineAmount object OptionalTariff Line Amount of the package
Value number OptionalValue of the tariff line
currencyCode string OptionalCurrency code of the tariff line
DangerousGoods array OptionalInformation about dangerousgoods being shipped
GoodsDescription string OptionalDescription of goods being shipped
Example: Contains socks
LoadCarrier string OptionalTransport equipment (pallet, container etc)
Example: EFP
Package array RequiredList of packages being shipped
email string RequiredRecipient’s email address.
phoneNumber string RequiredRecipient’s phone number, including country code.
Pattern: \+[0-9 ]+
Example: +4700000000
postalCode string RequiredA valid Norwegian postal code.
recipientName string RequiredRecipient name.
rfid boolean RequiredWhether to activate tracking with RFID for the package.
streetAddress string RequiredRecipient’s street address.
weight integer RequiredWeight in grams.
PackageTypeCode string RequiredTypes of cargo, packaging of cargo. Either use supported enumeration or UN/ECE Recommendation 21
PackingDetails array OptionalList of Package Details for goods being shipped
ArticleDescription string OptionalArtical description of Packing Details
ArticleNumber string OptionalArticla details of Packing Details
ArticlePrice object OptionalArtical Price of the Packing Details
Value number OptionalValue of packages
currencyCode string OptionalQuantity of packages
ItemBackOrder number OptionalItem Back Order within Packing Details
ItemDelivered number OptionalItem Delivered within Packing Details
ItemOrdered number OptionalItem Ordered within the Packing Details
ItemUnity string OptionalItem Unity within Packing Details
PositionNumber integer OptionalPosition number within Packing Details
SealId string OptionalItem sealed for customs etc, number of the seal
Example: 123456
Temperature object OptionalTemperature requirements for goods being shipped
Storage object RequiredTemperature requirements for storage of goods
Value integer RequiredSpecific temperature for transportation of the cargo
Example: 3
maximum string OptionalMaximum allowed temperature
Example: 4
minimum string OptionalMinimum allowed temperature
Example: -8
unitCode string RequiredUnit code for temperature measure
Possible values:
  • CEL
  • FAH

Example: CEL
Transport object RequiredTemperature requirements during transport
Value integer RequiredSpecific temperature for transportation of the cargo
Example: 3
maximum string OptionalMaximum allowed temperature
Example: 4
minimum string OptionalMinimum allowed temperature
Example: -8
unitCode string RequiredUnit code for temperature measure
Possible values:
  • CEL
  • FAH

Example: CEL
MonetaryAccount
Field Type Description
AccountHolderName string RequiredName of the owner of the account
Example: Ola Nordmann
AccountNumber object RequiredAccount number to receive payment
Value string RequiredActual account number
Example: 4567.45.12345
accountType string RequiredType of account to receive payment on delivery
Possible values:
  • Bank
  • Bankgiro
  • Plus
  • Post
  • Iban
  • Other
BankName string RequiredBank where account is created
Example: DNB
SwiftCode string RequiredSwift code for international transfers
Example: DNBANOKK
DangerousGoods
Field Type Description
AdditionalHazard string OptionalAdditional codes for hazard
Example: 2.3(8)
Flashpoint object RequiredFlashpointinformation for dangerousgoods (when will the item become volatile?)
Value integer OptionalValue when flashpoint occurs/ignites
Example: 18
unitCode string OptionalUnit code for flashpoint
Possible values:
  • CEL
  • FAH

Example: CEL
HazardClass string OptionalClassification of hazard
Example: 4.1
HazardPoints integer OptionalPoints for this hazard. Calculated from factor for dangerousgoods multiplied by amount in kg / dm3 for each material in cargo
Example: 10
Measures array OptionalMeasures for Dangerous Goods
Measure object OptionalMeasurements for goods
Value number OptionalMeasure value
Example: 1.22
unitCode string OptionalUnit code for measure
Example: DMQ
subClass string Optional
Example: NetHazardWeight
PackingGroup string OptionalPacking danger level code, roman numeral between 1 and 3
Example: II
Restrictions array OptionalRestrictions when carrying these hazardous goods
Value string OptionalFreetext specification of restriction for given tunnel. One element for each UN number in the dangerousgoods sequence
Example: Ellingsøy- og Valderøytunnelen på riksveg 658 utenfor Ålesund. Her gjelder tunnelkategori C i tidsrommet kl. 0600–2400 hver dag
restrictionType string OptionalType of restriction
Possible values:
  • Tunnel

Example: Tunnel
TechnicalName string OptionalTechnical name of hazard
Example: KALSIUMRESINAT, SINTRET
UNDGInformation object RequiredUnited nations dangerous goods information
FlashpointDescription string OptionalFlashpoint for dangerous goods
Example: BLACK POWDER, granulated or in powderform
HazardIdentifier string OptionalUnited nations dangerous goods hazard identifier
Example: 1.1D
regulatonCode string OptionalRegulation codes for the hazardous goods
Example: ADR		 
{
  "RequestVersion": "1",
  "RequestDate": "2022-04-20T10:55:07",
  "Shipment": {
    "updateIndicator": "Original",
    "shipmentType": "Instruction",
    "ShipmentHeaders": {
      "SendersReference": "1878959",
      "shipmentId": "70722150702977990",
      "NumberOfPackages": "1",
      "HazardPoints": "0",
      "GrossWeight": {
        "unitCode": "KGM",
        "Value": 1
      },
      "LoadingMetres": "0",
      "PalletFootPrints": "0"
    },
    "DateAndTimes":
    [{
      "subClass": "DocumentDate",
      "DateTime": "2022-04-20T10:55:07"
    }, {
      "subClass": "DeliveryEarliest",
      "DateTime": "2022-04-20T16:00:00"
    }, {
      "subClass": "DeliveryLatest",
      "DateTime": "2022-04-20T21:00:00"
    }, {
      "subClass": "PickupEarliest",
      "DateTime": "2022-04-20T14:00:00"
    }, {
      "subClass": "PickupLatest",
      "DateTime": "2022-04-20T18:00:00"
    }
    ],
    "Sender": {
      "partyId": "28371",
      "Name": "Mester Grønn Oasen Senter Bergen",
      "Address": {
        "AddressLine":
        [
          "Folke Bernadottes vei 52"
        ],
        "PostalCode": "5147",
        "City": "FYLLINGSDALEN",
        "CountryCode": "NO"
      },
      "Phone": "+4732229724"
    },
    "Receiver": {
      "Name": "Trine Elisabeth Rud Riera",
      "Address": {
        "AddressLine":
        [
          "Ture Nermans vei 107"
        ],
        "PostalCode": "5143",
        "City": "FYLLINGSDALEN",
        "CountryCode": "NO"
      },
      "MobilePhone": "98071041"
    },
    "AdditionalParty":
    [{
      "subClass": "GoodsReturnParty",
      "Name":"Ola Nordmann",
      "Address": {
        "PostalCode":"1065",
        "City":"OSLO",
        "CountryCode":"NO",
        "AddressLine":
        [{
          "Storgatan 1"
        }]
      },
      "MobilePhone":"4712345678",
      "Email":"ola.nordmann@someemail.com",
      "ContactName":"Ola Nordmann"
    }
    ],
    "AdditionalParty":
    [{
      "subClass": "TransportCompany",
      "partyId":"BEX",
      "subPartyId":"GLW"
    }
    ],
    "ProductAndService": {
      "ProductCode": "3270"
    },
    "GoodsItem":
    [{
      "PackageTypeCode":"PK",
      "GoodsDescription":"Kittens in a sack",
      "Package":
      [{
        "GrossWeight": {
          "unitCode": "KGM",
          "Value": 1
        },
        "packageId": "370722150758796447"
      }
      ]
    }
    ]
  }
}

Sample request to book a Bring Express Courier shipment.

{
  "RequestVersion": "1",
  "RequestDate": "2022-04-20T10:55:07",
  "Shipment": {
    "updateIndicator": "Original",
    "shipmentType": "Instruction",
    "ShipmentHeaders": {
      "SendersReference": "1878959",
      "shipmentId": "70722150702977990",
      "NumberOfPackages": "1",
      "HazardPoints": "0",
      "GrossWeight": {
        "unitCode": "KGM",
        "Value": 1
      },
      "LoadingMetres": "0",
      "PalletFootPrints": "0"
    },
    "DateAndTimes":
    [{
      "subClass": "DocumentDate",
      "DateTime": "2022-04-20T10:55:07"
    }, {
      "subClass": "DeliveryEarliest",
      "DateTime": "2022-04-20T16:00:00"
    }, {
      "subClass": "DeliveryLatest",
      "DateTime": "2022-04-20T21:00:00"
    }, {
      "subClass": "PickupEarliest",
      "DateTime": "2022-04-20T14:00:00"
    }, {
      "subClass": "PickupLatest",
      "DateTime": "2022-04-20T18:00:00"
    }
    ],
    "Sender": {
      "partyId": "28371",
      "Name": "Mester Grønn Oasen Senter Bergen",
      "Address": {
        "AddressLine":
        [
          "Folke Bernadottes vei 52"
        ],
        "PostalCode": "5147",
        "City": "FYLLINGSDALEN",
        "CountryCode": "NO"
      },
      "Phone": "+4732229724"
    },
    "Receiver": {
      "Name": "Trine Elisabeth Rud Riera",
      "Address": {
        "AddressLine":
        [
          "Ture Nermans vei 107"
        ],
        "PostalCode": "5143",
        "City": "FYLLINGSDALEN",
        "CountryCode": "NO"
      },
      "MobilePhone": "98071041"
    },
    "AdditionalParty":
    [{
      "subClass": "GoodsReturnParty",
      "Name":"Ola Nordmann",
      "Address": {
        "PostalCode":"1065",
        "City":"OSLO",
        "CountryCode":"NO",
        "AddressLine":
        [{
          "Storgatan 1"
        }]
      },
      "MobilePhone":"4712345678",
      "Email":"ola.nordmann@someemail.com",
      "ContactName":"Ola Nordmann"
    }
    ],
    "AdditionalParty":
    [{
      "subClass": "TransportCompany",
      "partyId":"BEX",
      "subPartyId":"GLW"
    }
    ],
    "ProductAndService": {
      "ProductCode": "3270"
    },
    "GoodsItem":
    [{
      "PackageTypeCode":"PK",
      "GoodsDescription":"Kittens in a sack",
      "Package":
      [{
        "GrossWeight": {
          "unitCode": "KGM",
          "Value": 1
        },
        "packageId": "370722150758796447"
      }
      ]
    }
    ]
  }
}

Media type: application/xml

CreateShipmentRequest
Field Type Description
RequestDate datetime RequiredDate and time for when the request was created
Example: 2018-11-22T08:58:52
RequestVersion number RequiredRequest version to use
Example: 1
Shipment object RequiredStructure for the shipment
Shipment
Field Type Description
AdditionalParty array RequiredAdditionalparties for the shipment, repeatable. Refer to detailed instructions
CashOnDelivery object OptionalCash on delivery for the shipment
DateAndTimes array RequiredDate and times for the message, repeatable structure. Several dates are required
DeliveryTerms object OptionalTerms of delivery
GoodsItem array RequiredInformation about the goods being shipped
ProductAndService object RequiredProduct and service codes in addition to value added service structures
Receiver object RequiredStructure to hold receiver information
Sender object RequiredStructure to hold sender information
ShipmentHeaders object RequiredStructure that handles information for the whole shipment
shipmentType string RequiredType of shipment
Possible values:
  • Instruction
  • Booking
  • Healthcheck

Example: Instruction
updateIndicator string RequiredIs this request an original, update or a deletion
Possible values:
  • Original
  • Update
  • Replace
  • Delete

Example: Original
ShipmentHeaders
Field Type Description
AdditionalReference array OptionalAdditional references for the shipment as indicated by referenceType
Dimensions object OptionalDimensions required for the whole shipment
ExchangableEquipment object OptionalEquipment that can be reused, ie. pallets
FreeText array OptionalFreetext elements
GrossVolume object OptionalGross volume for the whole shipment
GrossWeight object OptionalGross weight for the whole shipment
HazardPoints integer OptionalSum of hazard points for the shipment
Example: 22
LoadingMetres number OptionalHow many metres of loading space required of a truck’s length
Example: 12
NumberOfPackages string RequiredTotal number of packages for the whole shipment across all goodsitems.
Example: 3
PalletFootPrints integer OptionalHow many pallet footprints are needed for the shipment
Example: 3
ReceiversReference string OptionalReceivers reference for the shipment
Example: SOA-123222
SendersReference string RequiredSenders reference for the shipment
Example: SOA-123222
shipmentId string RequiredId for the whole shipment, can be retrieved by the API
Example: 70438101412575352
DateAndTimes
Field Type Description
DateTime datetime RequiredDate and Time
Example: 2018-11-22T08:58:52
subClass string RequiredType of datetime
Possible values:
  • DocumentDate
  • PickupRequested
  • PickupEarliest
  • PickupLatest
  • DeliveryRequested
  • DeliveryEarliest
  • DeliveryLatest

Example: DocumentDate
Sender
Field Type Description
Address object OptionalParty address
AddressLine array RequiredAddress lines. The first line will be mapped to primary address line
Example: Kong Oscars gate 12
CountryCode string RequiredCountry code. Use valid country codes
Example: NO
StateOrRegion string OptionalState or region, not in use in the nordic countries
Example: Washington DC
ContactName string OptionalContact name for the party
Example: Atle Thorstensen
Email string OptionalEmail
Example: mail@mail.com
Fax string OptionalFax
Example: +4712345678
MobilePhone string OptionalMobile phone
Example: +4712345678
Name string OptionalParty name
Example: Bring
Phone string OptionalPhone
Example: +4712345678
Reference array OptionalReference related to the party, can be used for account number of pallet system in Sweden for insatnce.
ReferenceValue string RequiredExtra Reference
Example: 4440/0189981/WEJ
referenceType string RequiredReferenceType
Possible values:
  • DESPATCH_ADVICE_NUMBER (AAK)
  • TRANSPORT_DOCUMENT_NUMBER (AAS)
  • CUSTOMS_DECLARATION_NUMBER (ABT)
  • ACCOUNT_NUMBER (ADE)
  • PROJECT_NUMBER (AEP)
  • SECONDARY_CUSTOMS_REFERENCE (AFM)
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER (AGM)
  • SENDERS_REFERENCE (AGO)
  • AIR_WAYBILL (AWB)
  • BILL_OF_LADING (BM)
  • BOOKING_REFERENCE (BN)
  • ROAD_CONSIGNMENT_NOTE (CMR)
  • SHIPMENT_REFERENCE (SRN)
  • TRANSPORT_INSTRUCTION (TIN)
  • GOODS_NUMBER (XC)
  • MESSAGE_SENDERS_IDENTITY (MS)

Example: TRANSPORT_DOCUMENT_NUMBER
partyId string OptionalIdentifier for the party
Example: BEX
subPartyId string OptionalFurther identification of the party
Example: GLW
Receiver
Field Type Description
Address object OptionalParty address
AddressLine array RequiredAddress lines. The first line will be mapped to primary address line
Example: Kong Oscars gate 12
CountryCode string RequiredCountry code. Use valid country codes
Example: NO
StateOrRegion string OptionalState or region, not in use in the nordic countries
Example: Washington DC
ContactName string OptionalContact name for the party
Example: Atle Thorstensen
Email string OptionalEmail
Example: mail@mail.com
Fax string OptionalFax
Example: +4712345678
MobilePhone string OptionalMobile phone
Example: +4712345678
Name string OptionalParty name
Example: Bring
Phone string OptionalPhone
Example: +4712345678
Reference array OptionalReference related to the party, can be used for account number of pallet system in Sweden for insatnce.
ReferenceValue string RequiredExtra Reference
Example: 4440/0189981/WEJ
referenceType string RequiredReferenceType
Possible values:
  • DESPATCH_ADVICE_NUMBER (AAK)
  • TRANSPORT_DOCUMENT_NUMBER (AAS)
  • CUSTOMS_DECLARATION_NUMBER (ABT)
  • ACCOUNT_NUMBER (ADE)
  • PROJECT_NUMBER (AEP)
  • SECONDARY_CUSTOMS_REFERENCE (AFM)
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER (AGM)
  • SENDERS_REFERENCE (AGO)
  • AIR_WAYBILL (AWB)
  • BILL_OF_LADING (BM)
  • BOOKING_REFERENCE (BN)
  • ROAD_CONSIGNMENT_NOTE (CMR)
  • SHIPMENT_REFERENCE (SRN)
  • TRANSPORT_INSTRUCTION (TIN)
  • GOODS_NUMBER (XC)
  • MESSAGE_SENDERS_IDENTITY (MS)

Example: TRANSPORT_DOCUMENT_NUMBER
partyId string OptionalIdentifier for the party
Example: BEX
subPartyId string OptionalFurther identification of the party
Example: GLW
AdditionalParty
Field Type Description
Address object OptionalParty address
AddressLine array RequiredAddress lines. The first line will be mapped to primary address line
Example: Kong Oscars gate 12
CountryCode string RequiredCountry code. Use valid country codes
Example: NO
StateOrRegion string OptionalState or region, not in use in the nordic countries
Example: Washington DC
ContactName string OptionalParty contact name
Example: Ola Nordmann
Email string OptionalEmail
Example: mail@mail.com
Fax string OptionalFax
Example: +4712345678
MobilePhone string OptionalMobile phone
Example: +4712345678
Name string OptionalParty name
Example: Rogers antistatiske overledninger
Phone string OptionalPhone
Example: +4712345678
Reference array OptionalFurther references related to the party
Example: SOA-121232332-AN
ReferenceValue string RequiredExtra Reference
Example: 4440/0189981/WEJ
referenceType string RequiredReferenceType
Possible values:
  • DESPATCH_ADVICE_NUMBER (AAK)
  • TRANSPORT_DOCUMENT_NUMBER (AAS)
  • CUSTOMS_DECLARATION_NUMBER (ABT)
  • ACCOUNT_NUMBER (ADE)
  • PROJECT_NUMBER (AEP)
  • SECONDARY_CUSTOMS_REFERENCE (AFM)
  • TEMPORARY_IMPORTATION_DOCUMENT_NUMBER (AGM)
  • SENDERS_REFERENCE (AGO)
  • AIR_WAYBILL (AWB)
  • BILL_OF_LADING (BM)
  • BOOKING_REFERENCE (BN)
  • ROAD_CONSIGNMENT_NOTE (CMR)
  • SHIPMENT_REFERENCE (SRN)
  • TRANSPORT_INSTRUCTION (TIN)
  • GOODS_NUMBER (XC)
  • MESSAGE_SENDERS_IDENTITY (MS)

Example: TRANSPORT_DOCUMENT_NUMBER
partyId string RequiredIdentifier for the party
Example: BEX
subClass string RequiredType of Party
Possible values:
  • DespatchParty
  • DeliveryParty
  • OrderingParty
  • FreightPayer
  • CashOnDeliveryPayee
  • GoodsReturnParty
  • NotifyParty
  • TransportCompany

Example: DeliveryParty
subPartyId string OptionalFurther identification for the party
Example: GLW
ProductAndService
Field Type Description
AdditionalService array OptionalAdditional service codes
AdditionalServiceCode string RequiredThe additional service code for the product
Example: EVARSLING
ServiceRequirements array RequiredSome AdditionalServiceCodes / valueadded service might require extra information
NatureOfCargo string OptionalIndicates if the cargo is out of bound of general expected parameters, dangerous goods or out og gauge
Example: 11
ProductCode string RequiredProductcode for shipment, refer to documentation for valid productcodes for this service
Example: COURIER_1H
TariffReference string OptionalAdditional information about the price of the cargo in connection with the service
Possible values:
  • COOL_ABERRANT
  • GENERAL_CARGO
  • MINERAL_WATER
  • CHILLED_0_4
  • TIRES
  • COOL_5_8
  • FISH_0_4
  • FROZEN_CARGO
  • FROST_FREE_CARGO
  • EARLY_DELIVERY
  • LATE_DELIVERY
  • SPECIAL_CARGO
  • COOL_0_2

Example: GNCG
DeliveryTerms
Field Type Description
ConditionCode string RequiredThe actual terms for the chosen deliverytermstype
Example: EXW
Location object OptionalThe location where the given deliveryterms (condition) applies (to or from given conditioncode.)
City string RequiredCity where the deliveryterms are valid to or from
Example: Bergen
CountryCode string RequiredCountry where the deliveryterms ar valid to or from
Example: NO
termsType string RequiredTerms valid for this shipment
Possible values:
  • Incoterms
  • Freightterms
  • Combiterms
  • PrePaid
  • ThirdParty

Example: Incoterms
CashOnDelivery
Field Type Description
Amount object OptionalAmount expected on delivery
Example: 123450
currencyCode string RequiredCurrencycode, valid currency codes allowed
Example: NOK
ControlDigit integer OptionalControl digit for incoming amount when there is specified a KID number (Norwegian only)
Example: 8
DocumentId array OptionalDocumentIds for Cash on Delivery
Example: SA-46789
MonetaryAccount object OptionalDescription of where the money should be received
TransactionIdentifier object OptionalSenders identifier for the transaction
Value string RequiredThe value to identify where the money should be sent
Example: 1234.12.123456
accountType string RequiredTypeof account to receive payment
Possible values:
  • Bank
  • Bankgiro
  • Plus
  • Post
  • Iban
  • Other

Example: Bank
identifierType string RequiredType of cash on delivery
Possible values:
  • PQ
  • SS

Example: PQ
codType string RequiredType of cash on delivery
Possible values:
  • CashOnDelivery
  • PrePaid
  • CreditCard

Example: CashOnDelivery
GoodsItem
Field Type Description
CustomsDetails array OptionalList of Customs Details for goods being shipped
CountryOfOrigin string OptionalCountry of origin of the package
CustomsArticleNumber string OptionalCustoms Article Number of the package
GoodsDescription string OptionalGoods Description of the package
NetWeight number OptionalNet weight of the package
Quantity number OptionalQuantity of packages
TariffLineAmount object OptionalTariff Line Amount of the package
Value number OptionalValue of the tariff line
currencyCode string OptionalCurrency code of the tariff line
DangerousGoods array OptionalInformation about dangerousgoods being shipped
GoodsDescription string OptionalDescription of goods being shipped
Example: Contains socks
LoadCarrier string OptionalTransport equipment (pallet, container etc)
Example: EFP
Package array RequiredList of packages being shipped
email string RequiredRecipient’s email address.
phoneNumber string RequiredRecipient’s phone number, including country code.
Pattern: \+[0-9 ]+
Example: +4700000000
postalCode string RequiredA valid Norwegian postal code.
recipientName string RequiredRecipient name.
rfid boolean RequiredWhether to activate tracking with RFID for the package.
streetAddress string RequiredRecipient’s street address.
weight integer RequiredWeight in grams.
PackageTypeCode string RequiredTypes of cargo, packaging of cargo. Either use supported enumeration or UN/ECE Recommendation 21
PackingDetails array OptionalList of Package Details for goods being shipped
ArticleDescription string OptionalArtical description of Packing Details
ArticleNumber string OptionalArticla details of Packing Details
ArticlePrice object OptionalArtical Price of the Packing Details
Value number OptionalValue of packages
currencyCode string OptionalQuantity of packages
ItemBackOrder number OptionalItem Back Order within Packing Details
ItemDelivered number OptionalItem Delivered within Packing Details
ItemOrdered number OptionalItem Ordered within the Packing Details
ItemUnity string OptionalItem Unity within Packing Details
PositionNumber integer OptionalPosition number within Packing Details
SealId string OptionalItem sealed for customs etc, number of the seal
Example: 123456
Temperature object OptionalTemperature requirements for goods being shipped
Storage object RequiredTemperature requirements for storage of goods
Value integer RequiredSpecific temperature for transportation of the cargo
Example: 3
maximum string OptionalMaximum allowed temperature
Example: 4
minimum string OptionalMinimum allowed temperature
Example: -8
unitCode string RequiredUnit code for temperature measure
Possible values:
  • CEL
  • FAH

Example: CEL
Transport object RequiredTemperature requirements during transport
Value integer RequiredSpecific temperature for transportation of the cargo
Example: 3
maximum string OptionalMaximum allowed temperature
Example: 4
minimum string OptionalMinimum allowed temperature
Example: -8
unitCode string RequiredUnit code for temperature measure
Possible values:
  • CEL
  • FAH

Example: CEL
MonetaryAccount
Field Type Description
AccountHolderName string RequiredName of the owner of the account
Example: Ola Nordmann
AccountNumber object RequiredAccount number to receive payment
Value string RequiredActual account number
Example: 4567.45.12345
accountType string RequiredType of account to receive payment on delivery
Possible values:
  • Bank
  • Bankgiro
  • Plus
  • Post
  • Iban
  • Other
BankName string RequiredBank where account is created
Example: DNB
SwiftCode string RequiredSwift code for international transfers
Example: DNBANOKK
DangerousGoods
Field Type Description
AdditionalHazard string OptionalAdditional codes for hazard
Example: 2.3(8)
Flashpoint object RequiredFlashpointinformation for dangerousgoods (when will the item become volatile?)
Value integer OptionalValue when flashpoint occurs/ignites
Example: 18
unitCode string OptionalUnit code for flashpoint
Possible values:
  • CEL
  • FAH

Example: CEL
HazardClass string OptionalClassification of hazard
Example: 4.1
HazardPoints integer OptionalPoints for this hazard. Calculated from factor for dangerousgoods multiplied by amount in kg / dm3 for each material in cargo
Example: 10
Measures array OptionalMeasures for Dangerous Goods
Measure object OptionalMeasurements for goods
Value number OptionalMeasure value
Example: 1.22
unitCode string OptionalUnit code for measure
Example: DMQ
subClass string Optional
Example: NetHazardWeight
PackingGroup string OptionalPacking danger level code, roman numeral between 1 and 3
Example: II
Restrictions array OptionalRestrictions when carrying these hazardous goods
Value string OptionalFreetext specification of restriction for given tunnel. One element for each UN number in the dangerousgoods sequence
Example: Ellingsøy- og Valderøytunnelen på riksveg 658 utenfor Ålesund. Her gjelder tunnelkategori C i tidsrommet kl. 0600–2400 hver dag
restrictionType string OptionalType of restriction
Possible values:
  • Tunnel

Example: Tunnel
TechnicalName string OptionalTechnical name of hazard
Example: KALSIUMRESINAT, SINTRET
UNDGInformation object RequiredUnited nations dangerous goods information
FlashpointDescription string OptionalFlashpoint for dangerous goods
Example: BLACK POWDER, granulated or in powderform
HazardIdentifier string OptionalUnited nations dangerous goods hazard identifier
Example: 1.1D
regulatonCode string OptionalRegulation codes for the hazardous goods
Example: ADR		 
<CreateShipmentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.bring.com/CreateShipment">
  <RequestVersion xmlns="">1</RequestVersion>
  <RequestDate xmlns="">2021-04-20T10:55:07</RequestDate>
  <Shipment updateIndicator="Original" shipmentType="Instruction" xmlns="">
    <ShipmentHeaders shipmentId="70722150702977990">
      <SendersReference>1878959</SendersReference>
      <NumberOfPackages>1</NumberOfPackages>
      <GrossWeight unitCode="KGM">1</GrossWeight>
      <LoadingMetres>0</LoadingMetres>
      <PalletFootPrints>0</PalletFootPrints>
      <HazardPoints>0</HazardPoints>
    </ShipmentHeaders>
    <DateAndTimes subClass="DocumentDate">
      <DateTime>2022-04-20T10:55:07</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="DeliveryEarliest">
      <DateTime>2022-04-20T16:00:00</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="DeliveryLatest">
      <DateTime>2022-04-20T21:00:00</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="PickupEarliest">
      <DateTime>2022-04-20T14:00:00</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="PickupLatest">
      <DateTime>2022-04-20T18:00:00</DateTime>
    </DateAndTimes>
    <Sender partyId="28371">
      <Name>Mester Grønn Oasen Senter Bergen</Name>
      <Address>
        <AddressLine>Folke Bernadottes vei 52</AddressLine>
        <PostalCode>5147</PostalCode>
        <City>FYLLINGSDALEN</City>
        <CountryCode>NO</CountryCode>
      </Address>
      <Phone>+4732229724</Phone>
    </Sender>
    <Receiver>
      <Name>Trine Elisabeth Rud Riera</Name>
      <Address>
        <AddressLine>Ture Nermans vei 107</AddressLine>
        <PostalCode>5143</PostalCode>
        <City>FYLLINGSDALEN</City>
        <CountryCode>NO</CountryCode>
      </Address>
      <MobilePhone>98071041</MobilePhone>
    </Receiver>
    <AdditionalParty subClass="GoodsReturnParty">
      <Name>Ola Nordmann</Name>
      <Address>
        <PostalCode>1065</PostalCode>
        <City>OSLO</City>
        <CountryCode>NO</CountryCode>
        <AddressLine>Storgatan 1</AddressLine>
      </Address>
      <MobilePhone>4712345678</MobilePhone>
      <Email>ola.nordmann@someemail.com</Email>
      <ContactName>Ola Nordmann</ContactName>
    </AdditionalParty>
    <AdditionalParty subClass="TransportCompany" partyId="BEX" subPartyId="GLW" />
    <ProductAndService>
      <ProductCode>3270</ProductCode>
    </ProductAndService>
    <GoodsItem>
      <PackageTypeCode>PK</PackageTypeCode>
      <GoodsDescription>Kittens in a sack</GoodsDescription>
      <Package packageId="370722150758796447">
        <GrossWeight unitCode="KGM">1</GrossWeight>
      </Package>
    </GoodsItem>
  </Shipment>
</CreateShipmentRequest>

Sample request to book a Bring Express Courier shipment.

<CreateShipmentRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.bring.com/CreateShipment">
  <RequestVersion xmlns="">1</RequestVersion>
  <RequestDate xmlns="">2021-04-20T10:55:07</RequestDate>
  <Shipment updateIndicator="Original" shipmentType="Instruction" xmlns="">
    <ShipmentHeaders shipmentId="70722150702977990">
      <SendersReference>1878959</SendersReference>
      <NumberOfPackages>1</NumberOfPackages>
      <GrossWeight unitCode="KGM">1</GrossWeight>
      <LoadingMetres>0</LoadingMetres>
      <PalletFootPrints>0</PalletFootPrints>
      <HazardPoints>0</HazardPoints>
    </ShipmentHeaders>
    <DateAndTimes subClass="DocumentDate">
      <DateTime>2022-04-20T10:55:07</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="DeliveryEarliest">
      <DateTime>2022-04-20T16:00:00</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="DeliveryLatest">
      <DateTime>2022-04-20T21:00:00</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="PickupEarliest">
      <DateTime>2022-04-20T14:00:00</DateTime>
    </DateAndTimes>
    <DateAndTimes subClass="PickupLatest">
      <DateTime>2022-04-20T18:00:00</DateTime>
    </DateAndTimes>
    <Sender partyId="28371">
      <Name>Mester Grønn Oasen Senter Bergen</Name>
      <Address>
        <AddressLine>Folke Bernadottes vei 52</AddressLine>
        <PostalCode>5147</PostalCode>
        <City>FYLLINGSDALEN</City>
        <CountryCode>NO</CountryCode>
      </Address>
      <Phone>+4732229724</Phone>
    </Sender>
    <Receiver>
      <Name>Trine Elisabeth Rud Riera</Name>
      <Address>
        <AddressLine>Ture Nermans vei 107</AddressLine>
        <PostalCode>5143</PostalCode>
        <City>FYLLINGSDALEN</City>
        <CountryCode>NO</CountryCode>
      </Address>
      <MobilePhone>98071041</MobilePhone>
    </Receiver>
    <AdditionalParty subClass="GoodsReturnParty">
      <Name>Ola Nordmann</Name>
      <Address>
        <PostalCode>1065</PostalCode>
        <City>OSLO</City>
        <CountryCode>NO</CountryCode>
        <AddressLine>Storgatan 1</AddressLine>
      </Address>
      <MobilePhone>4712345678</MobilePhone>
      <Email>ola.nordmann@someemail.com</Email>
      <ContactName>Ola Nordmann</ContactName>
    </AdditionalParty>
    <AdditionalParty subClass="TransportCompany" partyId="BEX" subPartyId="GLW" />
    <ProductAndService>
      <ProductCode>3270</ProductCode>
    </ProductAndService>
    <GoodsItem>
      <PackageTypeCode>PK</PackageTypeCode>
      <GoodsDescription>Kittens in a sack</GoodsDescription>
      <Package packageId="370722150758796447">
        <GrossWeight unitCode="KGM">1</GrossWeight>
      </Package>
    </GoodsItem>
  </Shipment>
</CreateShipmentRequest>

Responses

HTTP status code 200

Returns a confirmation of successful delivery and package IDs / shipment IDs if requested.

Media type: application/json

Field Type Description
EndpointProcessingID string Optional
Errors array Optional
Error string OptionalError type
Possible values:
  • VALIDATION
  • SYSTEM
  • BAD_REQUEST
ErrorText string Optional
Identities array Optional
PackageId array Required
ShipmentId string Required
ProcessingID string Optional
Status string Optional
Possible values:
  • OK
  • OK_CONFIRMED
  • ERROR
  • VALIDATION_ERROR
  • FORBIDDEN
StatusText string Optional 
{
  "CreateShipmentResponse": {
    "Status": "OK_CONFIRMED",
    "StatusText": "Order created",
    "Identities": {
      "ShipmentId": "70438103433199319",
      "PackageId": "370438103696190758"
    },
    "ProcessingID": "fc3f2481-759e-43a3-a6ae-eb10a2fd183a",
    "EndpointProcessingID": "c7167ab6-8e35-46c6-8aff-75087eed9e97"
  }
}

Media type: application/xml

Field Type Description
EndpointProcessingID string Optional
Errors array Optional
Error string OptionalError type
Possible values:
  • VALIDATION
  • SYSTEM
  • BAD_REQUEST
ErrorText string Optional
Identities array Optional
PackageId array Required
ShipmentId string Required
ProcessingID string Optional
Status string Optional
Possible values:
  • OK
  • OK_CONFIRMED
  • ERROR
  • VALIDATION_ERROR
  • FORBIDDEN
StatusText string Optional 
<CreateShipmentResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.bring.com/CreateShipment">
  <Status>OK_CONFIRMED</Status>
  <StatusText>Order created</StatusText>
  <Identities ShipmentId="70438103433199319">
    <PackageId>370438103696190758</PackageId>
  </Identities>
  <ProcessingID>fc3f2481-759e-43a3-a6ae-eb10a2fd183a</ProcessingID>
  <EndpointProcessingID>c7167ab6-8e35-46c6-8aff-75087eed9e97</EndpointProcessingID>
</CreateShipmentResponse>

HTTP status code 400

Error in validation of request or error in data structure of request.

HTTP status code 417

Missing authentication headers.

HTTP status code 500

Unknown error. Error sending data to destination.

Create shipment booking

Sends a booking request consisting of a Shipment with a Goods Item attached. The Goods Item must contain a Package.

A consignment value must not be included as this would imply that the shipment itself, was to be created.

URL

                          POST
                          https://bapi.bring.com/shipment/sendbooking?shipmentId={createShipmentId}&packageIds={createPackageId}

Request parameters

URI param Type Description
createPackageId boolean Required If “true” the API will assign all package IDs for you and return them in the response.
createShipmentId boolean Required If “true” the API will assign a shipment ID for you and return it in the response.
HTTP header Type Description
Accept string Required Specify response format (application/json, application/xml)
Possible values:
  • application/json
  • application/xml
Content-Type string Required Specify request format (application/json, application/xml)
Possible values:
  • application/json
  • application/xml

Request body

Media type: application/json

{
  "RequestVersion": "1",
  "RequestDate": "2018-11-21T10:36:27.3139022+01:00",
  "Shipment": {
    "updateIndicator": "Original",
    "shipmentType": "Booking",
    "ShipmentHeaders": {
      "SendersReference": "CUSTOMERS REFERENCE",
      "NumberOfPackages": "2",
      "AdditionalReference": [
        {
          "ReferenceValue": "Dummy",
          "referenceType": "BOOKING_REFERENCE"
        }
      ],
      "FreeText": [
        {
          "Text": [
            {
              "Value": "My instructions for pickup"
            }
          ],
          "usageCode": "PICKUP_INSTRUCTIONS"
        }
      ],
      "GrossWeight": {
        "unitCode": 1,
        "Value": 2.0
      },
      "LoadingMetres": 0.0,
      "PalletFootPrints": 0.0,
      "HazardPoints": 0.0,
      "shipmentId": "73500012345678911"
    },
    "DateAndTimes": [
      {
        "subClass": "PickupEarliest",
        "DateTime": "2018-11-21T14:36:27.3139022+01:00"
      },
      {
        "subClass": "DeliveryEarliest",
        "DateTime": "2018-11-21T18:36:27.3139022+01:00"
      },
      {
        "subClass": "DeliveryLatest",
        "DateTime": "2018-11-21T20:36:27.3139022+01:00"
      },
      {
        "subClass": "DocumentDate",
        "DateTime": "2018-11-21T10:36:27.3139022+01:00"
      }
    ],
    "Sender": {
      "partyId": "00096882527",
      "Name": "Sender name",
      "Address": {
        "AddressLine": [
          "MyStreet 123"
        ],
        "PostalCode": "5122",
        "City": "My City",
        "CountryCode": "NO"
      },
      "MobilePhone": "12345678",
      "Email": "Sender@Sender.com"
    },
    "Receiver": {
      "Name": "Receiver name",
      "Address": {
        "AddressLine": [
          "MyStreet 123"
        ],
        "PostalCode": "5122",
        "City": "Other City",
        "CountryCode": "NO"
      },
      "MobilePhone": "87654321",
      "Email": "Receiver@Receiver.com"
    },
    "AdditionalParty": [
      {
        "subClass": "TransportCompany",
        "partyId": "BEX",
        "subPartyId": "ALY"
      }
    ],
    "ProductAndService": {
      "ProductCode": "COURIER_1H",
      "AdditionalService": [
        {
          "AdditionalServiceCode": "EVARSLING"
        }
      ]
    },
    "GoodsItem": [
      {
        "GoodsDescription": "Socks",
        "Package": [
          {
            "GrossWeight": {
              "unitCode": 1,
              "Value": 1.0
            },
            "packageId": "373500123456789012"
          },
          {
            "GrossWeight": {
              "unitCode": 1,
              "Value": 1.0
            },
            "packageId": "37350012345678929"
          }
        ]
      }
    ]
  }
}

Media type: application/xml

<?xml version="1.0" encoding="utf-8"?>
<CreateBookingRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.bring.com/CreateShipment">
	<RequestVersion xmlns="">1</RequestVersion>
	<RequestDate xmlns="">2019-01-31T07:33:09.9666092+01:00</RequestDate>
	<Shipment updateIndicator="Original" shipmentType="Booking" xmlns="">
		<ShipmentHeaders shipmentId="73500012345678911">
			<SendersReference>CUSTOMERS REFERENCE</SendersReference>
			<NumberOfPackages>2</NumberOfPackages>
			<AdditionalReference referenceType="BOOKING_REFERENCE">
				<ReferenceValue>Dummy</ReferenceValue>
			</AdditionalReference>
			<FreeText usageCode="PICKUP_INSTRUCTIONS">
				<Text>My instructions for pickup</Text>
			</FreeText>
			<GrossWeight unitCode="KGM">2</GrossWeight>
			<LoadingMetres>0</LoadingMetres>
			<PalletFootPrints>0</PalletFootPrints>
			<HazardPoints>0</HazardPoints>
		</ShipmentHeaders>
		<DateAndTimes subClass="PickupEarliest">
			<DateTime>2019-01-31T11:33:09.9666092+01:00</DateTime>
		</DateAndTimes>
		<DateAndTimes subClass="DeliveryEarliest">
			<DateTime>2019-01-31T15:33:09.9666092+01:00</DateTime>
		</DateAndTimes>
		<DateAndTimes subClass="DeliveryLatest">
			<DateTime>2019-01-31T17:33:09.9666092+01:00</DateTime>
		</DateAndTimes>
		<DateAndTimes subClass="DocumentDate">
			<DateTime>2019-01-31T07:33:09.9666092+01:00</DateTime>
		</DateAndTimes>
		<Sender partyId="00096882527">
			<Name>Sender name</Name>
			<Address>
				<AddressLine>MyStreet 123</AddressLine>
				<PostalCode>5122</PostalCode>
				<City>My City</City>
				<CountryCode>NO</CountryCode>
			</Address>
			<MobilePhone>12345678</MobilePhone>
			<Email>Sender@Sender.com</Email>
		</Sender>
		<Receiver>
			<Name>Receiver name</Name>
			<Address>
				<AddressLine>MyStreet 123</AddressLine>
				<PostalCode>5122</PostalCode>
				<City>Other City</City>
				<CountryCode>NO</CountryCode>
			</Address>
			<MobilePhone>87654321</MobilePhone>
			<Email>Receiver@Receiver.com</Email>
		</Receiver>
		<AdditionalParty subClass="TransportCompany" partyId="BEX" subPartyId="ALY" />
		<ProductAndService>
			<ProductCode>COURIER_1H</ProductCode>
			<AdditionalService>
				<AdditionalServiceCode>EVARSLING</AdditionalServiceCode>
			</AdditionalService>
		</ProductAndService>
		<GoodsItem>
			<GoodsDescription>Socks</GoodsDescription>
			<Package packageId="373500123456789012">
				<GrossWeight unitCode="KGM">1</GrossWeight>
			</Package>
			<Package packageId="37350012345678929">
				<GrossWeight unitCode="KGM">1</GrossWeight>
			</Package>
		</GoodsItem>
	</Shipment>
</CreateBookingRequest>

Responses

HTTP status code 200

Returns a confirmation of successful delivery and package IDs / shipment IDs if requested.

HTTP status code 400

Error in validation of request or error in data structure of request.

HTTP status code 417

Missing authentication headers.

HTTP status code 500

Unknown error. Error sending data to destination.

comments powered by Disqus