Help Desk
العربية
Go to dashboard

Connect your Aramex account

If you have your own e-commerce contract with Aramex, you can connect it to Zid through custom shipping. Shipping labels are then issued under your Aramex account and rates, and you decide which cities customers see Aramex in and what they pay. Start from the Custom shipping card on the Logistics page.

Custom shipping isn't included in every Zid plan. Without it, the Custom shipping card offers an upgrade instead of Add option. Staff members need the Zid Ship view or settings permission, and the store needs at least one inventory location to ship from.

Your own Aramex account or Aramex through Zid Ship

You can also ship with Aramex without a contract of your own, as a Zid Ship method. Pick the one that fits how you work:

Your own Aramex accountAramex through Zid Ship
ContractYour e-commerce contract with AramexNone with Aramex: one agreement with Zid
SetupEnter five account details from Aramex in ZidSelect Activate on the Aramex method
What you payYour contract rates; Aramex bills you directlyThe method's rate, deducted from your Zid wallet or a label package
What customers payThe prices you set per zoneThe method's default price, or your own prices per zone
Cash on deliveryDepends on your Aramex contractOn methods that support it; Zid charges the COD fee and settles the cash to you
ServicesThe Aramex method you connectPickup from your location (Standard), branch drop-off (Economy), heavy shipments (Care Required) and the Gulf (International)
Cancel a labelWith AramexFrom the order's page in Zid. See Cancel a shipping label.

Choose your own account when you already ship enough with Aramex to have negotiated rates. Otherwise Zid Ship is quicker to start with. See Zid Ship shipping methods.

What you need first

  • An e-commerce account with Aramex, opened under a contract with Aramex. Zid doesn't issue Aramex accounts.

  • Five details from that account, listed below. If you're missing one, ask your Aramex account manager or Aramex's support.

DetailWhere it comes from
Account numberYour Aramex account
Account PINYour Aramex account, with the account number
EntityThe city code of your Aramex account, such as RUH, JED or DMM
UsernameThe username you sign in to Aramex with, usually your email
PasswordThe password for that username

Connect Aramex to Zid

  1. On the Logistics page, in the Custom shipping card, select Add option.

  2. On Manage custom shipping methods, in the Shipping method details card, choose an Aramex method in Shipping method. The Aramex fields appear.

  3. Fill in the fields below.

  4. Select Activate.

FieldWhat to enterRule
Shipping methodThe Aramex method you want to offerRequired
EntityYour account's city codeRequired
UsernameYour Aramex usernameRequired
PasswordYour Aramex passwordRequired
Account PINYour Aramex account PINRequired
Account numberYour Aramex account numberRequired

Shipping method can list more than one Aramex method, such as one for the Gulf and one for international shipping. Each method you connect keeps its own account details.

Zid saves the account and opens the method's page, titled with its name. If the button at the top reads Activate, select it so customers can see Aramex at checkout. Activation fails if Aramex doesn't serve the inventory you ship from; the message names the inventory.

Manage custom shipping methods with an Aramex method chosen and its Entity, Username, Password, Account PIN and Account number fields
Sample data from a demo store.

Check the connection

Zid has no separate test button. To check that Aramex is connected:

  1. Open View all in the Custom shipping card. The Aramex method is listed with the Status Active.

  2. The Cash on delivery column shows whether you can offer cash on delivery with this method.

  3. Issue a label for your next Aramex order (see below). If the label is issued, your account details work.

Set zones and customer prices

Customers see Aramex only in the cities of your zones, and pay the price you set for each zone.

  1. On the method's page, in Shipping zone customization, select Add shipping zone.

  2. Enter a Zone name and select the zone's cities.

  3. Under Customer price, choose Flat rate or Weight-based pricing and enter the prices.

  4. If the method supports cash on delivery, turn on Cash on delivery (COD) and enter the COD rate customers pay.

  5. Select Save.

The zone table appears once the method is active. For every field, and how to pause, edit or delete a zone, see Set shipping zones and prices. An international Aramex method has no zone table: you edit the price of each destination zone instead, as described in International methods. For how customers pay on delivery, see Offer cash on delivery.

Issue labels and track shipments

You issue Aramex labels from each order, the same way as with any shipping company:

  1. Open the order and select Issue shipping label on the shipping company card. The order moves to Ready and the label is issued under your Aramex account.

  2. Select Manage shipment > Print label to print it.

  3. Select Manage shipment > Order tracking to open Aramex's tracking page in a new tab. You can also send the tracking number on the card to your customer.

Aramex bills you for these shipments under your contract; they don't appear in Zid's wallet or Transactions log. To cancel a label, cancel it with Aramex. See Issue a shipping label and Manage the shipment.

Update your account details or turn Aramex off

Open the method's page from View all in the Custom shipping card, then select View. The Password and Account PIN show as asterisks after you save them.

  • To change a detail, edit the field, entering a new password or PIN over the asterisks, and select Update. Leave the asterisks as they are to keep the saved values.

  • To stop offering Aramex, select Deactivate and confirm. It disappears from checkout immediately.

  • To offer it again, select Activate.

If Aramex labels aren't issued

When you can't mark an order Ready, or no label is issued for an Aramex order, the cause is usually your Aramex account. Check that:

  • the account number, PIN and entity are the ones on your Aramex contract, and the entity is your account's city code;

  • the username and password still sign you in to Aramex; if you changed your Aramex password, update it in Zid too;

  • Aramex has activated your e-commerce account and API shipping on it.

Then correct the details on the method's page and select Update. If labels still aren't issued, contact your Aramex account manager.

Did this article solve your problem?
Your answer helps us see what needs improving.

Still need help?

Our customer service team is ready to help, or find quick answers in the FAQ.

Contact usRead the FAQ