La confusió més comuna amb Mirakl és tractar-lo com si fos Amazon. No ho és. Mirakl és la plataforma que Decathlon, Leroy Merlin, Bricodepot, GACD i desenes de cadenes més fan servir per obrir el seu propi marketplace a venedors externs. Per a tu això té una conseqüència molt bona i una de regular.
La bona: l'API és la mateixa per a tots. Una integració ben feta amb Mirakl et val per al primer operador i per al cinquè, canviant la URL de l'operador i la clau d'API. La regular: a sobre d'aquesta base comuna, cada operador posa les seves regles (el seu arbre de categories, els seus atributs obligatoris, els seus terminis, les seves penalitzacions, i fins i tot quines parts de l'API té obertes) i aquestes no es comparteixen.
El que comparteixen tots
El cicle és sempre el mateix: publiques ofertes (producte, preu, estoc, termini), l'operador t'envia comandes, tu les acceptes o les rebutges, envies amb seguiment i cobres per liquidació. El connector de Mirakl porta aquest cicle a documents normals d'Odoo a 17, 18 i 19: publica ofertes amb preu, estoc i termini d'enviament, importa les comandes com a comandes de venda, les accepta (a mà o en automàtic si ho actives), envia a Mirakl el transportista i el número de seguiment de l'albarà i importa les liquidacions per assentar-les a comptabilitat.
Un detall que sorprèn: a Mirakl pots rebutjar línies d'una comanda. No és un error, és part del protocol. El nostre connector no rebutja línies soltes: accepta la comanda sencera. Si hi ha una línia que no pots servir, rebutja-la al back office de Mirakl abans d'acceptar, i tingues en compte que l'acceptació automàtica, que ve desactivada, accepta tot el que entra.
El que canvia amb cada operador
L'arbre de categories i els atributs obligatoris, que no s'assemblen entre una cadena d'esport i una de bricolatge. El termini d'acceptació, que en alguns operadors es mesura en hores. I l'exigència de dades del producte: hi ha operadors que rebutgen una oferta si falta l'EAN, i d'altres que a més demanen fitxa tècnica completa.
Per això tenim una pàgina per operador a més de la del connector: Decathlon, Leroy Merlin, Brico Depot i GACD. El connector base és el mateix i cada operador és una instància més, amb la seva URL i la seva clau; per a alguns operadors hi ha a més un perfil complementari que deixa posats la URL i els seus valors per defecte. El que canvia de debò és la preparació del catàleg.
El que cal preparar abans de demanar l'alta
Tres coses, i cap és tècnica. EAN a totes les referències que vulguis publicar: hi ha operadors que sense ell no t'accepten l'oferta. Un termini de preparació que puguis complir de debò, no el que t'agradaria; prometre 24 hores i servir en 72 es paga al compte. I fotos que compleixin la seva norma, que sol ser més estricta que la de la teva pròpia web.
I un advertiment per experiència pròpia
Vam auditar el nostre propi connector de Mirakl quan la seva suite de proves passava en verd a Odoo 19, 18 i 17, i vam trobar 18 errors confirmats, entre ells un registre de trucades que mai no escrivia res i una sincronització que mirava la data equivocada. Ho expliquem sencer a auditar un connector heretat. Si et volen vendre una integració de Mirakl, pregunta què passa quan l'API retorna un error, no quants tests té.
Preguntes freqüents
Una alta a Mirakl m'obre tots els operadors?
No. Cada operador t'accepta o no per separat, amb el seu propi procés comercial. Allò que es reutilitza és la integració tècnica, no la relació comercial.
Puc tenir preus diferents per operador?
Sí, i hauries: les comissions no són iguals. Al connector cada operador és una instància, i cada instància calcula el seu preu amb la seva pròpia estratègia: preu de venda del producte, una tarifa d'Odoo o cost més marge.
Què passa amb les liquidacions?
Arriben per operador i cal conciliar-les contra les vendes, descomptant la comissió. És la part que més es descuida i on s'escapa més diners sense que ningú ho noti.
Enllaços útils dins de FlexigoTech
El que fem sobre això
T'han acceptat en un marketplace de Mirakl?
Digue'ns quin operador i quantes referències vols publicar. Revisem si el teu catàleg compleix el que et demanaran abans que te'l rebutgin. Escriu a comercial@flexigobe.com o agenda una trucada.

