Connecting ProductFlow

ProductFlow is a PIM system that exchanges your products and orders with marketplaces. If you connect ProductFlow as an integrator, Stockhub fetches the orders of the marketplaces you have connected in ProductFlow. Stockhub sends your stock to ProductFlow and reports shipped orders back. How an integrator works in general is explained in Integrators.

Getting the data in ProductFlow

You need two pieces of data: your Company ID and a Personal Access Token.

1. Log in to your ProductFlow environment.
2. Click your name in the top right corner and choose Profile.
3. Under API you find your Company ID. Copy it.
4. Go to Personal Access Tokens and click the plus icon to create a new token.
5. Give the token a recognisable name, for example Stockhub, and click Create.
6. Copy the token.

A ProductFlow token is valid for one year. You see the expiry date in the API tables on your profile page.

More information from ProductFlow: https://www.productflow.com/news/expiring-api-tokens

Creating the connection in Stockhub

1. In the menu, go to Integrations > Integrators.

2. Click New Integrator. The Add integrator window opens.

3. Choose Productflow.

4. Under Integrator credentials, fill in a Name, for example ProductFlow. Paste the token into the apiKey field and the Company ID into companyId.

   

5. Look at Connection status. You first see Connecting and then the number of Connected marketplaces found. If you see Connection failed, check the token and the Company ID. As long as there is no connection, you cannot continue.

6. Click Next.

7. Under Synchronisations, set the parts you want to use to Active: Import orders, Update existing product info, Import new products and Update stock to channel. Click Next.

8. Under Channels you see the marketplaces that are enabled for orders in ProductFlow. For each Channel, choose whether you want to Connect it and whether Import orders is Active. If there are several warehouses, you also choose the Warehouse for each channel.

9. Click Save.

After connecting

• A new integrator is first set to Concept. The fulfilment company then sets the connection to active; only then do the synchronisations start. You see the current state at Status in the Integrators overview.
• The marketplaces you have connected appear as sales channels on the Integrator tab of the Sales channels page.

Carriers in ProductFlow

With every shipped order, Stockhub reports the carrier to ProductFlow, and ProductFlow passes it on to the marketplace. Make sure ProductFlow has carriers with exactly these names, in lower case:

• dhlparcel
• dhlpaket
• postnl
• dpd
• ups
• gls
• correos
• es mrw
• atpost
• cttexpress
• posteitaliane
• other

Stockhub reports shipments with TNT as postnl. A carrier that is not in the list is reported as other.

What the connection does

• Orders: Stockhub fetches orders with the status accepted from your connected marketplaces. Stockhub links each order line to a product by SKU. If the product has not been linked yet, the whole order is not imported.
• Products: about every half hour, Stockhub links the products from ProductFlow to your products in Stockhub, by SKU or barcode. Through ProductFlow, Stockhub does not create new products and does not update product data, not even when Update existing product info or Import new products is switched on. So make sure your products with the same SKU are already in Stockhub.
• Dimensions and weight to ProductFlow: if you change a linked product in Stockhub, Stockhub sends the length, width, height and weight to ProductFlow as package dimensions, in centimetres and kilograms. This does not apply to bundled products.
• Stock: if Update stock to channel is switched on, Stockhub sends the available stock of linked products to ProductFlow.
• Shipments: Stockhub reports shipped orders back to ProductFlow with the carrier and the track & trace number.