Hibou Odoo Suite: Sales Modules: Sale Line Change

Repository Versions:

Modules:

Author:

Hibou Corp.

License:

AGPL-3

Purpose

This documentation outlines the use case and processes associated with Hibou's Sale Line Change module. The Sale Line Change Module allows users to change the routes and/or warehouses on confirmed sale lines.

Getting Started

First thing's first, we want to install the module! Navigate to the Apps application.


Once there, remove the 'Apps' filter, then search for 'Sale Line Change'. When ready, click install.

Odoo CMS - a big picture



Good to Know!

The Sale Line Change module requires the Sale Sourced by Line, Sale and Warehouse Management, and Drop Shipping modules. However, if you do not already have these modules installed Odoo will install them for you during this module's installation.

Processes

To get started, navigate to the Sales app.

Odoo - Sample 1 for three columns

Changing Procurements/Routes on a Confirmed Sale Order

Once there, go to Orders > Orders, then select a Sale Order from the list. Within that order, click the new Line Change button. 

Important!

Check Your Permissions

The new Line Change button is only available to users with the permission set of Sales: Manager.

 
Odoo CMS - a big picture

A pop-up modal for the 'Sale Line Change Order' wizard will appear. For the line(s) that need to be altered, select an alternative Warehouse or Route. You may also change the Planned date.

There is no need to make any changes to lines on the order that are already planned to the correct warehouse/route.

Odoo CMS - a big picture







 

When you're ready, click APPLY CHANGES. The original procurement will be canceled and new procurements will be created, as needed. 

If the route was change to Dropship, a new RFQ will be created.

Important!

If you are only changing the Planned Date, and not also the warehouse or route, no changes will be applied.

Changing the Planned Date, in the absence of other necessary changes, should be done on existing Pickings or Purchase Orders.

Changing Procurements/Routes on a Confirmed Dropship

To change the procurement/route on a picking created by a confirmed sale order to dropship, follow the same steps as described above. 


When the Route or Warehouse fields are changed and the Apply Changes button is pressed, an exception will be raised if the associated PO has not yet been canceled.

Odoo CMS - a big picture 

In this scenario, note the PO reference number, then click OK. Click Cancel on the Sale Line Change Order form and navigate to the Purchase app.



Search for and open the Purchase Order, then click Cancel.


You can now go back to the Sale Order and complete the Line Change.

Important!

Disable a Dropship Route

To have the ability to disable a Dropship route, it must be configured for Sales Order Lines. To do so, navigate to the Inventory app.


Once there, go to Configuration > Routes, then select the Dropship route from the list. Within the route, click Edit.

Under the Applicable On section, eanble Sales Order Lines, then click Save.


Technical

The Sale Line Change module adds a new Sale Line Change Order wizard that allows users to change sale order lines on a confirmed sale order. The Sale Like Change Order wizard tase two fields:

  • `order_id` Many2one field for the Sale Order

  • `line_ids` One2many field for the Change Lines on the sale Order

There is also a new Sale Line Change Order Line Wizard with the following eight fields:

  • `change_order_id` Many2one field for the `sale.line.change.order` (Transient Model/Wizard)

  • `sale_line_id` Many2one field for the Sale Order Line being changed

  • `line_ordered_qty` Float field for the Ordered Quantity on the sale order line

  • `line_delivered_qty` Float field for the Delivered Quantity on the sale order line

  • `line_reserved_qty` Float field for the Reserved Quantity on the sale order line

  • `line_date_planned` Datetime field for the Planned Date on the sale order line

  • `line_warehouse_id` Many2one field for the Warehouse the sale order line is being fulfilled from

  • `line_route_id` Many2one field for the Route that the sale order line is using

 A Line Change button is added to the sale order form view and is only visible to users with the Sales: Manager permission set. This will open the form view for the Sale Line Change Order wizard.