Price calculation API – Begoma's Developer Portal

We have two different price calculation APIs – PriceCalculation and PriceCalculationDifferentModeOfTransportation.

PriceCalculation – gives actual market price for truck transport.

PriceCalculationDifferentModeOfTransportation – gives actual market prices for different transports methods.

PriceCalculation

https://ws.begoma.se/upcwebservice.asmx?op=PriceCalculation

Request

Field	Comment
<LoadPlace>	Add load place with this format [Countrycode]-[Zip code], i.e. SE-21566
<UnloadPlace>	Add unload place with this format [Countrycode]-[Zip code], i.e. SE-21566
<ActualWeight>	double, the total weight of the shipment
<LDM>	Optional, double, number of loading meters.
<CBM>	Optional, double, number of cubic meters
<PPL>	Optional, integer, number of pallets
<Key>	string, your unique authentication key

POST /upcwebservice.asmx HTTP/1.1
Host: ws.begoma.se
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://ws.begoma.se/PriceCalculation"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
	<soap:Body>   
		<PriceCalculation xmlns="https://ws.begoma.se/">    
			<LoadPlace>IT-1022</LoadPlace>    
			<UnloadPlace>SE-89435</UnloadPlace>    
			<ActualWeight>24000</ActualWeight>    
			<LDM>0</LDM>    
			<CBM>0</CBM>    
			<PPL>0</PPL>    
			<Key>920740db-4ab2-403a-bc49-20de0b7d0554</Key>   
		</PriceCalculation>  
	</soap:Body>
</soap:Envelope>

Response

Field	Comment
<PriceEUR>	Actual market price for requested transport in EUR, VAT excluded
<PriceSEK>	Actual market price for requested transport in SEK, VAT excluded
<LoadCity>	What we have translated the requested zip code into
<UnloadCity>	What we have translated the requested zip code into
<EarliestLoadingDate>	Our earliest loading day
<EstimatedEarliestDelivery>	Our earliest delivery day
<EstimatedLatestDelivery>	Our latest delivery day
<ErrorMessage>	If we can’t process the request we give the rease why here.
<Surcharge>	One section for every available surcharge. Each section contain name and price both in EUR and SEK. For example delivery with tail lift.

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PriceCalculationResponse xmlns="https://ws.begoma.se/">
      <PriceCalculationResult>
        <PriceEUR>double</PriceEUR>
        <PriceSEK>double</PriceSEK>
        <LoadCity>string</LoadCity>
        <UnloadCity>string</UnloadCity>
        <EarliestLoadingDate>dateTime</EarliestLoadingDate>
        <EstimatedEarliestDelivery>dateTime</EstimatedEarliestDelivery>
        <EstimatedLatestDelivery>dateTime</EstimatedLatestDelivery>
        <ErrorMessage>string</ErrorMessage>
        <AvailableSurcharges>
          <Surcharge>
            <Id>int</Id>
            <Name>string</Name>
            <PriceEUR>double</PriceEUR>
            <PriceSEK>double</PriceSEK>
          </Surcharge>
          <Surcharge>
            <Id>int</Id>
            <Name>string</Name>
            <PriceEUR>double</PriceEUR>
            <PriceSEK>double</PriceSEK>
          </Surcharge>
        </AvailableSurcharges>
      </PriceCalculationResult>
    </PriceCalculationResponse>
  </soap:Body>
</soap:Envelope>

PriceCalculationDifferentModeOfTransportation

https://ws.begoma.se/upcwebservice.asmx?op=PriceCalculationDifferentModeOfTransportation

Request

Field	Comment
<LoadPlace>	string, Add load place with this format [Countrycode]-[Zip code], i.e. SE-21566
<UnloadPlace>	string, Add unload place with this format [Countrycode]-[Zip code], i.e. SE-21566
<ActualWeight>	double, Actual weight in kg of the load
<LDM>	Optional: double, number of loading meters
<CBM>	Optional double, number of cubic meters
<PPL>	Optional integer, number of pallets
<DiscountCode>	Optional string, Together we can setup a number of discount codes that we can use.
<IP>	string, Your IP address
<Key>	string, your unique authentication key

POST /upcwebservice.asmx HTTP/1.1
Host: ws.begoma.se
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://ws.begoma.se/PriceCalculationDifferentModeOfTransportation"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PriceCalculationDifferentModeOfTransportation xmlns="https://ws.begoma.se/">
      <LoadPlace>IT-1022</LoadPlace>
      <UnloadPlace>SE-89435</UnloadPlace>
      <ActualWeight>2400</ActualWeight>
      <LDM>0</LDM>
      <CBM>0</CBM>
      <PPL>0</PPL>
      <DiscountCode></DiscountCode>
      <IP>1.1.1.1</IP>
      <Key>920740db-4ab2-403a-bc49-20de0b7d0554</Key>
    </PriceCalculationDifferentModeOfTransportation>
  </soap:Body>
</soap:Envelope>

Response

Field	Customer
<LoadCity>	What we have translated the requested zip code into
<UnloadCity>	What we have translated the requested zip code into
<ErrorMessage>	If we can’t process the request we give the reason why here.
<Freight>	One section for each available freight methods.
<Name>	Name of the freight methods.
<OriginalPriceEUR>	Actual market price, before discount, for requested transport in EUR, VAT excluded
<OriginalPriceSEK>	Actual market price, before discount, for requested transport in SEK, VAT excluded
<DiscountEUR>	Discount in EUR
<DiscountSEK>	Discount in SEK
<NewPriceEUR>	Actual market price, after discount, for requested transport in EUR, VAT excluded
<NewPriceSEK>	Actual market price, after discount, for requested transport in SEK, VAT excluded
<EarliestLoadingDate>	Our earliest loading day
<EstimatedEarliestDelivery>	Our earliest delivery day
<EstimatedLatestDelivery>	Our latest delivery day
<Surcharge>	One section for every available surcharge. Each section contain name and price both in EUR and SEK. For example delivery with tail lift.

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PriceCalculationDifferentModeOfTransportationResponse xmlns="https://ws.begoma.se/">
      <PriceCalculationDifferentModeOfTransportationResult>
        <LoadCity>string</LoadCity>
        <UnloadCity>string</UnloadCity>
        <ErrorMessage>string</ErrorMessage>
        <AvailableFreightOptions>
          <Freight>
            <Name>string</Name>
            <OriginalPriceEUR>double</OriginalPriceEUR>
            <OriginalPriceSEK>double</OriginalPriceSEK>
            <DiscountEUR>double</DiscountEUR>
            <DiscountSEK>double</DiscountSEK>
            <NewPriceEUR>double</NewPriceEUR>
            <NewPriceSEK>double</NewPriceSEK>
            <EarliestLoadingDate>dateTime</EarliestLoadingDate>
            <EstimatedEarliestDelivery>dateTime</EstimatedEarliestDelivery>
            <EstimatedLatestDelivery>dateTime</EstimatedLatestDelivery>
          </Freight>
          <Freight>
            <Name>string</Name>
            <OriginalPriceEUR>double</OriginalPriceEUR>
            <OriginalPriceSEK>double</OriginalPriceSEK>
            <DiscountEUR>double</DiscountEUR>
            <DiscountSEK>double</DiscountSEK>
            <NewPriceEUR>double</NewPriceEUR>
            <NewPriceSEK>double</NewPriceSEK>
            <EarliestLoadingDate>dateTime</EarliestLoadingDate>
            <EstimatedEarliestDelivery>dateTime</EstimatedEarliestDelivery>
            <EstimatedLatestDelivery>dateTime</EstimatedLatestDelivery>
          </Freight>
        </AvailableFreightOptions>
        <AvailableSurcharges>
          <Surcharge>
            <Id>int</Id>
            <Name>string</Name>
            <PriceEUR>double</PriceEUR>
            <PriceSEK>double</PriceSEK>
          </Surcharge>
          <Surcharge>
            <Id>int</Id>
            <Name>string</Name>
            <PriceEUR>double</PriceEUR>
            <PriceSEK>double</PriceSEK>
          </Surcharge>
        </AvailableSurcharges>
      </PriceCalculationDifferentModeOfTransportationResult>
    </PriceCalculationDifferentModeOfTransportationResponse>
  </soap:Body>
</soap:Envelope>