Already using Webshipper? Connect your own Webshipper account to yayloh and create return labels with any carrier available in your Webshipper account.
Don't have Webshipper? Some carriers, such as DB Schenker, DPD and Posti, can be connected through yayloh's Webshipper account instead. See the guide for your carrier in Carriers & Routes: how it works.
Before you start
Your Webshipper account set up for the carriers, shipping rates and countries you want to use for returns. yayloh uses your Webshipper setup as it is.
Your warehouse set up under Settings > Stores & warehouses. You'll choose it when you create the route.
Admin access to yayloh.
Step 1: Get your credentials
You need two things from Webshipper:
Account name: the first part of your Webshipper URL. For example, if you log in at
mybrand.webshipper.io, your account name ismybrand.Token: an API token you create in Webshipper (see below).
Create a Webshipper API token
In your Webshipper dashboard, open Settings and select Access and Tokens.
Click Create API token.
Choose Select all and click Save.
Copy the token from the pop-up before you click Continue. It disappears afterwards.
Step 2: Add Webshipper as a carrier
Go to Settings > Carriers & Routes and open the Carriers tab.
Click Add carrier, enter a name (for example "Webshipper"), and choose WEBSHIPPER as the carrier company.
Under Credentials, enter your account name and token.
Step 3: Find your shipping rate ID
Each Webshipper shipping rate has an ID. You'll need it for the route.
In your Webshipper dashboard, open Connect and select the Order channels tab.
Choose the order channel you want to use for return labels.
Open the shipping rate for your carrier.
Look at the page URL. The number after
shipping-rates/is your shipping rate ID. For example, in.../shipping-rates/3/update, the ID is3.
Step 4: Create a route
Create one route for each Webshipper carrier and shipping rate you want to use.
In the Routes tab, click Add route and choose your Webshipper carrier under Use.
Under Allow returns from, choose the countries enabled in your Webshipper setup.
Choose your Default warehouse.
Open Specifications and fill in the fields below.
Field | What to enter |
SHIPPING_COMPANY (required) | The carrier in Webshipper, for example |
SHIPPING_RATE_ID (required) | The shipping rate ID from Step 3, for example |
IS_RETURN | Turn on if the shipping rate is set up as a return in Webshipper |
PAPERLESS | Turn on for paperless customs documents |
TAX_REDUCTION | Optional. Use it to adjust the value declared for customs. |
Step 5: Send tracking updates to yayloh
yayloh tracks returns using the carrier's tracking status. With your own Webshipper account, yayloh doesn't have permission to read that status, so Webshipper needs to send it to us.
In your Webshipper account, add a webhook for tracking events.
Point it to this address:
https://prod-generic-webhook-valines.yayloh.com/
If a 3PL manages your Webshipper account, ask them to add the webhook.
Without this webhook, yayloh can't see when a return is dropped off or in transit. Tracking statuses won't update, and refunds that are triggered by tracking won't run automatically.
Step 6: Save and test
Click Apply changes, then create a test label on the Labels page.
Good to know
Labels only work for countries enabled in your Webshipper setup.
Need extra customs details for paperless customs? Contact us and we'll help you set it up.
Webshipper carrier missing from the SHIPPING_COMPANY list? Contact us and we'll add it.
For how routes, priority and fallbacks work, see Carriers & Routes: how it works.