> For the complete documentation index, see [llms.txt](https://docs.shipra.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shipra.io/ajex.md).

# AJEX

Integrating  Ajex 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 Ajex account with Shipra.

## Before You Start <a href="#before-you-start" id="before-you-start"></a>

Before you begin the integration, you will need to contact Ajex to obtain the following details:

* **Username**: The username associated with your Ajex account.
* **Password**: The password for accessing your Ajex account.

You can reach out to Ajex Services support team to get these parameters if they are not already available.

## Step-by-Step Integration <a href="#step-by-step-integration" id="step-by-step-integration"></a>

### Step 1 <a href="#step-1" id="step-1"></a>

Log in to your Shipra account at [app.shipra.io](https://app.shipra.io/).

### Step 2 <a href="#step-1" id="step-1"></a>

Go to Integrations -> Carriers

In the list of all carriers, search for Ajex

click on activate

<figure><img src="/files/y1DXB5BdKMH3rRVsbX00" alt=""><figcaption></figcaption></figure>

### Step 3 <a href="#step-3" id="step-3"></a>

Enter  Ajex Credentials

{% hint style="info" %}
You can activate same carrier multiple times with same credentials with different Nick Name
{% endhint %}

<figure><img src="/files/sVN82cHB1wWcWaA91bOr" alt=""><figcaption></figcaption></figure>

### Fill the Shipment Detail <a href="#step-3" id="step-3"></a>

<figure><img src="/files/sVN82cHB1wWcWaA91bOr" alt=""><figcaption></figcaption></figure>

**PickupMethod**

**Select one of them**:

* **DROP\_OFF**: The sender drops  &#x20;the parcel at AJEX Service  Centers.
* P**ICKUP**: The courier comes at  sender location to pick the  &#x20;parcel.
* **FULFILLMENT**: Customer has  &#x20;the items in AJEX warehouses&#x20;

**Payment Method**

**Select one of them**:

Currently supported option is

* **SENDER\_INSTALLMENT**:  &#x20;The sender pays in installments.

**Customer Account:** Account number provided by&#x20;AJEX for the Customer.

**Contact Type**

Select one of them:

* **INDIVIDUAL**
* **ENTERPRISE**

**Address Type**

Select one of them:

* **COORDINATES:** longitude and  &#x20;latitude pairs.
* **LOOKUP:** Address data that  &#x20;matches the addresses defined  &#x20;in AJEX system. AJEX address  &#x20;lookup can provided ofline.
* **FREE\_TEXT :**  Allows collecting  &#x20;free-text input from end users,  &#x20;which is not restricted to  &#x20;address lookup data. The API will  &#x20;try to match the System’s address  &#x20;definition if valid input is  &#x20;provided. The same fields that  &#x20;are used for LOOKUP can be  &#x20;used in the case of FREE\_TEXT.
* **NATIONAL\_ADDRESS: A** short  &#x20;national address that fully  &#x20;defines the location.

&#x20;**Weight:** The actual weight of the package itself.

**Quantity:** The actual quantity of the package.

**Fulfillment Time Option** 

Select one of them:

* **SAMEDAY**:When customer  &#x20;wants the order to be fulfilled  &#x20;within the same day.
* **NEXTDAY:** When customer  &#x20;wants the order to be fulfilled&#x20;  in the next day.
* **SCHEDULED:** When customer  &#x20;wants the order to be fulfilled  &#x20;(can pass any date in future).

**Service Name**

* **IN01:**  cash on  &#x20;delivery (COD) &#x20;

**Order Type**: Select one option from the list below.

* **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.

<figure><img src="/files/sVN82cHB1wWcWaA91bOr" alt=""><figcaption></figcaption></figure>

Upon successful integration, Shipra will automatically configure a **webhook** to receive status updates from Ajex 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**
