Os campos de Encomendas Mirakl no Mirakl Connector: glossário

O Mirakl Connector está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0. O que se segue corresponde aos menus e campos do Mirakl Connector para Odoo 20.0.

Onde estão os campos

As fichas abrem-se a partir do menu Mirakl › Operações › Encomendas (Mirakl › Operations › Orders). Se não vê o menu Mirakl, falta-lhe a permissão que esse troço do menu exige.

Encomendas Mirakl (Mirakl Orders)

A ficha e a lista de encomendas Mirakl. Alguns campos aparecem só na ficha, outros também na lista e um só é visível para os utilizadores com uma permissão concreta.

Comissão e envio

Montante de Comissão (Amount Commission)

Campo de montante monetário. Vê-se na ficha de Encomendas Mirakl e também na vista pivot desse modelo. A sua ajuda diz: «Comissão do marketplace cobrada pelo operador nesta encomenda (custo do vendedor). Lida a partir do payload Mirakl (commission_fee / total_commission).». O que convém: tomá-lo como o custo do vendedor comunicado pelo operador e, se um valor não bater certo, confrontá-lo com o Payload Bruto (mais abaixo).

Código do tipo de envio (Shipping Type Code)

Texto curto que aparece na ficha, dentro do grupo Método de envio (Shipping Method). A sua ajuda diz: «Código do método de envio Mirakl escolhido pelo comprador (p. ex. STD, EXPRESS).». O que convém: lê-lo como a chave que a Mirakl usa; o texto pensado para pessoas está no campo seguinte.

Método de envio (Shipping Method)

Texto curto que aparece na ficha, no mesmo grupo Método de envio, e também na lista de Encomendas Mirakl. A sua ajuda diz: «Método de envio escolhido pelo comprador, tal como o marketplace o mostra (p. ex. 'Entrega standard ao domicílio', 'Dia seguinte').». O que convém: usá-lo para saber o que o comprador escolheu sem ter de interpretar o código.

Enviar antes de (Ship Before)

Data e hora que aparece na ficha, grupo Datas de envio (Shipping Dates), e também na lista. A sua ajuda diz: «Prazo da Mirakl para entregar a encomenda à transportadora. Enviar depois desta data prejudica a sua pontuação de qualidade no marketplace.». O que convém: ter presente esta data ao preparar o envio, porque a própria ajuda avisa de que ultrapassá-la afeta a sua pontuação.

Reembolso

Os dois campos estão no grupo Reembolso (Refund) da ficha e têm nomes parecidos, mas não fazem o mesmo.

Motivo do Reembolso (Refund Reason)

Texto curto. A sua ajuda diz: «Nota interna sobre o reembolso. O que a Mirakl exige de facto é o CÓDIGO de motivo do operador, abaixo.». O que convém: escrevê-lo como nota para a sua equipa, sabendo que não substitui o código.

Código de motivo de reembolso (Refund Reason Code)

Texto curto. A sua ajuda diz: «Código de motivo definido pelo operador exigido pela API de reembolsos da Mirakl (OR28); p. ex. a Decathlon publica códigos como 'RET' ou '11'. Use 'Obter motivos de reembolso' na instância do marketplace para listar os códigos que o seu operador aceita.». O que convém: indicar um código dos que o seu operador aceita, não uma descrição; a ajuda diz onde os consultar.

Quando não há encomenda de venda

Sem encomenda de venda porque (No Sales Order Because)

Campo de seleção que explica porque é que o conector não cria uma encomenda de venda para essa encomenda Mirakl. Só aparece se a encomenda não tiver encomenda de venda e o campo tiver um motivo; numa encomenda normal não o verá. Também aparece na lista, só de leitura. É preenchido pelo módulo, não pelo utilizador, e fica vazio ao criar a encomenda de venda com o botão Criar encomenda de venda (Create Sales Order). A sua ajuda diz: «Porque é que o conector não cria uma encomenda de venda para esta encomenda Mirakl. Use o botão 'Criar encomenda de venda' para a criar mesmo assim.». O que convém: ler o motivo antes de decidir se quer criá-la mesmo assim.

Os valores possíveis são estes:

A sua encomenda de venda foi eliminada no Odoo

A encomenda de venda dessa encomenda Mirakl foi eliminada no Odoo.

Já enviada, fechada ou reembolsada na Mirakl ao importar

Quando a encomenda foi importada, na Mirakl já estava enviada, fechada ou reembolsada.

Criada antes de 'Criar encomendas de venda a partir de'

A encomenda Mirakl foi criada antes da data de 'Criar encomendas de venda a partir de'. Se a vir e quiser a encomenda de venda, a ajuda do campo aponta para o botão Criar encomenda de venda.

Dados técnicos

Payload Bruto (Raw Payload)

Texto longo dentro do grupo Payload Bruto (Técnico) (Payload Raw (Technical)) da ficha. Só o veem os utilizadores com uma permissão concreta de administração, e só de leitura. A sua ajuda diz: «Os dados do marketplace exatamente como recebidos, formatados para leitura. É isto que deve anexar ao reportar um problema de importação.». O que convém: não o editar (é só de leitura) e copiá-lo inteiro quando for preciso comunicar uma falha de importação.

Como a FlexigoTech ajuda

Se está a implementar o Odoo e quer ligar a Mirakl, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. O módulo é de pagamento único por versão e precisa da subscrição FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. A ligação passa pela FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. O preço do módulo por versão está na ficha do Odoo Apps e a compra, na página do módulo.

Se ainda está a ligar a conta, antes de ver encomendas serve-lhe o que faz o botão Testar ligação, passo a passo.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

• Código do módulo: 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