Wanneer de knop zichtbaar is en wat Odoo doet zonder dat je klikt
Moet ik op de knop klikken om de factuur naar Mirakl te krijgen?
Niet altijd. De module breidt de standaardknop voor het valideren van de levering uit en kan bij het valideren van de levering de factuur ook zelf uploaden, mits de instantie facturen in automatische modus verstuurt en de levering nog geen uploaddatum heeft. De knop dient om de factuur handmatig te uploaden. Daarnaast zorgt het selectievakje Automatisch factuur aanmaken bij validatie levering (Auto-create invoice on delivery validation) ervoor dat bij het valideren van een levering van een Mirakl-order de klantfactuur wordt aangemaakt op basis van de bijbehorende verkooporder. Je vindt het op het formulier van Mirakl instanties (Mirakl Instances), tabblad Orders en retouren (Orders and Returns), groep Verkoopbrug (Sales Bridge), en het staat standaard uit. Volgens de hulptekst volgt het het facturatiebeleid (op bestelling of op levering) en blokkeert het de levering nooit als de facturatie mislukt.
Wanneer verschijnt de knop en waarom kan hij op een levering ontbreken?
Hij staat op het formulier van de levering (verplaatsing van Voorraad). Hij is verborgen als de levering niet bij een Mirakl-order hoort of als de status niet Voltooid is. Omgekeerd gezegd: je ziet hem alleen als de levering bij een Mirakl-order hoort en de status Voltooid heeft. Het gegeven Is Mirakl-order (Is Mirakl Order) staat in geen enkele weergave, dus er is geen vakje om te controleren; wat je wel kunt nakijken is de status van de levering. De voorwaarde is hetzelfde in Odoo 17, 18, 19 en 20.

Wat hij doet als je erop klikt, stap voor stap
Wat doet de knop precies?
De code loopt de leveringen af waarop hij werkt en houdt degene over die bij een Mirakl-order horen. Voor elk daarvan zoekt hij de Mirakl-instantie van de verkooporder waaraan de levering gekoppeld is. Heeft de levering geen verkooporder, dan is er geen instantie en gaat de knop er zonder iets te doen aan voorbij. Is die er wel, dan vraagt hij de instantie de factuur te uploaden; volgens de code van de module is wat wordt geüpload de pdf van de geboekte factuur. Gaat de upload goed, dan bewaart de module de datum en het tijdstip van de upload op de levering en laat er een notitie op achter.

Factuur uploaden naar Mirakl), aanwezig in Odoo 17, 18, 19 en 20.Wat verandert er op de levering als het goed gaat?
Twee dingen: de datum en het tijdstip van de upload worden bewaard, en op de levering verschijnt de notitie Mirakl: factuur geüpload naar de marktplaats. De automatische weg uploadt alleen als die datum leeg is.
Wat gebeurt er als de upload mislukt?
Bij de knop wordt de fout opnieuw opgegooid: je ziet hem op het scherm, de actie stopt en wat er zou wijzigen wordt niet bewaard, dus er komt geen uploaddatum. Laat FlexigoTech Cloud de bewerking niet door, dan wordt er niets geüpload en niets gemarkeerd, zodat je hem later kunt versturen, en de knop toont ook de fout. Bij de automatische weg wordt de fout daarentegen niet opnieuw opgegooid: bij een gewone fout laat de module een notitie met de fout op de levering achter en wordt de datum niet gemarkeerd; laat FlexigoTech Cloud de bewerking niet door, dan wordt er ook niets gemarkeerd. De concrete tekst van de fout hangt af van wat de upload terugmeldt en wordt niet door de knop bepaald.
Mag ik klikken als de factuur al is geüpload?
Bij het klikken controleert de knop zelf niet of er al een uploaddatum is, terwijl de automatische weg wel eist dat die leeg is. Kijk, voordat je hem handmatig herhaalt, in de notities van de levering of Mirakl: factuur geüpload naar de marktplaats. er al staat.
Versies, abonnement en hulp
Zit de knop in mijn versie van Odoo?
Ja: de module is gepubliceerd in Odoo Apps voor Odoo 17, 18, 19 en 20, en de knop staat op de levering in alle vier de takken. Het stap-voor-stap-overzicht hierboven komt uit de code van Odoo 20.0. Met Odoo in het Nederlands heet de knop Factuur uploaden naar Mirakl.

Wat is er nodig om te werken en wat kost het?
De module is een eenmalige aankoop per Odoo-versie (de prijs per versie staat op de pagina in Odoo Apps en op de pagina van de module) en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als die mislukt. Zonder abonnement, of met opgeschorte dienst, stopt wat het abonnement levert; de gegevens blijven in jouw Odoo. Met het abonnement is de module voor nieuwe Odoo-versies inbegrepen als je hem op flexigotech.com hebt gekocht; in de Odoo App Store koop je elke versie daar apart.
Helpen jullie met de ingebruikname?
FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): views/stock_picking_views.xml
- Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/stock_picking.py
- Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
