Saltar al contenido principal
ManoMano

ManoMano y Odoo: errores frecuentes y su solución

La mayoría de los errores del conector de ManoMano en Odoo vienen de cuatro sitios: la clave de API y su entorno, el contrato de vendedor, los datos de la oferta y el estado del pedido cuando intentas enviar o reembolsar. Cada mensaje dice qué falla. Aquí están agrupados por el momento en que aparecen, con su arreglo.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 3 de noviembre de 2026

Lo esencial

Módulo
ManoMano
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
3 min

Antes de la tabla, un dato que ahorra horas: el sandbox de ManoMano no está siempre encendido. Solo responde los lunes de 00:00 a 20:00 y de martes a viernes de 07:00 a 20:00, hora de París. Si pruebas un sábado y la API devuelve 404, no es tu configuración.

Conexión y cuenta

MensajeCausa probableArreglo
ManoMano API returned 404. Check that: …Clave inactiva, entorno equivocado (Sandbox o Production) o sandbox fuera de horario.Revisa la clave y el entorno en la cuenta y, si es el sandbox, el horario.
ManoMano authentication failed (…). Please verify the API key on account '…'.ManoMano rechaza la clave.Genera una nueva en ManoMano y pégala en la cuenta de Odoo.
x-thirdparty-name must follow 'Vendor_Version' format (e.g. Flexigobe_1.0).El identificador de integración no tiene el formato que pide ManoMano.Escríbelo como Proveedor_Versión.
ManoMano calls of account '…' are paused until … (UTC) after … failed calls in a row.Muchas llamadas seguidas fallaron y el conector hace una pausa para no castigar la cuenta.Espera: se reanudan solas. O pulsa Test Connection para probar ya.
The Seller Contract ID of ManoMano contract '…' is '…': ManoMano's contract IDs are numbers.En el contrato pegaste un texto en vez del número.Copia el identificador numérico del contrato.

La cuenta muestra su estado: borrador, conectada, error de autenticación o circuito abierto. Este último es la pausa automática de la cuarta fila.

Cuenta de ManoMano en Odoo con su estado de conexión
La cuenta de ManoMano en Odoo, con el estado de la conexión arriba. Captura de Odoo con datos de demostración.

Publicar ofertas

  • Select at least one product to publish. El asistente se abrió sin productos marcados.
  • The following products have no Internal Reference (SKU) and cannot… ManoMano identifica cada oferta por su SKU. Rellena la referencia interna en Odoo.
  • Manual price must be greater than zero. y Product '…' has a price of 0. ManoMano requires a positive price. El precio vacío o a cero no se publica. Revisa la tarifa o el precio manual del asistente.
Asistente para publicar ofertas en ManoMano desde Odoo
El asistente de publicación: productos, precio y contrato antes de enviar. Captura de Odoo con datos de demostración.

Envíos y reembolsos

Aquí el error casi siempre es de orden. ManoMano solo admite envíos de pedidos aceptados, en preparación o ya enviados. Si ves ManoMano only allows creating shippings for accepted orders…, acepta primero el pedido. Y Tracking number cannot be empty. pide el número de seguimiento antes de mandar nada.

Con los reembolsos pasa igual: ManoMano only refunds orders it has accepted: in preparation, shipped or refunded in part. Si intentas devolver más unidades de las pedidas, el mensaje te dice cuántas tiene el pedido. Y si no eliges ni productos ni gastos de envío, te pide que elijas.

Cuando un error vuelve solo

Las operaciones fallidas se reintentan cada 30 minutos. Si un error desaparece sin que hagas nada, era temporal. Si vuelve en cada intento, abre Tools › API Log: ahí está la petición y la respuesta completa de ManoMano.

Registro de llamadas a la API de ManoMano en Odoo
El registro de llamadas: cada petición a ManoMano con su respuesta. Captura de Odoo con datos de demostración.

Si dos registros de ManoMano apuntan a contratos o empresas distintas, Odoo lo bloquea con The order, picking or invoice of a ManoMano record must be of its own contract and company. Revisa que cada contrato pertenece a la empresa correcta.

Sigue leyendo

Facturas de ManoMano desde Odoo: preguntas y respuestasCómo se suben a ManoMano las facturas y los abonos de cada pedido desde Odoo 17, 18, 19 y 20: estados, formato PDF, orden de subida y errores.¿Necesitas un ERP para vender en ManoMano? Las señalesLista de señales para saber si tu venta en ManoMano ya pide un ERP, y qué hace Odoo con el conector: pedidos, ofertas, stock, transportistas y traducciones.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes

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