> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eykdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Returnista

> Connect your Returnista account to Eyk with an API key, so your returns, return reasons and outcomes land in BigQuery.

> [!NOTE]
>
> The Returnista source is currently in beta. Ask your Eyk contact person for access.

Connect Returnista to Eyk to collect your returns, their reasons and their outcomes.

## What Eyk builds from this data

Eyk copies what happens after checkout into your own BigQuery project: shipments, returns and stock. BigQuery is the data warehouse Eyk sets up for you. Data from all your warehouses and returns platforms lands in the same tables.

| Table in BigQuery | What it holds |
| - | - |
| `fact_return_items` | Every returned product, with its return reason and outcome |
| `fact_logistics` | Each step of an order after checkout, from warehouse intake to delivery |
| `fact_stock_levels` | Your stock per warehouse and product over time |
| `dim_stock_locations` | The warehouses that hold your stock |

In Canvas and Alvin AI, these tables show up as **Returns**, **Logistics**, **Stock** and **Stock Locations**. Eyk links each return and shipment to its order from your store platform, so connect that too. To open your BigQuery project, click **Google BigQuery** at the bottom of the Eyk sidebar.

Returnista sends returns only, so it fills `fact_return_items`.

## Before you start

You need:

* The Account admin role in the Returnista Merchant App.
* Access to the **Sources** page in Eyk.

Setup has two parts. First you copy your Account ID and create an API key in Returnista. Then you enter both in Eyk.

## Part 1: Get your Account ID and API key from Returnista

**1. Open Account settings**

In the Returnista Merchant App, open **Account settings**.

**2. Copy your Account ID**

Copy the Account ID from the account overview. You need it in Part 2.

**3. Create an API key**

Open the **API keys** tab and click **Create API key**.

**4. Copy the API key**

Copy the key right away. You need it in Part 2.

> [!WARNING]
>
> Returnista shows the key only once. If you lose it, create a new key.

## Part 2: Add the source in Eyk

**1. Open the source library**

In Eyk, go to **Sources** and click **Add new source**.

**2. Select Returnista**

In the **Data source library**, click **Add** next to **Returnista**.

**3. Enter your account details**

Enter the Account ID under **Account ID** and the key under **API key**.

![Returnista source form in Eyk with the Account ID and API key fields](https://mintcdn.com/eyk-data/bLMX2sfOr9PtO8G_/images/sources/returnista-eyk-form.png?fit=max\&auto=format\&n=bLMX2sfOr9PtO8G_\&q=85\&s=66da51c9c786c8917d3c190151bd39c8)

**4. Add the source**

Click **Add source**.

## Check it worked

In Eyk, go to **Sources**. Returnista is in the list with the text **Your data source is connected.** Eyk updates your BigQuery tables every night.

## Troubleshooting

> [accordion] Returnista shows Attention needed
>
> Open the Returnista source in Eyk and check the Account ID and API key. If the key no longer works, create a new key in Returnista and enter it there.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.