Odoo中的路线规则浅析

发表于 | 分类于 |

本文假设读者已经了解odoo路线的推拉规则

路线规则的优先级

我们知道，odoo中的路线可以在四个地方设置，分别是产品路线、产品分类路线、仓库路线和订单明细行中的路线。这四种路线的优先级为:

1
销售订单明细行 ——> 产品路线——> 产品分类路线——> 仓库路线

这个很好理解，当几个路线对某个库位设置的规则冲突时，依据本优先级进行应用。现在问题来了，我们知道产品路线中有多个路线可以选择，当产品路线中的多个路线的多个规则定义了相同的库位的规则时，会怎样呢？

隐藏的规则

相同级别的路线如果定义了相同的库位规则，官方并没有给出文档解释，我们从代码中可以窥见这隐秘的规则：

我们知道在早期的版本中，驱动销售产生采购、生产单的背后的大佬是需求单(procurement.order)，到了13.0中已经演变成了procurement.group，需求单也不复存在，而且这家伙并不为普罗大众所熟知，造成的结果就是，很容易陷在路线的泥潭里而百思不得其解。

我们先来看procurement.group中是如何运行路线规则的：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
@api.model
def run(self, procurements):
    """ Method used in a procurement case. The purpose is to supply the
    product passed as argument in the location also given as an argument.
    In order to be able to find a suitable location that provide the product
    it will search among stock.rule.
    """
    actions_to_run = defaultdict(list)
    errors = []
    for procurement in procurements:
        procurement.values.setdefault('company_id', self.env.company)
        procurement.values.setdefault('priority', '1')
        procurement.values.setdefault('date_planned', fields.Datetime.now())
        if (
            procurement.product_id.type not in ('consu', 'product') or
            float_is_zero(procurement.product_qty, precision_rounding=procurement.product_uom.rounding)
        ):
            continue
        rule = self._get_rule(procurement.product_id, procurement.location_id, procurement.values)
        if not rule:
            errors.append(_('No rule has been found to replenish "%s" in "%s".\nVerify the routes configuration on the product.') %
                (procurement.product_id.display_name, procurement.location_id.display_name))
        else:
            action = 'pull' if rule.action == 'pull_push' else rule.action
            actions_to_run[action].append((procurement, rule))

    ...

由此可见，关键方法_get_rule负责根据需求寻找对应的路线规则。所以，我们来看一下 _get_rule的具体内容:

1
2
3
4
5
6
7
8
9
10
11
12
@api.model
def _get_rule(self, product_id, location_id, values):
    """ Find a pull rule for the location_id, fallback on the parent
    locations if it could not be found.
    """
    result = False
    location = location_id
    while (not result) and location:
        domain = self._get_rule_domain(location, values)
        result = self._search_rule(values.get('route_ids', False), product_id, values.get('warehouse_id', False), domain)
        location = location.location_id
    return result

这里有两个方法，_get_rule_domain负责查找库位的domain，_search_rule负责根据传入的库位查找规则。_get_rule_domain的功能比较简单，就是在规则中查找源库位为location_id且不是推式物流的规则。而_search_rule才是真正查找路线规则的关键先生。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
@api.model
def _search_rule(self, route_ids, product_id, warehouse_id, domain):
    """ First find a rule among the ones defined on the procurement
    group, then try on the routes defined for the product, finally fallback
    on the default behavior
    """
    if warehouse_id:
        domain = expression.AND([['|', ('warehouse_id', '=', warehouse_id.id), ('warehouse_id', '=', False)], domain])
    Rule = self.env['stock.rule']
    res = self.env['stock.rule']
    if route_ids:
        res = Rule.search(expression.AND([[('route_id', 'in', route_ids.ids)], domain]), order='route_sequence, sequence', limit=1)
    if not res:
        product_routes = product_id.route_ids | product_id.categ_id.total_route_ids
        if product_routes:
            res = Rule.search(expression.AND([[('route_id', 'in', product_routes.ids)], domain]), order='route_sequence, sequence', limit=1)
    if not res and warehouse_id:
        warehouse_routes = warehouse_id.route_ids
        if warehouse_routes:
            res = Rule.search(expression.AND([[('route_id', 'in', warehouse_routes.ids)], domain]), order='route_sequence, sequence', limit=1)
    return res

这个方法印证了我们之前的结论:

  1. odoo会先查找给定的路线，如果没有指定路线，则在产品路线或者产品分类路线中查找，如果没有则在仓库的路线中查找。
  2. 相同优先级的路线规则，则依据规则的route_sequence和sequene进行排序，取第一个规则。

实际中的例子

其实关于odoo路线的讨论文章已经不少了，今天之所以会重新总结一遍，是因为在实际使用过程中又一次在这里摔了跟头。简单回顾一下问题发生的过程:

  1. 首先，odoo中制造的路线，默认的生产库位为WH/Stock。
  2. 因为某种原因，我们把Stock改成了视图库位，并在其下设置了很多内部库位。
  3. 销售某产品，产品路线设置MTO和Manufacture。生成的生产单无法完成，因为目的库位Stock为视图。
  4. 修改Manufacture的路线规则，将成品库位设置为Stock/A.
  5. 报错，提示在Input库位没有找到合适的路线规则。
  6. 一脸懵逼，怎么会跟Input库位有关系，经排查，产品分类中设置了两步入库、两步出库，两步出库第二步Stock->Output后，Stock为目的库位的规则只有一个，就是两步入库中的Input-> Stock，因为产品没有选购买，因此找不到Input的下一步规则。
  7. 发现错误，新增Stock/A->Output的规则到Manufacture, 并没有生效。
  8. 查看代码，发现优先级问题，调整规则的优先级，成功。

排查的过程真是耗费了大量的时间，因此为了节省时间作为以后排查的依据，整理的结论如下：

路线规则

  1. 销售订单明细行 ——> 产品路线——> 产品分类路线——> 仓库路线
  2. 路线规则的优先级，首先看路线的序号，然后看规则的序号，取找到的第一个规则应用。

思考题

不知道你是否想过 官方的原生的MTO路线是如何实现的？如果让你手动定义一个MTO路线，你会怎么定义？

本例中，如何设置Stock/A->Output的规则，可以实现销售单做完以后，生成两步出库单，并自动在Stock/A上生成生产单？

你的支持我的动力