Skip to main content
Return to top

How to upload your own prices from your direct carrier contract

Louise Thomasson
  • Updated

Purpose: Learn how to upload your own shipping prices via CSV import to have them appear via your Sendcloud API integration.

How to upload your prices

  1. In your Sendcloud account, go to Settings > Carriers > My contracts
  2. Select the contract you want to update with pricing
  3. Under the Contract prices section, click Download CSV
  4. Fill out the CSV file template according to the instructions below 
  5. Upload the completed CSV file 
  6. Click Save these prices 

151e2d82-3d73-4286-bed5-e61e3c4ee2d4.png

You will now be able to see your prices via the shipping price endpoint or the shipping product endpoint via the Sendcloud API. Prices will also be visible in the Sendcloud panel when you create or edit an order from the Incoming orders overview. 

How to edit prices

If you need to change any of the pricing information you previously provided, download the CSV file as described above (the CSV download will match your previous upload file) and make your changes. Then upload the CSV file again and click Save your prices.

How to delete prices

To delete your prices, download the CSV file as described above (the CSV download will match your previous upload file) and delete all the rows except for the headers. Then upload the CSV file again and click Save your prices. Your prices should now be removed.

Feature availability

Unfortunately, this feature is not supported by all carriers. The following carriers do not support uploading your own contract pricing:

  • Correos Express

  • CTT Express

  • Correos

  • Parcel Force

  • UPS ES

  • Hermes GB

  • FedEx 

How to fill in the CSV file

Important: Use a period (" . ") as decimal separator for weight classes and prices, and not a comma " , ".

Enter your prices per shipping method under the column "price".

4.png

If you have more than one weight class defined for the same shipping method, then do as follows:

  • Delete the data under the “min_weight” and the “max_weight” column:
    1.png

  • Enter the first weight class you need, and enter the price. E.g., 0-5 kg → €10:
    2.png

  • Copy the row, and do the same for the next weight class included in the shipping method:
    3.png

You can also combine multiple countries in the same row if the prices are the same per weight class, as in the below example: 

975,DHL Europlus,BE,"DK, ES",0.500,5.001,5
975,DHL Europlus,BE,"DK, ES",5.001,31.5,8

Make sure to delete the rows containing shipping methods you don't use and therefore did not fill in. When you don't delete them, an error message saying that information in the CSV is missing will appear.

info_sc_blue.png Important information about weight classes

The Sendcloud system considers that the “min_weight” is inclusive and the “max_weight” is exclusive.

  • Using the example above, this means that if the “min_weight” is 0.001 and the shipment weighs 0.001, then the price will be based on the weight class in which 0.001 is the minimum weight.
    • The price will therefore be €10 as per the above example.

  • If the shipment weighs 5.001, then the price applied will be based on the weight class with a minimum weight of 5.001, and not the class with a maximum of 5.001.
    • The price will therefore be €20 as per the above example. 

Note: To avoid errors when uploading the CSV file, make sure the maximum weight of one method is the same as the minimum weight of the next method. For example, if you set the maximum weight of one method to 20.001 and the minimum weight of the next method to 20.001, the first method’s actual maximum weight will be 20.000. This means parcels up to 20.001 will be handled by the second method. 

Please note: Sendcloud is not responsible for any deviations between the prices input into the CSV file and any actual prices charged by your shipping carrier. Any values input into this file are the entire responsibility of the individual.