# How to set up an OTTO order connection

OTTO order connections have specific setup requirements that set it apart from other marketplaces.

In this article, you’ll learn how to set up an OTTO order connection in Channable.

* If you’re looking for information on how to set up a standard order connection, [refer to our general order connection set up guide](/list-advertise/orders/order-connections/how-to-set-up-an-order-connection.md).

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> Before you start

**You’ll need**

* The **Order Sync** add-on enabled
* An existing OTTO channel set up in your Channable project

### Create and configure your OTTO order connection

OTTO requires additional shipping information for their orders.

{% stepper %}
{% step %}

### Set up an OTTO connection

1. Go to **Setup > Order connections**.
2. Click **Add connection**.
3. Select your webshop platform and your OTTO channel.
4. Fill in the following fields:
   * **Name**: Add a descriptive name for your order connection (e.g. OTTO DE orders).
   * **Shipping from city**: Enter the city you’re shipping from.
   * **Shipping from country**: Enter the country code of the country you’re shipping from.
5. Click **Save**.

Country code examples:

| Country         | Code |
| --------------- | ---- |
| Germany         | DEU  |
| The Netherlands | NLD  |
| France          | FRA  |
| United Kingdom  | GBR  |
| Belgium         | BEL  |
| Spain           | ESP  |
| Italy           | ITA  |
| Sweden          | SWE  |
| Poland          | POL  |

{% hint style="warning" %}
**Important:** Orders won’t be fully processed until you add tracking information. This includes providing a return tracking number.

* If you have [a compatible web shop](broken://pages/4581cf2f933a8a9633896635f08527ac18507194#option-1-automate-sending-tracking-number-via-web-shop), you can set it up to automate this step.
* If not, you’ll need to [manually add tracking details in Channable after each order](broken://pages/4581cf2f933a8a9633896635f08527ac18507194#option-2-manually-update-tracking-number-in-channable).
  {% endhint %}
  {% endstep %}

{% step %}

### Add tracking information

To process OTTO orders successfully, you must provide both a tracking number and return tracking number for each order. OTTO requires this information to confirm shipments, even if a customer decides not to return their order.

You can configure this in two ways:

* Automatically submit return tracking codes using a compatible webshop
* Manually enter these details in Channable after each order

This article explains both methods of setting this up.

### <i class="fa-circle-1">:circle-1:</i> Option 1: Automate sending tracking number via web shop

If you’ve connected one of the following webshops to Channable, you can set them up to automatically fetch return tracking numbers. Select your platform below and follow the instructions provided.

<details>

<summary>Shopware 5</summary>

To set up a return tracking field in Shopware 5:

1. Go to **Configuration > Free Text Field Management.**
2. Select the option to add a new text field to the **Orders**(s\_order\_attributes) table.

   <figure><img src="/files/bc184b1368a834d6c78bbd7aabd1b00869379e41" alt=""><figcaption></figcaption></figure>
3. Check that **Display in Backend** is selected so it appears in the order overview.
4. Click **Save**. It will appear at the bottom of the **Overview** tab in the **Order details** section.

   <figure><img src="/files/34ae99ab0a62653bb4ba5f1fe638b1587c79f848" alt=""><figcaption></figcaption></figure>
5. The field name to use when retrieving this data is **returnTrackingCode**, despite setting it as **return\_tracking\_code** during creation.

</details>

<details>

<summary>Shopware 6</summary>

To add a return tracking code in Shopware 6:

1. Go to **Settings > System > Custom Fields**
2. Click on **Add Set** to create a new set named: **Return tracking code**.

   <figure><img src="/files/aba996212e9b1b9b8811611173375e98c15f4d4a" alt=""><figcaption></figcaption></figure>
3. Inside the new set, create a new text custom field.

   <figure><img src="/files/c99f27f89b552e3cb3826e4a7d63604459a72580" alt=""><figcaption></figcaption></figure>
4. For **Technical name**, fill in “return\_tracking\_code”.
5. For **Label**, fill in “Return tracking code.”
6. Click **Save**. This custom field will now be available at the bottom of the order details page to fill in.

   <figure><img src="/files/065cb847ca46939212209b147c688bb54c04f683" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>WooCommerce</summary>

To add a return tracking code in WooCommerce:

1. In your WordPress dashboard, go to **WooCommerce > Orders**.
2. Select the specific order to which you want to add a return tracking code to.
3. Locate the **Custom fields** section within the order details page.\
   Note: The appearance and location of this section may be different depending on your WooCommerce version and any installed plugins.

Create a new custom field. For **Name**, enter “return\_tracking\_code”. For **Value**, enter the return tracking code.

<figure><img src="/files/60154b9c2b2c99a8646591bd3ba24c67143d6e38" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Shopify</summary>

To add a return tracking code in Shopify:

1. In your Shopify account, go to **Metafields.**
2. Select the **Orders** section to add a new metafield to orders.
3. Create a new metafield and name it “Return tracking code”.
4. Set the type to **Single line text** and ensure it's configured to accept a single value. This metafield will then be accessible for each order, allowing to input the return tracking code directly within the order's details.

<figure><img src="/files/8f8dcda2bb0812722b7ec11a7d60525596e6dc7c" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/f80e14b4086c020990a7863c6962d1cbdbf78acd" alt=""><figcaption></figcaption></figure>

To retrieve this information programmatically, make a GET request to the *orders/{order\_id}/metafields.json* endpoint.

{% hint style="info" %}
**Note:** This endpoint might not be listed in the official Shopify documentation but has been verified to work for accessing order metafields, including the return tracking code.
{% endhint %}

</details>

<details>

<summary>Magento</summary>

To add a return tracking number in Magento:

1. In your **Magento** account, enable **Return Labels** in the plugin and configure Regexp as follows:

   <figure><img src="/files/6cb0a936ae5d3893a558a650d33574679d492579" alt=""><figcaption></figcaption></figure>
2. Fill in the information required:
   * For **Title**, put the value from the **Title should contain** field (from the 'Return Labels' configuration)
   * For **Number** fill in the return tracking key.

     <figure><img src="/files/d54fc397cf3d11f8b264b2f1a354bb926c8c8d24" alt=""><figcaption></figcaption></figure>

</details>

### <i class="fa-circle-2">:circle-2:</i> Option 2: Manually update tracking number in Channable

If your import platform doesn’t support automated return tracking codes, prepare them and submit them in Channable to send them to OTTO.

After a customer places an order on OTTO:

1. Channable will automatically import the order into your order processing system.
2. Prepare a tracking code for your order and a return tracking code in your system.
3. In Channable, open the project containing your **\[your Otto channel]** and go to **Orders**.
4. In the **Processed orders** tab, click the unprocessed order and select **Shipment confirmation**.
5. Fill in the information requested:
   * For **Tracking code**, add the tracking code of your customer’s order.
   * For **Transporter** (optional), select the postal carrier responsible for delivering the order.
   * For **Return tracking code**, fill in the prepared return tracking code if the customer decides to return their order.
   * For **Return transporter**, select the postal carrier responsible for returning the order.

{% hint style="info" %}
**Note**: OTTO only accepts DHL, GLS, or Hermes.
{% endhint %}

6. Click **Send shipment confirmation**.

<figure><img src="/files/d8b6be212a48f93d17e2f6f4176d61d289d5b3c9" alt=""><figcaption></figcaption></figure>

Channable will update the information for the order to include the required tracking information.
{% endstep %}
{% endstepper %}

### Processing returns&#x20;

If you receive a return, you must notify OTTO by creating a return.

1. Go to **Orders** and click on the order you want to create a return for from the list.
2. Click **Process return**.

<figure><img src="/files/ZVA0v5TMt5r7rTarufdU" alt=""><figcaption></figcaption></figure>

3. Select the products you want to return.&#x20;

<figure><img src="/files/BNaisaasu9FqZS4oSHDC" alt=""><figcaption></figcaption></figure>

4. Click **Process return**.


---

# 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-an-otto-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.