Salta al contingut principal
Mirakl

Camps d'Instància de Mirakl a Mirakl Connector: glossari amb el que convé posar

Els camps de comandes obertes, devolucions, factures, missatges i acceptació vénen desmarcats per defecte; d'aquests camps, només Returns Fallback To Orders ve marcat.

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
5 min

A la fitxa de Mirakl Instances, diversos camps decideixen què porta el connector de Mirakl a Odoo i quan. La fitxa s'obre des de Mirakl › Configuration › Marketplaces. Els camps i els seus valors per defecte són els del codi d'Odoo 20; el mòdul està publicat per a Odoo 17, 18, 19 i 20.

Esquema del menú d'accés i de la fitxa de la instància de Mirakl amb els seus camps
Esquema fet amb codi a partir del codi publicat del mòdul (no és una captura d'Odoo): el menú d'accés i la fitxa amb els camps, amb els seus rètols originals del codi.

Els camps són en dues pestanyes: Orders and Returns i Invoices and Messages.

Comandes obertes: rellegir el que ja és a Odoo

Refresh Status of Open Orders
Casella de la pestanya Orders and Returns, grup Windows. Ve desmarcada. Segons la seva ajuda, després de cada importació torna a llegir a Mirakl cada comanda que ja és a Odoo i encara no ha acabat (no rebuda, tancada, rebutjada ni cancel·lada) i n'actualitza l'estat, encara que la comanda sigui anterior a la finestra d'importació. Sense ella, una comanda l'estat de la qual canvia al marketplace molt després de crear-se es queda a Odoo amb l'estat antic. Què posar: marca-la si t'importa que aquests canvis tardans arribin a Odoo.
Open Orders Refreshed per Run
Nombre enter al mateix grup Windows. Només apareix quan la casella anterior està marcada, així que amb els valors per defecte no el veus. Ve amb 100. La seva ajuda diu que és el màxim de comandes obertes que es rellegeixen a Mirakl a cada passada, i que es llegeixen primer les que porten més temps sense actualitzar, de manera que tot el pendent es cobreix en passades successives. Què posar: pots començar amb el valor que porta; la mateixa ajuda indica que el pendent no ha de cabre en una sola passada.
Esquema amb l'ajuda del camp Refresh Status of Open Orders tal com la veu l'usuari segons l'idioma del seu Odoo
Esquema fet amb codi a partir de les traduccions publicades del mòdul (no és una captura d'Odoo): la mateixa ajuda en castellà, alemany, francès, italià i portuguès.
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)

Devolucions: interruptor, suport i avís

Sync Returns Enabled
Casella del grup Sync Policy, pestanya Orders and Returns; també surt a la llista de Mirakl Instances. Ve desmarcada. La seva ajuda: habilitar la importació programada genèrica de devolucions de Mirakl per a aquesta instància. La tasca programada Mirakl - Sync Returns s'executa cada 30 minuts i està activa en instal·lar. Què posar: marca-la a les instàncies de les quals vulguis portar devolucions de manera programada.
Returns Fallback To Orders
Casella del mateix grup; a diferència de les anteriors, ve marcada. La seva ajuda diu: si /returns no està disponible, construeix registres de devolució genèrics a partir dels reemborsaments trobats als payloads de les comandes. Què posar: deixa-la com ve si vols aquest suport; desmarca-la només si no el vols.
Returns Endpoint Unavailable
Casella de només lectura al mateix grup: no l'omples tu. La seva ajuda diu que s'estableix automàticament quan /returns retorna 404, perquè la sincronització programada ometi l'endpoint fins que es reintenti manualment. Qui la buida és el codi de la sincronització de devolucions, al qual s'arriba des del botó Import Returns i des de la tasca programada. Què mirar: si està marcada, la sincronització programada se salta aquest endpoint.

Acceptar i confirmar comandes

Els tres camps següents són a Sync Policy i vénen desmarcats. Les seves ajudes descriuen coses diferents, així que convé llegir-les una a una.

Auto Accept Orders
La seva ajuda: acceptar automàticament les comandes importades que requereixen l'acceptació del venedor a Mirakl. Què posar: marca-la si vols que aquesta acceptació es faci sola.
Accept Pending On Import
La seva ajuda: intentar acceptar les comandes en espera just després de cada importació de comandes, manual o programada.
Auto Confirm Sale
La seva ajuda: confirmar automàticament les comandes de venda importades després de la sincronització. Què posar: marca-la només si vols que aquestes comandes de venda es confirmin sense intervenció d'una persona.

Factures (liquidacions)

Són a la pestanya Invoices and Messages, grup Invoices (Settlements).

Sync Invoices Enabled
Ve desmarcada. La seva ajuda: habilitar la sincronització programada de factures per a aquesta instància. La tasca Mirakl - Sync Invoices s'executa un cop al dia i està desactivada en instal·lar.
Initial Invoice Sync Days
Nombre enter que ve amb 90. La seva ajuda el defineix com la finestra històrica, en dies, per a la sincronització manual de factures. Què posar: els dies d'històric que vulguis portar quan la llancis a mà.
Invoices Endpoint Unavailable
Casella de només lectura. S'estableix automàticament quan /invoices retorna 404, perquè la sincronització programada ometi l'endpoint fins que es reintenti manualment. La buida el codi de la sincronització de factures, al qual s'arriba des del botó Import Invoices i des de la tasca programada.

Missatges

A la mateixa pestanya, grup Messages.

Sync Messages Enabled
Ve desmarcada. La seva ajuda: habilitar la sincronització programada de missatges per a aquesta instància. La tasca Mirakl - Sync Messages s'executa cada 30 minuts i està desactivada en instal·lar.
Initial Message Sync Days
Nombre enter que ve amb 30. És la finestra històrica, en dies, per a la sincronització manual de missatges, segons la seva ajuda.
Messages Endpoint Unavailable
Casella de només lectura. S'estableix automàticament quan /messages retorna 410 Gone o 404 (no exposat per aquest operador), i la sincronització programada ometi l'endpoint fins que es reintenti manualment. La buida el codi de la sincronització de missatges, al qual s'arriba des del botó Import Messages i des de la tasca programada.

Com encaixa amb FlexigoTech

La connexió amb Mirakl passa per FlexigoTech Cloud: desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. El mòdul necessita aquesta subscripció, pla Connector: 49 € al mes o 490 € a l'any, sense IVA. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció, i les dades es queden al teu Odoo. Pots veure el mòdul a la seva fitxa d'Odoo Apps i a la pàgina de FlexigoTech.

Si estàs implantant Odoo i vols decidir amb ajuda quina política de sincronització li toca a cada marketplace, 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