Skip to main content
Octopia (Cdiscount)

The Download Label button in Octopia Connector: myths and facts

The Download Label button requests a return's label through its account's connection and, if it receives a file with content, saves it as a PDF attachment on the record; it only appears when the return has a Return ID.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 5 November 2026

Key facts

Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
4 min

Where the button is and when it appears

The Download Label button is on the FFM Returns form. That form opens from the menu Octopia › Fulfillment › Returns. The Octopia part of the menu requires the Octopia User permission: without it, you do not see that part.

The button is in every published branch of the module: Odoo 17, 18, 19 and 20. What is described below is how the Odoo 20 code works.

Diagram made from code (not an Odoo screen): from top to bottom, the menu path Octopia, Fulfillment, Returns and the Download Label button, with the original English labels from the module code
Diagram of the menu and the button in Odoo 17, 18, 19 and 20, with the original English labels.

The label of the button changes with the language of your Odoo:

Diagram made from the published translations (not an Odoo screen): the text Download Label in Spanish, German, French, Italian and Portuguese
The same button by language: Descargar etiqueta in Spanish, Etikett herunterladen in German, Télécharger l'étiquette in French, Scarica etichetta in Italian and Descarregar etiqueta in Portuguese.
48 business hours to accept each Cdiscount order. Do it in Odoo
Video: 48 business hours to accept each Cdiscount order. Do it in Odoo

Misconceptions about the button, one by one

"The button is on any return"

In fact, the button is hidden when the Return ID field is empty. With the default values that field is empty, so the button is not visible. The field appears on the form and also in the FFM Returns list, so it is the first thing to look at if you cannot find the button. The condition is the same in Odoo 17, 18, 19 and 20.

"The button builds the label from Odoo data"

The Odoo 20 code does something else. For each return, it takes the account in the Account field and obtains its client. It then asks for that return's label, identified by the value of Return ID. In other words, the label is requested with that identifier and through the return's account.

"Pressing the button is enough to get the label"

Only if what comes back is a file with content. According to the code, if the response is not a file (bytes) or comes back empty, the method moves on to the next return without creating anything and without touching the record. After pressing, check whether the Label Attachment field has been filled in. If it is still empty, the method did not receive a file with content for that return.

"Download means the PDF is saved on your computer"

What the method does is save the label inside Odoo. It creates a PDF attachment named octopia-return-…-label.pdf, with the Return ID in place of the dots, and links it to the return itself. It then places that attachment in the Label Attachment field.

That field is visible on the FFM Returns form and is read-only: the code writes it when the button is pressed, not the user.

"Pressing it twice changes nothing"

Each time the method receives content, it creates a new attachment and the Label Attachment field points to it. If on a second press no file with content arrives, the method moves on to the next return and the field stays as it was.

"Any user reaches the button, on any return"

There are two caveats. The first is the menu: the Octopia part requires Octopia User, and without that permission you do not see it. The second is in the code: the method only works on returns that have a Return ID and skips the rest.

What to check after pressing it

On the return form:

  • The Label Attachment field has a value. That shows the method received a file with content and saved it.
  • The attachment is named octopia-return-…-label.pdf with that return's identifier.
  • The Account and Return ID fields are the ones for the return you meant. They are the two values the method uses to request the label.

If you are looking for a different button in the module, Submit to Octopia has its own article: Submit to Octopia.

Cost and how FlexigoTech helps

Octopia Connector is a one-off purchase per Odoo version and needs a FlexigoTech Cloud subscription, Connector plan: €49 a month or €490 a year excluding VAT, with up to 3 marketplace accounts. It is published on Odoo Apps for Odoo 17, 18, 19 and 20; on the Odoo App Store, each version is bought there.

The connection goes through FlexigoTech Cloud, which stores the credentials encrypted, monitors synchronisation and emails you if it fails. If you are implementing Odoo and need to set up the Cdiscount or Octopia returns flow, FlexigoTech implements Odoo 17, 18, 19 and 20 and builds custom connectors and integrations.

Keep reading

What the Submit to Octopia button of Octopia Connector does, step by stepWhat the Submit to Octopia button does in Bulk Invoice Imports: when it shows, what it checks, what it changes and the one error it can raise.What the Import button of Octopia Connector does, step by stepWhat the Import button of Octopia Connector does in Odoo: when it shows, what it imports, what changes, the notice it gives and the log entry it leaves.What the Create Vendor Bill button in Octopia Connector doesWhat the Create Vendor Bill button in Octopia Connector does in Odoo: when it shows, what it checks, what it creates and where it can stop.
Checked in the connector's source code (version 20.0) and the linked sources

Sources