Product Groups is a powerful feature designed for 3PLs who manage the same physical product for multiple merchants.

This feature allows you to link these identical products together as "sibling products." When the inventory level of one product in the group changes (e.g., from a sale or stock correction), the stock levels for all other "sibling" products are automatically updated to match.

Note: This functionality requires the "Stock Synchronisation" integration to be active and configured for your account groups

Managing Product Groups

How to create product groups

You can create and manage groups from the products page.

First, ensure the Product Groups feature is enabled in your settings. Please address the PULPO WMS team to enable this in your account. This will add a new "Product Groups" tab to your Products page.
Navigate to the Products page and open the "Product Groups" tab.

3. Click the "+" button to add a new group.

4. Use the dropdowns to select a Merchant and then the specific Product (you can search by SKU, name, or barcode) that you want to add to the group.

5. Repeat this step to add the corresponding sibling products from your other merchants.

6. Click Save to create the group.

Bulk Uploading Groups via CSV

You can also create many groups at once by uploading a CSV file.

This option is available in the "Product Groups" tab.
The CSV file must contain the group name, merchant slug (Alias name) and product SKU.
The CSV template is available in the Web App and can be downloaded from here.
If the system encounters an error during the upload, it will provide a list of the specific rows that failed, allowing you to easily copy, correct, and re-upload them.

Important Rules for Grouping

To ensure stock synchronisation works correctly, please keep these rules in mind:

One Product Per Merchant: A single group cannot contain two different products from the same merchant.
One Group Per Product: A product can only belong to one product group.
Matching Management Types: All products in a group must have the same management type. For example, you can group two "Batch" products, but you cannot group a "Batch" product with a "Serialized" product.

How to Track Synchronised Stock Changes

When a stock level is updated automatically via this feature, it is logged in the system for full visibility.

You can find these changes in the Stock History view with the related event type.
The correction type will be labeled as "product_group_stock_movement," so you can easily identify all changes triggered by the Product Groups feature.

Setting up the product groups' stock synchronisation integration

This integration is necessary to automatically synchronise the stock levels of products you have linked together in Product Groups.

Integration Setup Fields

Here is a breakdown of each field and how to configure it.

Field	Description	Example from Image
Name	A custom name for your integration so you can easily identify it.	`product groups stock plenty merchant 1`
Merchant	The specific merchant this integration configuration will apply to.	`merchant_1`
Channel	The sales channel. In most cases, this will be `default`.	`default`
Type	The type of integration you are setting up.	`Products Groups Stock`
Origin credentials	The source system credentials. For this sync, it should be your PULPO WMS account.	`Merchant 1 PULPO (Type: pulpo)`
Target credentials	The destination system credentials. This should also be your PULPO WMS account, as the integration syncs stock within PULPO WMS.	`Merchant 1 PULPO (Type: pulpo)`

Additional Settings: Events to Process

This section is crucial. You must select all the inventory events that should trigger a stock update for your product groups.

When any of these events happen to one product in a group, the integration will run and update the stock for all other "sibling" products in that same group.

By default, all the events are activated: