What this guide covers
The bits that are specific to Aramex — its services, its label, and the errors it sends back. Aramex is one of the carriers behind myWork's shared courier screens, not a separate way of working.
Read Couriers & Waybills first. It covers where the Book courier and Record waybill buttons live, when a document may be couriered, direction, tracking and printing. All of that is identical for every carrier. This page only adds what is different about Aramex.
Choosing Aramex
Pick it as the carrier in the Book-courier wizard, or ask for a comparison in Courier Tools → rate calculator and choose from the quotes.
Aramex supports the full set: rating, booking, scheduling a collection, tracking and a printable label.
Services
- PEX — Road Express. The default, and right for most domestic parcels.
- ONP — Overnight delivery.
- EMD — Early morning delivery.
- SMP — Same day shipment.
- PEC — Economy.
Leave it on the account default unless you have a reason. Same-day and early-morning cost meaningfully more and are not available everywhere — if a service is not offered to that address the quote comes back failed for that code only, and the others still show.
Parcels
Aramex rejects a waybill if any parcel is missing a height, length or width, or has one set to zero. myWork sizes parcels from each product's stored dimensions, so this normally takes care of itself — but a product with nothing recorded falls back to a default box. For anything bulky, check the sizes on the booking screen before you submit: carriers bill on volumetric weight, so a wrong box size shows up on the invoice, not in an error.
The waybill and the collection
A successful booking returns two references:
- the waybill number, which starts
LAR…— the parcel; - the collection reference, which starts
D…— the pickup.
Both are stored on the consignment, alongside myWork's own WB-… reference. Searching the Waybills list on any of them finds it.
The collection is a separate call to Aramex, made straight after the waybill. It can fail on its own — you will see a warning saying the waybill was created but the collection was not. The parcel is still booked; either retry, or phone the pickup in.
The label
Print waybill on the consignment gives you Aramex's own PDF — Download it, or send it to a LAN printer with Print via service.
The PDF is served by Aramex and needs no login: anyone who knows the waybill number can fetch the label. Treat the number as sensitive, and don't paste it into public threads.
Common errors and fixes
Aramex's own message is shown verbatim, so the text varies. The frequent ones:
- "Dimensions of a parcel is not complete" — a height, length or width is missing or zero. Fill all three on every parcel.
- Invalid postal code — the postal code doesn't match the suburb or city. Verify the receiver address; Aramex is strict about the pairing.
- Account suspended — Aramex has put the account on hold, normally a billing matter. Nothing to fix on the parcel; escalate it.
- Phone number format — strip spaces, dashes and the country code from the contact number and resubmit.
- Service unavailable for destination — the chosen service doesn't reach that area. Fall back to PEX.
- Failed to create waybill — nothing was booked. Fix the field it names and try again.
- Failed to book collection — the waybill was created; only the pickup wasn't. See above.
A refusal is always shown with Aramex's reason on the record. If the failure is a network timeout rather than a refusal, retrying is safe — myWork will not book the same parcel twice.
Tips and gotchas
- Credentials live in Courier Accounts, not in the code. An admin rotates them at Procurement & Logistics → Couriers → Courier Accounts on the Aramex row; no redeploy, and nobody else needs to know them.
- The default sender address comes from that same account row. If our branch address changes, change it there — every carrier's bookings read from it.
- Addresses are assumed South African. Cross-border parcels need extra setup; talk to whoever manages the account before promising a customer an international delivery.
- Insurance is off unless you tick it. The insured value is ignored until you do.