# Integration with a Third Party Using the API

> Source: https://help.getedara.com/en/articles/8113059-integration-with-a-third-party-using-the-api · Category: Extensions Store › Custom integration (API) · Last updated: 2026-05-04 · العربية: https://help.getedara.com/ar/articles/8113059-%D8%A7%D9%84%D8%B1%D8%A8%D8%B7-%D9%85%D8%B9-%D8%B7%D8%B1%D9%81-%D8%AB%D8%A7%D9%84%D8%AB-%D8%A8%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-%D8%A7%D9%84%D9%80-api

If you manage a store inside a mall, the mall management may need to track sales orders of each store. To achieve this, you can integrate Edara with the mall’s system to instantly share sales order data.

## Integration with a Third Party Using the API

Follow these steps to complete the integration:

### 1. Create an Integration User (Token) in “Edara”

1. Go to “Data”.
2. Open the “Integration” page
3. Click on “ **Manage”** under “Rest APIs”.
4. Click on “ **Add New User”.**
5. Enter a description (name) for the integration user (Token).
6. Grant the following permissions: “ **Get Warehouse by Name”** and **“Return a list of sales documents by specific criteria** ”
7. Click on **“Save”** .

![1. Create an Integration User (Token) in “Edara” — Click on “Save”.](https://help.getedara.com/images/integrations/8113059/01.en.gif)

> **Note:** This user is created exclusively for API integration and cannot be used to log in to the Edara application.

### 2. Grant User Permissions for Warehouse and Items

The integration user (Token) must have permissions to access the warehouse and items. To configure this, refer to the following articles:

1. [Granting\ Revoking a Warehouse Access Permission](https://help.getedara.com/en/articles/5244387-granting-revoking-a-warehouse-access-permission) (for the branch you want to integrate)
2. [Granting\ Revoking Data Access Permission](https://help.getedara.com/en/articles/5244360-granting-revoking-data-permissions)

![2. Grant User Permissions for Warehouse and Items — Granting\ Revoking Data Access Permission](https://help.getedara.com/images/integrations/8113059/02.en.gif)

> **Notes:**
>
> - Before performing the following steps, make sure you have an [API endpoint testing tool](https://www.postman.com/downloads/) .
>
> - When adding the authorization token, ensure it is of type “Bearer”, then make sure to remove the word Bearer from the token itself. Also, verify that there are no extra spaces at the beginning or end.

![2. Grant User Permissions for Warehouse and Items — Granting\ Revoking Data Access Permission](https://help.getedara.com/images/integrations/8113059/03.en.gif)

### 3. Retrieve the Warehouse ID

The first step the third-party developer needs to perform is retrieving the warehouse ID. To do this, they will need:

1. The warehouse name as it appears in Edara
2. The endpoint: “ [Return a Warehouse by Name](https://api.edara.io/swagger/ui/index#tag/Warehouse/operation/GetStockItemByCode) ”

Example endpoint call:

[https://api.edara.io/v2/warehouses/FindByName/Main](https://api.edara.io/v2/warehouses/FindByName/Main)

The response will return the warehouse ID based on the provided warehouse name.

![3. Retrieve the Warehouse ID — The response will return the warehouse ID based on the provided warehouse name.](https://help.getedara.com/images/integrations/8113059/04.gif)

### 4. Retrieve Sales Orders via API

When calling the API, make sure to include the following parameters:

1. Warehouse ID (Required): Integer
2. Date From (Required): Date-time string (e.g., 2020-01-08T00:00:00.00Z)
3. Date To (Required): Date-time string (e.g., 2020-01-08T00:00:00.00Z)
4. Document Type: SO, SR, or NULL

API Sample:

[https://api.edara.io/v2/salesOrders/Find?warehouseID=1&limit=10&dateFrom=2022-08-23T00:00:00.00Z&dateTo=2022-08-24T00:00:00.00Z&offset=0](https://api.edara.io/v2/salesOrders/Find?warehouseID=1&limit=10&dateFrom=2022-08-23T00:00:00.00Z&dateTo=2022-08-24T00:00:00.00Z&offset=0)

![4. Retrieve Sales Orders via API —…](https://help.getedara.com/images/integrations/8113059/05.en.gif)

> **Important Notes:**
>
> - The maximum limit for retrieving sales orders is 1000 transactions per call.
> - Service-only documents cannot be retrieved using this endpoint.
> - If the Response Code is not 200 when calling the API, check the API URL, ensure the authorization token is entered correctly, and verify that the integration user has the required permissions.
> - You can access more endpoints through the [Integration Support Center.](https://api.edara.io/swagger/ui/index)

## Frequently asked questions

**Can the integration user log in to “Edara”?**

This user is created exclusively for API integration and cannot be used to log in to the Edara application.

**What is the maximum number of orders per call?**

The maximum limit for retrieving sales orders is 1000 transactions per call.