Magento koppelen

Met de Magento-koppeling haalt Stockhub de bestellingen uit je Magento 2-webshop op. Stockhub stuurt de voorraad en de track & trace terug naar Magento. In dit artikel maak je eerst een integratie in Magento en daarna de koppeling in Stockhub.

Wat je nodig hebt

• Toegang tot de Magento Admin met een account dat integraties mag aanmaken.
• Het basisadres van je webshop, bijvoorbeeld https://www.jouwwebshop.nl.

Integratie aanmaken in Magento

1. Log in op de Magento Admin.
2. Ga naar System > Extensions > Integrations.
3. Klik op Add New Integration.
4. Vul bij Name een herkenbare naam in, bijvoorbeeld Stockhub. Vul bij Your Password het wachtwoord van je eigen beheerdersaccount in.
5. Klik links op API en zet Resource Access op All.
6. Klik op Save.
7. Klik in het overzicht bij de nieuwe integratie op Activate en daarna op Allow.
8. Kopieer het Access Token en klik op Done.

Kies je bij Resource Access liever voor Custom, vink dan minimaal deze onderdelen aan:

• Sales > Operations > Orders, met daaronder Actions > View, Ship, Comment en Credit Memos.
• Catalog > Inventory > Products.
• Customers > Customer Groups.
• Stores > Attributes > Product, als je het veld Leverancier gebruikt.
• Stores > Inventory > Sources, als je Voorraad in bulk synchroniseren gebruikt.

Access Token toestaan als bearer token

Vanaf Magento 2.4.4 accepteert Magento het Access Token van een integratie standaard niet meer op de manier waarop Stockhub het gebruikt. Zet dit daarom aan:

1. Ga naar Stores > Settings > Configuration > Services > OAuth.
2. Open Consumer Settings.
3. Zet Allow OAuth Access Tokens to be used as standalone Bearer tokens op Yes.
4. Klik op Save Config.

Staat dit uit, dan geeft Test verbinding in Stockhub Verbinding mislukt.

Meer uitleg vind je in de handleiding van Adobe Commerce: https://experienceleague.adobe.com/en/docs/commerce-admin/systems/integrations

Koppeling aanmaken in Stockhub

1. Ga in het menu naar Integraties > Verkoopkanalen.
2. Klik op de tab Verkoopkanalen op Nieuw verkoopkanaal. Het venster Verkoopkanaal toevoegen opent.
3. Kies Magento.
4. Vul de velden in:
   • Omschrijving: een herkenbare naam voor de koppeling, bijvoorbeeld de naam van je webshop.
   • Afzendernaam: de naam op het verzendlabel. Laat je dit leeg, dan gebruikt Stockhub je bedrijfsnaam.
   • Webshop: het basisadres van je webshop met https://, bijvoorbeeld https://www.jouwwebshop.nl. Zet er geen /rest achter, dat voegt Stockhub zelf toe.
   • Access token: het Access Token uit Magento.

5. Klik op Test verbinding. Zie je Verbonden, dan kan Stockhub je webshop bereiken. Zie je Verbinding mislukt, controleer dan het adres, het token en de instelling voor bearer tokens.
6. Klik op Volgende.
7. Kies welke gegevens Stockhub uitwisselt. Zet elke instelling op Actief of Inactief:
   • Importeer bestellingen: haal bestellingen op uit Magento.
   • Alle producten bijwerken en Nieuwe producten importeren: deze zie je alleen als het fulfilmentbedrijf dit heeft aangezet.
   • Voorraad bijwerken naar kanaal: stuur de voorraad uit Stockhub naar Magento.
   • Synchroniseer een virtuele voorraad hoeveelheid: deze hoeveelheid telt Stockhub op bij de voorraad die naar Magento gaat.
   • Track & trace e-mail versturen: deze zie je alleen als het fulfilmentbedrijf dit heeft aangezet.
8. Klik op Opslaan.

Je ziet daarna de melding Activatie verkoopkanaal in behandeling. Het kanaal staat in conceptstatus tot het fulfilmentbedrijf het activeert. Pas dan starten de synchronisaties.

Zo werkt de koppeling met Magento

• Stockhub haalt bestellingen op met de status Processing.
• Stockhub herkent producten aan de SKU.
• Staat Meld bestellingen af (met tracking) aan, dan maakt Stockhub in Magento een zending met de track & trace aan. De bestelling krijgt dan de status Complete. Met Track & trace e-mails versturen vanuit webshop stuurt Magento zelf de verzendmail naar je klant.
• Gebruikt je webshop Multi-Source Inventory (MSI), zet dan Voorraad in bulk synchroniseren aan.

Instellingen die bij Magento horen

Open het kanaal via Integraties > Verkoopkanalen. Naast de algemene instellingen vind je daar:

• Op de tab Gegevens: Webshop en Access token. Hier vul je een nieuw token in als je in Magento een nieuwe integratie hebt gemaakt.
• Op de tab Synchroniseren: Attribuut geplande datum, Voorraad in bulk synchroniseren en Track & trace e-mails versturen vanuit webshop.
• Onder Aangepaste product velden: bij HS code, Land van oorsprong, Barcode, Afwijzen bij retour, Kostprijs en Leverancier vul je in uit welk attribuut van je producten Stockhub die waarde haalt.
• Onder Bestellingen: Negeer bestellingen met voorlooptekst, Importeer bestellingen met voorlooptekst, B2B voorvoegsel, Velden voor opmerking en Velden voor klantreferentie. Meerdere teksten scheid je met een komma.
• Op de tab Verzendopties: verzendopties in de checkout van je webshop. Deze tab zie je alleen als het fulfilmentbedrijf verzendopties heeft aangezet.

Zie ook Verkoopkanalen beheren voor alle instellingen, de bestellingen van het kanaal en het verwijderen van een kanaal.