Campos da Instância Mirakl no Mirakl Connector: glossário com o que convém definir

Na ficha de Instâncias Mirakl (Mirakl Instances), vários campos decidem o que o conector Mirakl traz para o Odoo e quando. A ficha abre-se a partir de Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces). Os campos e os seus valores por defeito são os do código do Odoo 20; o módulo está publicado para Odoo 17, 18, 19 e 20.

Os campos estão em dois separadores: Encomendas e Devoluções (Orders and Returns) e Faturas e Mensagens (Invoices and Messages).

Encomendas abertas: reler o que já está no Odoo

Atualizar o estado das encomendas abertas (Refresh Status of Open Orders)

Caixa do separador Encomendas e Devoluções, grupo Windows. Vem desmarcada. Segundo a sua ajuda, depois de cada importação volta a ler no Mirakl cada encomenda que já está no Odoo e ainda não terminou (não recebida, fechada, rejeitada nem cancelada) e atualiza o seu estado, mesmo que a encomenda seja anterior à janela de importação. Sem ela, uma encomenda cujo estado muda no marketplace muito depois de ser criada fica no Odoo com o estado antigo. O que definir: marque-a se lhe interessa que essas alterações tardias cheguem ao Odoo.

Encomendas abertas atualizadas por execução (Open Orders Refreshed per Run)

Número inteiro no mesmo grupo Windows. Só aparece quando a caixa anterior está marcada, por isso com os valores por defeito não o vê. Vem com 100. A sua ajuda diz que é o máximo de encomendas abertas que se relêem no Mirakl em cada execução, e que se leem primeiro as que há mais tempo não são atualizadas, de modo que tudo o que está pendente é coberto em execuções sucessivas. O que definir: pode começar com o valor que traz; a própria ajuda indica que o pendente não tem de caber numa só execução.

Devoluções: interruptor, alternativa e aviso

Sincronização de Devoluções Ativada (Sync Returns Enabled)

Caixa do grupo Política de Sincronização (Sync Policy), separador Encomendas e Devoluções; também aparece na lista de Instâncias Mirakl. Vem desmarcada. A sua ajuda: ativar a importação agendada genérica de devoluções do Mirakl para esta instância. A tarefa agendada Mirakl - Sincronizar Devoluções (Mirakl - Sync Returns) corre a cada 30 minutos e está ativa ao instalar. O que definir: marque-a nas instâncias de que queira trazer devoluções de forma agendada.

Devoluções Recorrem a Encomendas (Returns Fallback To Orders)

Caixa do mesmo grupo; ao contrário das anteriores, vem marcada. A sua ajuda diz: se /returns não estiver disponível, constrói registos de devolução genéricos a partir dos reembolsos encontrados nos payloads das encomendas. O que definir: deixe-a como vem se quiser essa alternativa; desmarque-a só se não a quiser.

Endpoint de Devoluções Indisponível (Returns Endpoint Unavailable)

Caixa só de leitura no mesmo grupo: não é você que a preenche. A sua ajuda diz que é definida automaticamente quando /returns devolve 404, para que a sincronização agendada ignore o endpoint até ser repetida manualmente. Quem a limpa é o código da sincronização de devoluções, a que se chega a partir do botão Importar Devoluções (Import Returns) e a partir da tarefa agendada. O que verificar: se estiver marcada, a sincronização agendada salta esse endpoint.

Aceitar e confirmar encomendas

Os três campos seguintes estão em Política de Sincronização e vêm desmarcados. As suas ajudas descrevem coisas diferentes, por isso convém lê-las uma a uma.

Aceitar Encomendas Automaticamente (Auto Accept Orders)

A sua ajuda: aceitar automaticamente as encomendas importadas que requerem a aceitação do vendedor no Mirakl. O que definir: marque-a se quiser que essa aceitação se faça sozinha.

Aceitar Pendentes na Importação (Accept Pending On Import)

A sua ajuda: tentar aceitar as encomendas em espera logo a seguir a cada importação de encomendas, manual ou agendada.

Confirmar Venda Automaticamente (Auto Confirm Sale)

A sua ajuda: confirmar automaticamente as ordens de vendas importadas após a sincronização. O que definir: marque-a só se quiser que essas ordens de vendas sejam confirmadas sem intervenção de uma pessoa.

Faturas (liquidações)

Estão no separador Faturas e Mensagens, grupo Faturas (Liquidações) (Invoices (Settlements)).

Sincronização de Faturas Ativada (Sync Invoices Enabled)

Vem desmarcada. A sua ajuda: ativar a sincronização agendada de faturas para esta instância. A tarefa Mirakl - Sincronizar Faturas (Mirakl - Sync Invoices) corre uma vez por dia e está desativada ao instalar.

Dias de Sincronização Inicial de Faturas (Initial Invoice Sync Days)

Número inteiro que vem com 90. A sua ajuda define-o como a janela histórica, em dias, para a sincronização manual de faturas. O que definir: os dias de histórico que quiser trazer quando a lançar à mão.

Endpoint de Faturas Indisponível (Invoices Endpoint Unavailable)

Caixa só de leitura. É definida automaticamente quando /invoices devolve 404, para que a sincronização agendada ignore o endpoint até ser repetida manualmente. Quem a limpa é o código da sincronização de faturas, a que se chega a partir do botão Importar Faturas (Import Invoices) e a partir da tarefa agendada.

Mensagens

No mesmo separador, grupo Mensagens (Messages).

Sincronização de Mensagens Ativada (Sync Messages Enabled)

Vem desmarcada. A sua ajuda: ativar a sincronização agendada de mensagens para esta instância. A tarefa Mirakl - Sincronizar Mensagens (Mirakl - Sync Messages) corre a cada 30 minutos e está desativada ao instalar.

Dias de Sincronização Inicial de Mensagens (Initial Message Sync Days)

Número inteiro que vem com 30. É a janela histórica, em dias, para a sincronização manual de mensagens, segundo a sua ajuda.

Endpoint de Mensagens Indisponível (Messages Endpoint Unavailable)

Caixa só de leitura. É definida automaticamente quando /messages devolve 410 Gone ou 404 (não exposto por este operador), e a sincronização agendada ignora o endpoint até ser repetida manualmente. Quem a limpa é o código da sincronização de mensagens, a que se chega a partir do botão Importar Mensagens (Import Messages) e a partir da tarefa agendada.

Como se encaixa com a FlexigoTech

A ligação ao Mirakl passa pelo FlexigoTech Cloud: guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. O módulo precisa dessa subscrição, plano Conector: 49 € por mês ou 490 € por ano, sem IVA. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá, e os dados ficam no seu Odoo. Pode ver o módulo na sua ficha do Odoo Apps e na página da FlexigoTech.

Se está a implementar o Odoo e quer decidir com ajuda que política de sincronização cabe a cada marketplace, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

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_instance.py
• Código do módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html