Què canvia als teus marketplaces Mirakl amb Odoo com a ERP
Segons la documentació de Mirakl, cada marketplace té la seva pròpia adreça (la documentació indica que cal substituir-la per la URL de la teva instància de Mirakl) i l'API de venedor s'autentica amb la clau de botiga, enviada a la capçalera Authorization. Per tant, cada operador on vens té la seva adreça i la seva clau.
Amb Mirakl Connector, cada operador passa a ser una instància de Mirakl dins d'Odoo, creada amb la URL base real de l'operador, el API Base URL i la clau d'API. Segons la seva fitxa, el mòdul connecta Odoo amb qualsevol marketplace Mirakl: publica productes, preus i estoc, i porta comandes, devolucions, liquidacions i missatges. Tot penja d'un únic menú Mirakl, amb Dashboard, Operations, Catalog, Finances i Configuration.
Cada clau de botiga es queda amb el seu operador: el mòdul només l'envia al API Base URL de la seva instància. Si se li demana contactar amb una altra adreça, s'atura amb aquest missatge: Refusing to contact …: the Mirakl API key of … only goes to its API Base URL (…). Write the endpoint as a path, such as /orders.


Operador per operador avui davant Mirakl dins d'Odoo
Aquesta és la comparativa tasca per tasca de què fas amb cada marketplace i on acaba a Odoo amb el connector.
| Tasca | Avui, operador per operador | A Odoo amb Mirakl Connector |
|---|---|---|
| Connectar cada marketplace | Cada marketplace té la seva adreça i hi entres amb la clau de botiga | Una instància per operador, amb la URL base de l'operador, el API Base URL i la clau d'API |
| Llegir comandes noves | Mirakl recomana consultar la llista de comandes (OR11) cada 5 minuts i com a màxim un cop per minut | Acció planificada Mirakl - Sync Orders, cada 10 minuts; llista a Mirakl › Operations › Orders |
| Acceptar comandes | Les línies en WAITING_ACCEPTANCE s'accepten o es refusen amb OR21 | Acció planificada Mirakl - Accept Orders, cada 10 minuts |
| Ofertes i estoc | A cada marketplace, a la seva adreça | Mirakl › Operations › Offers; accions planificades Mirakl - Export Offers (cada 5 minuts), Mirakl - Export Prices (PRI01) (cada 15 minuts) i Mirakl - Export Stock (STO01) (cada 10 minuts) |
| Devolucions | A cada marketplace, a la seva adreça | Mirakl › Operations › Returns; acció planificada Mirakl - Sync Returns, cada 30 minuts |
| Liquidacions de l'operador | A cada marketplace, a la seva adreça | Mirakl › Finances › Settlements & Invoices i, al mateix menú, Financial Analysis (P&L) |
Totes les accions planificades de la taula estan actives des que s'instal·la el mòdul. Però cadascuna només treballa amb les instàncies que tenen marcada la seva casella, i aquestes caselles per defecte estan sense marcar. Avui, cada fila es fa a cada marketplace, a la seva adreça; a Odoo, cada fila és un menú o una acció planificada del mòdul. Què afegeix el mòdul a la comanda d'Odoo, camp per camp, ho tens a què afegeix Mirakl Connector a Vendes.
El catàleg i els missatges queden fora de la taula. A Mirakl › Catalog tens Categories, Attributes, Value Lists, Category Mapping i Carrier Mapping, amb les accions planificades Mirakl - Export Catalog (cada 30 minuts) i Mirakl - Sync Catalog Dictionary (cada 60 minuts). Els missatges tenen el seu propi menú a Mirakl › Operations › Messages.


Preus de Mirakl Connect i què necessita el connector
Mirakl publica preus per a la seva eina per a venedors, Mirakl Connect, que presenta com una eina que ajuda desenes de milers de venedors a arribar als principals marketplaces del món. Els preus de la seva web són en dòlars i van per trams segons el volum de vendes mensual (GMV):
- Growth: 699 $ al mes, per a un volum de fins a 50.000 $ de GMV al mes.
- Pro: 2.299 $ al mes, per a un volum de fins a 200.000 $ de GMV al mes.
- Enterprise: a mida, per a qui supera aquest volum (més de 200.000 $ de GMV al mes).
Per portar els teus marketplaces Mirakl a Odoo amb Mirakl Connector necessites això:
- Odoo en versió 17, 18, 19 o 20.
- Mirakl Connector instal·lat en aquesta versió.
- Una subscripció a FlexigoTech Cloud amb el pla Connector, que el mòdul necessita segons la seva fitxa.
- Per a cada operador, la seva URL base real, la seva API base URL i la teva clau de botiga.
Amb aquestes dades, cada operador queda en la seva pròpia instància dins d'Odoo i cada clau de botiga només va a l'adreça d'API del seu operador.
De la implantació d'Odoo a la teva primera liquidació Mirakl, per ordre
Si encara no tens Odoo, l'ordre importa: primer Odoo, després el connector, després cada operador.
- Implanta Odoo. FlexigoTech implanta Odoo 17, 18, 19 i 20; pots començar per una implantació d'Odoo abans de connectar cap marketplace.
- Instal·la Mirakl Connector a la teva versió i vincula'l a la teva subscripció a FlexigoTech Cloud amb el pla Connector.
- Crea una instància de Mirakl per operador amb la URL base real de l'operador, el
API Base URLi la clau d'API de la teva botiga. AMirakl › ConfigurationtensMarketplacesiLogs. Què significa cada camp de la instància ho tens a els camps de la instància de Mirakl. - Espera la primera comanda. L'acció planificada
Mirakl - Sync Orderss'executa cada 10 minuts i les comandes apareixen aMirakl › Operations › Orders. L'acció només porta les comandes de les instàncies amb la casellaSincronització de comandes activada(Sync Orders Enabled) marcada, que per defecte ve sense marcar. A Mirakl, les línies noves que s'accepten o es refusen amb OR21 són les que estan enWAITING_ACCEPTANCE. - Revisa les teves comandes a
Mirakl › Operations › Orders: la llista mostra el seu estat i la seva acceptació. L'acció planificadaMirakl - Accept Orderss'executa cada 10 minuts i està activa en instal·lar. Només accepta comandes a les instàncies amb la casellaAccepta automàticament les comandes(Auto Accept Orders) marcada, que per defecte ve sense marcar. - Repassa les teves ofertes a
Mirakl › Operations › Offers. Les accions planificades que exporten ofertes, preus i estoc també estan actives en instal·lar. Però només exporten de les instàncies amb la casella corresponent marcada: les ofertes ambSincronització d'ofertes activada(Sync Offers Enabled), els preus ambExportació automàtica de preus activada(Auto Export Prices Enabled) i l'estoc ambExportació automàtica d'estoc activada(Auto Export Stock Enabled). Totes tres per defecte estan sense marcar. - Obre la primera liquidació a
Mirakl › Finances › Settlements & Invoicesi miraFinancial Analysis (P&L)al mateix menú.
Si vols veure el connector abans de decidir, la seva pàgina és a flexigotech.com. A més d'implantar Odoo, FlexigoTech desenvolupa connectors i integracions a mida, per si la teva manera de treballar amb un operador concret necessita alguna cosa més.
Què costa portar Mirakl a Odoo: mòdul i pla Connector
Mirakl Connector costa 9 € per versió d'Odoo, sense IVA, per a 17, 18, 19 i 20. La seva fitxa diu que necessita la subscripció a FlexigoTech Cloud: el pla Connector costa 49 €/mes o 490 €/any sense IVA, amb fins a 3 comptes de plataforma, i Pro costa 98 €/mes o 980 €/any sense IVA, amb fins a 10. La subscripció es pot provar gratis, sense targeta.
A això s'hi suma la implantació d'Odoo, que és un treball a part. El mòdul i la subscripció són a la pàgina del connector Mirakl per a Odoo.
Mirakl amb Odoo com a ERP: preguntes freqüents
Puc portar diversos operadors Mirakl al mateix Odoo?
Cada operador entra en la seva pròpia instància de Mirakl, amb la seva URL base, la seva API base URL i la seva clau. El pla Connector inclou fins a 3 comptes de plataforma i Pro fins a 10.
Cada quant arriben les comandes a Odoo?
L'acció planificada Mirakl - Sync Orders s'executa cada 10 minuts i està activa en instal·lar. Només porta les comandes de les instàncies amb la casella Sincronització de comandes activada (Sync Orders Enabled) marcada, que per defecte ve sense marcar. Mirakl, per la seva banda, recomana llegir la llista de comandes cada 5 minuts i com a màxim un cop per minut.
Pot acabar una clau de botiga en un altre operador?
El mòdul només envia la clau de cada instància al seu API Base URL. Si se li demana contactar amb una altra adreça, s'atura amb el missatge Refusing to contact …: the Mirakl API key of … only goes to its API Base URL (…). Write the endpoint as a path, such as /orders.
En quines versions d'Odoo funciona?
Mirakl Connector està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20.
Continua llegint
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or11.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or21.md
- www.mirakl.com/products/connect/pricing/
- www.mirakl.com/
- apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (2766034c): __manifest__.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (2766034c): views/menu_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (2766034c): data/ir_cron_data.xml
- flexigotech.com/ca/connector-mirakl-odoo.html
- flexigotech.com/ca/precios.html
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (2766034c): models/mirakl_api_mixin.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (2766034c): README.md
