Naar hoofdinhoud
Shopify

Wat de knop «Voorraad retourneren» van Shopify Connector doet, stap voor stap

De knop Voorraad retourneren bij een Shopify-terugbetaling maakt in Odoo een of meer reeds gevalideerde retourtransfers aan met wat nog terug moet van de voorraad die Shopify heeft aangevuld; heeft Odoo het al geretourneerd, dan maakt hij er geen aan en opent hij de levering. Je ziet hem alleen bij bepaalde waarden van het veld Voorraadretour en als er iets misgaat, stopt hij met een melding over niet-gekoppelde producten of een aanmaakfout.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 5 november 2026

In het kort

Module
Shopify
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

De uitleg van de methode hieronder volgt de code van Odoo 20. De knop zit in de takken 17, 18, 19 en 20, met dezelfde zichtbaarheidsvoorwaarde.

Waar hij staat en wanneer je hem ziet

Waar staat de knop Voorraad retourneren en wanneer verschijnt hij?

Hij staat op het formulier van Shopify-terugbetalingen, dat je opent via Verkoop › Shopify › Operations › Terugbetalingen. De weergave toont hem alleen als het veld Voorraadretour op in afwachting, in beoordeling of mislukt staat; bij elke andere waarde verbergt ze hem. Met de standaardwaarden zie je hem niet, omdat dat veld begint met een waarde die geen van die drie is. In Odoo in het Nederlands heet de knop Voorraad retourneren; het tweede schema laat zien hoe hij in andere talen heet.

Schema met het menu van terugbetalingen, de knop Voorraad retourneren en de meldingen die hem kunnen stoppen
Schema gemaakt met code op basis van de gepubliceerde code van de module, geen schermafbeelding van Odoo.
Schema met de tekst van de knop Voorraad retourneren in het Nederlands, Spaans, Duits, Frans, Italiaans en Portugees
Schema gemaakt met code op basis van de gepubliceerde vertalingen van de module, geen schermafbeelding van Odoo: in het Nederlands Voorraad retourneren, in het Duits Lager zurückgeben, in het Frans Retourner au stock, in het Italiaans Restituisci al magazzino en in het Portugees Devolver ao stock.

Wat gebeurt er als de voorraadretour al was uitgevoerd?

De methode kijkt daar eerst naar. Stond het veld op mislukt maar was de retourtransfer al gedaan, dan zet hij het op uitgevoerd en wist hij de foutmelding. Was het al uitgevoerd en is er een Retourtransfer, dan opent hij die transfer; is er geen, dan doet hij verder niets.

Your Odoo doesn't talk to Amazon, Temu or Shopify?
Video: Your Odoo doesn't talk to Amazon, Temu or Shopify? (video in het Engels)

Wat hij controleert en wat hij aanmaakt

Hoe bepaalt hij welke producten worden geretourneerd?

Hij leest de aanvullijnen van de terugbetaling, dus wat Shopify weer in voorraad heeft gezet. Lijnen met aantal nul of lager laat hij vallen. Per lijn zoekt hij het product eerst op het Shopify-variant-ID en, als hij het daar niet vindt, op de SKU. Lijnen die niet worden gevonden, komen niet in de retour en laten een waarschuwing achter in het log. Blijft er geen enkel product over, dan stopt de methode met de melding die je hieronder ziet.

Wat doet hij als de terugbetaling een verkooporder met gevalideerde leveringen heeft?

Op het formulier staat het veld Verkooporder in de groep Amounts. De code zoekt de uitgaande leveringen van die order die al klaar zijn. Zijn er die, dan berekent hij per product wat nog terug moet: wat Shopify heeft aangevuld in alle terugbetalingen van die order, min wat de niet-geannuleerde retouren al hebben teruggebracht (ook die van Odoo zelf), en nooit meer dan er geleverd is. De verdeling loopt van de oudste naar de nieuwste levering, zonder uit te komen boven wat elke levering heeft verzonden min wat er al van is teruggekomen.

Hij maakt per betrokken levering een gevalideerde retour aan, dus het kunnen er meerdere zijn. Heeft de levering de beweging van dat product, dan wordt de retour eraan gekoppeld als een retour van Odoo zelf, zodat de levering hem als geretourneerd telt.

Blijft er niets over om te retourneren, dan maakt hij geen transfer aan: hij zet de voorraadretour op uitgevoerd, wist de fout, laat in de leveringen die die producten hebben verzonden de notitie Shopify-terugbetaling …: er is niets meer te retourneren uit deze levering, Odoo heeft het al geretourneerd. achter en opent de eerste daarvan.

En als er geen order of geen gevalideerde levering is?

Dan maakt hij een handmatige ontvangsttransfer aan, met als bron de klantenlocatie en als bestemming de voorraadlocatie van het magazijn. Het magazijn is dat van de Shopify-instantie of, als er geen is, het eerste dat hij vindt van het bedrijf van de instantie. Hij gebruikt een ontvangsttype van dat magazijn, zet bij elke beweging de beschrijving Retour: … met de productnaam, bevestigt de transfer, reserveert hem, zet het gevraagde aantal als uitgevoerd en valideert hem.

Wat verandert er als het goed afloopt?

De voorraadretour staat op uitgevoerd, de foutmelding is gewist en het veld Retourtransfer, in de groep Amounts van het formulier, wijst naar de eerste aangemaakte transfer. Dat veld is verborgen zolang het leeg is en wordt door de knop gevuld, niet door de gebruiker. Alle transfers hebben als bron Shopify-terugbetaling … met de naam van de terugbetaling (het veld Name, groep Shopify).

De knop laat notities achter in de transfers: in elke retour Voorraad geretourneerd van Shopify-terugbetaling …. Transfer: … en, als hij uit een levering komt, in die levering Shopify-terugbetaling …: geretourneerd in …. Aan het eind opent hij de eerste retourtransfer.

Fouten en wat je eraan doet

Wat doe ik met Geen aanvulbare producten gevonden voor deze terugbetaling. Zorg ervoor dat producten zijn gekoppeld via SKU of Shopify-variant-ID.?

Dit is de melding (No restockable products found for this refund. Make sure products are linked by SKU or Shopify variant ID.) die de knop geeft als er na het lezen van de lijnen geen product overblijft: lijnen met aantal nul of lager, of producten die het variant-ID noch de SKU vindt. Ze komt voordat er iets wordt aangemaakt en wijzigt het veld Voorraadretour niet. Controleer of de producten van de terugbetaling in Odoo zijn gekoppeld via SKU of Shopify-variant-ID, zoals de melding vraagt, en klik opnieuw.

Wat betekent Aanmaken voorraadretour mislukt: …?

Dit is de melding (Failed to create stock return: …) die verschijnt als er iets misgaat terwijl de methode leveringen zoekt of de transfers aanmaakt en valideert. Na de dubbele punt staat de oorspronkelijke fouttekst, en die tekst zegt wat je moet corrigeren. Voordat hij haar toont, zet de methode Voorraadretour op mislukt en bewaart hij de fouttekst. Omdat de voorwaarde van de weergave de waarde mislukt bevat, blijft de knop zichtbaar zodra de oorzaak is verholpen.

Wat kost het en wat heb ik nodig om het te gebruiken?

Shopify Connector kost € 9 per Odoo-versie, voor 17, 18, 19 en 20, als eenmalige betaling excl. btw (zie de Odoo Apps-pagina). Daarnaast heb je het abonnement op FlexigoTech Cloud nodig: het plan Connector kost € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform. Wil je dat de retourstroom aansluit op je magazijnen, dan implementeert FlexigoTech Odoo en ontwikkelt het connectoren en integraties op maat.

Lees verder

Wat de knop Pull Stock van Shopify Connector doet, stap voor stapWat de knop Pull Stock van Shopify Connector in Odoo 20 doet: wanneer hij verschijnt, wat hij controleert, welke correcties hij maakt en welke fouten kunnen…
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen