Els camps de Comandes de Mirakl a Mirakl Connector: glossari

Mirakl Connector està publicat a Odoo Apps per a 17.0, 18.0, 19.0 i 20.0. Tot el que segueix correspon als menús i camps de Mirakl Connector per a Odoo 20.0.

On són els camps

Les fitxes s'obren des del menú Mirakl › Operations › Orders. Si no veus el menú Mirakl, et falta el permís que demana aquest tram del menú.

Mirakl Orders

La fitxa i la llista de comandes de Mirakl. Alguns camps surten només a la fitxa, altres també a la llista i un només el veuen els usuaris amb un permís concret.

Comissió i enviament

Amount Commission

Camp d'import monetari. Es veu a la fitxa de Mirakl Orders i també a la vista pivot d'aquest model. La seva ajuda diu: «Marketplace commission charged by the operator on this order (seller cost). Read from the Mirakl payload (commission_fee / total_commission).». Què convé: prendre'l com el cost del venedor que informa l'operador i, si una xifra no et quadra, contrastar-la amb el Raw Payload (més avall).

Shipping Type Code

Text curt que es veu a la fitxa, dins del grup Shipping Method. La seva ajuda diu: «Mirakl shipping method code chosen by the buyer (e.g. STD, EXPRESS).». Què convé: llegir-lo com la clau que fa servir Mirakl; el text pensat per a persones és al camp següent.

Shipping Method

Text curt que es veu a la fitxa, al mateix grup Shipping Method, i també a la llista de Mirakl Orders. La seva ajuda diu: «Shipping method chosen by the buyer, as shown by the marketplace (e.g. 'Standard home delivery', 'Next day').». Què convé: fer-lo servir per saber què va triar el comprador sense haver d'interpretar el codi.

Ship Before

Data i hora que es veu a la fitxa, grup Shipping Dates, i també a la llista. La seva ajuda diu: «Mirakl deadline to hand the parcel to the carrier. Shipping after this date hurts your marketplace quality score.». Què convé: tenir present aquesta data en preparar l'enviament, perquè la mateixa ajuda avisa que passar-se afecta la teva puntuació.

Abonament

Els dos camps són al grup Refund de la fitxa i s'assemblen en el nom, però no fan el mateix.

Refund Reason

Text curt. La seva ajuda diu: «Internal note about the refund. What Mirakl actually requires is the operator's reason CODE below.». Què convé: escriure'l com a nota per al teu equip, sabent que no substitueix el codi.

Refund Reason Code

Text curt. La seva ajuda diu: «Operator-defined reason code required by the Mirakl refund API (OR28), e.g. Decathlon publishes codes like 'RET' or '11'. Use 'Fetch Refund Reasons' on the marketplace instance to list the codes your operator accepts.». Què convé: posar un codi dels que accepti el teu operador, no una descripció; l'ajuda indica on consultar-los.

Quan no hi ha comanda de venda

No Sales Order Because

Camp de selecció que explica per què el connector no crea una comanda de venda per a aquesta comanda de Mirakl. Només apareix si la comanda no té comanda de venda i el camp té un motiu; en una comanda normal no el veuràs. També surt a la llista, en només lectura. L'omple el mòdul, no l'usuari, i es buida en crear la comanda de venda amb el botó Create Sales Order. La seva ajuda diu: «Why the connector does not create a sales order for this Mirakl order. Use the 'Create Sales Order' button to create it anyway.». Què convé: llegir el motiu abans de decidir si vols crear-la igualment.

Els valors possibles són aquests:

Its sales order was deleted in Odoo

La comanda de venda d'aquesta comanda de Mirakl es va eliminar a Odoo.

Already shipped, closed or refunded in Mirakl when imported

Quan la comanda es va importar, a Mirakl ja estava enviada, tancada o abonada.

Created before 'Create Sales Orders From'

La comanda de Mirakl es va crear abans de la data de 'Create Sales Orders From'. Si ho veus i vols la comanda de venda, l'ajuda del camp apunta al botó Create Sales Order.

Dades tècniques

Raw Payload

Text llarg dins del grup Payload Raw (Technical) de la fitxa. Només el veuen els usuaris amb un permís concret d'administració, i en només lectura. La seva ajuda diu: «The marketplace payload exactly as received, formatted for reading. This is what to attach when reporting an import problem.». Què convé: no editar-lo (és de només lectura) i copiar-lo sencer quan calgui comunicar un error d'importació.

Com ajuda FlexigoTech

Si estàs implantant Odoo i vols connectar Mirakl, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. El mòdul és de pagament únic per versió 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 FlexigoTech Cloud, que desa xifrades les credencials, vigila la sincronització i avisa per correu si falla. El preu del mòdul per versió és a la fitxa d'Odoo Apps i la compra, a la pàgina del mòdul.

Si encara estàs connectant el compte, abans de mirar comandes et serveix què fa el botó Provar connexió, pas a pas.

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_order.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html