Connecting Returnless

Returnless is a returns portal. With the connection, Stockhub fetches the returns your customers register in Returnless as returns in Stockhub. Once the warehouse has processed the return, Stockhub reports the result back to Returnless. You create the connection yourself in the customer portal.

Creating an API key in Returnless

1. Log in to your Returnless environment.
2. Open the Integrations menu and click the API keys tab.
3. Click Create API key. Fill in a name, for example Stockhub, and choose the responsible Team member.
4. Copy the key.

More information from Returnless: https://support.returnless.com/article/1077-api-keys

Creating the connection in Stockhub

1. In the menu, go to Integrations > External connections.

2. Click Add External Connection. The Add External Connection window opens.

3. Choose Returnless.

4. Under Authorisation, fill in a name in the Channel field, for example Returnless. Paste the key from Returnless into API Key.

   

5. Click Test connection. You first see Connecting and then Connected. If you see Connection failed, check the key.

6. Click Next. Under Configuration, the window tells you that Returnless needs no extra configuration.

7. Click Save.

What the connection does

Stockhub synchronises with Returnless every five minutes.

• Fetching returns: Stockhub fetches new returns from Returnless. Test returns from Returnless are skipped. Each return gets the letter R followed by the order number as its reference, for example R1001. If the original order with that order number is in Stockhub, the return is linked to it.
• Products by SKU: Stockhub links each item of the return to the product with the same SKU. An item whose SKU is not in Stockhub is skipped. If no item is found at all, the return does not come into Stockhub. So make sure the SKUs in Returnless and Stockhub are the same.
• Once only: a return that is already in Stockhub is not fetched again. If you change the return in Returnless afterwards, Stockhub does not take that over.
• Result back to Returnless: as soon as the warehouse has handled a return line, Stockhub sends Returnless how many items were received and how many go back into stock. Rejected items count as received, but not as back in stock. Stockhub adds a note with the result and the warehouse's remark. Your customer does not see that note.
• Approving the return: when all lines of the return have been handled and the return is still in the request stage in Returnless, Stockhub approves the return in Returnless.

You see the returns in Stockhub in the overview of your returns.

Changing the settings later

In the External connections overview, click the connection. On the Details tab you can replace the API Key if needed. Then click Save.

See also Externe koppelingen for the overview, the detail screen and deleting a connection.