Saltar para o conteúdo principal
Correos Express

Erros e avisos do Correos Express Connector no Odoo: o que significam e o que fazer

Quase todas as mensagens do Correos Express Connector apontam para um dado concreto que falta ou não bate certo: um código CEX da transportadora, a morada do remetente, um produto não ativado ou a palavra-passe por guardar no FlexigoTech Cloud. Aqui encontra cada texto tal como o módulo o mostra, agrupado pelo que tem de verificar, para saber onde mexer sem abrir o código.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 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
6 min

Avisos de configuração: valores e produtos

Parte das mensagens não vem da Correos Express. São verificações do próprio módulo sobre os valores que introduz na configuração. O texto indica qual o valor que não bate certo.

Separador Operacion y Producto da configuração da Correos Express com produto, formato de etiqueta PDF, raio PUDO, modelo de URL de rastreamento, sincronização e novas tentativas automáticas ativadas
O separador Operacion y Producto, com o raio PUDO, a sincronização e as novas tentativas automáticas ativadas.

Os valores numéricos têm um mínimo

Há três limites e cada um tem a sua mensagem:

  • El maximo de reintentos CEX no puede ser negativo. O número máximo de novas tentativas não aceita um valor negativo.
  • Los dias de sincronizacion tracking deben ser >= 1. Os dias de sincronização do rastreamento têm de ser, no mínimo, 1.
  • El radio PUDO por defecto debe ser >= 1 km. O raio PUDO predefinido não pode ser inferior a 1 km.

O produto CEX tem de ser suportado e, além disso, estar ativado

Há aqui duas verificações distintas. A primeira é do módulo: se o código de produto não estiver entre os suportados, verá Producto CEX no soportado por el modulo: %s ou a versão no plural, Codigos de producto CEX no soportados por el modulo: %s. Revisa tu contrato (ej: 54 activo, 44 no operativo). A própria mensagem pede-lhe que reveja o seu contrato.

A segunda compara o produto escolhido com os ativados. Se não estiver lá, aparece El producto seleccionado (%s -> %s) no esta en "Productos habilitados". ou então El producto seleccionado (%s -> %s) no esta en los codigos habilitados del contrato (%s). A mensagem mostra o produto selecionado, por isso sabe qual deve verificar.

O B-PACK exige um ponto externo

Se trabalha com o produto B-PACK, o módulo exige mais um dado: Para producto B-PACK (18) debes informar "ID Punto Externo (B-PACK)". Preencha o campo ID Punto Externo (B-PACK) e volte a guardar.

Dados em falta na transportadora, na empresa ou na guia de remessa

Formulário do método de envio Correos Express com fornecedor do serviço, ligação para instalar mais fornecedores, nível de integração, margens de tarifa, produto de entrega e política de faturação com custo estimado
O método de envio Correos Express, com o fornecedor do serviço, o nível de integração e o produto de entrega.

O tipo de transportadora e os códigos CEX

El transportista no es de tipo Correos Express. surge quando a transportadora com que está a trabalhar não é do tipo Correos Express. Abra o método de envio e verifique o fornecedor do serviço.

Os códigos da sua conta têm mensagens próprias:

  • Credenciales de Correos Express no configuradas en el transportista.
  • Falta el Codigo Cliente CEX en el transportista.
  • Falta el Codigo Solicitante CEX en el transportista.

Todas apontam para a transportadora. No separador Credenciales y Entorno da configuração da Correos Express estão o utilizador, a palavra-passe e os códigos de requerente e de cliente.

Outras três mensagens indicam dados fora da transportadora. No se encontro la empresa asociada al transportista. diz que o módulo não encontrou essa empresa. Faltan datos de direccion del remitente en la configuracion de la empresa. refere-se à morada do remetente que é obtida da sua empresa: complete-a. E El albaran no tiene destinatario configurado. significa que a guia de remessa não tem destinatário: acrescente-o e repita a operação.

Com o FlexigoTech Cloud, a palavra-passe fica guardada na nuvem

Este conector funciona através do FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se algo falhar. Por isso há duas mensagens, em inglês, que dependem do FlexigoTech Cloud:

  • Save the Correos Express password of this carrier in FlexigoTech Cloud first (Correos Express settings of the carrier). Nothing was sent. A palavra-passe da Correos Express dessa transportadora ainda não está guardada no FlexigoTech Cloud. Guarde-a a partir da configuração da Correos Express da transportadora, como indica a mensagem. Não foi enviado nada.
  • Through FlexigoTech Cloud this carrier only reaches the Correos Express API of its environment (%(base)s), so %(host)s was not requested and nothing was sent. A transportadora só chega à API da Correos Express do seu ambiente, e o endereço pedido não é esse, pelo que não foi feita a chamada e não se enviou nada. Verifique o ambiente e os URLs da API em Credenciales y Entorno.

Sem subscrição, ou com o serviço suspenso, para tudo o que a subscrição disponibiliza, mas os dados ficam no seu Odoo.

Percurso pelo método de envio Correos Express, o separador Credenciales y Entorno, o separador Validacion guiada com a pré-validação em OK e o separador Operacion y Producto
Do método de envio à configuração: credenciais, validação guiada e definições de operação.

Na configuração tem também o separador Validacion guiada, com o botão Ejecutar prevalidacion. A captura mostra os resultados de credenciais, ambiente, serviços, produto, rastreamento e timeout.

Separador Validacion guiada da configuração da Correos Express com lista de verificação de interruptores ativados, botão Ejecutar prevalidacion e resultados OK de credenciais, ambiente, serviços, produto, rastreamento e timeout
O separador Validacion guiada com o botão Ejecutar prevalidacion e todos os resultados em [OK].

Etiqueta, rastreamento e pontos PUDO

Cada consulta tem os seus requisitos

Para a etiqueta, o módulo precisa de duas coisas. No hay numero de envio CEX para recuperar etiqueta. diz que não existe número de envio da Correos Express. No hay keyCli CEX (cliente/solicitante) para recuperar etiqueta. remete para os códigos de cliente e de requerente.

Se a Correos Express não devolver conteúdo de etiqueta, verá CEX no devolvio contenido de etiqueta para este envio. Claves respuesta: %s, que lista as chaves que vieram de facto na resposta. Outra falha ao obtê-la aparece como No se pudo recuperar la etiqueta CEX: %s. Guarde o texto completo, porque o detalhe vem depois dos dois pontos.

O rastreamento e os pontos PUDO também pedem os dois códigos: Falta Codigo Solicitante/Codigo Cliente para consultar tracking CEX. e Falta Codigo Solicitante/Codigo Cliente para consulta PUDO CEX. No rastreamento, além disso, No hay referencia de seguimiento para consultar en CEX. indica que não há referência de rastreamento para consultar. Se a consulta de pontos falhar, a mensagem é Consulta PUDO CEX fallida: %s, com o detalhe no fim.

Mensagens técnicas: JSON, biblioteca e modo debug

Restam alguns avisos mais técnicos. Respuesta no JSON en servicio CEX %s. e %s: respuesta JSON invalida. dizem que a resposta não pôde ser lida como JSON, e a mensagem inclui o serviço. Servicio CEX no configurado para clave: %s assinala uma chave de serviço por configurar. No se puede importar la libreria 'requests': %s diz que o módulo não conseguiu importar a biblioteca requests: passe o texto completo a quem administra o seu Odoo.

Por fim, Solo administradores pueden activar auditoria tecnica CEX (modo debug). não é uma falha do envio: a auditoria técnica só pode ser ativada por um administrador. Peça-o a quem tenha essa permissão.

Como a FlexigoTech o ajuda

Se uma mensagem não lhe fizer sentido, anote o texto literal e a operação que estava a fazer, e conte-nos. A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, e se a Correos Express mudar a sua API, o módulo e o serviço são adaptados. Se preferir perceber primeiro o que faz cada peça, veja como funciona o Correos Express Connector por dentro.

A app custa 9 € sem IVA por versão do Odoo na Odoo Apps (pagamento único, para 17, 18, 19 e 20) e a ligação está incluída no plano Conector, de 49 €/mês ou 490 €/ano sem IVA. Encontra os detalhes na página do conector e na ficha da Odoo Apps.

Continue a ler

Como funciona o Correos Express Connector no Odoo por dentroOnde se configura o Correos Express Connector no Odoo, que tarefas agendadas deixa ativas, que assistentes traz e qual o papel do FlexigoTech Cloud.Correos Express ainda sem Odoo: o que o Odoo centraliza com o Correos Express ConnectorSe trabalha com a Correos Express e ainda não usa Odoo: o que o conector leva para o Odoo, o que precisa do contrato CEX e por onde começar a implementação.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes