# Aramex
Integrating Aramex with Shipra allows you to seamlessly manage shipments, automate tracking, and streamline the delivery process. This guide will walk you through the steps to integrate your Aramex account with Shipra.
## Before You Start
Before you begin the integration, you will need to contact Aramex to obtain the following details:
* **Account Number**: Your unique identifier for your Aramex.
* **Username**: The username associated with your Aramex account.
* **Password**: The password for accessing your Aramex account.
You can reach out to Aramex Services support team to get these parameters if they are not already available.
## Step-by-Step Integration
### Step 1
Log in to your Shipra account at [app.shipra.io](https://app.shipra.io/).
### Step 2
Go to Integrations -> Carriers
In the list of all carriers, search for Aramex
click on activate
### Step 3
Enter Aramex Credentials
{% hint style="info" %}
You can activate same carrier multiple times with same credentials with different Nick Name
{% endhint %}
### Fill the Account Details
* **Account Number**: Your unique identifier for your Aramex.
* **Username**: The username associated with your Aramex account.
* **Password**: The password for accessing your Aramex account.
* Version :Based on the WSDL version the user is using to
invoke the web service.
* **Account PIN:** A key that is associated with the account
number, so as to validate customer identity.
* **Account
Country
Code:** Two-letter code identifying the Country.
* **Source:** A value will be provided by
aramex.
### Fill the Order Details
**Product Types**
**Select one of them:**
| **Name** | **Stands For** | **Full Description** |
| -------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| PDX | Priority Document Express | Urgent, time-sensitive consignments containing printed matter or document material |
| PPX | Priority Parcel Express | Urgent, time-sensitive consignments containing non-printed matter or non-document material |
| PLX | Priority Letter Express | Urgent, time-sensitive consignments containing printed matter of weight less than 0.5 kg |
| DDX | Deferred Document Express | 2nd Day Delivery consignments containing printed matter or document material |
| DPX | Deferred Parcel Express | 2nd Day Delivery consignments containing non-printed matter or non-document material |
| GDX | Ground Document Express | Ground delivery consignments containing printed matter or document material |
| GPX | Ground Parcel Express | Ground delivery consignments containing non-printed matter or non-document material |
| EPX | Economy Parcel Express | Non-document/printed matter (commercial) shipment irrespective of weight. "Economy" refers to selling products/services online with Aramex handling delivery |
**Payment Type**
**Select one of them:**
| **Payment Method** | **Stands For** | **Description** |
| ------------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **P** | Prepaid | Transportation charges payable by the **shipper** |
| **C** | Collect | Transportation charges payable by the **consignee** |
| **3** | Third Party | Transportation charges payable by a **third party**. Note: All third-party details must be completed, including a valid Aramex Account Number for the billing party. |
**Product Type International : Select the same as Product Types.**
**Payment Type Import: Select the same as Payment Type**.
**Pickup with Shipment**
**select one:**
**True**: A pickup request **is created** along with the shipment. The courier will be dispatched to collect the shipment from the sender.
False: A pickup request **is not created** with the shipment. The sender must schedule a pickup separately or drop off the shipment manually.
Product Group
**Select one of them:**
* **EXP** = Express
* **DOM** = Domestic
**Order Type**
Select one option:
* **Order No** – *Select if you do **not** have a reference number.*
* **Ref No** – *Select if you **do** have a reference number.*
Once you have entered these credentials, click **Activate** to link the two systems.
Upon successful integration, Shipra will automatically configure a **webhook** to receive status updates from Aramex Status. This ensures that tracking and delivery statuses are updated in real-time on Shipra, allowing you to stay informed about the progress of each shipment without any manual intervention.
No additional setup is required for **webhooks**
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.shipra.io/aramex.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.