Home Docs User guide
Guide

User guide

How to configure, price, test and manage Custom Shipping Rules day to day.

The Home dashboard

Home is your activation centre. At a glance it tells you whether shipping is live, needs action, or is off:

  • Status hero — green means shoppers are seeing your UPS options; amber means the service is on but the carrier isn't connected yet; grey means shipping is off.
  • Setup checklist — three steps (connect carrier → review rates → turn on) with a progress bar.
  • At a glance — your carrier, quote currency, active pricing strategy, and checkout status.
  • Preview at checkout — opens a mock of exactly what a shopper sees, using your live rates.

Connecting the carrier

Connect carrier attaches the UPS shipping options to your store's shipping zone(s) so they can appear at checkout. Run it once after installing.

If the options ever stop showing, use Re-sync carrier (the same button). It refreshes the connection and updates the checkout method name without a reinstall. The checklist shows how many zones the carrier is attached to.

Pricing strategies

On Configure you choose how the UPS base rate becomes the price a shopper pays. Pick one:

  • UPS rate + markup — adds a single flat percentage on top of the UPS rate. Example: a 50% markup turns an AED 100 base into AED 150.
  • UPS rate + fuel surcharge + VAT — layers a fuel surcharge and UAE VAT onto the base in sequence: base × (1 + fuel%) × (1 + VAT%)

Set your percentages, press Save pricing, and the rate table and tester immediately reflect the change. Shoppers only ever see the final price — never the markup, fuel, or VAT breakdown.

The rate table

The table on Configure shows every weight bracket and its price for each delivery tier, after your pricing is applied:

  • Weight is normalised to kilograms.
  • Any fraction over a listed weight rounds up to the next bracket.
  • Over 70 kg is billed at the per-kilogram over-size rate (with a minimum), shown automatically.

Testing a shipment

The Test a shipment tool shows the exact rates a shopper would see for a given parcel. Enter an actual weight and the dimensions, then press Test rates.

The result makes the calculation transparent. It compares two numbers and marks which one was used:

  • Actual weight — the parcel's real weight.
  • Dimensional weightL × W × H ÷ 5000, which accounts for light, bulky parcels.

The chargeable weight is always the greater of the two — that's the one the price is based on. The two AED quotes below it are exactly what the shopper is charged.

What shoppers see at checkout

When a shopper enters a UAE delivery address, the shipping step shows two UPS options, priced in AED:

  • UPS (Delivery by Close of Business) — the dependable everyday service (UPS Domestic Express Saver).
  • UPS (Delivery by Midday) — priority delivery for urgent orders (UPS Domestic Express).

Each option carries the delivery time and the chargeable weight on its sub-line. The shopper picks whichever speed they prefer.

Turning shipping on / off

The master switch on Home controls everything. When it's off, the app returns no quotes and shoppers don't see these options — useful for pausing without uninstalling. When it's on and the carrier is connected, rates go live immediately.

Coverage & limitations

This app quotes UPS UAE Domestic rates only. Shoppers with a delivery address outside the United Arab Emirates won't see these options. More carriers and destinations are planned.

New here? Start with the Installation guide. For anything else, email info@codinative.com.