Shopify: return tracking code

About this article

This article describes how to configure return tracking codes on Shopify.

Table of contents

Introduction

Setup

Exporting shipments to ChannelEngine

Introduction

Some marketplaces, such as Zalando, OTTO Market, and About You, require a return tracking code with shipments. Shopify does not support return tracking codes as a standard field; therefore, use a metafield on Shopify to include a return tracking code with your shipments.

Setup

Either use an existing metafield on Shopify to store return tracking codes or create a new custom field on Shopify. Optionally, configure ChannelEngine to automatically create a new metafield for your return tracking code.

On Shopify

Creating a metafield

1. On Shopify, go to Settings, Custom, Data.
2. From the list of metafield definitions, select Orders.
3. Click Add definition to create a new metafield.
   
4. In the Name field, enter the name of the metafield. E.g.: Return Tracking Code.
5. In the Namespace and key field, enter the namespace and key, separated by a dot. E.g.: order.return_tracking_code. For the synchronization between Shopify and ChannelEngine to work, the values for namespace and key must match the settings on the Setup page of the Shopify plugin. 
6. Set the Field type to Single line text.
7. You can leave the remaining fields empty and click Save.

On ChannelEngine

To enable synchronizing a return tracking code with your shipments:

1. Go to the Setup step of your Shopify plugin.
2. Under Advanced settings, enable the Enable check for return tracking code setting.
   
3. Configure the following settings:
   • Return T&T metafield namespace - the namespace for the metafield used to submit return tracking codes on Shopify. To connect to the existing metafield, this must match the metafield namespace on Shopify. The number of characters must be between 3 and 255. You can use letters, numbers, hyphens, and underscores. E.g.: 'order'.

   • Return T&T metafield key - the key for the metafield used to submit return tracking codes on Shopify. To connect to the existing metafield, this must match the metafield key on Shopify. The number of characters must be between 3 and 64. You can use letters, numbers, hyphens, and underscores. E.g.: 'return_tracking_code'. 

     NB: if the specified metafield namespace or key does not match the existing metafield identifier on Shopify, ChannelEngine creates a new metafield based on the values you enter.
4. (optional) To enable ChannelEngine to automatically generate a metafield, configure the following setting:
   • Return T&T metafield name - the name of the metafield used to submit return tracking codes on Shopify. Only specify this if you do not already have a metafield for return tracking codes and want ChannelEngine to create a new one. If an existing metafield matches the namespace and key you provide, ChannelEngine uses that metafield.

Exporting shipments to ChannelEngine

After you or ChannelEngine create a new metafield, it is displayed at the order level on Shopify. When fulfilling an order, you must enter the return tracking code in the corresponding field. We recommend that you do this when you create a shipment on Shopify and not afterwards. Otherwise, a shipment without a tracking code cannot be exported to the marketplaces that require return tracking code information.

Make sure you follow the respective marketplace's return tracking code requirements to ensure that the marketplace accepts the shipment. If the marketplace requires a return tracking code for the type of carrier that you use, then provide one as soon as you create your shipment on Shopify.