# Aramex

Floormode books Aramex labels on your own Aramex account: within your country (Overnight Parcel) and abroad (Priority, Value and Economy Parcel Express), with cash on delivery.

import DocUpdated from '~/components/DocUpdated.astro';

Floormode books Aramex labels on your own Aramex account: within your country
(Overnight Parcel) and abroad (Priority, Value and Economy Parcel Express), with cash
on delivery.

## On this page

- What you enter
- What Floormode books
- Test labels first
- See also

## What you enter

| Field | Where you find it |
|---|---|
| User name | the e-mail address of your aramex.com login with API access |
| Password | that login's password |
| Account number | your Aramex shipping account number (digits), on your contract or in your aramex.com account |
| Account PIN | the PIN Aramex issued with the account (digits) |
| Account entity | the three-letter code of your Aramex office, for example JNB (Johannesburg) or CPT |
| Account country | your account's two-letter country, for example ZA |

1. Ask your Aramex account manager to enable the Shipping Services API for your login,
   and for the account number, PIN and entity if you do not have them.
2. In Floormode, open **Settings → Shipping & carriers → Carriers & printing → Connect carrier →
   Aramex** and enter the six fields.

## What Floormode books

- One parcel per label, prepaid by your Aramex account, to the customer's door.
- **At home:** Aramex Overnight, priced by Aramex for your account.
- **Abroad:** Priority, Value and Economy Parcel Express, each priced by Aramex; a
  route Aramex does not serve with a product is not offered. The parcel carries its
  customs lines (HS code, value and origin of each product), and duties are paid by
  the recipient. Aramex builds the commercial invoice from those lines: print it from
  Aramex's portal and put it with the parcel.
- **Cash on delivery:** the amount and currency you enter for the order. Floormode
  shows the amount Aramex confirmed it will collect. Aramex pays the cash out to your
  account under your account's cash-on-delivery agreement.
- An insured value, when you enter one.
- The label as a PDF, and tracking from Aramex's updates.

Not offered: cancelling a label in Floormode (Aramex's API has no cancellation; ask
Aramex), pickups, returns and dangerous goods.

## Test labels first

Aramex runs a test system (ws.dev.aramex.net) with a public test account in its
Shipping Services API manual; ask Aramex for test credentials of your own, connect them
as a test account, and test labels cost nothing.

## See also

- [Carriers and packaging](/features/settings/carriers-and-packaging/)
- [Labels, printers and scanners](/features/settings/labels-printers-and-scanners/)

<DocUpdated date="2026-11-18" />