Naar inhoud
retourly
Gratis starten

Shop koppelen

Onder Koppelingen beheer je de verbindingen met je shop en marktplaats. Laat je een geheim veld leeg, dan blijft de bestaande sleutel behouden.

Je kunt meer dan één winkel koppelen, ook twee van hetzelfde platform: bijvoorbeeld een Nederlandse en een Belgische webshop, of twee Shopify-stores. Geef elke koppeling een naam die je zelf herkent; die naam komt terug in de retourenlijst, op de retourdetailpagina, in het winkelfilter van je dashboard en in de regels. Sleep de koppelingen in de volgorde waarin je portaal ze mag doorzoeken: een klant die een ordernummer invult, ziet geen keuze, en wij pakken de eerste winkel waar die bestelling met dat e-mailadres of die postcode staat. Een retour onthoudt uit welke winkel hij komt; terugbetalingen, tegoed en het afboeken van artikelen gaan altijd naar diezelfde winkel. Heb je één koppeling, dan verandert er niets aan je schermen.

Stap voor stap per platform

Dezelfde stappen staan op het koppelscherm zelf, onder Zo koppel je …. Doet iemand anders het beheer van je webshop, gebruik dan de knop Instructies mailen: die stuurt deze stappen naar het e-mailadres dat je invult, met de naam van je winkel en van jou erbij.

Magento 2

Je doet dit in de Magento-admin van je shop.

  1. Maak een integratie aan. Ga naar System → Extensions → Integrations en klik op Add New Integration. Geef de integratie een naam die je herkent, bijvoorbeeld Retourly, en vul je e-mailadres in. Callback URL en Identity Link URL laat je leeg.

    De handleiding van Adobe bij deze stappen

  2. Geef de integratie rechten. Open het tabblad API, zet Resource Access op Custom en vink deze onderdelen aan:

    • Sales: bestellingen, facturen en creditmemo's
    • Catalog: producten lezen
    • Customers: klanten lezen en bijwerken
    • Marketing: kortingsregels en coupons aanmaken

  3. Zet tegoed op het klantsaldo aan. Wil je tegoed op het klantsaldo van je klant kunnen geven en niet als eenmalige coupon, zet Resource Access dan op All. Retourly vraagt je shop namelijk welke modules draaien, en Magento geeft die lijst alleen aan een integratie met volledige toegang:

    • Magento_Backend::admin: de modulelijst van je shop opvragen, dat is Resource Access op All

  4. Activeer de integratie. Klik op Save; Magento vraagt je adminwachtwoord ter bevestiging. Klik daarna in de lijst achter je integratie op Activate en bevestig met Allow. Magento toont dan het venster met de tokens.

    Wat Adobe over activeren schrijft

  5. Neem het token over. Kopieer de Access Token uit dat venster en sluit het met Done.

  6. Sta het token toe als los token. Magento accepteert een integratietoken standaard alleen binnen zijn eigen integratie. Ga naar Stores → Configuration → Services → OAuth → Consumer Settings, zet Allow OAuth Access Tokens to be used as standalone Bearer tokens op Yes en sla op. Zonder die instelling wijst je shop elke aanvraag van Retourly af. Staat de instelling er niet, dan heeft jouw Magento-versie hem niet nodig.

    Wat Adobe over deze instelling schrijft

  7. Zet het token in Retourly. Vul het token in bij deze koppeling, samen met het adres van je shop.

WooCommerce

Je doet dit in je WordPress-beheer.

  1. Maak een API-sleutel aan. Ga naar WooCommerce → Instellingen → Geavanceerd → REST API keys en klik op Sleutel toevoegen. In een Nederlandse shop heet die sectie REST API-sleutels.

    De handleiding van WooCommerce bij deze stap

  2. Zet de rechten goed. Kies jezelf als gebruiker, geef de sleutel een omschrijving zoals Retourly en zet Rechten op:

    • Lezen/schrijven: bestellingen, producten en kortingen lezen en bijwerken

  3. Neem beide sleutels over. WooCommerce toont de consumer key en het consumer secret één keer. Kopieer ze meteen en zet ze in Retourly bij deze koppeling, samen met het adres van je shop.

Shopify

Je doet dit in het Shopify Dev Dashboard. Naar het Shopify Dev Dashboard

  1. Maak een app aan. Ga in het Shopify Dev Dashboard op dev.shopify.com naar Apps en kies Create app. Geef de app een naam die je herkent, bijvoorbeeld Retourly.

  2. Zet de rechten aan. Open de app, ga naar Configuration en vink onder Admin API access scopes deze rechten aan:

    • read_orders: bestellingen lezen
    • write_orders: bestellingen bijwerken
    • read_products: producten lezen
    • read_customers: klanten lezen
    • write_discounts: kortingscodes aanmaken
    • write_store_credit_account_transactions: tegoed op het klantaccount

  3. Retourtermijn langer dan 60 dagen. Shopify geeft een app standaard alleen bestellingen van de laatste 60 dagen. Is je retourtermijn langer, vraag dan bij Shopify het recht read_all_orders aan voor deze app; zonder dat recht vindt het portaal een oudere bestelling niet.

    Zo vraag je read_all_orders aan

  4. Kies Custom distribution. Ga naar Distribution, kies Custom distribution en vul het domein van je store in, bijvoorbeeld jouwshop.myshopify.com. Die keuze ligt daarna vast.

    Wat Custom distribution inhoudt

  5. Installeer de app op je store. Klik op Generate link, open de installatielink en bevestig de installatie in je Shopify-beheer.

  6. Neem Client ID en Client secret over. Die staan in het Dev Dashboard onder Configuration bij Client credentials. Zet ze in Retourly bij deze koppeling, samen met je shopdomein.

  7. Zet store credit aan in je store. Wil je dat een klant tegoed op zijn account krijgt in plaats van een kortingscode, zet store credit dan aan in je Shopify-beheer onder Instellingen → Klantaccounts.

    Zo zet je store credit aan

Lightspeed eCom

Je doet dit in het backoffice van je shop. Retourly koppelt met Lightspeed eCom C-Series, de omgeving waar je inlogt op services.webshopapp.com. Naar je Lightspeed-backoffice

  1. Maak een API-sleutel aan. Ga naar Instellingen → Shopinstellingen → Developers en maak een nieuwe sleutel aan. Geef hem een naam die je herkent, bijvoorbeeld Retourly.

    De handleiding van Lightspeed bij deze stap

  2. Zet de sleutel aan en geef rechten. Zet de sleutel aan met de schakelaar onder Instellingen en vink daarna deze onderdelen aan:

    • orders: bestellingen lezen en bijwerken
    • products: producten lezen
    • discounts: kortingscodes aanmaken
    • metafields: gegevens bij de bestelling bewaren

  3. Zoek de taalcode van je shop. Die staat in de API-URL bij je sleutel, bijvoorbeeld nl. Vul hem in Retourly in bij de taalcode.

  4. Neem de sleutel en het secret over. Kopieer beide waarden en zet ze in Retourly bij deze koppeling. Het secret is later niet meer op te vragen; maak dan een nieuwe sleutel aan.

bol.com

Je doet dit in je bol-verkoopaccount. Naar je bol Seller Dashboard

  1. Vraag API-gegevens aan. Ga naar Instellingen → Diensten → API Instellingen en vul de technische contactgegevens in; bol toont het blok met client credentials pas daarna. Vraag daar de credentials aan voor de Retailer API:

    • Retailer API: retouren lezen en afhandelen

    De handleiding van bol bij deze stap

  2. Neem client id en secret over. Kopieer beide waarden en zet ze in Retourly bij deze koppeling.

  3. Laat de retouren binnenkomen. Retourly haalt elke 30 minuten je onafgehandelde bol-retouren op; ze komen in je handmatige wachtrij te staan.

Goed om te weten per platform

  • Magento 2: refunds worden creditmemo's, online via je betaalprovider waar dat kan. Tegoed komt op het klantsaldo (store credit) als je Adobe Commerce draait; in Magento Open Source wordt het een eenmalige coupon. Mag de integratie de modulelijst niet opvragen, dan blijft de koppeling gewoon werken en krijgt de klant een coupon.
  • WooCommerce: refunds lopen via je betaalprovider en vallen automatisch terug op een handmatige refund als de gateway weigert. WooCommerce kent geen tegoed op het klantaccount: tegoed is hier altijd een eenmalige kortingscode.
  • Shopify: heb je nog een oudere custom app uit je store-admin, dan werkt het vaste shpat_…-token ook. Zonder de scope write_store_credit_account_transactions of zonder store credit in je store krijgt de klant een eenmalige kortingscode in plaats van tegoed op zijn account; Retourly zegt dat erbij op het koppelscherm.
  • Lightspeed eCom: Lightspeed kan geen geld terugzetten via de API. Retourly legt de terugbetaling vast in de order (en zet een volledig terugbetaalde order op refunded), daarna boek je het bedrag zelf terug via je betaalprovider of bank. Tegoed is hier altijd een eenmalige kortingscode. Wat Retourly al terugbetaalde, kan de klant niet nog een keer aanmelden: dat houdt Retourly bij in de order zelf, dus de rechten op metafields zijn nodig. Ontbreken ze, dan zegt Verbinding testen dat erbij. Meer terugbetalen dan er besteld is kan niet; zo'n retour komt in je handmatige wachtrij. Digitale artikelen zoals downloads en cadeaubonnen biedt het portaal niet aan voor retour.
  • bol.com: retouren verschijnen elke 30 minuten in je handmatige wachtrij en handel je af vanuit de retourdetailpagina. bol regelt zelf het label en de klantcommunicatie.

Werkt de koppeling nog

De kolommen Laatst gelukt en Laatste fout laten zien of de koppeling werkt; bij een authenticatiefout krijgt de koppeling de status Fout en vul je een nieuwe sleutel in.

De kolom Rechten laat zien of je koppeling alles mag wat Retourly nodig heeft. Kan een platform ons vertellen welke rechten het gaf (Shopify doet dat), dan controleert Retourly dat bij het opslaan en bij Verbinding testen, en noemt een ontbrekend recht met wat er niet werkt en hoe je het aanzet. Kan een platform dat niet vertellen, dan staat er Niet op te vragen: we gokken er niet naar.

Verbinding testen controleert de koppeling zonder iets in je shop aan te passen.

Nog niet gevonden wat je zocht? Mail retouren@retourly.nl, dan helpen we je verder.