Knop «Catalogusgegevens automatisch invullen» van Mirakl Connector

De knop Catalogusgegevens automatisch invullen (Auto Fill Catalog Data) van Mirakl Connector zit in Odoo 17, 18, 19 en 20. Wat hij doet, in Odoo 20, lees je hieronder.

Voordat je klikt: waar staat hij en wanneer zie je hem

Zoek eerst de knop op en weet waarmee hij werkt.

• Open het menu Mirakl › Bewerkingen › Aanbiedingen en open een aanbieding: de knop staat in het scherm Mirakl aanbiedingen (Mirakl Offers).
• Wacht niet tot hij verschijnt: de weergave stelt er geen enkele voorwaarde aan en hij is altijd zichtbaar, in alle vier de versies.
• Onthoud dat hij telkens op één aanbieding werkt, de aanbieding die je open hebt.
• Met Odoo in het Nederlands heet de knop Catalogusgegevens automatisch invullen; in een andere taal verandert het label, zoals het tweede schema laat zien.

Wat hij controleert en wat hij wijzigt, stap voor stap

De knop behandelt drie onderdelen, het ene na het andere, en slaat aan het eind op wat hij heeft verzameld.

Het merk

• Houd er rekening mee dat de knop het catalogusmerk van de aanbieding niet aanraakt als daar al tekst in staat.
• Als het leeg is, zoekt de knop een waarde op het product: eerst op de variant en daarna op het sjabloon. Bij elk kijkt hij eerst naar de merkvelden die een relatie zijn en daarna naar de tekstvelden voor merk of fabrikant, als jouw Odoo die heeft. Hij neemt de eerste tekst die hij vindt.
• Als het product geen enkel merk oplevert, gebruikt hij de bedrijfsnaam van de Mirakl-verbinding van de aanbieding of, als de aanbieding geen verbinding heeft, die van het actieve bedrijf. Als je producten geen merk hebben, controleer dan achteraf of die naam is wat je wilt versturen.

De media-urls

• Als de media-urls al inhoud hebben, laat de knop ze zoals ze zijn.
• Als ze leeg zijn, stelt hij voor elk product met een afbeelding een adres voor (eerst de variant, dan het sjabloon), zonder herhalingen, en slaat ze op, één per regel.
• Als noch de variant noch het sjabloon een afbeelding heeft, wordt in dit onderdeel niets geschreven.

De catalogusattributen

• Weet dat de knop eerst de inhoud van de catalogusattributen leest. Als die leeg is, gaat hij verder. Als het een JSON is die als object of als lijst gelezen wordt, ook.
• Als de inhoud geen geldige JSON is (of een waarde van een ander type), slaat de knop dit onderdeel over en wijzigt hij het niet.
• Als hij verder kan, voegt hij de suggesties samen met de eigen waarden die niet leeg zijn, en die laatste gaan voor op de suggesties. Als het resultaat iets bevat, slaat hij het op als JSON met inspringing, gesorteerde sleutels en niet-ASCII-tekens (bijvoorbeeld accenten) als escape-reeksen.
• Houd er rekening mee dat dit onderdeel opnieuw wordt geschreven, ook als er al attributen waren: anders dan bij het merk en de media-urls wordt niet eerst gecontroleerd of het leeg is.

Opslaan

• Als er een nieuwe waarde is, schrijft de knop alles in één keer naar de aanbieding; als er geen is, schrijft hij niets.

Nadat je hebt geklikt: lees de melding

De knop eindigt met een melding met de titel Mirakl, die niet vast op het scherm blijft staan, en laadt het formulier opnieuw.

• Als je een succesmelding ziet, luidt de tekst Rellenado automáticamente: … (Auto-filled: ….). De puntjes zijn de lijst van wat is geschreven, gescheiden door komma's en in deze volgorde: merk, media-urls, catalogusattributen. Alleen de onderdelen die zijn opgeslagen verschijnen.
• Als je een waarschuwing ziet, luidt de tekst Er zijn geen nieuwe cataloguswaarden automatisch ingevuld. (No new catalog values were auto-filled.) en dat betekent dat er in geen van de drie onderdelen iets is geschreven: het merk had al tekst (of er is geen gevonden, zelfs niet de bedrijfsnaam), de media-urls hadden al inhoud (of er is geen afbeelding) en bij de attributen was er niets om op te slaan of de JSON was ongeldig. Het volstaat dat één van de drie wordt opgeslagen om een succesmelding te krijgen.
• Als catalogusattributen in de melding staat, betekent dat niet dat ze eerder leeg waren: dit onderdeel wordt altijd opgeslagen zodra het resultaat van de samenvoeging inhoud heeft.
• Als je attributen verwachtte en ze niet in de melding staan, kan het zijn dat de JSON ongeldig is (de knop slaat hem zonder verdere melding over) of dat er niets was om samen te voegen.

Dezelfde controle in de automatische export

Het lezen van de JSON van de attributen door de knop is niet exclusief voor hem: ook de catalogusexport gebruikt het. Daar kom je zonder iets in te drukken terecht via de geplande taak Mirakl - Catalogus exporteren (Mirakl - Export Catalog), die elke 30 minuten draait en actief is bij de installatie van de module.

• Reken erop dat in die export een aanbieding waarvan de attributeninhoud niet als JSON gelezen kan worden, niet wordt geëxporteerd.
• Let op de instelling Importstatus catalogus automatisch controleren (Auto Check Catalog Import Status), die standaard is ingeschakeld: daarmee vraagt de export, nadat een import is verstuurd die een identificatiecode teruggeeft, de status ervan op.

Kosten en hulp

Mirakl Connector is een eenmalige betaling per Odoo-versie en is gepubliceerd in Odoo Apps voor 17, 18, 19 en 20 (productpagina, modulepagina). Daarnaast heb je het abonnement op FlexigoTech Cloud nodig, plan Connector: € 49 per maand of € 490 per jaar, excl. btw. FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat, voor als je wilt dat de catalogus met andere regels uit je producten wordt opgebouwd.

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