Mirakl koppelen

Veel marketplaces draaien op Mirakl, zoals Decathlon, Kruidvat, ANWB en MediaMarktSaturn. Met de koppeling met Mirakl haalt Stockhub je bestellingen van zo'n marketplace op en stuurt Stockhub je voorraad naar de marketplace. Je maakt de koppeling zelf aan in het klantenportaal. Je hebt daarvoor een API-sleutel en de Shop ID uit het Mirakl back office van de marketplace nodig.

Verkoop je op meer marketplaces die op Mirakl draaien, dan maak je per marketplace een verkoopkanaal aan.

Gegevens ophalen in Mirakl

Log in op het back office van de marketplace. Dat is de omgeving voor verkopers, niet de website van de marketplace.

API-sleutel:

1. Klik rechtsboven op je gebruikersnaam en kies My user settings.
2. Open de tab API Key.
3. Heb je nog geen sleutel, klik dan op Generate a new key.
4. Kopieer de API-sleutel en bewaar hem veilig. Lukt het aanmaken niet, vraag dan de hoofdgebruiker van je account.

Shop ID:

1. Open in het back office de instellingen van je winkel.
2. Noteer de Shop ID. Waar die precies staat, verschilt per marketplace.

Meer uitleg van Mirakl: https://help.mirakl.com/

Koppeling aanmaken in Stockhub

1. Ga in het menu naar Integraties > Verkoopkanalen.

2. Klik op Nieuw verkoopkanaal. Het venster Verkoopkanaal toevoegen opent.

3. Kies Mirakl.

4. Vul de gegevens in:

   • Omschrijving: een herkenbare naam, bijvoorbeeld de naam van de marketplace.
   • Afzendernaam: deze naam komt op het verzendlabel. Dit veld is niet verplicht.
   • Marktplaats: kies de marketplace waarop je verkoopt. Stockhub vult dan zelf het adres van de Mirakl-omgeving in. Staat je marketplace er niet bij, kies dan Anders en vul bij URL het API-adres van de marketplace in. Dat adres eindigt op /api, bijvoorbeeld https://naam-van-de-marketplace.mirakl.net/api. Je krijgt dit adres van de marketplace.
   • API Sleutel: de API-sleutel uit Mirakl.
   • Winkel ID: de Shop ID uit Mirakl.

   

5. Klik op Test verbinding. Zie je Verbonden, dan kloppen de gegevens. Zie je Verbinding mislukt, controleer dan de API-sleutel, de Winkel ID en de marketplace of URL.

6. Klik op Volgende. Krijg je de melding URL moet eindigen op /api, vul de URL dan aan.

7. Kies onder Automatische gegevens verwerking wat Stockhub met de marketplace uitwisselt. Zet elke instelling op Actief of Inactief:

   • Importeer bestellingen: haal bestellingen op uit de marketplace.
   • Alle producten bijwerken en Nieuwe producten importeren: deze zie je alleen als het fulfilmentbedrijf ze heeft aangezet.
   • Voorraad bijwerken naar kanaal: stuur je voorraad uit Stockhub naar de marketplace.
   • Synchroniseer een virtuele voorraad hoeveelheid: deze hoeveelheid wordt bij je werkelijke voorraad opgeteld.
   • Track & trace e-mail versturen: deze zie je alleen als het fulfilmentbedrijf dit heeft aangezet.

8. Klik op Opslaan.

Na het koppelen

Een nieuw verkoopkanaal staat eerst in conceptstatus. Je ziet dan de melding Activatie verkoopkanaal in behandeling. Het fulfilmentbedrijf activeert het kanaal, daarna starten de synchronisaties.

Goed om te weten:

• Een nieuwe bestelling wacht in Mirakl eerst op acceptatie. Stockhub haalt een bestelling pas op als die is geaccepteerd. Accepteer je bestellingen zelf in het back office, of zet op de tab Synchroniseren de instelling Automatisch bestellingen accepteren op Actief. Stockhub accepteert dan de wachtende bestellingen voor je.
• Veel marketplaces geven het e-mailadres van de klant niet door. Vul op de tab Synchroniseren bij Dummy e-mailadres een adres in dat Stockhub gebruikt voor bestellingen zonder e-mailadres.
• De marketplace, URL, API-sleutel en Winkel ID pas je later aan op de tab Gegevens van het kanaal.

Zie ook Verkoopkanalen beheren voor de tabs van het detailscherm, de synchronisatie-instellingen en het verwijderen van een kanaal.