Saltar para o conteúdo principal
Temu

O erro mainPackageSn do Temu Connector for Odoo: os detalhes que ninguém lhe conta

A mensagem mainPackageSn (package_sn) is required for shipment sub confirm. surge ao clicar em Execute numa ficha de Fulfillment quando a operação é a de confirmação de subpacote e o campo Package Sn da ficha está vazio; resolve-se preenchendo esse campo e clicando de novo no botão.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
Temu
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 19.0 · nas fontes indicadas no fim
Leitura
4 min

Onde aparece e o que o provoca

A mensagem surge ao clicar no botão Execute numa ficha que abre a partir do menu Temu › Orders & Fulfillment › Fulfillment. No Odoo 17, 18 e 19 esse botão está sempre visível, sem qualquer condição de vista. Ao clicar, o módulo chega ao ponto em que monta o pedido e, se se verificar a condição que se segue, interrompe-o com este texto: mainPackageSn (package_sn) is required for shipment sub confirm. É um erro: a ação fica parada.

A condição, dita por palavras, tem duas partes em simultâneo: a operação da ficha é a de confirmação de subpacote de envio (shipment sub confirm) e o campo Package Sn da ficha está vazio. Se faltar qualquer uma das duas, esta mensagem não surge.

Esquema feito com código, não um ecrã do Odoo: de cima para baixo, o menu de Fulfillment, o botão de executar junto ao campo Package Sn e a mensagem de erro
Esquema feito com código a partir do código publicado do módulo (não é uma captura do Odoo): o menu, o botão e o campo envolvidos, e a mensagem que se obtém com o campo vazio.
Temu orders in Odoo every 15 minutes. Stock out every 5
Vídeo: Temu orders in Odoo every 15 minutes. Stock out every 5 (vídeo em inglês)

O que não lhe contam sobre esta mensagem

Só uma operação concreta a lança

O código do módulo percorre as operações uma a uma, e esta verificação vive dentro do ramo de confirmação de subpacote. Que Package Sn esteja vazio não basta para ver a mensagem: se a ficha for de outra operação, não passa por esse ramo. Outras operações têm as suas próprias verificações e as suas próprias mensagens, por isso não as misture com esta.

É a primeira coisa que se verifica nessa operação

Dentro do ramo, a verificação do pacote principal vem antes de ler as linhas da ficha. Por isso, com o campo vazio, o erro surge mesmo que as linhas estejam perfeitamente preenchidas: o código nem chega a lê-las. E, como a ação fica parada, o pedido não é construído.

A verificação olha para o campo da ficha

Package Sn aparece na ficha de Fulfillment e também no separador Fulfillment, dentro da tabela Fulfillment Operations. A verificação desta mensagem é feita sobre o valor do campo da própria ficha. Quando é ultrapassada, esse valor viaja como pacote principal (mainPackageSn) do pedido, que é precisamente o que o texto do erro nomeia.

Ultrapassada a verificação, as linhas fornecem os subpacotes

Com o pacote principal presente, o código segue para as linhas da ficha e monta a lista de pedidos de subpacote. Se uma linha já traz escrito o seu pedido de subpacote, o código usa-o tal como está. Se não o traz, monta o dessa linha com a transportadora, o armazém de envio próprio e o número de seguimento, tomando da ficha o que a linha não tenha. Isto importa porque resolver este erro apenas o leva à verificação seguinte: se depois surgir outra mensagem diferente, é outra condição. Em O que faz o botão «Execute» passo a passo tem o percurso do botão.

Um pedido escrito à mão salta esta verificação

Se a ficha leva um pedido completo escrito à mão que substitui o que o módulo monta, o código devolve-o tal como está, desde que seja um objeto, antes de ver que operação é. Nesse caso esta mensagem não pode surgir. Se vir o erro, é porque a ficha está a usar o pedido que o módulo constrói.

Que versões o incluem

A mensagem está no código publicado dos ramos 17.0, 18.0 e 19.0. O módulo está publicado no Odoo Apps para as versões 17.0, 18.0, 19.0 e 20.0.

Como resolver

  1. Abra Temu › Orders & Fulfillment › Fulfillment e entre na ficha que dá o erro.
  2. Preencha o campo Package Sn da ficha com o identificador do pacote principal, a que a mensagem chama mainPackageSn.
  3. Clique de novo em Execute. Se a mensagem já não surgir, a verificação foi ultrapassada.
Esquema feito com código, não um ecrã do Odoo: o texto do botão tal como o vê o utilizador com o Odoo em inglês, Execute
Esquema feito com código a partir das traduções publicadas do módulo (não é uma captura do Odoo): o botão chama-se Execute.

Se precisar de ajuda com a operação

Se está a implementar o Odoo e quer que o fluxo de envios da Temu fique ajustado à sua forma de trabalhar, na FlexigoTech implementamos o Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. Pode ver o módulo na sua ficha do Odoo Apps ou na página do Temu Connector for Odoo. É de pagamento único por versão do Odoo e requer a subscrição do FlexigoTech Cloud, no plano Conector: 49 €/mês ou 490 €/ano, sem IVA.

Continue a ler

O que faz o botão Execute do Temu Connector for Odoo, passo a passoO que faz o botão Execute de Fulfillment no Temu Connector for Odoo: o que verifica, que estados escreve e que mensagens o podem travar.
Verificado no código do conector (versão 19.0) e nas fontes indicadas

Fontes