Quando se vê o botão e o que faz o Odoo sem o premires
É preciso premir o botão para a fatura chegar ao Mirakl?
Nem sempre. O módulo amplia o botão padrão de validar da guia de remessa e, ao validar a entrega, também pode carregar a fatura sozinho, desde que a instância tenha o envio de faturas em modo automático e a guia de remessa ainda não tenha data de carregamento. O botão serve para a carregar manualmente. À parte, a caixa Criar fatura automaticamente na validação da entrega (Auto-create invoice on delivery validation) faz com que, ao validar uma entrega de uma encomenda Mirakl, seja criada a fatura de cliente a partir da respetiva ordem de venda. Encontras a caixa na ficha de Instâncias Mirakl (Mirakl Instances), separador Encomendas e Devoluções (Orders and Returns), grupo Ponte de Vendas (Sales Bridge), e vem desativada. Segundo a sua ajuda, respeita a política de faturação (encomenda ou entregue) e nunca bloqueia a entrega se a faturação falhar.
Quando aparece o botão e porque pode faltar numa guia de remessa?
Está na ficha da guia de remessa (movimento de Inventário). Fica oculto quando a guia de remessa não é de uma encomenda Mirakl ou quando o seu estado não é Concluído. Dito ao contrário: só o vês se a guia de remessa for de uma encomenda Mirakl e estiver em Concluído. O dado É Encomenda Mirakl (Is Mirakl Order) não aparece em nenhuma vista, por isso não há caixa para consultar; o que podes verificar é o estado da guia de remessa. A condição é a mesma no Odoo 17, 18, 19 e 20.

O que faz ao premi-lo, passo a passo
O que faz exatamente o botão?
O código percorre as guias de remessa sobre as quais atua e fica com as que são de encomendas Mirakl. Para cada uma procura a instância Mirakl da ordem de venda a que está ligada. Se a guia de remessa não tiver ordem de venda, não há instância e o botão passa ao lado sem fazer nada. Se houver, pede à instância que carregue a fatura; segundo o próprio código do módulo, o que se carrega é o PDF da fatura contabilizada. Se o carregamento correr bem, o módulo guarda a data e a hora do carregamento na guia de remessa e deixa lá uma nota.

Carregar Fatura para o Mirakl), presente no Odoo 17, 18, 19 e 20.O que muda na guia de remessa se correr bem?
Duas coisas: ficam guardadas a data e a hora do carregamento, e aparece na guia de remessa a nota Mirakl: fatura carregada para o marketplace. O caminho automático só carrega se essa data estiver vazia.
O que acontece se o carregamento falhar?
Com o botão, o erro é lançado de novo: vês no ecrã, a ação é interrompida e não se guarda o que ia mudar, ou seja, não fica data de carregamento. Se for o FlexigoTech Cloud a não deixar passar a operação, não se carrega nada nem se marca nada, para a poder enviar mais tarde, e o botão também mostra o erro. No caminho automático, pelo contrário, o erro não é lançado de novo: perante uma falha corrente o módulo deixa na guia de remessa uma nota com o erro e a data não é marcada; se for o FlexigoTech Cloud a não passar a operação, também não se marca nada. O texto concreto do erro depende do que responder o carregamento e não é fixado pelo botão.
Posso premi-lo se a fatura já foi carregada?
Ao premi-lo, o botão não verifica por si se já existe data de carregamento, ao passo que o caminho automático exige que esteja vazia. Antes de a repetir manualmente, vê nas notas da guia de remessa se já aparece Mirakl: fatura carregada para o marketplace.
Versões, subscrição e ajuda
O botão existe na minha versão do Odoo?
Sim: o módulo está publicado no Odoo Apps para o Odoo 17, 18, 19 e 20, e o botão está na guia de remessa nos quatro ramos. O percurso passo a passo acima vem do código do Odoo 20.0. Com o Odoo em português, o botão chama-se Carregar Fatura para o Mirakl.

O que precisa para funcionar e quanto custa?
O módulo é de pagamento único por versão do Odoo (o preço de cada versão está na ficha do Odoo Apps e na página do módulo) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição proporciona; os dados ficam no teu Odoo. Com a subscrição, o módulo para as versões novas do Odoo vai incluído se o compraste em flexigotech.com; na Odoo App Store, cada versão compra-se lá.
Ajudam-me a pô-lo em funcionamento?
A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações por 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): views/stock_picking_views.xml
- Código do módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/stock_picking.py
- Código do módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
