# How to set up a Rakuten Order connection?

The Rakuten order connection deviates from other order connections in a couple of points: the setup and the use of tracking URLs. This guide will explain what you need to set up to properly work with the Rakuten order connection.

{% hint style="info" %}
Note I: This service only works when you have a Professional account at Rakuten.

Note II: The order connection retrieves all open orders, we don't filter by country. That means that an order connection with Rakuten picks up all orders in one specific seller account, regardless of which country the order comes from.
{% endhint %}

### Set SKU as an internal reference in your Rakuten feed

Unlike most order connections, the Rakuten order connection doesn't use the `id` field to match the orders with your products in your backend. Instead, Rakuten uses the `SKU` field as the main identifier for your products. Therefore, you need to map the internal product ID of your backend to the `SKU` field in the " *Finalize*" step (which can be, for example, the `id` field) for the orders to match the products in your backend:

<figure><img src="/files/60491ded6c2fe95d69b5e1d1aa4fba22df3b46af" alt=""><figcaption></figcaption></figure>

### Copying an API token

To create a connection with Rakuten, you will require an API token. The API token is the standard authentication system of the Rakuten API, so to be able to connect Channable with the Rakuten API system, you will need to copy this API token from your Rakuten seller account. To copy this token, follow these steps:

{% stepper %}
{% step %}

### Go to your account settings

In your Rakuten seller account, go to "Mon compte" (my account).
{% endstep %}

{% step %}

### Open developer information

Click on "Mes informations développeur" (my developer information).
{% endstep %}

{% step %}

### Copy the API token

From this page you can copy the API token.
{% endstep %}
{% endstepper %}

### Creating the connection

Once you copied the API token, you can set up the actual connection in Channable. Under Setup > Setup Orders, click on setup orders and then "add a new connection". On this page, fill in a name for your order connection under "label".

<figure><img src="/files/36ae5474ffbd6be88c2a5eacd525bd32ef88a143" alt=""><figcaption></figcaption></figure>

For the "login", you use the name of your Rakuten account, not the email that is used to log in, as this won't be accepted by Rakuten. You can find the name of your account in your user banner:

<figure><img src="/files/25e532bb5b3037bce1fa02bf40d6c42f45f4a22c" alt=""><figcaption></figcaption></figure>

Finally, paste the Token that you copied earlier under "Token".

Once this connection is created, you can follow the steps on this page to create the order connection: [Broken mention](broken://pages/ae2d9141823caba4f23da5e58752fe1dc07814d9). After that, you can contact our Technical support department to request a test order.

{% hint style="warning" %}
We cannot support the "In-store pickups" feature from Rakuten. If the shipping type in the order is "in-store pickup" (or "retrait chez le vendeur"), we will filter these orders out.
{% endhint %}

### Rakuten Tracking URLs: Supported Transporters

Rakuten is one of the few marketplaces that does not accept an order without a tracking URL, which means that we will have to generate the URL ourselves. We do not know what tracking URLs look like for all logistics providers, thus it is important to check with our support department to see if your transporter is already supported.

If you don't check with support and your transporter is not supported, you will see an error message about it in your order status!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/orders/order-connections/how-to-set-up-an-order-connection/how-to-set-up-a-rakuten-order-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.