Salta al contingut principal
Mirakl

Què afegeix Mirakl Connector a la comanda d'Odoo (Vendes)

Mirakl Connector afegeix a la comanda una pestanya Mirakl amb la instància, la comanda, el seu estat, l'última sincronització i les dades d'enviament i contacte, i només es veu quan la comanda porta un Mirakl Order. A més canvia el que passa en esborrar la comanda, en desar canvis a les adreces i en facturar-la.

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è toca el mòdul a Vendes

El mòdul amplia la comanda estàndard de l'app Vendes d'Odoo. El que afegeix són camps a la fitxa, un d'ells també a la llista de comandes, i ajustos de comportament al codi de la comanda. Això és el que convé saber abans d'obrir la primera comanda que arribi d'un marketplace.

Esquema fet amb codi: l'app Vendes a dalt i, a sota, els camps que li afegeix Mirakl Connector
Esquema generat a partir del codi del mòdul, no és una pantalla d'Odoo. Les etiquetes van en anglès, el text original del codi.
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)

Detalls que no es veuen a la fitxa

Els camps no apareixen fins que la comanda té Mirakl Order

Els camps del mòdul són a la fitxa de la comanda, a la pestanya Mirakl, repartits en dos grups: Marketplace i Shipping & Contact. Tots s'amaguen mentre Mirakl Order sigui buit, així que en una comanda sense aquest valor no veuràs res d'això.

Al grup Marketplace hi ha Mirakl Instance, Mirakl Order, Mirakl Order State i Mirakl Last Sync At. Els quatre són de només lectura: es consulten, no s'editen.

Esquema fet amb codi amb el text del grup Marketplace en altres idiomes: Marktplatz, Place de marché i Marktplaats
Esquema generat a partir de les traduccions del mòdul, no és una pantalla d'Odoo. Amb Odoo en alemany el grup es veu com Marktplatz, en francès com Place de marché i en neerlandès com Marktplaats.

El correu del client pot ser un relé anonimitzat

Mirakl Customer Email és al grup Shipping & Contact i és de només lectura. Segons la seva ajuda, no sempre guarda el correu real del comprador: quan existeix, guarda el relé anonimitzat que Mirakl crea per a cada comanda, i el que s'hi envia arriba al comprador. Si no hi ha relé, guarda el correu del client que porta la comanda.

El telèfon i la persona de contacte tenen la seva pròpia lògica

Mirakl Customer Phone recull el telèfon que el comprador va indicar al marketplace, per tenir-lo a mà des de la mateixa comanda. Segons la seva ajuda, també es desa al contacte de lliurament. És de només lectura.

Mirakl Contact Person té una condició més. Només es veu si la comanda té Mirakl Order i, a més, el propi camp té valor. La seva ajuda diu que conté la persona que va fer la comanda quan el marketplace envia també un nom d'empresa, i que en aquest cas l'empresa s'utilitza com a nom del contacte de lliurament. Si no el veus, el camp és buit en aquesta comanda.

El mètode d'enviament també surt a la llista de comandes

Mirakl Shipping Method és a Shipping & Contact i, a diferència dels altres, apareix també a la llista de comandes. La seva ajuda diu que és el mètode d'enviament que el comprador va triar al marketplace (per exemple, Estàndard o Dia següent) i que queda buit quan l'operador no l'envia.

Un camp buit aquí, doncs, no indica un error: és el que passa quan l'operador no envia aquesta dada.

Esborrar una comanda de Mirakl la deixa esborrada

El mòdul canvia el que passa en eliminar una comanda. Segons el codi d'Odoo 20, abans d'esborrar-la cerca les comandes de Mirakl enllaçades. Si la comanda té Mirakl Order, cerca també la comanda de Mirakl amb aquest identificador a la mateixa instància, cosa que cobreix un pressupost que mai es va arribar a enllaçar. Després d'esborrar, marca aquestes comandes de Mirakl com a esborrades.

La raó és en un comentari del propi codi: una comanda esborrada ha de continuar esborrada, perquè la comanda de Mirakl la recorda i una nova sincronització no la crea ni la confirma automàticament una altra vegada.

Canviar client o adreces en una comanda de Mirakl

A Odoo 20, quan deses canvis al client, a l'adreça de lliurament o a l'adreça de factura d'una comanda amb Mirakl Order, el mòdul fa aquest desament de manera diferent de l'estàndard. En comandes sense Mirakl Order, el desament és l'estàndard.

La factura pot sortir simplificada o completa segons la instància

Al preparar la factura des de la comanda, el mòdul mira l'ajust de tipus de factura espanyola de la instància de Mirakl de la comanda (codi d'Odoo 20). Aquest ajust viu a la instància, no a la comanda; el repassa Els camps d'Instància de Mirakl a Mirakl Connector.

  • Si la comanda no té instància, o l'ajust és en automàtic, la factura es prepara com a Odoo estàndard.
  • Si la localització espanyola d'Odoo no està instal·lada (les factures no tenen el camp de factura simplificada), tampoc no es toca res.
  • Si l'ajust és simplificada, la factura es marca com a simplificada. Si és completa, es marca com a no simplificada.

Com encaixa amb la resta i què costa

El mòdul és de pagament únic per versió i necessita la subscripció a FlexigoTech Cloud: pla Connector, 49 €/mes o 490 €/any sense IVA. La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials, vigila la sincronització i avisa per correu si falla. Està publicat per a Odoo 17, 18, 19 i 20; a l'Odoo App Store cada versió s'hi compra. Més detall a la fitxa d'Odoo Apps i a la pàgina del mòdul.

Si vols que revisem com queda el flux de comandes al teu Odoo, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida.

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