Refonte MTO dans Odoo 19 :
procurement.group remplacé par stock.reference

L'ossature du MTO vient de changer. Votre code personnalisé, probablement pas.

Si votre instance Odoo utilise le Make-to-Order (MTO), le réapprovisionnement Make-to-Stock, ou toute logique d'approvisionnement personnalisée—et que vous planifiez une migration vers Odoo 19—lisez ceci avant de toucher à un script de migration.

Le modèle procurement.group, qui servait de fil conducteur invisible entre les commandes de vente, les commandes d'achat et les ordres de fabrication depuis Odoo 8, a été fondamentalement remplacé. À sa place : un nouveau modèle appelé stock.reference.

Ce n'est pas un simple renommage. C'est une refonte architecturale. Et si vous avez surchargé _run_buy(), _run_manufacture(), ou toute méthode qui touche à procurement.group, votre code va casser silencieusement—les commandes seront générées sans liaison documentaire, la traçabilité s'effondrera, et votre équipe d'exploitation se retrouvera face à des ordres de fabrication orphelins, sans savoir quelle commande de vente les a déclenchés.

Nous avons déjà migré trois clients à forte composante manufacturière à travers ce changement. Voici ce que nous avons appris.

Comment stock.reference simplifie la liaison documentaire entre Ventes et Fabrication

Dans Odoo 18 et versions antérieures, le modèle procurement.group servait de mécanisme de regroupement fourre-tout. Un groupe d'approvisionnement était créé à partir d'une commande de vente puis transmis à travers toute la chaîne logistique : mouvements de stock, bons de commande, ordres de fabrication. Le problème ? Le modèle était surchargé. Il transportait des données spécifiques à l'approvisionnement, des références de vente et de la logique de routage—le tout amalgamé dans un seul enregistrement difficile à étendre sans effets secondaires.

Odoo 19 introduit stock.reference comme modèle dédié de liaison inter-documents. Au lieu d'un groupe monolithique sur lequel tout repose, stock.reference agit comme un pont léger et explicite entre les documents sources (commandes de vente) et les documents en aval (ordres de fabrication, bons de commande, transferts de stock).

class StockReference(models.Model):
    _name = 'stock.reference'
    _description = 'Stock Document Reference'

    name = fields.Char(string='Reference', required=True)
    res_model = fields.Char(string='Source Model')
    res_id = fields.Integer(string='Source ID')
    sale_id = fields.Many2one('sale.order', string='Sale Order')
    move_ids = fields.One2many('stock.move', 'reference_id')

    def get_source_document(self):
        """Retourne l'enregistrement source (sale.order, orderpoint, etc.)"""
        if self.res_model and self.res_id:
            return self.env[self.res_model].browse(self.res_id)
        return False

procurement.group vs. stock.reference : ce qui change dans le MTO Odoo 19

Comment refactorer les surcharges _run_buy et _run_manufacture pour Odoo 19

Si vous avez personnalisé l'approvisionnement dans Odoo 18, vous avez presque certainement surchargé _run_buy() ou _run_manufacture() sur stock.rule. Voici le changement de pattern à appliquer.

Avant (Odoo 18)

class StockRule(models.Model):
    _inherit = 'stock.rule'

    def _run_manufacture(self, procurements):
        """Odoo 18 : procurement.group porte le lien CV."""
        for procurement in procurements:
            group = procurement.values.get('group_id')
            # Custom : ajouter une réf. projet sur l'OF
            # depuis la commande de vente via procurement group
            sale_order = group.sale_id if group else False
            project_ref = (
                sale_order.x_project_ref if sale_order else ''
            )
            procurement.values['x_project_ref'] = project_ref

        return super()._run_manufacture(procurements)

Après (Odoo 19)

class StockRule(models.Model):
    _inherit = 'stock.rule'

    def _run_manufacture(self, procurements):
        """Odoo 19 : stock.reference remplace procurement.group."""
        for procurement in procurements:
            reference = procurement.values.get('reference_id')
            # Utiliser la nouvelle API polymorphique
            source_doc = (
                reference.get_source_document() if reference
                else False
            )
            project_ref = ''
            if source_doc and source_doc._name == 'sale.order':
                project_ref = source_doc.x_project_ref or ''
            procurement.values['x_project_ref'] = project_ref

        return super()._run_manufacture(procurements)

Le même pattern s'applique à _run_buy(). Remplacez chaque values.get('group_id') par values.get('reference_id'), et utilisez get_source_document() au lieu d'accéder directement à .sale_id.

Checklist de refactoring

Ce que cela signifie pour les résultats financiers

Ce n'est pas qu'une préoccupation de développeur. Le passage de procurement.group à stock.reference apporte des bénéfices métier concrets une fois la migration correctement réalisée :