Saleor
Saleor (opens in a new tab) 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
In order to integrate 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). |
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
To integrate an existing system with Saleor:
- Navigate to Data map → View Systems and choose the system that you want to connect.
- Click on the Integrations tab.
- Pick the vendor or system type that you want to integrate with from the Connection type drop-down menu.
- 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.
Technical detail
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
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) | Retrieves draft order information associated with an email. |
| Access Requests | Orders (opens in a new tab) | Retrieves order information associated with an email. |
| Update Requests | Orders (opens in a new tab) | Updates order information. |
| Access Requests | User (opens in a new tab) | Retrieves user account details based on email. |
| Update Requests | User (opens in a new tab) | Updates user account details. |
| Access Requests | Addresses (opens in a new tab) | Retrieves address information associated with a user. |
| Update Requests | Addresses (opens in a new tab) | Updates address information. |