PulpoWMS Integration

Purpose: This is a guide on how to integrate with PulpoWMS in a couple of short steps.

To install Pulpo integration, you need to go to the Sendcloud panel > Settings > Integrations and find Pulpo. 

After clicking the Connect button integration settings page should be displayed where a user needs to enter the name of the integration and his Pulpo credentials so the authentication is performed. 

1. Go to the configuration page button will be enabled after valid Pulpo credentials are saved.
2. This button should lead the user to the application site, where it will have a configuration page.
3. Here you can map warehouses from Pulpo WMS with the Sender addresses that are listed in the drop-down select box. Also, there is an option for enabling/disabling sending box-type information.

International shipment

On the configuration page, you can set up default fields for international shipping, HS code, country of origin, and shipment type. 

The default values for HS code and country of origin will be used if these values are not set for a product in Pulpo WMS.

When creating a parcel for international shipment, an international document will be uploaded to Pulpo WMS, along with the label.

Automatic return labels & tracking

For selected shipping methods, you can automatically create a return label at the same time as the outbound label. You can either print it and put it in the box or link it digitally to the shipment via the tracking code.

How to set it up

In Pulpo (Integration settings)

• Choose the Shipping methods you want to auto-create returns for.
• Tick Attach return label if you want the label to be linked digitally to the shipment’s tracking.

In Sendcloud

• Create a Return address if you haven’t yet.
• Create one or more Return rules with the conditions you need.
  • Ship with and Return address is are required (Pulpo orders don’t include these by default).
  • If Return address is isn’t set, we’ll use the customer address as the return address.

How it works

• When a shipment is processed, Sendcloud automatically creates the return label.
• The return tracking number is added to the Pulpo order.
• If Attach return label is enabled, the label file is uploaded to the Pulpo shipment (type: return_label) so it’s available digitally.

Tracking numbers

When a return is created — automatically or manually (e.g., via the Return portal) — Pulpo updates the order with the return tracking number in the Returns tab. If Attach return label is enabled, the label file is also attached to the shipment.

Multicollo shipments

PulpoWMS supports multicollo shipments through the Sendcloud integration. This allows you to ship one order in multiple parcels. 

How to set it up

In PulpoWMS

• Make sure your integration is using API v3.
• Configure your warehouse mapping by linking PulpoWMS warehouses to Sendcloud sender addresses.

• In the configuration page, find the Enable Multicollo section, tick the checkbox, and click Save.

When you save the configuration, the integration automatically updates your webhooks to support multicollo shipments. 

In Sendcloud

• Configure shipping rules with carriers and shipping methods that support multicollo shipments.

Important: Not all carriers support multicollo shipments. If you use an unsupported carrier, the shipment creation will fail. 

How it works

Once configured, continue packing and shipping orders in PulpoWMS as usual. 

When items are packed into multiple boxes, Sendcloud automatically creates a multicollo shipment with multiple parcel labels. 

{
  "functionalities": {
    "multicollo": true
  }
}

Delete integration

To delete the integration, go to the Sendcloud panel > Settings > Integrations, find your PulpoWMS integration, and click Disconnect.

FAQ