Salta al contingut principal

Mirakl

Botó «Generate Bindings» de Mirakl Connector: què fa, pas a pas

El botó Generate Bindings analitza, fins al Offer Binding Generate Limit (500 per defecte), els productes actius i venibles amb referència interna, sense companyia o de la companyia de la instància, i crea un vincle d'oferta per als que encara no el tenen en aquesta instància de Mirakl. Es veu sempre a la fitxa de la instància i acaba amb un avís que compta les ofertes generades, les existents i les omeses sense SKU.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul: Mirakl
Versions: Odoo 17, 18, 19 i 20
Comprovat: al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura: 4 min

El cas: catàleg a Odoo i instància recent creada

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Ferretería Costa Norte té el seu catàleg a Odoo, amb referència interna als productes, i acaba de crear la seva instància de marketplace. Ara necessita vincles d'oferta per als productes que vulgui tenir a Mirakl i no vol donar-los d'alta un a un. Per a això serveix el botó Generate Bindings. Seguim el seu recorregut i, a cada pas, el que fa el codi d'Odoo 20.0.

Same stock on every Mirakl marketplace, sent from Odoo — Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo en anglès)

On és el botó i quan apareix

Obre Mirakl › Configuration › Marketplaces i entra a la fitxa de Mirakl Instances. El botó Generate Bindings és a la vista d'aquesta pantalla i es veu sempre: cap condició de la vista l'amaga. Hi és a les branques 17.0, 18.0, 19.0 i 20.0 del mòdul.

Esquema fet amb codi: el menú Mirakl, Configuration, Marketplaces i a sota el botó Generate Bindings — Esquema (no és una captura d'Odoo) amb la ruta del menú i el botó, que existeix a Odoo 17.0, 18.0, 19.0 i 20.0.

Dos camps que condicionen el resultat

Abans de prémer convé mirar aquests dos:

Company: es veu a la fitxa de Mirakl Instances i també a la llista. Per defecte pren la companyia activa. El botó la fa servir per decidir quins productes hi entren (ho veuràs als passos).
Offer Binding Generate Limit: és a la fitxa, pestanya Manual Operations, grup Offers. Val 500 per defecte. La seva ajuda diu: «Maximum products scanned when auto-generating missing offer bindings.»

Què fa en prémer-lo, pas a pas

Treballa només amb la instància de la fitxa oberta.
Pren el valor de Offer Binding Generate Limit; el límit mai baixa d'un.
Cerca productes actius, amb la referència interna emplenada i sense companyia o de la companyia de la instància. Quan el producte té l'opció de venda, només hi entren els que es poden vendre. Els ordena per identificador, del més antic al més recent, i es queda amb tants com digui el límit.
Mira quins productes ja tenen vincle en aquesta instància.
Recorre els productes trobats. Els que ja tenen vincle s'ometen i es compten com a existents; els que no porten referència s'ometen i es compten com a omesos sense SKU. Amb la resta prepara un vincle nou: la instància, el producte, la referència interna com a SKU, el nom del producte tal com es mostra com a títol i el mode de sincronització de categories en mapatge.
Si hi ha alguna cosa preparada, crea tots els vincles d'una vegada.
Compon el resultat, el publica com a missatge a la fitxa de la instància i el mostra en un avís.

Per als productes que ja tenien vincle, el codi no crea res de nou: només els compta com a existents.

Què veus en acabar

Apareix un avís titulat Mirakl, de tipus èxit, que no es queda fix a la pantalla, amb aquest text: Generated … offers. Existing: …. Skipped without SKU: ….. Els tres buits són els recomptes del pas cinc. El mateix text queda com a missatge a la fitxa de la instància.

Si el teu Odoo és en un altre idioma, el botó canvia de rètol:

Esquema fet amb codi a partir de les traduccions del mòdul: el text Generate Bindings en castellà, alemany, francès, italià i portuguès — Esquema (no és una captura d'Odoo): en castellà Generar vínculos, en alemany Verknüpfungen generieren, en francès Générer les liaisons, en italià Genera collegamenti i en portuguès Gerar Ligações.

Quan el resultat no és l'esperat

Costa Norte prem i, en revisar, troba a faltar productes. Això és el que diu el codi sobre què entra a l'anàlisi:

Producte a Odoo	Entra a la selecció?
Arxivat	No
Sense referència interna	No
Amb la venda desactivada	No, quan el producte té aquesta opció
D'una companyia diferent de la de la instància	No
Sense companyia	Sí
Ja vinculat en aquesta instància	S'analitza, però s'omet i compta com a existent

Hi ha una conseqüència de l'ordre dels passos: el límit s'aplica als productes analitzats, no als vincles creats. Els productes ja vinculats compten dins del límit, així que, si el catàleg que compleix les condicions és més gran que el límit, els últims productes per identificador queden fora d'aquesta passada. Si l'avís indica poques ofertes generades i moltes d'existents, puja el valor de Offer Binding Generate Limit a Manual Operations i torna a prémer: els productes que ja tenen vincle s'ometen, així que no es creen duplicats per a ells.

Què comprovar després

Que l'avís i el missatge de la fitxa quadren amb el que esperaves en generades, existents i omeses sense SKU.
Que la Company de la instància és la correcta si falten productes d'una companyia concreta.
Que el límit és més gran que el nombre de productes que vols analitzar.

Si t'interessa un altre botó del mòdul explicat igual, mira què fa el botó «Cancel in Mirakl». I per a una tasca programada, «Mirakl - Accept Orders».

Cost i ajuda

Mirakl Connector és un mòdul de pagament únic per versió d'Odoo i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any, sense IVA. La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials. El mòdul està publicat per a Odoo 17.0, 18.0, 19.0 i 20.0 (fitxa a Odoo Apps, pàgina del mòdul). FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, per si necessites ajuda amb la posada en marxa del teu catàleg.

Continua llegint

L'error «Post the invoice before sending it to Mirakl.» a Mirakl ConnectorQuan surt l'error «Post the invoice before sending it to Mirakl.» a Mirakl Connector per a Odoo, què comprova el codi i com resoldre'l.La tasca «Mirakl - Accept Orders», passada a passadaQuè fa a cada passada la tasca programada Mirakl - Accept Orders de Mirakl Connector per a Odoo, cada quant corre i què revisar si no accepta res.Què fa el botó `Cancel in Mirakl` de Mirakl Connector, pas a pasQuè fa el botó Cancel in Mirakl de Mirakl Connector per a Odoo: quan apareix, què comprova, què canvia a la comanda i quins errors pot donar.

Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): views/mirakl_instance_views.xml
Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
Codi del mòdul: 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