Shipping Guide API
Endpoints
Base URL
https://api.bring.com/shippingguide
| Usage | Method | Endpoint |
|---|---|---|
| Get shipment prices and leadtime | POST |
/v2/products
|
| Use this endpoint to get same information as above REST API | POST |
/api/ws
|
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.
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"
},
"zones": {
"totalZoneCount": 1
}
},
"expectedDelivery": {
"workingDays": "1",
"userMessage": "",
"formattedExpectedDeliveryDate": "14.01.2021",
"expectedDeliveryDate": {
"year": "2021",
"month": "1",
"day": "14"
},
"alternativeDeliveryDates": []
}
}
]
}
],
"uniqueId": "cedb345a-759a-4892-9ee8-3672f5a5ebf5"
}
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:Zones>
<ns2:TotalZoneCount>1</ns2:TotalZoneCount>
</ns2:Zones>
</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>