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.


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.
| Camp | On és | Què diu l'ajuda | Per defecte |
|---|---|---|---|
Initial Order Sync Days | Orders and Returns, grup Windows | «Historical window used when there is no previous order sync. Manual import also uses this range.» | 30 |
Initial Return Sync Days | Orders and Returns, grup Windows | «Historical window used when there is no previous return sync. Manual import also uses this range.» | 30 |
Max Sync Pages | Orders and Returns, grup Windows | «Safety limit for paginated order/return imports.» | 40 |
Offer Binding Generate Limit | Manual Operations, grup Offers | «Maximum products scanned when auto-generating missing offer bindings.» | 500 |
Endpoint Shipping Carriers | Carriers, 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.
| Camp | Quan es veu | Per defecte |
|---|---|---|
Order Customer Mode | Al grup Customer & Privacy | One customer per shopper (standard) |
Default Marketplace Customer | Només amb el mode de client únic; amb els valors per defecte no es veu | Ocult amb el mode estàndard |
Delivery Contacts as Companies | Només amb el mode de client únic; amb els valors per defecte no es veu | Desactivada |
Use Mirakl Notification Email | Al grup Customer & Privacy | Desactivada |
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.
| Camp | Si el deixes buit | Si l'omples |
|---|---|---|
Shipping Product. En pantalla va sense etiqueta: només es veu el seu contingut | No s'afegeix cap línia d'enviament a la comanda de venda | Aquest producte de servei s'utilitza per a la línia de despeses d'enviament |
Create Sales Orders From | Sense límit | Les comandes de Mirakl creades abans d'aquesta data s'importen però mai passen a ser comandes de venda |
Salesperson on Orders | Decideix 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 Orders | Les comandes de venda no porten mètode d'enviament | Aquest 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.

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 Validationi revisa el transportista a la pestanyaCarriers. - No vols línia de despeses d'enviament: deixa
Shipping Productbuit. - No tens un comercial fix per a aquestes comandes: deixa
Salesperson on Ordersbuit 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
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): 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
