De velden van de Mirakl-instantie in Odoo: wat elk betekent en wat je invult

Waar de velden staan en waarom sommige ontbreken

• Verzendregel is verborgen zolang de instantie geen verzendproduct heeft.
• Commissieproduct verschijnt alleen als Commissie in verkooporder op Commissie aftrekken (netto dat u ontvangt) staat.
• De aangemaakte factuur automatisch boeken verschijnt alleen als Automatisch factuur aanmaken bij validatie levering is ingeschakeld.

Orderprijs: verzending, korting en commissie

• Geen commissie (totaal betaald door de klant): het totaal is product plus belasting, wat de klant betaalt. De commissie wordt alleen als informatief gegeven in de Mirakl-order bewaard.
• Commissie aftrekken (netto dat u ontvangt): er wordt een negatieve regel met de commissie toegevoegd via het Commissieproduct, een dienstproduct. Het totaal is product plus belasting min commissie, het netto dat je ontvangt.
• Inkoopprijs van de operator (de operator koopt bij u): voor marktplaatsen waar de operator de goederen bij je koopt en zelf aan de koper factureert (bijvoorbeeld GACD). Elke regel neemt de inkoopprijs die Mirakl ervoor geeft en Odoo voegt de belastingen van het product toe, zodat de order overeenkomt met de inkooporder van de operator. Op die regels wordt de marktplaatskorting niet toegepast. Als Mirakl voor een regel geen inkoopprijs meestuurt, behoudt die regel de prijs van de koper en de korting, en wordt een notitie achtergelaten in de verkooporder en in de Mirakl-logboeken.

De keuze hangt af van welk bedrag je in de order wilt zien: wat de klant betaalt, wat je netto ontvangt of de inkooporder van de operator.

Facturen en importritme

• Automatisch (Odoo beslist): met btw-nummer komt er een volledige F1, zonder btw-nummer een vereenvoudigde F2. Dit is de standaardwaarde.
• Vereenvoudigd met btw-nummer (F2 TicketBAI/VeriFACTU): er wordt een vereenvoudigde factuur uitgegeven ook als de koper een btw-nummer heeft. De hulptekst beschouwt dit als geldig voor B2C in Baskenland (TicketBAI) of wanneer je fiscaal adviseur aangeeft dat F2 volstaat.
• Volledig (F1 TicketBAI/VeriFACTU): er wordt een volledige factuur uitgegeven ook als de koper geen btw-nummer heeft, bijvoorbeeld buitenlandse klanten die dat vereisen.

Twijfel je, raadpleeg dan je fiscaal adviseur.

• Automatisch factuur aanmaken bij validatie levering: standaard uitgeschakeld. Schakel je het in, dan wordt bij het valideren van een levering van een Mirakl-order de klantfactuur aangemaakt vanuit de verkooporder. Het volgt het facturatiebeleid (besteld of geleverd) en blokkeert de levering nooit als de facturatie mislukt.
• De aangemaakte factuur automatisch boeken: de hulptekst raadt aan het uitgeschakeld te laten bij TicketBAI, VeriFACTU of SII, omdat boeken onomkeerbaar is en de elektronische factuur naar de belastingdienst stuurt. Niet-positieve facturen blijven in concept.
• Factuur naar Mirakl sturen: met Handmatig (met een knop) wordt niets vanzelf geüpload, en de hulptekst markeert dat als aanbevolen, bijvoorbeeld om te uploaden na het bewerken van klant of btw-nummer. Met Automatisch (bij validatie levering) wordt geüpload bij het valideren van de levering, alleen als de factuur geboekt is, en de operator moet het uploaden van facturen hebben ingeschakeld. Opnieuw versturen vervangt het vorige document in Mirakl, zonder duplicaten.

• Ordersynchronisatie ingeschakeld, in Synchronisatiebeleid en ook in de lijst van instanties: schakelt de geplande import van orders in voor die instantie. Standaard is het uitgeschakeld.
• Frequentie ordersynchronisatie (minuten), in de groep Windows: de minimale tijd tussen twee imports van die marktplaats. De geplande actie Mirakl - Orders synchroniseren wordt elke 10 minuten wakker en verwerkt de instantie wanneer die minuten verstreken zijn. Met 0 importeert het bij elke keer wakker worden en met 60 elk uur.
• Synchronisaties filteren op laatste wijziging: vraagt Mirakl om wat er sinds de laatste synchronisatie is gewijzigd, niet wat is aangemaakt. De hulptekst zegt dat je het ingeschakeld moet laten, want met het filter op aanmaakdatum valt een order die 's ochtends is aangemaakt en 's middags verzonden buiten de boot en bereikt de nieuwe status Odoo niet. Schakel het alleen uit als de API van je operator dat filter negeert. De eerste import gebruikt altijd de aanmaakdatum.

Wat er met het abonnement gebeurt en hoe we helpen

Mirakl Connector is een eenmalige aankoop per Odoo-versie en heeft het FlexigoTech Cloud-abonnement nodig, plan Connector: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 platformaccounts. De verbinding loopt via die dienst, die de inloggegevens versleuteld bewaart en per e-mail waarschuwt als de synchronisatie faalt. Zonder abonnement stopt wat het abonnement levert, en de gegevens blijven in je Odoo. Je kunt de module bekijken op de Odoo Apps-pagina of op de pagina van de module.

We implementeren Odoo 17, 18, 19 en 20 en ontwikkelen connectoren en integraties op maat. Ben je Odoo aan het invoeren en wil je deze velden samen met ons doorlopen voordat je de synchronisatie activeert? Neem gerust contact op.

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): models/mirakl_instance.py
• Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html