Saltar para o conteúdo principal
Correos Express

Envios Correos Express a partir do Odoo: botão, novas tentativas e avisos

Com o conector Correos Express, o envio cria-se a partir da guia de remessa de saída do Odoo: o botão Enviar CEX lança-o manualmente e uma tarefa agendada, a cada 5 minutos, volta a tentar os envios que ficaram pendentes de nova tentativa após um erro temporário.

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

O essencial

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

O que o conector reúne na guia de remessa

Um envio com Correos Express deixa dados que convém ter à mão: o número de envio, os códigos de volume e as etiquetas. O conector reúne-os na guia de remessa de saída do Odoo: a guia guarda o número de envio (N.º Envio CEX), os códigos de volume (Códigos Volumes CEX) e as etiquetas (Etiquetas CEX). Da mesma guia partem o botão manual e as novas tentativas automáticas.

O conector funciona com a subscrição do FlexigoTech Cloud. A regra de quando se vê o botão Enviar CEX é a mesma no Odoo 17, 18, 19 e 20.

How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

Os caminhos, lado a lado

CaminhoQuem o lançaQuando atuaO que faz ou quando para
Botão Enviar CEXTu, a partir da guiaGuia de uma transportadora CEX, sem número de envio, sem códigos de volume, sem etiquetas, que não esteja Cancelada e com o botão visívelCria o envio na Correos Express. Pode parar com um aviso, por exemplo se a guia não for de saída ou se o envio manual estiver desativado no método de envio
Tarefa CEX - Retry pending shipmentsOdoo, automaticamenteA cada 5 minutos, ativa desde a instalaçãoRecolhe guias marcadas para nova tentativa, sem número de envio, não canceladas, com a tentativa seguinte vazia ou já vencida. No máximo 50 por passagem, primeiro as que têm a tentativa seguinte agendada mais cedo (comportamento do Odoo 20)
Falha temporária da Correos ExpressOdoo, automaticamenteAo criar o envio, se a Correos Express devolver um erro que o módulo considera temporárioAgenda uma nova tentativa, apenas se as novas tentativas estiverem ativadas e o máximo não tiver sido atingido
Novas tentativas desativadas ou máximo atingidoOdoo, automaticamenteAo voltar a falhar com um erro temporárioNão agenda mais novas tentativas

O que faz a tarefa de novas tentativas no Odoo 20

A tarefa CEX - Retry pending shipments corre a cada 5 minutos e vem ativa ao instalar o módulo. Em cada passagem procura as guias marcadas para nova tentativa que ainda não têm número de envio, que não estão canceladas e cuja tentativa seguinte está vazia ou já chegou. Toma no máximo 50 e começa pelas que têm a tentativa seguinte agendada mais cedo.

Para cada guia, a tarefa faz isto, por ordem:

  1. Procura a transportadora Correos Express da guia. Se não encontrar nenhuma válida, retira a guia das novas tentativas e regista esse motivo.
  2. Verifica que a ligação através do FlexigoTech Cloud está pronta: credencial guardada, serviço ativo e fora do modo de teste. Se não, a guia continua pendente e não é tocada.
  3. Tenta criar o envio.
  4. Se a gateway rejeitar a chamada, a tarefa não volta a chamar por essa transportadora nessa passagem, regista-o na saúde do serviço e as guias continuam pendentes.
  5. Se a criação do envio parar com um aviso, a tarefa não faz mais nada com essa guia. Se falhar com outro erro, agenda uma nova tentativa, apenas se as novas tentativas estiverem ativadas e o máximo não tiver sido atingido.
Separador `Operação e Produto` da configuração da Correos Express, com o produto, o formato de etiqueta, o raio PUDO, o modelo do URL de seguimento, a sincronização e as novas tentativas automáticas ativadas
O separador Operação e Produto da configuração da Correos Express, com a sincronização e as novas tentativas automáticas ativadas

Quando se atinge o máximo de novas tentativas, ou as novas tentativas estão desativadas, o módulo não agenda mais novas tentativas para essa guia.

O que a nova tentativa deixa na guia

Sempre que o módulo agenda uma nova tentativa, deixa uma mensagem na guia: avisa que a Correos Express não estava temporariamente disponível e indica a data e a hora a que fica agendada a tentativa automática seguinte. Quem trabalha a guia pode lê-la aí, sem precisar de ver mais nada.

O botão Enviar CEX: quando se vê e quando para

O botão Enviar CEX está na guia de remessa e fica oculto se se cumprir qualquer uma destas condições:

  • a guia não é de uma transportadora CEX (o campo Transportadora CEX não se vê em nenhuma vista);
  • já tem número de envio, códigos de volume ou etiquetas;
  • está Cancelada;
  • o campo Mostrar botão Enviar CEX, que também não se vê em nenhuma vista, não está ativo.

Ao premi-lo, antes de chamar a Correos Express, a ação pode parar, entre outros, com estes avisos:

  • Manual CEX shipping is only allowed on outgoing transfers.
  • This transfer already has CEX shipment data and cannot be sent again automatically. Check the existing shipment, parcel codes and labels.
  • Manual CEX shipping is turned off on the shipping method. To use this button, turn on Show manual "Send CEX" button.

Com qualquer um deles a ação para e não se guarda nada do que ia mudar.

Porque não se duplicam os envios

Ao criar um envio, o módulo bloqueia primeiro o registo da guia para evitar duplicados quando há validações simultâneas. Se ao bloqueá-lo descobrir que a guia já tem número de envio, não cria outro: reutiliza o existente e completa os códigos de volume ou a referência de seguimento se faltarem.

Como te ajudamos

Se ainda não usas o Odoo, podemos acompanhar-te na implementação do Odoo e deixar o conector Correos Express a funcionar nas tuas guias de remessa. A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Tens a ficha no Odoo Apps e a página do conector para ver versões e compra.

Continue a ler

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

Fontes

  • Código do módulo: flexigobe_correos_express 20.0 (1afd9c7f): data/cex_cron_data.xml
  • Código do módulo: flexigobe_correos_express 20.0 (1afd9c7f): models/delivery_carrier.py
  • Código do módulo: flexigobe_correos_express 20.0 (1afd9c7f): models/stock_picking.py
  • Código do módulo: flexigobe_correos_express 20.0 (1afd9c7f): views/stock_picking_views.xml
  • flexigotech.com/en/services.html