Saltar para o conteúdo principal
ManoMano

ManoMano e Odoo: erros frequentes e como corrigi-los

A maior parte dos erros do conector da ManoMano no Odoo vem de quatro sítios: a chave de API e o seu ambiente, o contrato de vendedor, os dados da oferta e o estado da encomenda quando tenta enviar ou reembolsar. Cada mensagem diz o que está mal. Aqui ficam agrupados pelo momento em que aparecem, com a solução.

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

O essencial

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

Antes da tabela, um dado que poupa horas: a sandbox da ManoMano não está sempre ligada. Só responde às segundas-feiras das 00:00 às 20:00 e de terça a sexta das 07:00 às 20:00, hora de Paris. Se testar a um sábado e a API devolver 404, não é a sua configuração.

Ligação e conta

MensagemCausa provávelSolução
ManoMano API returned 404. Check that: …Chave inativa, ambiente errado (Sandbox ou Production) ou sandbox fora do horário.Verifique a chave e o ambiente na conta e, se for a sandbox, o horário.
ManoMano authentication failed (…). Please verify the API key on account '…'.A ManoMano rejeita a chave.Gere uma nova na ManoMano e cole-a na conta do Odoo.
x-thirdparty-name must follow 'Vendor_Version' format (e.g. Flexigobe_1.0).O identificador da integração não segue o formato que a ManoMano pede.Escreva-o como Vendor_Version.
ManoMano calls of account '…' are paused until … (UTC) after … failed calls in a row.Muitas chamadas seguidas falharam e o conector faz uma pausa para não martelar a conta.Espere: retomam sozinhas. Ou carregue em Test Connection para tentar de imediato.
The Seller Contract ID of ManoMano contract '…' is '…': ManoMano's contract IDs are numbers.Colou texto no contrato em vez do número.Copie o identificador numérico do contrato.

A conta mostra o seu estado: rascunho, ligada, erro de autenticação ou circuito aberto. O último é a pausa automática da quarta linha.

Conta da ManoMano no Odoo com o estado da ligação
A conta da ManoMano no Odoo, com o estado da ligação em cima. Captura do Odoo com dados de demonstração.

Publicar ofertas

  • Select at least one product to publish. O assistente abriu sem produtos selecionados.
  • The following products have no Internal Reference (SKU) and cannot… A ManoMano identifica cada oferta pelo SKU. Preencha a referência interna no Odoo.
  • Manual price must be greater than zero. e Product '…' has a price of 0. ManoMano requires a positive price. Um preço vazio ou a zero não se publica. Verifique a lista de preços ou o preço manual do assistente.
Assistente para publicar ofertas na ManoMano a partir do Odoo
O assistente de publicação: produtos, preço e contrato antes de enviar. Captura do Odoo com dados de demonstração.

Envios e reembolsos

Aqui o erro é quase sempre de ordem. A ManoMano só aceita envios de encomendas aceites, em preparação ou já enviadas. Se vir ManoMano only allows creating shippings for accepted orders…, aceite primeiro a encomenda. E Tracking number cannot be empty. pede o número de seguimento antes de se enviar seja o que for.

Os reembolsos funcionam da mesma forma: ManoMano only refunds orders it has accepted: in preparation, shipped or refunded in part. Se tentar reembolsar mais unidades do que as encomendadas, a mensagem diz-lhe quantas tem a encomenda. E, se não escolher nem produtos nem portes, pede-lhe que escolha.

Quando um erro desaparece sozinho

As operações falhadas repetem-se a cada 30 minutos. Se um erro desaparece sem fazer nada, era temporário. Se volta a cada tentativa, abra Tools › API Log: o pedido completo e a resposta da ManoMano estão lá.

Registo de chamadas à API da ManoMano no Odoo
O registo de chamadas: cada pedido à ManoMano com a respetiva resposta. Captura do Odoo com dados de demonstração.

Se dois registos da ManoMano apontarem para contratos ou empresas diferentes, o Odoo bloqueia-o com The order, picking or invoice of a ManoMano record must be of its own contract and company. Verifique se cada contrato pertence à empresa certa.

Continue a ler

Faturas da ManoMano a partir do Odoo: perguntas e respostasComo se carregam na ManoMano, a partir do Odoo 17, 18, 19 e 20, as faturas e notas de crédito de cada encomenda: estados, formato PDF, ordem de envio e erros.Precisa de um ERP para vender na ManoMano? Os sinaisUma lista para saber se o seu negócio na ManoMano já precisa de um ERP e o que faz o Odoo com o conector: encomendas, ofertas, stock, transportadoras e traduções.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

  • Código do módulo: flexigobe_manomano_connector (093b2e34): models/manomano_account.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_account.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_api_client.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_contract.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_fgt_cloud.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): wizard/offer_publish_wizard.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): wizard/refund_create_wizard.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): wizard/shipping_create_wizard.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): models/manomano_binding_mixin.py
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): data/manomano_cron.xml
  • Código do módulo: flexigobe_manomano_connector 20.0 (093b2e34): views/menu.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_manomano_connector