O que o Temu Connector for Odoo acrescenta à guia de remessa do Inventário: campos, botão e quando atua

O que acrescenta à guia de remessa e quando se vê

O grupo «Temu» só aparece em guias de remessa de encomendas do Temu

O módulo amplia a guia de remessa standard do Inventário (Inventory). Na ficha da guia de remessa (a transferência) acrescenta um grupo Temu com estes campos: Temu Order Record, Temu Fulfillment, Temu Tracking Sync State, Temu Tracking Last Sync At, Temu Tracking Last Tracking Ref, Temu Tracking Last Error, Temu Tracking Last Payload e Temu Tracking Last Response.

Todos são só de leitura e ficam ocultos quando a guia de remessa não é de uma encomenda do Temu, pelo que numa guia que não vem do Temu o grupo não aparece. Os campos de acompanhamento, desde Temu Fulfillment até Temu Tracking Last Response, são escritos pelo código do módulo: não há nada a preencher manualmente.

O botão só aparece com a guia de remessa em «Concluído»

O botão Send Temu Tracking está oculto quando a guia de remessa não é de uma encomenda do Temu ou quando o seu estado não é Concluído. Essa condição é a mesma no Odoo 17, 18 e 19.

Carregar nele não equivale ao automático. O botão pede o envio saltando a verificação de «já sincronizado com esse mesmo número de seguimento», pelo que pode voltar a enviar uma guia de remessa que já estava em Synced. Além disso, se a guia não cumprir as condições do envio ou faltar o número de seguimento, o botão pára em vez de deixar a guia em espera. Se algo falhar, a falha é mostrada ao utilizador e pode chegar como Error sending Temu tracking: ….

Os valores de estado e o que se escreve em cada caso

O campo Temu Tracking Sync State assume os valores Pending, Synced e Error, e cada um deixa campos diferentes:

• Pending: o módulo escreve em Temu Tracking Last Error o motivo da espera. É o que acontece no fluxo automático quando falta o número de seguimento.
• Synced: preenchem-se Temu Fulfillment, Temu Tracking Last Sync At, Temu Tracking Last Tracking Ref, Temu Tracking Last Payload e Temu Tracking Last Response, e esvazia-se Temu Tracking Last Error.
• Error: escreve-se Temu Tracking Last Error e, se já existir o envio para o Temu, também Temu Fulfillment, Temu Tracking Last Payload e Temu Tracking Last Response.

O estado Error não resulta apenas do envio de tracking: o código também chega a ele a partir dos botões Create Sales Order e Sync to Sales Order.

Quando atua sem que carregues em nada

O que se segue descreve o código publicado do Odoo 19.

Ao validar e ao guardar, o módulo tenta primeiro

O caminho normal não é o botão. O módulo amplia a validação standard da guia de remessa e também reage ao guardar a sua ficha; em ambos os casos tenta confirmar o envio para o Temu com o verificador automático. Para que tente, a guia de remessa tem de cumprir várias condições, entre elas:

• que o seu tipo de operação seja de saída;
• que a guia tenha uma encomenda do Temu associada;
• que essa encomenda não esteja cancelada;
• que, se a encomenda indicar um tipo de cumprimento, esse texto contenha a palavra seller.

Se não se cumprirem, o módulo não faz nada e a guia segue o seu curso.

A ordem em que decide o envio automático

Quando as condições se cumprem, o código segue esta ordem:

• Obtém os números de seguimento da guia de remessa. Se não houver nenhum, deixa a guia em Pending e termina.
• Se a guia já estiver em Synced e o número de seguimento for o mesmo que consta em Temu Tracking Last Tracking Ref, não volta a enviar nada.
• Se não conseguir preparar os dados do envio, trata-o como a falta de número: Pending.
• Cria o envio para o Temu e executa-o. Se correr bem, marca Synced e deixa uma nota no chatter da guia com o número usado.

Por isso, com uma guia que já consta como Synced com esse número, o fluxo automático não repete o envio; o botão pode fazê-lo.

Usa-se o primeiro número de seguimento como referência

Se a guia de remessa tiver vários números de seguimento, o código usa o primeiro como referência. Nesse caso, a nota do chatter indica qual o número principal usado e avisa de que os restantes números da guia não foram enviados no fluxo automático. A nota é publicada quando o envio corre bem, seja lançado pelo fluxo automático ou pelo botão.

O que acontece quando o envio falha

Se a execução do envio para o Temu falhar, o código passa antes por uma verificação adicional; se esta der resultado positivo, devolve o envio sem marcar Error. Se não, marca Error (com o texto em Temu Tracking Last Error), guarda Temu Fulfillment, Temu Tracking Last Payload e Temu Tracking Last Response do envio criado, e volta a lançar a falha.

No fluxo automático essa falha não fica solta: o módulo apanha-a, escreve-a no registo do servidor, marca a guia como Error e deixa uma nota no chatter com o motivo. Com o botão, a falha é mostrada ao utilizador e pode chegar como Error sending Temu tracking: …. No fluxo automático, esses campos são o que consultas para saber o que foi enviado e o que o Temu respondeu.

Ao arrancar o Odoo, o módulo repara colunas e limpa avisos

Há um comportamento que não se vê em nenhum ecrã. Se o código for implementado antes de atualizar o módulo, ao arrancar o Odoo o módulo verifica se existem na tabela de guias de remessa as colunas dos campos de acompanhamento (de Temu Fulfillment a Temu Tracking Last Response) e acrescenta as que faltam. Se a base de dados não o conseguir fazer por um bloqueio (lock timeout), adia-o nesse processo, regista-o no log como aviso e espera por um reinício ou pela atualização; qualquer outro erro é propagado.

Se não tiver sido adiado, o módulo apaga ainda as atividades de aviso de endereço de entrega que ficaram obsoletas nas guias de remessa das ordens de vendas ligadas a encomendas do Temu, e regista no log quantas removeu.

Quanto custa e como te ajudamos

O 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, até 3 contas da plataforma. Está publicado para o Odoo 17, 18, 19 e 20; o detalhe está na ficha da Odoo Apps e na página do módulo. Se queres ver como muda o mesmo nos artigos, lê o que o módulo acrescenta à ficha de artigo.

Se estás a implementar o Odoo e queres rever as tuas guias de remessa de saída antes de ligar o Temu, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

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

Fontes

• Código do módulo: flexigobe_temu_connector 19.0 (455b3f0f): models/stock_picking.py
• Código do módulo: flexigobe_temu_connector 19.0 (455b3f0f): views/stock_picking_views.xml
• apps.odoo.com/apps/modules/19.0/flexigobe_temu_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html