Aller au contenu principal
Octopia (Cdiscount)

Ce que fait le bouton « Soumettre à Octopia » des retours FFM

Le bouton Soumettre à Octopia (Submit to Octopia) se trouve sur la fiche des retours FFM et crée le retour dans Octopia avec les données de cette fiche. Il n'est visible que tant que le retour n'a pas d'ID du retour (Return ID), et il s'arrête avec Un retour nécessite au moins une ligne. (A return needs at least one line.) si la fiche n'a aucune ligne.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 5 novembre 2026

L'essentiel

Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
6 min

Où se trouve le bouton et quand il est visible

Les fiches de retour s'ouvrent depuis le menu Octopia › Fulfillment › Retours (Octopia › Fulfillment › Returns). La branche Octopia exige la permission Utilisateur Octopia (Octopia User) : si vous ne l'avez pas, vous ne voyez pas cette branche. Le bouton se trouve dans l'écran Retours FFM (FFM Returns), et il existe dans les quatre versions publiées du module : Odoo 17, 18, 19 et 20.

Schéma du menu Octopia, Fulfillment, Returns et du bouton Submit to Octopia, avec à côté le message qui peut l'arrêter
Schéma réalisé avec du code à partir du code publié du module, ce n'est pas une capture d'Odoo : le menu, le bouton (Odoo 17, 18, 19 et 20) et le message qui peut l'arrêter.

Le bouton n'a qu'une seule condition de vue : il est masqué lorsque le champ ID du retour a une valeur. Avec les valeurs par défaut, ce champ est vide, donc le bouton est visible. Dit à l'inverse : un retour qui a déjà un ID du retour ne propose plus le bouton.

Avec Odoo en français, le bouton s'appelle Soumettre à Octopia. Voici comment il se lit dans chaque langue disposant d'une traduction publiée :

Schéma avec le texte du bouton Submit to Octopia selon la langue d'Odoo : espagnol, allemand, français, italien et portugais
Schéma réalisé avec du code à partir des traductions publiées du module, ce n'est pas une capture d'Odoo.
Langue d'OdooLibellé du bouton
EspagnolSoumettre à Octopia
AllemandAn Octopia übermitteln
FrançaisSoumettre à Octopia
ItalienInvia a Octopia
PortugaisSubmeter à Octopia
48 business hours to accept each Cdiscount order. Do it in Odoo
Vidéo : 48 business hours to accept each Cdiscount order. Do it in Odoo (vidéo en anglais)

Un cas pour le suivre de bout en bout

Exemple Cas illustratif : l'entreprise et ses chiffres sont inventés pour expliquer le flux.

Hogar Norte est une boutique fictive qui vend des articles de maison sur Cdiscount et gère ses retours FFM depuis Odoo. Un client retourne un produit d'un envoi déjà effectué. Marta, du service client, ouvre la fiche du retour dans Octopia › Fulfillment › Retours et renseigne ce que cette fiche affiche : le Compte (Account) Octopia, l'Expédition sortante (Outbound Shipment) d'où vient le produit, le Commentaire (Comment) si elle veut laisser une note et les Lignes (Lines) du retour.

Elle clique d'abord sur Soumettre à Octopia avec la fiche sans lignes : l'action s'arrête et Un retour nécessite au moins une ligne. apparaît. Rien n'a été envoyé à Octopia. Marta ajoute une ligne dans Lignes et clique de nouveau. Cette fois, le module prépare la requête, l'envoie avec le compte choisi et, si la réponse contient l'identifiant du retour, l'enregistre dans ID du retour. Ensuite, il passe le retour à l'état créé et note une ligne dans le journal de synchronisation du compte. Comme ID du retour a maintenant une valeur, le bouton disparaît de la fiche.

Ce que l'on retient du cas : la vérification préalable du module porte sur la présence de lignes, et la trace que la création est bien arrivée chez Octopia est la valeur de ID du retour.

Ce que fait le bouton, dans l'ordre

  1. Si le retour a déjà un ID du retour, la méthode l'ignore sans rien faire.
  2. Elle vérifie que le retour a des lignes. S'il n'en a aucune, elle s'arrête avec Un retour nécessite au moins une ligne. et ne va pas plus loin.
  3. Elle prépare la requête avec l'identifiant externe de l'Expédition sortante, le motif du retour et, pour chaque ligne, le produit, la quantité et l'état du produit.
  4. Si Commentaire contient du texte, elle l'ajoute à la requête. S'il est vide, la requête part sans commentaire.
  5. Elle se connecte avec le Compte du retour et demande à Octopia de créer le retour.
  6. Si la réponse contient l'identifiant du retour, elle l'enregistre dans ID du retour.
  7. Elle passe le retour à l'état créé.
  8. Elle note une ligne dans le journal de synchronisation du compte : de type fulfillment, avec un résultat correct, avec l'expédition sortante dans le texte et un enregistrement compté.

Ce journal n'est pas réservé au bouton. Deux tâches planifiées y écrivent aussi. La tâche Octopia : actualiser les référentiels (catégories, marques, transporteurs, typologies) (Octopia: refresh referentials (categories, brands, carriers, typologies)) s'exécute tous les sept jours et est active à l'installation, mais elle n'écrit dans le journal que lorsqu'une étape de l'actualisation échoue : elle y laisse alors une erreur de référentiels incomplets. La tâche Octopia : récupérer les discussions (file ToTreat) (Octopia: pull discussions (ToTreat queue)) s'exécute toutes les 15 minutes, est active à l'installation et laisse aussi sa note dans ce journal.

Le message qui peut arrêter le bouton

MessageQuand il apparaîtQue faire
Un retour nécessite au moins une ligne.En cliquant sur Soumettre à Octopia avec un retour sans lignes.Ajoutez au moins une ligne dans Lignes de la fiche et cliquez de nouveau.

La vérification passe avant la préparation de la requête et la connexion à Octopia. Quand le message apparaît, ce retour n'est pas envoyé et rien de ce que le bouton allait écrire n'est enregistré : ni ID du retour, ni le changement d'état, ni la ligne de journal.

Questions fréquentes à l'usage

Le commentaire est-il envoyé s'il est vide ?

Non. Le module n'ajoute le commentaire à la requête que lorsque Commentaire contient du texte.

Avec quel compte l'envoi se fait-il ?

Avec celui indiqué dans Compte sur la fiche du retour. Vous le voyez aussi dans la liste des Retours FFM, à côté de l'Expédition sortante.

Que se passe-t-il si la réponse ne contient pas d'identifiant ?

Le module passe quand même le retour à l'état créé et note la ligne de journal, mais ID du retour reste vide. Selon la condition de vue du bouton, avec ce champ vide, le bouton reste visible.

Peut-on envoyer deux fois le même retour ?

Cela dépend de ID du retour. Si le retour en a déjà un, non : le bouton n'est pas affiché et la méthode l'ignore. S'il est resté vide parce que la réponse ne contenait pas d'identifiant, le bouton reste visible et un nouveau clic renvoie la requête à Octopia.

Ce dont vous avez besoin pour l'utiliser

Le module est en paiement unique par version et publié sur Odoo Apps pour Odoo 17, 18, 19 et 20 ; chaque version d'Odoo s'y achète séparément et son prix figure sur sa fiche. Il nécessite en outre l'abonnement à FlexigoTech Cloud, plan Connecteur : 49 €/mois ou 490 €/an HT, pour jusqu'à 3 comptes de la plateforme (le plan Pro est à 98 €/mois ou 980 €/an HT, pour jusqu'à 10).

La connexion passe par FlexigoTech Cloud, qui conserve les identifiants chiffrés, surveille la synchronisation et prévient par e-mail en cas d'échec ; si la plateforme modifie son API, le module et le service s'adaptent. Sans abonnement, ou avec le service suspendu, ce que l'abonnement apporte s'arrête ; les données restent dans votre Odoo.

Le module a d'autres boutons qui ont leur propre article, comme Ouvrir la conversation et Déclarer à Octopia.

Si vous avez besoin d'aide avec Octopia et Odoo

FlexigoTech met en place Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure. Si vous souhaitez examiner comment vos retours FFM s'intègrent dans votre Odoo, écrivez-nous.

À lire aussi

Ce que fait le bouton « Ouvrir la discussion » d'Octopia Connector : mythes et réalitésCe que fait le bouton Ouvrir la discussion d'Octopia Connector dans Odoo : quand il s'affiche, ce qu'il vérifie, ce qui change et quelles erreurs il renvoie.Ce que fait le bouton « Soumettre à Octopia » des promotions, pas à pasComment fonctionne le bouton Soumettre à Octopia des promotions dans Odoo : quand il apparaît, ce qu'il vérifie, ce qui change et les avertissements possibles.Déclarer à Octopia dans Odoo : checklist du bouton, pas à pasChecklist du bouton Déclarer à Octopia : ce qu'il vérifie, ce qu'il change sur l'expédition et la commande, et que faire des messages qui le bloquent.
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources