Salta al contingut principal
Octopia (Cdiscount)

Declare to Octopia a Odoo: checklist del botó, pas a pas

El botó Declare to Octopia comprova que hi hagi bultos, que la comanda no sigui de Fulfillment i que cada bulto tingui número i transportista; si tot quadra, declara l'enviament a Octopia i marca la comanda com a enviada. Aquí tens què mirar abans, què fa en prémer-lo i què revisar després.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
4 min

Abans de prémer: on és el botó i què ha de complir l'enviament

El botó Declare to Octopia és a la mateixa fitxa que els camps Order, Picking i Parcels. La vista no li posa cap condició: es veu sempre, a Odoo 17, 18, 19 i 20.

Esquema fet amb codi del botó Declare to Octopia, amb alguns dels missatges que el poden aturar i l'estat error en què deixa la fitxa
Esquema a partir del codi del mòdul, no una pantalla d'Odoo: el botó, els missatges que l'aturen i l'estat error.

El que el botó comprova, en aquest ordre

  • Hi ha almenys un bulto. Si la llista Parcels és buida, el botó s'atura amb Add at least one parcel.. És la primera comprovació.
  • La comanda és de les que envies tu. A Odoo 20.0, si la comanda porta indicat un mode de subministrament que no és el del venedor, el botó s'atura amb Fulfillment orders ship themselves -- declaring one would be refused (409) by Octopia.. Si el mode de subministrament és buit, aquesta comprovació no frena res.
  • Cada bulto té número de bulto. Els bultos es revisen un a un; el primer sense número atura l'acció amb Every parcel needs a parcel number..
  • Cada bulto té transportista. S'envia el nom del transportista mapejat i, si no n'hi ha, el text lliure. Sense cap dels dos, surt Every parcel needs a carrier (mapped or free text)..

Si alguna d'aquestes comprovacions falla, l'acció s'atura en aquest punt: el registre d'enviament i la crida a Octopia vénen després.

Dades opcionals que viatgen a la declaració

  • Adreça de seguiment. Si un bulto en té, s'afegeix a la seva declaració; si no, el bulto va sense.
  • Línies de la comanda. Si un bulto té marcades algunes línies de la comanda, però no totes, la declaració anomena aquestes línies. Si no en té cap de marcada, o les té totes, no les detalla.
  • Albarà. Si la fitxa porta albarà, l'enviament que es crea el desa.

Les CGMAD de Cdiscount Marketplace (25/08/2025, p. 47) indiquen que la confirmació d'enviament porta el número de seguiment.

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 (vídeo en castellà)

Què passa en prémer, pas a pas

A Odoo 20.0, un cop superades les comprovacions, el botó fa això, en aquest ordre:

  1. Crea el registre d'enviament de la comanda, amb els bultos preparats i l'albarà si n'hi ha.
  2. Pren la connexió del compte d'Octopia de la comanda i envia a Octopia la declaració d'enviament, amb l'identificador de la comanda a Octopia i els bultos.
  3. Si Octopia retorna un error de la seva API, escriu a l'enviament l'estat error i, com a missatge, el text de l'error seguit del detall d'errors que porti la resposta, i torna a llançar el mateix error. L'acció acaba amb aquest error i la comanda no es marca com a enviada.
  4. Si tot va bé, posa l'enviament en estat sent amb la data i hora d'enviament, marca la comanda com a enviada, deixa una línia al registre de sincronització (tipus enviaments, resultat correcte, amb l'identificador de la comanda i el nombre de bultos) i tanca la finestra.

Amb Odoo en català, el botó es diu Declare to Octopia; en altres idiomes canvia el rètol:

Esquema fet amb codi a partir de les traduccions del mòdul, amb el text del botó en cinc idiomes
Esquema a partir dels fitxers d'idioma del mòdul, no una pantalla d'Odoo: castellà Declarar a Octopia, alemany An Octopia melden, francès Déclarer à Octopia, italià Dichiara a Octopia i portuguès Declarar à Octopia.

Després de prémer: què comprovar

  • La finestra s'ha tancat: és el que fa el botó quan acaba bé.
  • L'enviament és a sent i la comanda figura com a enviada.
  • Hi ha una línia nova al registre de sincronització, de tipus enviaments.
  • Si ha saltat un error d'Octopia, llegeix el text complet, que inclou el detall d'errors de la resposta, i corregeix el que indiqui abans de tornar a declarar.
  • Si el missatge és un dels de la primera secció, l'error és a les dades de la fitxa: aquestes comprovacions es fan abans de crear l'enviament i de cridar Octopia.

Què cal per tenir-lo

El mòdul és de pagament únic per versió i està publicat a Odoo Apps per a 17, 18, 19 i 20; el preu de cada versió és a la seva fitxa d'Odoo Apps. A més necessita la subscripció a FlexigoTech Cloud, pla Conector: 49 € al mes o 490 € a l'any, sense IVA. La connexió passa per FlexigoTech Cloud, que desa xifrades les credencials i vigila la sincronització.

Com t'ajuda FlexigoTech

Si estàs implantant Odoo i vols deixar llest el circuit d'enviaments amb Octopia, a FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida.

Continua llegint

Què fa el botó «Open Discussion» d'Octopia Connector: mites i realitatsQuè fa el botó Open Discussion d'Octopia Connector a Odoo: quan es veu, què comprova, què canvia i quins errors dona, desmuntant idees equivocades.Què fa el botó «Submit to Octopia» de les promocions, pas a pasCom funciona el botó Enviar a Octopia de les promocions a Odoo: quan apareix, què comprova, què canvia i quins avisos pot donar.Què fa el botó «Submit to Octopia» d'una cancel·lació, amb un casQuè fa el botó Submit to Octopia d'una cancel·lació a Odoo: quan apareix, què comprova, què canvia i com resoldre el seu missatge d'error.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts