Salta al contingut principal
Mirakl

Què afegeix Mirakl Connector a Productes d'Odoo: camps, botó i quan actua

Mirakl Connector afegeix a la fitxa de variant de producte un comptador de vincles, tres camps de només lectura al grup Mirakl Marketplace i el botó Publish to Mirakl. Els camps es consulten; el botó és el que treballa sobre la variant quan el prems.

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

Què afegeix a la fitxa de variant de producte

Esquema fet amb codi: l'app estàndard Productes i, a sota, el que li afegeix el mòdul (el botó Publish to Mirakl, el camp Mirakl Bindings i els camps Last published to Mirakl, Mirakl import reference i Last Mirakl error)
Esquema fet amb codi a partir del codi publicat del mòdul, no és una captura d'Odoo. Les etiquetes van en anglès, el text original del codi.

Què afegeix Mirakl Connector a Productes?

El mòdul amplia el model estàndard de Productes d'Odoo. A la fitxa de variant de producte apareixen un camp comptador, Mirakl Bindings, i un botó, Publish to Mirakl. A més hi ha un grup, Mirakl Marketplace, amb tres camps: Last published to Mirakl, Mirakl import reference i Last Mirakl error.

Què compta Mirakl Bindings?

És un nombre enter que Odoo calcula comptant els vincles de producte de Mirakl que apunten a aquesta variant; si no n'hi ha cap, el valor és zero. Cada vincle reuneix un marketplace i una variant de producte, i és la peça que el botó crea i consulta per a cada marketplace, com veuràs més avall.

Es poden editar els tres camps del grup Mirakl Marketplace?

No, els tres són de només lectura. Last published to Mirakl és de data i hora, Mirakl import reference és un text curt i Last Mirakl error és un text llarg. Són a la fitxa de variant de producte per consultar-los, no per escriure-hi.

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)

El botó Publish to Mirakl

Quan es veu el botó?

Es veu sempre a la fitxa de variant de producte, sense cap condició, a Odoo 17, 18, 19 i 20.

Esquema amb el text del botó segons l'idioma d'Odoo: Publicar en Mirakl en castellà, Auf Mirakl veröffentlichen en alemany, Publier sur Mirakl en francès, Pubblica su Mirakl en italià i Publicar na Mirakl en portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no és una captura d'Odoo: amb Odoo en català, el botó es diu Publish to Mirakl.

Què fa en prémer-lo, per ordre?

Segons el codi d'Odoo 20, treballa sobre una sola variant. Primer mira quins marketplaces Mirakl hi ha creats. Si no n'hi ha cap, s'atura amb un missatge i no crea res. Si n'hi ha, recorre cada marketplace: busca el vincle d'aquesta variant amb aquest marketplace i, si no existeix, el crea. Després intenta autocompletar les dades de catàleg d'aquest vincle. Quan ha passat per tots els marketplaces, obre l'oferta, o la llista de vincles si són diversos.

Quin missatge surt si encara no hi ha cap marketplace?

Al prémer Publish to Mirakl sense marketplaces creats, el mòdul s'atura amb aquest missatge: Create a Mirakl marketplace first (Mirakl ▸ Configuration ▸ Marketplaces), then publish products to it. Cal crear abans un marketplace Mirakl; els camps d'aquesta fitxa els explica aquest article sobre la instància de Mirakl.

Què passa si premo el botó dues vegades sobre la mateixa variant?

Per a cada marketplace, el botó busca primer el vincle d'aquesta variant i només en crea un si no existeix. En prémer una altra vegada reutilitza els vincles que ja hi ha i crea únicament els que falten, per exemple si has donat d'alta un altre marketplace entre una pulsació i l'altra. L'intent d'autocompletat es repeteix a cada pulsació.

Autocompletat i diversos marketplaces

Què autocompleta el botó i què passa si falla?

L'intent d'autocompletat mira tres coses a cada vincle: la marca, les URL de mitjans i els atributs de catàleg. La marca i les URL de mitjans només s'omplen si eren buides i si el mòdul troba un valor que proposar. Els atributs de catàleg s'escriuen quan el mòdul obté atributs que desar. Si l'autocompletat dona error, el botó no s'atura: l'intent està protegit, es continua endavant i l'oferta s'obre igualment, amb el que hi hagi.

Què obre el botó si tinc més d'un marketplace?

El botó crea, si falten, un vincle per cada marketplace. Amb un sol vincle, n'obre directament el formulari. Amb més d'un, obre la llista de vincles d'aquesta variant, amb vistes de llista i de formulari, titulada Publish to Mirakl. El botó no publica res per ell mateix: deixa preparats els vincles i obre l'oferta, o la llista, perquè el venedor la revisi sense haver de construir a mà una fila de llista.

Què necessites per fer-lo servir

Mirakl Connector està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20. És un mòdul de pagament únic per versió i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any, sense IVA. Amb aquesta subscripció, la connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo. Pots veure-ho a la fitxa d'Odoo Apps o a la pàgina del mòdul.

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, per si necessites ajustar el flux de publicació al teu catàleg.

Continua llegint

Checklist de la instància de Mirakl Connector, camp a campChecklist per omplir la instància de Mirakl Connector a Odoo: connexió, comptes de liquidació i opcions, amb el que diu l'ajuda de cada camp.Camps d'Instància de Mirakl a Mirakl Connector: què signifiquen i què posarGuia comparada dels camps de la fitxa Instàncies de Mirakl a Mirakl Connector per a Odoo: què diu cada ajuda, el seu valor per defecte i què posar-hi.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts