TerramineDESKTalk to our team

Documentation / Set-up guides / Orders and money

Couriers: DHL, UPS and FedEx

On this page

Live shipping rates from DHL Express, UPS and FedEx on your own accounts, asked from an order's logistics planner. Switch on only the couriers you ship with: one that is off is asked for nothing, and its keys stay saved.

Couriers: the set-up page in Terramine Desk Admin, before anything is entered
Couriers in Admin, as the page looks before anything is entered.

Before you start

  • An account with the courier, and its account number.
  • API credentials from the courier's developer portal: for DHL Express an API key and an API secret, for UPS a Client ID and a Client secret, for FedEx an API key and a Secret key.
  • The Couriers plugin switched on in Admin → Apps.

Connecting a courier

  1. Open Admin → Integrations → Couriers and click the courier's tile to open its settings.
  2. Enter the two credentials and the Account number.
  3. Leave Mode on Test for the first try. Test asks the courier's test system; Live asks for your account's real rates.
  4. Press Save changes and switch the courier on with the switch on its tile.
  5. Press Get a test rate. It asks for one quote, a 1 kg parcel from Dubai to London. A rate came back means the account answers; otherwise the courier's own words say why not.
  6. Switch Mode to Live and save, once the test rate has come back.

Where the rates are used

  • On an ERP order, Get rates in the logistics planner asks every courier that is switched on and set up. The rates come back as options; choosing one and offering it to the customer stays a person's step.
  • DHL Express and UPS use parcel services: non-box pieces or pieces above 70 kg need a manual freight quote. FedEx can also return International Priority Freight and International Economy Freight rates for international shipments above 68 kg total. Enter the actual pieces, gross weights and all dimensions; online freight requests allow at most 1,000 kg per piece and 100 physical pieces. A returned rate does not book transport or prove a negotiated discount: confirm the lane, handling and pickup with FedEx.
  • Forwarders and their rates are not here. They are in ERP → Reference.

Address lookup

The Address lookup tile takes a Loqate API key. With it, address search inside delivery routes offers Loqate's candidates; opening an address in full uses Loqate credit, so set usage limits in your Loqate account. Without it, addresses are looked up in published sources through the assistant. Neither search confirms that a courier delivers there.