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. Go to your Sendcloud account and navigate to:
    Shipping → Carriers → My contracts
  2. Find the contract you want to update and click the edit (pen) icon.
  3. Scroll down to the Upload contract prices section.
    Turn on the toggle and click Download CSV to get the template.
  4. Fill in the CSV file according to the guidelines provided below.
  5. Return to the same section and upload your completed CSV file.
  6. Click Save these prices to apply your updated contract rates.
Note: When the Upload contract prices toggle appears to be off, it does not mean that your prices are not saved. After saving your prices and returning to edit your contract, the toggle may look switched off, but your previously uploaded prices remain stored.
To verify this, turn the toggle back on and click Download CSV. You will see that your previously uploaded prices are still present.
If your prices are uploaded but not appearing in the order view, please contact Sendcloud Support for assistance.

EN.png (2234×792)

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

  • Evri

  • 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.

Use only your own carrier rates

You can now ensure that only your negotiated carrier contracts are applied to shipments, even in the event of a carrier outage.

Enable the toggle at the bottom of your My contracts page Use only my rates for the carriers I've added contracts for to guarantee that your own rates are always used, even if a shipment fails or needs to be re-announced. This protects you from unexpected costs and ensures your negotiated rates always apply.

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.