Salta al contingut principal
Mirakl

Els camps de la instància de Mirakl a Odoo: què vol dir cadascun i què posar-hi

A la fitxa de cada marketplace de Mirakl Connector es decideix com entra una comanda a Odoo: enviament, descompte, comissió, idioma, factura i ritme d'importació. Aquí tens cada camp segons la seva pròpia ajuda i què convé posar-hi.

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

On són els camps i per què alguns no es veuen

Esquema fet amb codi del menú de Marketplaces i de la fitxa d'instància amb els camps que s'expliquen més avall
Esquema fet amb codi (no és una captura d'Odoo): el menú i els camps de la fitxa de la instància

On s'obren aquests camps?

Des del menú Mirakl › Configuration › Marketplaces s'obren les fitxes de Mirakl Instances. Aquests camps són a la pestanya Orders and Returns, repartits en grups: Sales Bridge, Customer & Privacy, Sync Policy i Windows. El mòdul està publicat a Odoo Apps per a Odoo 17, 18, 19 i 20.

Per què no veig Shipping Line, Commission Product ni Auto-post the created invoice?

Perquè s'oculten segons un altre camp, i amb els valors per defecte no es veuen.

  • Shipping Line s'oculta mentre la instància no té producte d'enviament.
  • Commission Product només apareix quan Commission in sale order està en Deduct commission (net you receive).
  • Auto-post the created invoice només apareix amb Auto-create invoice on delivery validation activat.
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)

Preu de la comanda: enviament, descompte i comissió

Quan afegeix el mòdul la línia d'enviament a la comanda de venda?

Ho decideix Shipping Line. L'ajuda demana indicar a dalt un Producte d'enviament, sigui quina sigui l'opció triada. Amb Only when the marketplace charged shipping no hi ha línia si el marketplace ha enviat gratis. Amb Always, even when shipping is free (0.00) es crea igualment una línia a 0.00, així totes les comandes tenen la mateixa estructura i el descompte de marketplace s'aplica també a aquesta línia. El valor per defecte és Only when the marketplace charged shipping.

Esquema fet amb codi de l'opció Always, even when shipping is free (0.00) en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades, no és una captura d'Odoo: així es veu aquesta opció segons l'idioma d'Odoo

Per a què serveix Marketplace Discount (%)?

El camp Marketplace Discount (%) escriu un percentatge a la columna Desc.% de cada línia importada, tant les de producte com la d'enviament. L'ajuda ho planteja per a quan el marketplace et compra amb un marge fix sobre el preu que veu el comprador: així el total de la comanda coincideix amb el que factures a l'operador. Exemple de la mateixa ajuda: total a Mirakl 100.00 amb un 20% de descompte, la línia d'Odoo mostra 100.00 amb Desc.% 20% i un subtotal de 80.00. Per defecte val 0, i amb 0 els preus s'importen sense canvis.

Com reflecteix Odoo la comissió del marketplace?

Depèn de Commission in sale order, el valor per defecte del qual és sense comissió. La comissió és el que el marketplace et cobra a tu i dedueix del teu pagament.

  • No commission (total paid by the customer): el total és producte més impost, el que paga el client. La comissió només es desa a la comanda de Mirakl com a dada informativa.
  • Deduct commission (net you receive): s'afegeix una línia negativa amb la comissió fent servir el Commission Product, un producte de servei. El total és producte més impost menys comissió, el net que reps.
  • Operator purchase price (the operator buys from you): per a marketplaces on l'operador et compra la mercaderia i factura ell mateix al comprador (GACD, per exemple). Cada línia pren el preu de compra que Mirakl dona per a ella i Odoo afegeix els impostos del producte, de manera que la comanda coincideix amb l'ordre de compra de l'operador. A aquestes línies no se'ls aplica el descompte de marketplace. Si Mirakl no envia preu de compra per a una línia, aquesta línia conserva el preu del comprador i el descompte, i es deixa una nota a la comanda de venda i als registres de Mirakl.

La tria depèn de quina xifra vulguis veure a la comanda: el que paga el client, el que cobres net o l'ordre de compra de l'operador.

Quin idioma es posa als clients que crea el marketplace?

El de Language of Imported Contacts. S'aplica als clients i contactes de lliurament que aquest marketplace crea a Odoo, i marca l'idioma dels seus pressupostos, factures i correus. Si el deixes buit s'usa el predeterminat d'Odoo. Només surten els idiomes instal·lats: afegeix abans el que falti a Ajustes ▸ Traducciones ▸ Idiomas.

Factures i ritme d'importació

Què trio a Invoice type (Spain)?

El camp Invoice type (Spain) defineix com es classifica la factura generada des de comandes de Mirakl quan l10n_es (TicketBAI, VeriFACTU) està instal·lat.

  • Automatic (Odoo decides): amb NIF surt una F1 completa i sense NIF una F2 simplificada. És el valor per defecte.
  • Simplified with Tax ID (F2 TicketBAI/VeriFACTU): s'emet simplificada encara que el comprador tingui NIF. L'ajuda la dona per vàlida per a B2C al País Basc (TicketBAI) o quan el teu assessor fiscal indiqui que F2 és suficient.
  • Full (F1 TicketBAI/VeriFACTU): s'emet completa encara que el comprador no tingui NIF, per exemple clients estrangers que ho requereixin.

Si dubtes, consulta-ho amb el teu assessor fiscal.

Convé crear, comptabilitzar i enviar la factura a Mirakl automàticament?

Són camps separats, i cadascun té la seva pròpia ajuda.

  • Auto-create invoice on delivery validation: està desactivat per defecte. Si l'actives, en validar un lliurament d'una comanda de Mirakl es crea la factura de client des de la seva comanda de venda. Respecta la política de facturació (comanda o lliurat) i mai bloqueja el lliurament si falla la facturació.
  • Auto-post the created invoice: l'ajuda recomana deixar-lo desactivat amb TicketBAI, VeriFACTU o SII, perquè comptabilitzar és irreversible i envia la factura electrònica a l'administració tributària. Les factures no positives es deixen en esborrany.
  • Send invoice to Mirakl: amb Manual (with a button) no es puja res sol, i l'ajuda ho marca com a recomanat, per exemple per pujar-la després d'editar client o NIF. Amb Automatic (on delivery validation) es puja en validar el lliurament, només si la factura està comptabilitzada, i requereix que l'operador tingui habilitada la pujada de factures. Reenviar substitueix el document anterior a Mirakl, sense duplicats.

Quan toco Mirakl invoice document type i Invoice PDF report?

El primer porta CUSTOMER_INVOICE i l'ajuda diu que el canviïs només si el teu operador defineix un codi personalitzat. El segon és el nom tècnic (XML id) de l'informe que genera el PDF, i ve amb account.account_invoices.

Cada quant importa comandes i com evito que es perdin canvis d'estat?

Ells governen aquests camps.

  • Sync Orders Enabled, a Sync Policy i també a la llista d'instàncies: habilita la importació programada de comandes per a aquesta instància. Per defecte està desactivada.
  • Order Sync Frequency (minutes), al grup Windows: és el temps mínim entre dues importacions d'aquest marketplace. L'acció planificada Mirakl - Sync Orders es desperta cada 10 minuts i processa la instància quan han passat aquests minuts. Amb 0 importa a cada despertar i amb 60, cada hora.
  • Filter Syncs by Last Update: demana a Mirakl el que ha canviat des de l'última sincronització, no el que s'ha creat. L'ajuda diu que el deixis activat, perquè amb el filtre per data de creació una comanda creada al matí i enviada a la tarda queda fora i el seu nou estat no arriba a Odoo. Desactiva'l només si l'API del teu operador ignora aquest filtre. La importació inicial fa servir sempre la data de creació.

Què passa amb la subscripció i com t'ajudem

Mirakl Connector és de pagament únic per versió d'Odoo i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any sense IVA, amb fins a 3 comptes de la plataforma. La connexió passa per aquest servei, que desa xifrades les credencials i avisa per correu si la sincronització falla. Sense subscripció s'atura el que aquesta dona, i les dades es queden al teu Odoo. Pots veure el mòdul a la fitxa d'Odoo Apps o a la pàgina del mòdul.

Si estàs implantant Odoo i vols revisar amb tu aquests camps abans d'activar la sincronització, 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