Salta al contingut principal
Mirakl

Camps d'Instància de Mirakl a Mirakl Connector: què signifiquen i què posar

La fitxa de Mirakl Instances reparteix els seus camps en diverses pestanyes, i cadascun porta la seva pròpia ajuda. Aquí els comparem: què diu l'ajuda, quin valor porten per defecte i què canvia si els deixes buits o els omples.

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

On són els camps

Les fitxes s'obren des del menú Mirakl › Configuration › Marketplaces. A la fitxa de Mirakl Instances, els camps d'aquesta guia estan repartits en tres pestanyes: Carriers, Orders and Returns i Manual Operations.

Esquema fet amb codi del menú Mirakl, Configuration, Marketplaces i de la fitxa Mirakl Instance amb els camps que es comparen aquí
Esquema fet amb codi a partir del codi publicat del mòdul, no és una captura d'Odoo: el menú i els camps de la fitxa amb les seves etiquetes originals.
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)

Finestres d'importació i límits

Aquests camps acoten el que s'importa, s'analitza o es consulta. Tots porten un valor per defecte al codi.

CampOn ésQuè diu l'ajudaPer defecte
Initial Order Sync DaysOrders and Returns, grup Windows«Historical window used when there is no previous order sync. Manual import also uses this range.»30
Initial Return Sync DaysOrders and Returns, grup Windows«Historical window used when there is no previous return sync. Manual import also uses this range.»30
Max Sync PagesOrders and Returns, grup Windows«Safety limit for paginated order/return imports.»40
Offer Binding Generate LimitManual Operations, grup Offers«Maximum products scanned when auto-generating missing offer bindings.»500
Endpoint Shipping CarriersCarriers, grup Carrier Sync«Mirakl SH21 endpoint used to retrieve available shipping carriers when supported by the operator.»/shipping/carriers

Els dos camps de dies marquen la finestra que s'utilitza quan encara no hi ha una sincronització prèvia de comandes o de devolucions, i l'ajuda afegeix que la importació manual fa servir el mateix rang. Max Sync Pages és, segons la seva ajuda, un límit de seguretat per a les importacions paginades.

Client de la comanda: dos modes i dues caselles

El camp Order Customer Mode és a Orders and Returns, grup Customer & Privacy. Té dos valors: One customer per shopper (standard), el que ve per defecte, i Single default customer with delivery child contacts.

CampQuan es veuPer defecte
Order Customer ModeAl grup Customer & PrivacyOne customer per shopper (standard)
Default Marketplace CustomerNomés amb el mode de client únic; amb els valors per defecte no es veuOcult amb el mode estàndard
Delivery Contacts as CompaniesNomés amb el mode de client únic; amb els valors per defecte no es veuDesactivada
Use Mirakl Notification EmailAl grup Customer & PrivacyDesactivada

El que diu l'ajuda de cada opció:

  • Mode estàndard: cada comprador passa a ser el seu propi client a Odoo.
  • Client únic per defecte: totes les comandes del marketplace s'assignen a un client fix, el que tries a Default Marketplace Customer. L'adreça de lliurament del comprador es desa com a contacte fill seu (tipus Lliurament, marcat com a comprador del marketplace), així les dades personals queden acotades i es poden ocultar amb una regla de registre. Les factures s'emeten al client per defecte i no porten dades del comprador.
  • Contactes de lliurament com a empreses: només amb client únic. Cada adreça de lliurament passa a ser un contacte d'empresa propi en lloc d'un contacte fill del client per defecte, de manera que la comanda de venda, el lliurament i l'albarà mostren l'empresa del client final i mai el nom del client per defecte. L'ajuda indica que la persona va a Persona de contacte, i que el correu que Mirakl envia del client no es desa: als marketplaces en què l'operador et compra (GACD, per exemple) és una adreça de l'operador, no del client.
  • Correu de notificació: Mirakl anonimitza el comprador darrere d'una adreça de relé per comanda, que canvia a cada comanda. Amb la casella activa, el relé s'utilitza com a correu del contacte de lliurament de la comanda (mai en una fitxa de client permanent), així les respostes arriben al comprador a través de Mirakl. En mode client únic, el contacte fill del comprador porta sempre el relé quan Mirakl el facilita. El valor de cada comanda es desa també a la comanda de venda.

Pont de vendes: buit davant ple

A la pestanya Orders and Returns, el grup Sales Bridge reuneix camps l'ajuda dels quals diu què passa si els deixes buits.

CampSi el deixes buitSi l'omples
Shipping Product. En pantalla va sense etiqueta: només es veu el seu contingutNo s'afegeix cap línia d'enviament a la comanda de vendaAquest producte de servei s'utilitza per a la línia de despeses d'enviament
Create Sales Orders FromSense límitLes comandes de Mirakl creades abans d'aquesta data s'importen però mai passen a ser comandes de venda
Salesperson on OrdersDecideix Odoo: el comercial del client o, si no en té, l'usuari que ha importat la comanda (OdooBot a la importació automàtica)Aquest comercial es posa a cada comanda de venda importada d'aquest marketplace
Shipping Method on OrdersLes comandes de venda no porten mètode d'enviamentAquest mètode es posa a cada comanda de venda i, amb ell, al seu lliurament

Dos matisos de l'ajuda. A Create Sales Orders From, el motiu és que les comandes que es van gestionar abans d'usar el connector no s'enviïn una altra vegada. A Shipping Method on Orders, l'ajuda demana assignar-lo a Mirakl > Catálogo > Asignación de transportistas perquè el número de seguiment arribi a Mirakl amb el transportista correcte.

Enviar el seguiment en validar

La casella Send Tracking to Mirakl on Validation està desactivada per defecte. Activada, en validar el lliurament a Odoo s'envia l'enviament a Mirakl (número de seguiment, transportista i confirmació d'enviament), perquè el marketplace marqui la comanda com a enviada i el comprador vegi el seguiment. L'ajuda posa dos requisits: el lliurament ha de portar un número de seguiment i el seu transportista hauria d'estar mapat a la pestanya Carriers. Si falta el número, l'albarà no es toca i una nota explica per què. Alguns perfils de marketplace, com Leroy Merlin, ho envien sempre perquè l'operador ho exigeix.

El camp de l'endpoint de transportistes

L'ajuda d'Endpoint Shipping Carriers es llegeix, amb Odoo en català, «Mirakl SH21 endpoint used to retrieve available shipping carriers when supported by the operator.». L'esquema mostra aquest mateix text en alemany, francès, italià i portuguès.

Esquema amb l'ajuda del camp Endpoint Shipping Carriers en català, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no és una captura d'Odoo.

Què posar segons el teu cas

  • Venies al marketplace abans d'instal·lar el connector: omple Create Sales Orders From; segons l'ajuda, les comandes anteriors s'importen però no passen a ser comandes de venda.
  • No vols un client d'Odoo per comprador: tria el mode de client únic i indica el Default Marketplace Customer; l'ajuda suggereix un contacte genèric per marketplace.
  • Vols que el comprador vegi el seguiment en validar: activa Send Tracking to Mirakl on Validation i revisa el transportista a la pestanya Carriers.
  • No vols línia de despeses d'enviament: deixa Shipping Product buit.
  • No tens un comercial fix per a aquestes comandes: deixa Salesperson on Orders buit i decidirà Odoo segons la seva ajuda.

Cost i ajuda de FlexigoTech

Mirakl Connector és un mòdul de pagament únic per versió d'Odoo (publicat a Odoo Apps per a 17, 18, 19 i 20) i necessita la subscripció a FlexigoTech Cloud: pla Connector, 49 €/mes o 490 €/any sense IVA, fins a 3 comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. Tens la fitxa d'Odoo Apps i la pàgina del mòdul. Si prefereixes que algú configuri la instància amb tu, 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.Els camps de la instància de Mirakl a Odoo: què vol dir cadascun i què posar-hiGuia dels camps de la instància de Mirakl Connector per a Odoo: enviament, descompte, comissió, idioma, factures i sincronització, segons la seva ajuda.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts