Wat de knop «Mirakl-tracking pushen» doet, stap voor stap

Wanneer de knop op de levering verschijnt

De knop staat op de levering (overboeking in Voorraad) en bestaat in de takken 17.0, 18.0, 19.0 en 20.0 van de module. Hij is verborgen als de levering niet bij een Mirakl-order hoort of als de status niet Voltooid is. Positief gezegd: je ziet hem alleen op een Mirakl-levering die al gevalideerd is. Het onderdeel «Mirakl-order» hangt af van een intern gegeven, Is Mirakl-order (Is Mirakl Order), dat in geen enkele weergave zichtbaar is.

Het label hangt af van de taal van je Odoo: in het Nederlands is het Mirakl-tracking pushen, in het Duits Mirakl-Tracking übertragen, in het Frans Envoyer le suivi à Mirakl, in het Italiaans Invia tracciamento Mirakl en in het Portugees Enviar Seguimento Mirakl.

Een casus van begin tot eind

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Stel je een verzonnen winkel voor, Almenara Hogar, die via de connector verkoopt op een Mirakl-marktplaats. We bekijken drie leveringen, met wat de code van Odoo 20.0 doet.

Eerste levering: de automatische route

In de Mirakl-instantie van Almenara Hogar staat de instelling aan om de tracking te versturen bij het valideren van de levering. Het magazijn zet het nummer van de vervoerder op de levering en valideert. Zodra de validatie klaar is, controleert Odoo dat de levering op Voltooid staat, dat ze bij een Mirakl-order hoort, dat de instantie die instelling actief heeft en dat er een trackingnummer is. Daarna stuurt het de tracking naar Mirakl zonder dat iemand op iets klikt. Dit is de normale route: de knop is dan niet nodig.

Als de verzending op die route mislukt, wordt de validatie van de levering niet onderbroken: de module laat op de levering een notitie achter met de reden van de fout.

Tweede levering: zonder trackingnummer

Het magazijn valideert een andere levering zonder nummer van de vervoerder. Omdat de instelling actief is, verstuurt de module niets en laat op de levering een notitie achter die uitlegt dat het trackingnummer ontbreekt en dat je het aan de levering moet toevoegen en op Mirakl-tracking pushen moet klikken.

Het magazijn voegt het nummer van de vervoerder toe aan de levering en klikt op de knop. Dit is het gebruik van de knop als uitzondering: handmatig opnieuw proberen wat niet vanzelf is verstuurd.

Derde levering: de verzending mislukt bij het klikken

Bij een andere levering mislukt de aanroep naar Mirakl na het klikken op de knop. De module laat op de levering een notitie achter met de reden van de fout en de knop toont je de fout op het scherm. Op de automatische route blijft de notitie daarentegen op de levering staan en gaat de validatie gewoon door.

Wat de knop controleert en in welke volgorde

1. Dat de levering op Voltooid staat.
2. Dat de levering hangt aan een verkooporder die een Mirakl-order heeft.
3. Dat er een trackingnummer is. De module leest het uit de trackingreferentie van de vervoerder op de levering (die komt van de optionele module stock_delivery; als die niet is geïnstalleerd, faalt de connector niet). Als de referentie meerdere regels heeft, neemt hij de eerste, en daarvan wat voor de eerste komma of puntkomma staat.
4. Dat de verkooporder een gekoppelde Mirakl-instantie heeft.
5. Als alles in orde is, stuurt hij de tracking via die instantie naar Mirakl.
6. Als de verzending lukt, laat hij een notitie op de levering achter met de tekst Mirakl tracking succesvol gepusht. Als het mislukt, zie je de fout op het scherm.

Als een van de eerste vier controles mislukt, stopt de actie met een melding voordat de verzending van stap vijf wordt geprobeerd.

Wat er gebeurt als het abonnement ontbreekt

Als de marktplaats via FlexigoTech Cloud loopt en deze database de dienst van de connector niet heeft, gaat de validatie van de levering gewoon door in Odoo en gaat er niets naar Mirakl: de tracking en de factuur blijven wachten om later te worden verstuurd. Als je in die toestand op de knop klikt, blijft de tracking in afwachting, wordt niets als verzonden gemarkeerd en wordt de actie onderbroken.

Wat er in dezelfde validatie gebeurt

Bij dezelfde validatie kan de module ook de factuur aanmaken als de instantie het vakje Automatisch factuur aanmaken bij validatie levering (Auto-create invoice on delivery validation) heeft aangevinkt. Het staat op het formulier van Mirakl instanties (Mirakl Instances), tabblad Orders en retouren (Orders and Returns), groep Verkoopbrug (Sales Bridge), en staat standaard uit. Dat is iets anders dan de tracking. Als de factuur je interesseert, lees dan de melding over het boeken van de factuur voordat je haar naar Mirakl stuurt; en als je een order ongedaan moet maken, de knop «Annuleren in Mirakl».

Wat je van de casus leert

• Het versturen van de tracking gebeurt automatisch bij het valideren als de instantie dat heeft ingeschakeld; de knop dient om handmatig opnieuw te proberen.
• De knop verschijnt alleen bij een levering op Voltooid die bij een Mirakl-order hoort.
• Zonder trackingnummer is er geen verzending: voeg het nummer van de vervoerder toe aan de levering en klik opnieuw.
• Na het klikken blijft er bij een geslaagde verzending een notitie op de levering staan; als het mislukt, zie je de fout op het scherm.

Kosten en hulp

Mirakl Connector is een module met eenmalige betaling per Odoo-versie (gepubliceerd in Odoo Apps voor 17.0, 18.0, 19.0 en 20.0) en heeft een abonnement op FlexigoTech Cloud nodig: plan Connector, € 49 per maand of € 490 per jaar excl. btw, tot 3 accounts van het platform. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart en per e-mail waarschuwt als de synchronisatie mislukt. Zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert; de gegevens blijven in je Odoo. Je vindt de productpagina in Odoo Apps en de pagina van de module.

Als je Odoo implementeert en logistiek en tracking goed gekoppeld wilt hebben, implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het 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