Qué significa el mensaje y cuándo sale
¿Qué quiere decir Cada bulto necesita un número de bulto.?
Que en la ventana desde la que declaras el envío de un pedido hay al menos una línea de bulto con el número de bulto vacío. El módulo no declara el envío a Octopia si algún bulto va sin él: el aviso detiene la acción y de ahí no pasa.
¿Cuándo sale exactamente?
El módulo recorre las líneas de bulto de la ventana, una detrás de otra. En cada una mira si el número de bulto está vacío; en cuanto encuentra una así, lanza el mensaje y se detiene en ese punto. Basta con una sola línea vacía para que salga, aunque todas las demás estén completas. El código hace además otras comprobaciones sobre el pedido antes de recorrer las líneas y sobre cada línea después de esta. Este mensaje solo sale cuando el número de bulto está vacío; si ves un texto distinto, la causa es otra.
¿Con qué botón sale?
Con Declarar a Octopia, el botón de esa misma ventana. En Odoo 17, 18, 19 y 20 el botón se ve siempre, y el mensaje está en el código publicado de las cuatro versiones.

Declarar a Octopia y, debajo, el mensaje, con los textos originales del código en inglés.¿Cómo lo veo con mi Odoo?
Con Odoo en castellano, el mensaje es Cada bulto necesita un número de bulto. y el botón se llama Declarar a Octopia. El módulo trae el mismo texto traducido a otros idiomas; la figura siguiente muestra el mensaje en castellano, alemán, francés, italiano y portugués.

Cada bulto necesita un número de bulto. en castellano.
Qué pasa cuando sale
¿Se envía algo a Octopia al ver el mensaje? ¿Tiene que ver con la conexión?
No se envía nada. El mensaje detiene la acción y no se guarda nada de lo que iba a cambiar. La comprobación de los números de bulto va antes de crear el registro del envío, antes de preparar la conexión con Octopia y antes de declarar nada. Por eso no se crea el registro del envío, no se llama a Octopia y el pedido no pasa a enviado. No es un fallo de conexión: es una comprobación de lo que hay en la ventana. Puedes corregir la línea que falta y volver a pulsar Declarar a Octopia sin que haya quedado nada a medias.
¿Qué se manda a Octopia cuando todas las líneas pasan la comprobación?
Para cada bulto, el módulo arma un dato con el número de bulto y el nombre del transportista (el del transportista mapeado o, si no lo hay, el texto libre), y añade la dirección de seguimiento si la línea la tiene. Después crea el registro del envío y declara el envío a Octopia. Si la declaración falla, la acción se detiene con el error. Si no falla, el módulo marca el registro del envío como enviado, pasa el pedido a enviado y deja una entrada en el registro de sincronización del módulo. Las CGMAD de Cdiscount Marketplace (p. 47) recogen que la confirmación de envío lleva el número de seguimiento; lo que comprueba este mensaje es el número de bulto de cada línea.
Cómo resolverlo
¿Qué hago para que desaparezca?
Revisa una por una las líneas de bulto de la ventana y comprueba que todas llevan su número de bulto, también la última. Cuando no quede ninguna vacía, pulsa de nuevo Declarar a Octopia. Si hay varios bultos, cada uno es una línea y cada línea necesita su propio número: completar una no vale para las demás. Mientras una línea siga vacía, la acción se detiene y no se declara nada.
¿Y si el mensaje sigue saliendo?
Entonces todavía queda alguna línea con el número vacío. El módulo se detiene en la primera que encuentra, así que arreglar esa no garantiza que las siguientes estén bien: revísalas todas antes de volver a pulsar. Si lo que aparece es otro mensaje, trátalo por separado, porque este solo habla del número de bulto.
¿Pueden ayudarme a implantar Odoo con Octopia?
FlexigoTech implanta Odoo 17, 18, 19 y 20 y desarrolla conectores e integraciones a medida. Si tu forma de declarar envíos necesita algo más a medida, se puede estudiar como desarrollo.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigobe_octopia_connector 20.0 (4848da6a): wizard/octopia_shipment_wizard.py
- Código del módulo: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_completeness2_views.xml
- marketplace.cdiscount.com/wp-content/uploads/2025/08/2025.08.25-CGMAD-FR.pdf
- flexigotech.com/en/services.html
