Botão «Obter Transportadoras Mirakl»: o que faz e que erros dá

Antes de carregar: onde está e o que verificar

As fichas de instância abrem-se a partir do menu Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces). O botão Obter Transportadoras Mirakl está no ecrã Instâncias Mirakl (Mirakl Instances) e não depende de nenhuma condição da vista: vê-se sempre, no Odoo 17, 18, 19 e 20.

• Abre a ficha da instância a partir de Mirakl › Configuração › Marketplaces. O botão trabalha sobre uma só instância, a que tens aberta.

• Confirma que o teu Odoo é da versão 17, 18, 19 ou 20: o módulo está publicado no Odoo Apps para essas quatro e o botão existe em todas elas.

• Revê o campo Transportadoras de Envio do Endpoint (Endpoint Shipping Carriers), na ficha, separador Transportadoras, grupo Sincronização de Transportadoras. A sua ajuda diz: «Endpoint SH21 do Mirakl utilizado para obter as transportadoras de envio disponíveis quando suportado pelo operador.» O valor por defeito que vem no código é /shipping/carriers.

• Confirma que a subscrição do FlexigoTech Cloud está ativa. A ligação passa por esse serviço e, sem subscrição ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no teu Odoo.

O que faz o botão ao carregar, por ordem

• Consulta o Mirakl: lança um pedido de leitura (GET) a um endpoint de transportadoras. Se houver vários endpoints candidatos, experimenta-os um a seguir ao outro.

• Se um endpoint responder com um erro 404, passa ao candidato seguinte.

• Se o erro for de outro tipo, a ação pára com Não foi possível obter as transportadoras do Mirakl: … (Could not fetch carriers from Mirakl: …), em que as reticências são o erro recebido. Como a ação pára, não se guarda o que ia mudar e não se mostra nenhum aviso.

• Se o FlexigoTech Cloud não deixar passar o pedido (sem subscrição ou com o serviço em pausa), a ação pára e não se marca nada.

• Se nenhum endpoint devolver uma resposta, publica no chatter e num aviso de advertência Este operador não expõe transportadoras Mirakl genéricas via SH21. Tentado: …. (This operator does not expose generic Mirakl carriers via SH21. Tried: ….). As reticências são os endpoints testados.

• Se o endpoint que respondeu for diferente do que estava em Transportadoras de Envio do Endpoint, o módulo escreve nesse campo o que respondeu.

• Lê a resposta. Se não a conseguir interpretar como uma lista de transportadoras, a ação pára com Formato de resposta inesperado do endpoint de transportadoras Mirakl. (Unexpected response format from Mirakl carriers endpoint.)

• Processa a lista e obtém dois dados: quantas transportadoras há e quantos mapeamentos de transportadora foram atualizados.

• Se, depois de processar a resposta, não houver nenhuma transportadora, publica no chatter e num aviso de advertência O operador respondeu a … mas não devolveu transportadoras. O mapeamento de transportadoras permanece opcional para esta instância. (The operator responded to … but returned no carriers. Carrier mapping remains optional for this instance.) O espaço em branco é o endpoint que respondeu.

O que deves ver quando corre bem

O aviso de sucesso só sai quando, depois de processar a resposta, há pelo menos uma transportadora.

• Um aviso no ecrã com o título Transportadoras Mirakl (Mirakl Carriers) e o texto … transportadoras disponíveis em …. … mapeamento(s) atualizado(s). Consulte o chatter para a lista completa. (… carriers available from …. … map(s) updated. See chatter for full list.) Os espaços em branco são, por ordem, o número de transportadoras, o endpoint que respondeu e o número de mapeamentos atualizados. O aviso não fica fixo no ecrã.

• Abre o chatter da instância: o módulo publica aí uma mensagem com o endpoint, quantas transportadoras estão disponíveis, a lista com o código de cada uma e o seu nome entre parênteses, e quantos mapeamentos de transportadora foram atualizados.

• Volta a ver Transportadoras de Envio do Endpoint: se respondeu um endpoint diferente do configurado, o campo já tem o valor do que respondeu.

Quando não corre bem: o que rever em cada caso

• Não foi possível obter as transportadoras do Mirakl: … sai ao carregar no botão quando um pedido falha com um erro que não é um 404. O que fazer: lê o detalhe que vem depois dos dois pontos, que é o erro recebido. Se tens dúvidas sobre a ligação ao Mirakl, vê o que faz o botão Testar ligação.

• Formato de resposta inesperado do endpoint de transportadoras Mirakl. sai ao carregar no botão quando a resposta chega, mas o módulo não a consegue ler como lista de transportadoras. O que fazer: revê o valor de Transportadoras de Envio do Endpoint e lembra-te do que diz a sua ajuda, que é o endpoint SH21 para obter as transportadoras de envio quando o operador o suporta.

• Este operador não expõe transportadoras Mirakl genéricas via SH21. Tentado: …. aparece no chatter e num aviso de advertência quando nenhum endpoint devolve uma resposta. O que fazer: vê que endpoints figuram depois de «Tentado:» e compara-os com Transportadoras de Envio do Endpoint.

• O operador respondeu a … mas não devolveu transportadoras. O mapeamento de transportadoras permanece opcional para esta instância. aparece no chatter e num aviso de advertência quando não fica nenhuma transportadora depois de processar a resposta. O que fazer: o próprio texto diz que o mapeamento de transportadoras continua opcional para essa instância.

• Se o FlexigoTech Cloud não deixar passar o pedido (sem subscrição ou com o serviço em pausa), a ação pára e não se marca nada: confirma que a subscrição está ativa.

A etiqueta do botão em cada idioma

O que precisas e como te ajuda a FlexigoTech

O Mirakl Connector é um módulo de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud: plano Conector, 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. O preço de cada versão do Odoo está na ficha do Odoo Apps.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiseres que revejamos a tua instância do Mirakl, tens a página do módulo.

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): views/mirakl_instance_views.xml
• 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/precios.html
• flexigotech.com/en/services.html