Purpose: Find out how to easily connect weclapp to Sendcloud by using the steps in this article.
Please note: To make sure that weclapp works properly, we recommend using Google Chrome only.
Step 1: Connect your shop
- In your Sendcloud panel, go to Settings > Integrations and look for weclapp:
- Click on
Connect
to open the weclapp settings. Name, URL prefix, and API token are mandatory. You can enter a name for your integration (for example: weclapp).
- You can find the URL prefix in your Weclapp account at MY WECLAPP > My company data. Look for 'Configure personal web address' on the page. The URL prefix will be located there at 'Personal web address':
- The API token must be generated in your weclapp account. Click on your account icon and go to My settings in the top right corner.
- Scroll down the page until you see 'API token'. Generate the API token by clicking on
+ Add new API token
. The API token will appear and you can copy and paste this into the relevant field in your Sendcloud panel (step 2).
-
Save your settings in the Sendcloud panel.
- Click on the
Go to configuration
button in the blue pop-up (as shown above) to configure weclapp warehouse mapping. Note: this button will only be visible after completing the previous step.
Step 2: Configure warehouse mapping
You have the option to configure weclapp warehouse mapping with your sender addresses in Sendcloud. In the drop-down menu you can select the correct sender address per warehouse
Besides sender addresses, you can also configure custom attributes from weclapp sales orders. Those attributes will be used for service point ID and international shipping mapping. Select default values for shipment type, country and the HS codes used for international shipping.
You have the option to define whether the labels should automatically be created in Sendcloud or not. A custom field needs to be assigned for both manual and automatic label creation. This field will be used for error information about the label creation. The fields need to be created manually in weclapp, as described in the next step.
Step 3: Create custom field
- Define whether or not you'd like the label to be automatically created in Sendcloud by ticking the checkbox.
- Click on
Create custom field in weclapp
. You'll then be redirected to weclapp, where you need to create custom attributes per label type; one for label creation and one for error messages.
- After creating and saving the custom field, you'll need to close the configuration and then reopen it. (The configuration needs to be refreshed in order for it to work.)
-
Enable/disable your return synchronization by ticking the checkbox. You can also choose the default return error, return reason, return assessment and return rectification. This will be used when the return is created in weclapp.
Label generation
To get started with creating labels, you must follow the instructions below, depending on your preferred way to generate labels - manual or automatic.
For manual label creation
- Link shipment type. Ensure that the Shipment Type in the sales order corresponds to the Checkout Delivery Method used in our Sendcloud shipping rules.
- Create a sales order. Generate a new sales order in weclapp, providing a valid customer address, at least one item with the appropriate weight, and specify the shipment type. Save the sales order, then proceed to create the sales order confirmation and the shipment.
- Navigate to shipment. Once in the shipment, you'll notice empty Sendcloud fields (label creation and logs). Refresh the shipment page to enable the link. This may take a few seconds, but occasionally up to 1 minute.
For automatic label creation
- Configuration settings. Ensure you've switched to Automatically Create Label in the weclapp two-step configuration and set up shipping rules in Sendcloud.
- Create a sales order. Generate a new sales order and proceed to confirm it and create the shipment.
- Refresh the shipment page to find the Documents tab at the top, where the automatically generated label will appear. Please be aware that label creation may take up to 1 minute.
Note: The Shipment type field in WeClapp can be used to create shipping rules. For example, if the Shipment type in WeClapp is "DPD Sendcloud", then the shipping rule would be:
- If the 'Automatically create label' option is checked (see step 3), the label will automatically be created via Sendcloud at the moment the shipment is created in weclapp. The shipment will also be updated with the tracking link, tracking number and label document from Sendcloud.
- If the 'Automatically create label' option isn’t checked, labels won’t be directly created via Sendcloud and the shipment custom fields will be updated with an external link for label creation.
When you click on the external link, the label will be created in Sencloud and the shipment in weclapp will be updated with the tracking link, tracking number, and label document from Sendcloud. After successfully creating the label, the integration will open the success page.
When the label is successfully created, you need to reload the page inside weclapp to see any updates.
Q: What happens when the label couldn't be created?
If the label creation fails, the integration will open an error page describing why label creation failed. The integration will also update a configurable field on the shipment entity with an error message retrieved from Sendcloud.To fix the issue, you'll need to go to Incoming orders in your Sendcloud panel. You can find the specific order in the list of imported orders, click on the pencil icon to edit it, and change or provide the information that is resulting in the error message. After the issue has been resolved, you can go back to the external link from weclapp or manually create the order from Sendcloud.