Skip to content

Commit f4a8d17

Browse files
ppyczkoppyczko
committed
[15.0][ADD] fieldservice_sale_stock_route_backorder: New module fieldservice_sale_stock_route_backorder
1 parent 381a6fc commit f4a8d17

22 files changed

+1719
-0
lines changed

‎fieldservice_sale_stock_route_backorder/README.rst‎

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
==========================================
2+
Field Service - Sale Stock Route Backorder
3+
==========================================
4+
5+
..
6+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
7+
!! This file is generated by oca-gen-addon-readme !!
8+
!! changes will be overwritten. !!
9+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
10+
!! source digest: sha256:8d2e3e157d288e550262aba54a16930a5be9dc2ae26b0d863ba42e01708ef3f6
11+
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
12+
13+
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
14+
:target: https://odoo-community.org/page/development-status
15+
:alt: Beta
16+
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
17+
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
18+
:alt: License: AGPL-3
19+
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Ffield--service-lightgray.png?logo=github
20+
:target: https://github.com/OCA/field-service/tree/15.0/fieldservice_sale_stock_route_backorder
21+
:alt: OCA/field-service
22+
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
23+
:target: https://translation.odoo-community.org/projects/field-service-15-0/field-service-15-0-fieldservice_sale_stock_route_backorder
24+
:alt: Translate me on Weblate
25+
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
26+
:target: https://runboat.odoo-community.org/builds?repo=OCA/field-service&target_branch=15.0
27+
:alt: Try me on Runboat
28+
29+
|badge1| |badge2| |badge3| |badge4| |badge5|
30+
31+
This module automates the creation of backorders directly from an FSM order.
32+
33+
A new wizard is available in the FSM order form view to adjust deliveries. This wizard allows setting the quantity to deliver for each outgoing product, and it also supports adding new products that were not part of the initial demand. Before confirming, it attempts to reserve newly available stock to ensure the most up-to-date availability is considered.
34+
35+
By default, the system checks the **reserved quantity** on each stock move and considers the **free stock available** in the warehouse for each **storable product**. If additional stock is available beyond the reserved quantity and has not been reserved by another stock move, it allows delivering more than the initially ordered amount, providing flexibility when extra stock is on hand. However, it still ensures that deliveries do not exceed the actual stock available in the warehouse. On the other hand, **Consumable products** can always be over-delivered, as they do not have stock constraints.
36+
37+
Example Scenario
38+
1. An order requests **70 units** of a product.
39+
2. Initially, only **40 units** are available and reserved, so the system prevents delivering more than 40.
40+
3. Later, additional stock arrives, increasing available inventory to **100 units**.
41+
4. If no other stock moves have reserved the extra **30 units**, the system allows delivering **up to 100 units**, even though the initial demand was 70.
42+
5. Additionally, new products can be added to the delivery through the wizard, and stock moves will be created for these new products, ensuring that quantities are validated and processed as part of the overall delivery.
43+
44+
Once confirmed, the system validates the picking and creates a backorder for any remaining quantities. This backorder is automatically scheduled for the next available route day based on the FSM location's route configuration.
45+
46+
When all quantities have been delivered, the FSM order is marked as completed automatically.
47+
48+
**Table of contents**
49+
50+
.. contents::
51+
:local:
52+
53+
Usage
54+
=====
55+
56+
To use this module, you need to:
57+
58+
1. Navigate to Sales > Orders.
59+
2. Create a new sales order.
60+
3. Add a product that generates an FSM order (Field Service Tracking set to "Create one FSM order per sale order" on the product form).
61+
4. Set the Customer and FSM Location.
62+
5. Make sure the FSM Location has a route set and this route has a person assigned and route days set.
63+
6. In the sale order, navigate to the 'Other Info' tab and set the 'Delivery Date' and 'Delivery End Date' fields. You can also leave them empty to have the system automatically assign the next available route day.
64+
7. Confirm the sale order.
65+
8. Enter the FSM order. A new 'Adjust Delivery' button is available in the header.
66+
9. Click the 'Adjust Delivery' button to open the wizard. Set the quantity to deliver for each product and, if necessary, add new products to the delivery. Proceed to confirm the wizard.
67+
10. The system will attempt to **reserve newly available stock** before delivery for storable products. It will allow **delivering more than the initial demand** if additional unreserved stock is available. It will prevent delivery of quantities exceeding the **total available stock** (reserved + free stock in the warehouse). For consumable products, the system will always allow over-delivery.
68+
11. Once confirmed, the system will validate the picking and create a backorder for any remaining quantities. This backorder will be scheduled for the next available route day based on the FSM location's route configuration and both the FSM order and sale order schedule will be updated.
69+
12. When all quantities have been delivered, the FSM order will be marked as completed automatically.
70+
71+
Bug Tracker
72+
===========
73+
74+
Bugs are tracked on `GitHub Issues <https://github.com/OCA/field-service/issues>`_.
75+
In case of trouble, please check there if your issue has already been reported.
76+
If you spotted it first, help us to smash it by providing a detailed and welcomed
77+
`feedback <https://github.com/OCA/field-service/issues/new?body=module:%20fieldservice_sale_stock_route_backorder%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
78+
79+
Do not contact contributors directly about support or help with technical issues.
80+
81+
Credits
82+
=======
83+
84+
Authors
85+
~~~~~~~
86+
87+
* APSL-Nagarro
88+
89+
Contributors
90+
~~~~~~~~~~~~
91+
92+
`APSL-Nagarro <https://www.apsl.tech>`_:
93+
* Patryk Pyczko <[email protected]>
94+
95+
Maintainers
96+
~~~~~~~~~~~
97+
98+
This module is maintained by the OCA.
99+
100+
.. image:: https://odoo-community.org/logo.png
101+
:alt: Odoo Community Association
102+
:target: https://odoo-community.org
103+
104+
OCA, or the Odoo Community Association, is a nonprofit organization whose
105+
mission is to support the collaborative development of Odoo features and
106+
promote its widespread use.
107+
108+
.. |maintainer-ppyczko| image:: https://github.com/ppyczko.png?size=40px
109+
:target: https://github.com/ppyczko
110+
:alt: ppyczko
111+
112+
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
113+
114+
|maintainer-ppyczko|
115+
116+
This module is part of the `OCA/field-service <https://github.com/OCA/field-service/tree/15.0/fieldservice_sale_stock_route_backorder>`_ project on GitHub.
117+
118+
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

‎fieldservice_sale_stock_route_backorder/__init__.py‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Copyright 2025 Patryk Pyczko (APSL-Nagarro)<[email protected]>
2+
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
3+
4+
from . import models
5+
from . import wizard

‎fieldservice_sale_stock_route_backorder/__manifest__.py‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Copyright 2025 Patryk Pyczko (APSL-Nagarro)<[email protected]>
2+
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
3+
4+
{
5+
"name": "Field Service - Sale Stock Route Backorder",
6+
"version": "15.0.1.0.0",
7+
"summary": "Manage backorders for Field Service Orders",
8+
"category": "Field Service",
9+
"website": "https://github.com/OCA/field-service",
10+
"author": "APSL-Nagarro, Odoo Community Association (OCA)",
11+
"maintainers": ["ppyczko"],
12+
"license": "AGPL-3",
13+
"application": False,
14+
"installable": True,
15+
"depends": ["fieldservice_sale_stock_route"],
16+
"data": [
17+
"security/ir.model.access.csv",
18+
"wizard/fsm_partial_delivery_wizard_form.xml",
19+
"views/fsm_order_view.xml",
20+
],
21+
}

‎fieldservice_sale_stock_route_backorder/i18n/ca.po‎

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
# Translation of Odoo Server.
2+
# This file contains the translation of the following modules:
3+
# * fieldservice_sale_stock_route_backorder
4+
#
5+
msgid ""
6+
msgstr ""
7+
"Project-Id-Version: Odoo Server 15.0\n"
8+
"Report-Msgid-Bugs-To: \n"
9+
"POT-Creation-Date: 2025-03-26 14:15+0000\n"
10+
"PO-Revision-Date: 2025-03-26 14:15+0000\n"
11+
"Last-Translator: \n"
12+
"Language-Team: \n"
13+
"MIME-Version: 1.0\n"
14+
"Content-Type: text/plain; charset=UTF-8\n"
15+
"Content-Transfer-Encoding: \n"
16+
"Plural-Forms: \n"
17+
18+
#. module: fieldservice_sale_stock_route_backorder
19+
#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_order_form_inherit_partial_delivery
20+
#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form
21+
msgid "Adjust Delivery"
22+
msgstr "Ajusta el lliurament"
23+
24+
#. module: fieldservice_sale_stock_route_backorder
25+
#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form
26+
msgid "Cancel"
27+
msgstr "Cancel·la"
28+
29+
#. module: fieldservice_sale_stock_route_backorder
30+
#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form
31+
msgid "Confirm"
32+
msgstr "Confirma"
33+
34+
#. module: fieldservice_sale_stock_route_backorder
35+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_uid
36+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_uid
37+
msgid "Created by"
38+
msgstr "Creat per"
39+
40+
#. module: fieldservice_sale_stock_route_backorder
41+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_date
42+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_date
43+
msgid "Created on"
44+
msgstr "Creat el"
45+
46+
#. module: fieldservice_sale_stock_route_backorder
47+
#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form
48+
msgid "Delivery Adjustments"
49+
msgstr "Ajustaments de lliurament"
50+
51+
#. module: fieldservice_sale_stock_route_backorder
52+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__display_name
53+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__display_name
54+
msgid "Display Name"
55+
msgstr "Nom de visualització"
56+
57+
#. module: fieldservice_sale_stock_route_backorder
58+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__fsm_order_id
59+
msgid "FSM Order"
60+
msgstr "Ordre FSM"
61+
62+
#. module: fieldservice_sale_stock_route_backorder
63+
#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_line
64+
msgid "FSM Partial Delivery Line"
65+
msgstr "Línia de lliurament parcial FSM"
66+
67+
#. module: fieldservice_sale_stock_route_backorder
68+
#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_wizard
69+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__wizard_id
70+
msgid "FSM Partial Delivery Wizard"
71+
msgstr "Assistent de lliurament parcial FSM"
72+
73+
#. module: fieldservice_sale_stock_route_backorder
74+
#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_order
75+
msgid "Field Service Order"
76+
msgstr "Ordre de servei de camp"
77+
78+
#. module: fieldservice_sale_stock_route_backorder
79+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__id
80+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__id
81+
msgid "ID"
82+
msgstr ""
83+
84+
#. module: fieldservice_sale_stock_route_backorder
85+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line____last_update
86+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard____last_update
87+
msgid "Last Modified on"
88+
msgstr "Última modificació el"
89+
90+
#. module: fieldservice_sale_stock_route_backorder
91+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_uid
92+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_uid
93+
msgid "Last Updated by"
94+
msgstr "Última actualització per"
95+
96+
#. module: fieldservice_sale_stock_route_backorder
97+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_date
98+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_date
99+
msgid "Last Updated on"
100+
msgstr "Última actualització el"
101+
102+
#. module: fieldservice_sale_stock_route_backorder
103+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__requested_quantity
104+
msgid "Ordered Quantity"
105+
msgstr "Quantitat demanada"
106+
107+
#. module: fieldservice_sale_stock_route_backorder
108+
#: model:ir.actions.act_window,name:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_action
109+
msgid "Partial Delivery"
110+
msgstr "Lliurament parcial"
111+
112+
#. module: fieldservice_sale_stock_route_backorder
113+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__product_id
114+
msgid "Product"
115+
msgstr "Producte"
116+
117+
#. module: fieldservice_sale_stock_route_backorder
118+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__quantity_done
119+
msgid "Quantity Delivered"
120+
msgstr "Quantitat lliurada"
121+
122+
#. module: fieldservice_sale_stock_route_backorder
123+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_order__show_partial_delivery_button
124+
msgid "Show Partial Delivery Button"
125+
msgstr "Mostra el botó de lliurament parcial"
126+
127+
#. module: fieldservice_sale_stock_route_backorder
128+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__move_id
129+
msgid "Stock Move"
130+
msgstr "Moviment d'estoc"
131+
132+
#. module: fieldservice_sale_stock_route_backorder
133+
#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__stock_move_ids
134+
msgid "Stock Moves"
135+
msgstr "Moviments d'estoc"
136+
137+
#. module: fieldservice_sale_stock_route_backorder
138+
#: code:addons/fieldservice_sale_stock_route_backorder/wizard/fsm_partial_delivery_wizard_form.py:0
139+
#, python-format
140+
msgid ""
141+
"You cannot deliver more than the available stock.\n"
142+
"Product: %(product)s\n"
143+
"Reserved Stock: %(reserved)s\n"
144+
"Free Stock: %(free)s\n"
145+
"Total Available (Reserved + Free): %(total)s\n"
146+
"Requested Delivery: %(requested)s"
147+
msgstr ""
148+
"No pots lliurar més del stock disponible.\n"
149+
"Producte: %(product)s\n"
150+
"Stock Reservat: %(reserved)s\n"
151+
"Stock Lliure: %(free)s\n"
152+
"Total Disponible (Reservat + Lliure): %(total)s\n"
153+
"Lliurament Sol·licitat: %(requested)s"

0 commit comments

Comments
 (0)