Saltar al contenido principal
Octopia (Cdiscount)

Declarar a Octopia en Odoo: checklist del botón, paso a paso

El botón Declarar a Octopia (Declare to Octopia) comprueba que haya bultos, que el pedido no sea de Fulfillment y que cada bulto tenga número y transportista; si todo cuadra, declara el envío a Octopia y marca el pedido como enviado. Aquí tienes qué mirar antes, qué hace al pulsarlo y qué revisar después.

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

Lo esencial

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
4 min

Antes de pulsar: dónde está el botón y qué debe cumplir el envío

El botón Declarar a Octopia (Declare to Octopia) está en la misma ficha que los campos Pedido (Order), Albarán (Picking) y Bultos (Parcels). La vista no le pone ninguna condición: se ve siempre, en Odoo 17, 18, 19 y 20.

Esquema hecho con código del botón Declarar a Octopia, con algunos de los mensajes que lo pueden parar y el estado error en que deja la ficha
Esquema a partir del código del módulo, no una pantalla de Odoo: el botón, mensajes que lo detienen y el estado error.

Lo que el botón comprueba, en este orden

  • Hay al menos un bulto. Si la lista Bultos está vacía, el botón se detiene con Añada al menos un bulto. (Add at least one parcel.). Es la primera comprobación.
  • El pedido es de los que envías tú. En Odoo 20.0, si el pedido trae indicado un modo de suministro que no es el del vendedor, el botón se detiene con Los pedidos de Fulfillment se envían por sí solos: Octopia rechazaría (409) declarar uno. (Fulfillment orders ship themselves -- declaring one would be refused (409) by Octopia.). Si el modo de suministro está vacío, esta comprobación no frena nada.
  • Cada bulto tiene número de bulto. Los bultos se revisan uno a uno; el primero sin número detiene la acción con Cada bulto necesita un número de bulto. (Every parcel needs a parcel number.).
  • Cada bulto tiene transportista. Se envía el nombre del transportista mapeado y, si no lo hay, el texto libre. Sin ninguno de los dos, sale Cada bulto necesita un transportista (mapeado o texto libre). (Every parcel needs a carrier (mapped or free text).).

Si alguna de estas comprobaciones falla, la acción se detiene en ese punto: el registro de envío y la llamada a Octopia vienen después.

Datos opcionales que viajan en la declaración

  • Dirección de seguimiento. Si un bulto la tiene, se añade a su declaración; si no, el bulto va sin ella.
  • Líneas del pedido. Si un bulto tiene marcadas algunas líneas del pedido, pero no todas, la declaración nombra esas líneas. Si no tiene ninguna marcada, o las tiene todas, no las detalla.
  • Albarán. Si la ficha trae albarán, el envío que se crea lo guarda.

Las CGMAD de Cdiscount Marketplace (25/08/2025, p. 47) indican que la confirmación de envío lleva el número de seguimiento.

48 horas hábiles para aceptar cada pedido de Cdiscount: hazlo en Odoo
Vídeo: 48 horas hábiles para aceptar cada pedido de Cdiscount: hazlo en Odoo

Qué pasa al pulsar, paso a paso

En Odoo 20.0, una vez superadas las comprobaciones, el botón hace esto, en este orden:

  1. Crea el registro de envío del pedido, con los bultos preparados y el albarán si lo hay.
  2. Toma la conexión de la cuenta de Octopia del pedido y le envía a Octopia la declaración de envío, con el identificador del pedido en Octopia y los bultos.
  3. Si Octopia devuelve un error de su API, escribe en el envío el estado error y, como mensaje, el texto del error seguido del detalle de errores que traiga la respuesta, y vuelve a lanzar el mismo error. La acción termina con ese error y el pedido no se marca como enviado.
  4. Si todo va bien, pone el envío en estado sent con la fecha y hora de envío, marca el pedido como enviado, deja una línea en el registro de sincronización (tipo envíos, resultado correcto, con el identificador del pedido y el número de bultos) y cierra la ventana.

Con Odoo en castellano, el botón se llama Declarar a Octopia; en otros idiomas cambia el rótulo:

Esquema hecho con código a partir de las traducciones del módulo, con el texto del botón en cinco idiomas
Esquema a partir de los ficheros de idioma del módulo, no una pantalla de Odoo: castellano Declarar a Octopia, alemán An Octopia melden, francés Déclarer à Octopia, italiano Dichiara a Octopia y portugués Declarar à Octopia.

Después de pulsar: qué comprobar

  • La ventana se ha cerrado: es lo que hace el botón cuando termina bien.
  • El envío está en sent y el pedido figura como enviado.
  • Hay una línea nueva en el registro de sincronización, de tipo envíos.
  • Si saltó un error de Octopia, lee el texto completo, que incluye el detalle de errores de la respuesta, y corrige lo que indique antes de volver a declarar.
  • Si el mensaje es uno de los de la primera sección, el fallo está en los datos de la ficha: esas comprobaciones se hacen antes de crear el envío y de llamar a Octopia.

Qué hace falta para tenerlo

El módulo es de pago único por versión y está publicado en Odoo Apps para 17, 18, 19 y 20; el precio de cada versión está en su ficha de Odoo Apps. Además necesita la suscripción a FlexigoTech Cloud, plan Conector: 49 € al mes o 490 € al año, sin IVA. La conexión pasa por FlexigoTech Cloud, que guarda cifradas las credenciales y vigila la sincronización.

Cómo te ayuda FlexigoTech

Si estás implantando Odoo y quieres dejar listo el circuito de envíos con Octopia, en FlexigoTech implantamos Odoo 17, 18, 19 y 20 y desarrollamos conectores e integraciones a medida.

Sigue leyendo

Qué hace el botón «Abrir conversación» de Octopia Connector: mitos y realidadesQué hace el botón Abrir conversación de Octopia Connector en Odoo: cuándo se ve, qué comprueba, qué cambia y qué errores da, desmontando ideas equivocadas.Qué hace el botón «Enviar a Octopia» de las promociones, paso a pasoCómo funciona el botón Enviar a Octopia de las promociones en Odoo: cuándo aparece, qué comprueba, qué cambia y qué avisos puede dar.Qué hace el botón «Enviar a Octopia» de una cancelación, con un casoQué hace el botón Enviar a Octopia de una cancelación en Odoo: cuándo aparece, qué comprueba, qué cambia y cómo resolver su mensaje de error.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes