# Saleor

This Integration requires Fides Cloud or Fides Enterprise. For more information, [talk to our solutions team. (opens in a new tab)](/content/speak-with-us?utm_source=docs-site/index.html)

[Saleor (opens in a new tab)](https://saleor.io/) is an open-source e-commerce platform featuring a GraphQL API for flexible data handling across e-commerce functions like products, orders, and payments.

## Prerequisites [Permalink for this section](/content/docs/integrations/saas-integrations/saleor#prerequisites/index.html)

In order to [integrate](/content/docs/integrations/index.html) with Saleor, you'll need to collect the following information:

| Name | Description |
| :-- | :-- |
| **Domain** | The unique URL for your Saleor instance (e.g., `your-store.saleor.cloud`) |
| **API Key** | Your Saleor API key. [Refer to Saleor documentation for instructions on how to generate an API key (opens in a new tab)](https://docs.saleor.io/api-usage/authentication). |

Your Saleor access token will need the following permission: `MANAGE_USERS`, `MANAGE_ORDERS`

To avoid the disruption of order information the Saleor integration will not mask orders unless their status is one of the following: RETURNED, PARTIALLY_RETURNED, FULFILLED, CANCELED, or EXPIRED. If an order does not have one of these statuses, an error will be returned. The DSR can be reprocessed once the order reaches a compatible status.

## Integrating with Saleor [Permalink for this section](/content/docs/integrations/saas-integrations/saleor#integrating-with-saleor/index.html)

To integrate an existing system with Saleor:

1. Navigate to **Data map** → **View Systems** and choose the system that you want to connect.
2. Click on the **Integrations** tab.
3. Pick the vendor or system type that you want to integrate with from the **Connection type** drop-down menu.
4. Complete the required fields for the integration and click **Save**.

You may confirm your connection is working using the **Test connection** button, if desired.

To learn more, please see our guide for [Managing Integrations](/content/docs/integrations/guides/manage-integrations/index.html).

## Technical detail [Permalink for this section](/content/docs/integrations/saas-integrations/saleor#technical-detail/index.html)

Fides utilizes _API endpoints_ to access the _API service_ for a SaaS application. An _API service_ is the programmatic interface through which Fides can query and update data within an application to access, rectify, or delete personal information. Each SaaS tool will have a unique set of endpoints to enable privacy functions.

### Saleor endpoints [Permalink for this section](/content/docs/integrations/saas-integrations/saleor#saleor-endpoints/index.html)

In the table below, you can find which endpoints are used for each type of privacy function. The Saleor integration uses GraphQL queries.

| Privacy function | Endpoint | Description |
| --- | --- | --- |
| **Access Requests** | [Draft Orders (opens in a new tab)](https://docs.saleor.io/api-reference/orders/queries/draft-orders) | Retrieves draft order information associated with an email. |
| **Access Requests** | [Orders (opens in a new tab)](https://docs.saleor.io/api-reference/orders/queries/orders) | Retrieves order information associated with an email. |
| **Update Requests** | [Orders (opens in a new tab)](https://docs.saleor.io/api-reference/orders/mutations/order-update) | Updates order information. |
| **Access Requests** | [User (opens in a new tab)](https://docs.saleor.io/api-reference/users/queries/user) | Retrieves user account details based on email. |
| **Update Requests** | [User (opens in a new tab)](https://docs.saleor.io/api-reference/users/mutations/customer-update) | Updates user account details. |
| **Access Requests** | [Addresses (opens in a new tab)](https://docs.saleor.io/api-reference/users/queries/user) | Retrieves address information associated with a user. |
| **Update Requests** | [Addresses (opens in a new tab)](https://docs.saleor.io/api-reference/users/mutations/address-update) | Updates address information.