Koppeling Stockhub met Magento (NL + EN)

Met de Magento-koppeling in Stockhub automatiseer je de synchronisatie van producten, bestellingen en voorraad. Hierdoor blijft je voorraad actueel, worden bestellingen automatisch doorgestuurd naar je fulfilmentpartner en voorkom je dubbele invoer. In dit artikel lees je hoe je zelf de koppeling kunt instellen via het klantenportaal in Stockhub.

1. Ga naar de integratie-instellingen

Log in op het klantenportaal van Stockhub en navigeer naar: Integraties > Verkoopkanalen. Klik vervolgens rechtsboven op ‘Nieuw verkoopkanaal’.

2. Selecteer Magento

Kies in de lijst met verkoopkanalen voor Magento.

3. Vul de gegevens in

Je wordt gevraagd om de volgende gegevens in te vullen:

• Omschrijving (een herkenbare naam voor de koppeling)

• Afzendernaam: De naam van de afzender die op het verzendlabel komt te staan. Laat je dit veld leeg, dan wordt automatisch de standaardnaam van je shop gebruikt. 

• URL van de webshop

• Access Token (toegangstoken) > zie onderstaand hoe je deze op kunt halen uit Magento.

🔑 Gegevens ophalen vanuit Magento

Volg deze stappen om de benodigde gegevens aan te maken in je Magento-webshop:

1. Log in op het Magento Admin-dashboard.

2. Ga naar Systeem > Integraties.

3. Klik op ‘toevoegen van nieuwe integratie'.

4. Vul een herkenbare naam in (bijvoorbeeld: ‘Stockhub’) en voer je admin-wachtwoord in bij ‘jouw wachtwoord’.

5. Klik op het tabblad API en selecteer alle bronnen & druk op 'opslaan' om de integratie op te slaan.

6. Klik op ‘opslaan & activeren’ naast de zojuist aangemaakte integratie.

7. Na het activeren wordt het Access Token weergegeven. Kopieer dit token en plak het in het juiste veld in Stockhub, samen met de URL van je webshop.

Na het invullen van de bovenstaande gegevens kun je op ‘Test verbinding’ klikken om te controleren of de koppeling correct werkt.

4. Kies de juiste eenheden

Selecteer de juiste gewichtseenheid en afmetingseenheid voor jouw producten. Kies hier de eenheden die in je Magento worden gebruikt. 

5. Stel de synchronisatie in

Geef aan welke onderdelen je wilt synchroniseren:

• Bestellingen importeren vanuit Magento

• Bestaande productinformatie bijwerken vanuit Magento (Deze optie is alleen zichtbaar als het fulfilmentbedrijf dit voor je heeft ingeschakeld).

• Nieuwe producten importeren vanuit Magento (Deze optie is alleen zichtbaar als het fulfilmentbedrijf dit voor je heeft ingeschakeld).

• Voorraad in Magento bijwerken op basis van Stockhub

Je kunt ook een hoeveelheid virtuele voorraad opgeven. Dit is een extra buffer bovenop je daadwerkelijke voorraad, om nee-verkopen te voorkomen.

6. Opslaan en activeren

Klik op Opslaan om de koppeling te activeren. Je Magento-webshop is nu verbonden met Stockhub.

Benodigde Magento rechten voor koppeling met StukHub

Om StukHub te koppelen met Magento moeten een aantal rechten ingeschakeld staan voor de API-gebruiker in Magento.

Producten ophalen

GET /products (Producten ophalen)

Benodigde rechten:

• Catalog > Inventory > Products > View

Orders ophalen

GET /orders (Orders ophalen met searchCriteria)

Benodigde rechten:

• Sales > Operations > Orders > View

Productvoorraad bijwerken

PUT /products/{sku}/stockItems/1 (Productvoorraad bijwerken)

Benodigde rechten:

• Catalog > Inventory > Products > Edit

Verzending aanmaken

POST /order/{orderId}/ship (Verzending aanmaken)

Benodigde rechten:

• Sales > Operations > Shipments > Create

• Sales > Operations > Orders > View

Comment toevoegen aan order

POST /orders/{orderId}/comments (Comment toevoegen aan order)

Benodigde rechten:

• Sales > Operations > Orders > Edit

• Sales > Operations > Orders > View

Koppeling beheren of verwijderen

Wil je later iets aanpassen? Klik op de koppeling in het overzicht om de instellingen te wijzigen.
Verwijderen kan door op de koppeling te klikken en vervolgens op de rode knop ‘Verwijderen’ te drukken.

English version

With the Magento integration in Stockhub, you can automate the synchronization of products, orders, and inventory. This keeps your stock up to date, ensures that orders are automatically forwarded to your fulfillment partner, and prevents duplicate data entry. In this article, you’ll learn how to set up the integration yourself through the customer portal in Stockhub.

1. Go to the integration settings

Log in to the Stockhub customer portal and navigate to Integrations > Sales channels. Then click the “New sales channel” button in the top right corner.

2. Select Magento

Choose Magento from the list of available sales channels.

3. Enter the required details

You will be asked to fill in the following information:

• Description (a recognizable name for the integration)

• Sender name: The name of the sender that will appear on the shipping label. If left empty, the default name of your shop will be used.

• Webshop URL

• Access Token – see below for instructions on how to obtain this from Magento.

🔑 Retrieving the credentials from Magento

Follow these steps to create the required details in your Magento webshop:

1. Log in to the Magento Admin Dashboard.

2. Go to System > Integrations.

3. Click Add New Integration.

4. Enter a recognizable name (for example: “Stockhub”) and fill in your admin password under Your Password.

5. Click the API tab, select all resources, and click Save to store the integration.

6. Click Save & Activate next to the integration you just created.

7. After activation, the Access Token will be displayed. Copy this token and paste it into the correct field in Stockhub, along with your webshop URL.

After entering the above details, click “Test connection” to verify that the integration works correctly.

4. Choose the correct units

Select the appropriate weight unit and dimension unit for your products. Choose the units that are used in your Magento environment.

5. Configure the synchronization

Specify which data you want to synchronize:

• Import orders from Magento

• Update existing product information from Magento (This option is only visible if your fulfillment provider has enabled this for you.)

• Import new products from Magento (This option is only visible if your fulfillment provider has enabled this for you.)

• Update stock levels in Magento based on Stockhub

You can also set a value for virtual stock. This is an additional buffer on top of your actual inventory to help prevent out-of-stock situations.

6. Save and activate

Click Save to activate the integration. Your Magento webshop is now connected to Stockhub.

Required Magento Permissions for the StukHub Integration

To connect StukHub with Magento, several permissions must be enabled for the Magento API user.

Retrieve products

GET /products (Retrieve products)

Required permissions:

• Catalog > Inventory > Products > View

Retrieve orders

GET /orders (Retrieve orders with searchCriteria)

Required permissions:

• Sales > Operations > Orders > View

Update product stock

PUT /products/{sku}/stockItems/1 (Update product stock)

Required permissions:

• Catalog > Inventory > Products > Edit

Create shipment

POST /order/{orderId}/ship (Create shipment)

Required permissions:

• Sales > Operations > Shipments > Create

• Sales > Operations > Orders > View

Add comment to order

POST /orders/{orderId}/comments (Add comment to order)

Required permissions:

• Sales > Operations > Orders > Edit

• Sales > Operations > Orders > View

Managing or removing the integration

Want to make changes later? Click the integration in the overview to edit the settings.
To remove the integration, click on it and then click the red “Delete” button.