diff --git a/fieldservice_sale_stock_route_backorder/README.rst b/fieldservice_sale_stock_route_backorder/README.rst new file mode 100644 index 0000000000..9b2244923d --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/README.rst @@ -0,0 +1,118 @@ +========================================== +Field Service - Sale Stock Route Backorder +========================================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:d433d0ea7fd220cd966046186853b1eb1082639b1bb0b6740203cb6b4e8a34d3 + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png + :target: https://odoo-community.org/page/development-status + :alt: Beta +.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png + :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html + :alt: License: AGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Ffield--service-lightgray.png?logo=github + :target: https://github.com/OCA/field-service/tree/15.0/fieldservice_sale_stock_route_backorder + :alt: OCA/field-service +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/field-service-15-0/field-service-15-0-fieldservice_sale_stock_route_backorder + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png + :target: https://runboat.odoo-community.org/builds?repo=OCA/field-service&target_branch=15.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module introduces a new wizard 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. + +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. + +Example Scenario +1. An order requests **70 units** of a product. +2. Initially, only **40 units** are available and reserved, so the system prevents delivering more than 40. +3. Later, additional stock arrives, increasing available inventory to **100 units**. +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. +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. + +Once confirmed, the system validates the picking and creates a backorder sale if any of the initially requested quantities cannot be delivered and the product has the 'create backorder sale' option enabled. This backorder sale will include the remaining quantities that could not be delivered and will be scheduled for the next available route day, allowing for future processing and fulfillment. + +When all quantities have been delivered, the FSM order is marked as completed automatically. + +**Table of contents** + +.. contents:: + :local: + +Usage +===== + +To use this module, you need to: + +**For this module to work as intended, you need to enable the Auto Validate FSM Pickings setting in Field Service > Configuration > Settings.** + +1. Navigate to Sales > Orders. +2. Create a new sales order. +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). If you want this product to generate a backorder sale whenever it is not fully delivered, ensure the field **Create Backorder Sale Order** is checked on the product form +4. Set the Customer and FSM Location. +5. Make sure the FSM Location has a route set and this route has a person assigned and route days set. +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. +7. Confirm the sale order. +8. Enter the FSM order. A new 'Adjust Delivery' button is available in the header. +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. +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. +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. +12. When all quantities have been delivered, the FSM order will be marked as completed automatically. + +Bug Tracker +=========== + +Bugs are tracked on `GitHub Issues `_. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +`feedback `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +~~~~~~~ + +* APSL-Nagarro + +Contributors +~~~~~~~~~~~~ + + `APSL-Nagarro `_: + * Patryk Pyczko + +Maintainers +~~~~~~~~~~~ + +This module is maintained by the OCA. + +.. image:: https://odoo-community.org/logo.png + :alt: Odoo Community Association + :target: https://odoo-community.org + +OCA, or the Odoo Community Association, is a nonprofit organization whose +mission is to support the collaborative development of Odoo features and +promote its widespread use. + +.. |maintainer-ppyczko| image:: https://github.com/ppyczko.png?size=40px + :target: https://github.com/ppyczko + :alt: ppyczko + +Current `maintainer `__: + +|maintainer-ppyczko| + +This module is part of the `OCA/field-service `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/fieldservice_sale_stock_route_backorder/__init__.py b/fieldservice_sale_stock_route_backorder/__init__.py new file mode 100644 index 0000000000..ea96d42eaa --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/__init__.py @@ -0,0 +1,5 @@ +# Copyright 2025 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import models +from . import wizard diff --git a/fieldservice_sale_stock_route_backorder/__manifest__.py b/fieldservice_sale_stock_route_backorder/__manifest__.py new file mode 100644 index 0000000000..df36326790 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/__manifest__.py @@ -0,0 +1,22 @@ +# Copyright 2025 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Field Service - Sale Stock Route Backorder", + "version": "15.0.1.0.0", + "summary": "Manage backorders for Field Service Orders", + "category": "Field Service", + "website": "https://github.com/OCA/field-service", + "author": "APSL-Nagarro, Odoo Community Association (OCA)", + "maintainers": ["ppyczko"], + "license": "AGPL-3", + "application": False, + "installable": True, + "depends": ["fieldservice_sale_stock_route"], + "data": [ + "security/ir.model.access.csv", + "wizard/fsm_partial_delivery_wizard_form.xml", + "views/fsm_order_view.xml", + "views/product_template.xml", + ], +} diff --git a/fieldservice_sale_stock_route_backorder/i18n/ca.po b/fieldservice_sale_stock_route_backorder/i18n/ca.po new file mode 100644 index 0000000000..b15afb98d5 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/i18n/ca.po @@ -0,0 +1,171 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * fieldservice_sale_stock_route_backorder +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 15.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-06-06 09:46+0000\n" +"PO-Revision-Date: 2025-06-06 09:46+0000\n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: fieldservice_sale_stock_route_backorder +#: code:addons/fieldservice_sale_stock_route_backorder/wizard/fsm_partial_delivery_wizard_form.py:0 +#, python-format +msgid "" +"A new Sale Order %(order_name)s was created for undelivered products." +msgstr "" +"S'ha creat una nova comanda de venda %(order_name)s per als productes no lliurats." + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_order_form_inherit_partial_delivery +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Adjust Delivery" +msgstr "Ajusta el lliurament" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Cancel" +msgstr "Cancel·la" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Confirm" +msgstr "Confirma" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_product_product__create_backorder_sale +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_product_template__create_backorder_sale +msgid "Create Backorder Sale Order" +msgstr "Crea una comanda de venda pendent de lliurament" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_uid +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_uid +msgid "Created by" +msgstr "Creat per" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_date +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_date +msgid "Created on" +msgstr "Creat el" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Delivery Adjustments" +msgstr "Ajustaments de lliurament" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__discount +msgid "Discount (%)" +msgstr "Desc (%)" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__display_name +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__display_name +msgid "Display Name" +msgstr "Nom de visualització" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__fsm_order_id +msgid "FSM Order" +msgstr "Ordre FSM" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_line +msgid "FSM Partial Delivery Line" +msgstr "Línia de lliurament parcial FSM" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_wizard +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__wizard_id +msgid "FSM Partial Delivery Wizard" +msgstr "Assistent de lliurament parcial FSM" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_order +msgid "Field Service Order" +msgstr "Ordre de servei de camp" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__id +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__id +msgid "ID" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,help:fieldservice_sale_stock_route_backorder.field_product_product__create_backorder_sale +#: model:ir.model.fields,help:fieldservice_sale_stock_route_backorder.field_product_template__create_backorder_sale +msgid "" +"If checked, undelivered quantities of this product will generate a new sale " +"order." +msgstr "" +"Si està marcat, les quantitats no lliurades d'aquest producte generaran una " +"nova comanda de venda." + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line____last_update +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard____last_update +msgid "Last Modified on" +msgstr "Última modificació el" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_uid +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_uid +msgid "Last Updated by" +msgstr "Última actualització per" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_date +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_date +msgid "Last Updated on" +msgstr "Última actualització el" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__requested_quantity +msgid "Ordered Quantity" +msgstr "Quantitat demanada" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.actions.act_window,name:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_action +msgid "Partial Delivery" +msgstr "Lliurament parcial" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__product_id +msgid "Product" +msgstr "Producte" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_product_template +msgid "Product Template" +msgstr "Plantilla de producte" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__quantity_done +msgid "Quantity Delivered" +msgstr "Quantitat lliurada" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__sale_line_id +msgid "Sale Order Line" +msgstr "Línia de comanda de venda" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__sale_line_ids +msgid "Sale Order Lines" +msgstr "Línies de comanda de venda" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_order__show_partial_delivery_button +msgid "Show Partial Delivery Button" +msgstr "Mostra el botó de lliurament parcial" diff --git a/fieldservice_sale_stock_route_backorder/i18n/es.po b/fieldservice_sale_stock_route_backorder/i18n/es.po new file mode 100644 index 0000000000..65e98c7dbd --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/i18n/es.po @@ -0,0 +1,172 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * fieldservice_sale_stock_route_backorder +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 15.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-06-06 09:46+0000\n" +"PO-Revision-Date: 2025-06-06 09:46+0000\n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: fieldservice_sale_stock_route_backorder +#: code:addons/fieldservice_sale_stock_route_backorder/wizard/fsm_partial_delivery_wizard_form.py:0 +#, python-format +msgid "" +"A new Sale Order %(order_name)s was created for undelivered products." +msgstr "" +"Se ha creado un nuevo Pedido de Venta %(order_name)s para los productos no " +"entregados." + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_order_form_inherit_partial_delivery +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Adjust Delivery" +msgstr "Ajustar Entrega" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Cancel" +msgstr "Cancelar" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Confirm" +msgstr "Confirmar" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_product_product__create_backorder_sale +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_product_template__create_backorder_sale +msgid "Create Backorder Sale Order" +msgstr "Crear pedido de venta con cantidades pendientes" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_uid +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_uid +msgid "Created by" +msgstr "Creado por" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_date +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_date +msgid "Created on" +msgstr "Creado el" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Delivery Adjustments" +msgstr "Ajustes de Entrega" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__discount +msgid "Discount (%)" +msgstr "Desc (%)" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__display_name +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__display_name +msgid "Display Name" +msgstr "Nombre para mostrar" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__fsm_order_id +msgid "FSM Order" +msgstr "Orden FSM" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_line +msgid "FSM Partial Delivery Line" +msgstr "Línea de Entrega Parcial FSM" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_wizard +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__wizard_id +msgid "FSM Partial Delivery Wizard" +msgstr "Asistente de Entrega Parcial FSM" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_order +msgid "Field Service Order" +msgstr "Orden de Servicio de Campo" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__id +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__id +msgid "ID" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,help:fieldservice_sale_stock_route_backorder.field_product_product__create_backorder_sale +#: model:ir.model.fields,help:fieldservice_sale_stock_route_backorder.field_product_template__create_backorder_sale +msgid "" +"If checked, undelivered quantities of this product will generate a new sale " +"order." +msgstr "" +"Si está marcado, las cantidades no entregadas de este producto generarán un " +"nuevo pedido de venta." + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line____last_update +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard____last_update +msgid "Last Modified on" +msgstr "Última modificación el" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_uid +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_uid +msgid "Last Updated by" +msgstr "Última actualización por" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_date +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_date +msgid "Last Updated on" +msgstr "Última actualización el" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__requested_quantity +msgid "Ordered Quantity" +msgstr "Cantidad solicitada" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.actions.act_window,name:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_action +msgid "Partial Delivery" +msgstr "Entrega parcial" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__product_id +msgid "Product" +msgstr "Producto" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_product_template +msgid "Product Template" +msgstr "Plantilla de producto" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__quantity_done +msgid "Quantity Delivered" +msgstr "Cantidad entregada" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__sale_line_id +msgid "Sale Order Line" +msgstr "Línea de pedido de venta" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__sale_line_ids +msgid "Sale Order Lines" +msgstr "Líneas de pedido de venta" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_order__show_partial_delivery_button +msgid "Show Partial Delivery Button" +msgstr "Mostrar botón de entrega parcial" diff --git a/fieldservice_sale_stock_route_backorder/i18n/fieldservice_sale_stock_route_backorder.pot b/fieldservice_sale_stock_route_backorder/i18n/fieldservice_sale_stock_route_backorder.pot new file mode 100644 index 0000000000..e98a270bc1 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/i18n/fieldservice_sale_stock_route_backorder.pot @@ -0,0 +1,167 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * fieldservice_sale_stock_route_backorder +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 15.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-06-06 09:47+0000\n" +"PO-Revision-Date: 2025-06-06 09:47+0000\n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: fieldservice_sale_stock_route_backorder +#: code:addons/fieldservice_sale_stock_route_backorder/wizard/fsm_partial_delivery_wizard_form.py:0 +#, python-format +msgid "" +"A new Sale Order %(order_name)s was created for undelivered products." +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_order_form_inherit_partial_delivery +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Adjust Delivery" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Cancel" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Confirm" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_product_product__create_backorder_sale +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_product_template__create_backorder_sale +msgid "Create Backorder Sale Order" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_uid +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_uid +msgid "Created by" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__create_date +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__create_date +msgid "Created on" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model_terms:ir.ui.view,arch_db:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_wizard_form +msgid "Delivery Adjustments" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__discount +msgid "Discount (%)" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__display_name +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__display_name +msgid "Display Name" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__fsm_order_id +msgid "FSM Order" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_line +msgid "FSM Partial Delivery Line" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_partial_delivery_wizard +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__wizard_id +msgid "FSM Partial Delivery Wizard" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_fsm_order +msgid "Field Service Order" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__id +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__id +msgid "ID" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,help:fieldservice_sale_stock_route_backorder.field_product_product__create_backorder_sale +#: model:ir.model.fields,help:fieldservice_sale_stock_route_backorder.field_product_template__create_backorder_sale +msgid "" +"If checked, undelivered quantities of this product will generate a new sale " +"order." +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line____last_update +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard____last_update +msgid "Last Modified on" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_uid +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_uid +msgid "Last Updated by" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__write_date +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__write_date +msgid "Last Updated on" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__requested_quantity +msgid "Ordered Quantity" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.actions.act_window,name:fieldservice_sale_stock_route_backorder.fsm_partial_delivery_action +msgid "Partial Delivery" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__product_id +msgid "Product" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model,name:fieldservice_sale_stock_route_backorder.model_product_template +msgid "Product Template" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__quantity_done +msgid "Quantity Delivered" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_line__sale_line_id +msgid "Sale Order Line" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_partial_delivery_wizard__sale_line_ids +msgid "Sale Order Lines" +msgstr "" + +#. module: fieldservice_sale_stock_route_backorder +#: model:ir.model.fields,field_description:fieldservice_sale_stock_route_backorder.field_fsm_order__show_partial_delivery_button +msgid "Show Partial Delivery Button" +msgstr "" diff --git a/fieldservice_sale_stock_route_backorder/models/__init__.py b/fieldservice_sale_stock_route_backorder/models/__init__.py new file mode 100644 index 0000000000..d67213ad89 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/models/__init__.py @@ -0,0 +1,5 @@ +# Copyright 2025 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import fsm_order +from . import product_template diff --git a/fieldservice_sale_stock_route_backorder/models/fsm_order.py b/fieldservice_sale_stock_route_backorder/models/fsm_order.py new file mode 100644 index 0000000000..82d44ae9f1 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/models/fsm_order.py @@ -0,0 +1,20 @@ +# Copyright 2025 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class FSMOrder(models.Model): + _inherit = "fsm.order" + + show_partial_delivery_button = fields.Boolean( + compute="_compute_partial_delivery_button_visibility", store=False + ) + + def _compute_partial_delivery_button_visibility(self): + for order in self: + order.show_partial_delivery_button = order._is_valid_fsm_order( + order + ) and any( + picking.state not in ["done", "cancel"] for picking in order.picking_ids + ) diff --git a/fieldservice_sale_stock_route_backorder/models/product_template.py b/fieldservice_sale_stock_route_backorder/models/product_template.py new file mode 100644 index 0000000000..f02d754380 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/models/product_template.py @@ -0,0 +1,15 @@ +# Copyright 2025 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class ProductTemplate(models.Model): + _inherit = "product.template" + + create_backorder_sale = fields.Boolean( + string="Create Backorder Sale Order", + default=False, + help="If checked, undelivered quantities of this product will " + "generate a new sale order.", + ) diff --git a/fieldservice_sale_stock_route_backorder/readme/CONTRIBUTORS.rst b/fieldservice_sale_stock_route_backorder/readme/CONTRIBUTORS.rst new file mode 100644 index 0000000000..be1e11d043 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/readme/CONTRIBUTORS.rst @@ -0,0 +1,2 @@ + `APSL-Nagarro `_: + * Patryk Pyczko diff --git a/fieldservice_sale_stock_route_backorder/readme/DESCRIPTION.rst b/fieldservice_sale_stock_route_backorder/readme/DESCRIPTION.rst new file mode 100644 index 0000000000..618a044665 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/readme/DESCRIPTION.rst @@ -0,0 +1,14 @@ +This module introduces a new wizard 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. + +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. + +Example Scenario +1. An order requests **70 units** of a product. +2. Initially, only **40 units** are available and reserved, so the system prevents delivering more than 40. +3. Later, additional stock arrives, increasing available inventory to **100 units**. +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. +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. + +Once confirmed, the system validates the picking and creates a backorder sale if any of the initially requested quantities cannot be delivered and the product has the 'create backorder sale' option enabled. This backorder sale will include the remaining quantities that could not be delivered and will be scheduled for the next available route day, allowing for future processing and fulfillment. + +When all quantities have been delivered, the FSM order is marked as completed automatically. diff --git a/fieldservice_sale_stock_route_backorder/readme/USAGE.rst b/fieldservice_sale_stock_route_backorder/readme/USAGE.rst new file mode 100644 index 0000000000..fee8c534fc --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/readme/USAGE.rst @@ -0,0 +1,16 @@ +To use this module, you need to: + +**For this module to work as intended, you need to enable the Auto Validate FSM Pickings setting in Field Service > Configuration > Settings.** + +1. Navigate to Sales > Orders. +2. Create a new sales order. +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). If you want this product to generate a backorder sale whenever it is not fully delivered, ensure the field **Create Backorder Sale Order** is checked on the product form +4. Set the Customer and FSM Location. +5. Make sure the FSM Location has a route set and this route has a person assigned and route days set. +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. +7. Confirm the sale order. +8. Enter the FSM order. A new 'Adjust Delivery' button is available in the header. +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. +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. +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. +12. When all quantities have been delivered, the FSM order will be marked as completed automatically. diff --git a/fieldservice_sale_stock_route_backorder/security/ir.model.access.csv b/fieldservice_sale_stock_route_backorder/security/ir.model.access.csv new file mode 100644 index 0000000000..7ec0e67f46 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/security/ir.model.access.csv @@ -0,0 +1,3 @@ +id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink +access_fsm_partial_delivery_wizard_user,fsm.partial.delivery.wizard.user,model_fsm_partial_delivery_wizard,fieldservice.group_fsm_user_own,1,1,1,1 +access_fsm_partial_delivery_line_user,fsm.partial.delivery.line.user,model_fsm_partial_delivery_line,fieldservice.group_fsm_user_own,1,1,1,1 diff --git a/fieldservice_sale_stock_route_backorder/static/description/icon.png b/fieldservice_sale_stock_route_backorder/static/description/icon.png new file mode 100644 index 0000000000..955674d8f0 Binary files /dev/null and b/fieldservice_sale_stock_route_backorder/static/description/icon.png differ diff --git a/fieldservice_sale_stock_route_backorder/static/description/index.html b/fieldservice_sale_stock_route_backorder/static/description/index.html new file mode 100644 index 0000000000..776c73c280 --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/static/description/index.html @@ -0,0 +1,460 @@ + + + + + +Field Service - Sale Stock Route Backorder + + + +
+

Field Service - Sale Stock Route Backorder

+ + +

Beta License: AGPL-3 OCA/field-service Translate me on Weblate Try me on Runboat

+

This module introduces a new wizard 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.

+

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.

+

Example Scenario +1. An order requests 70 units of a product. +2. Initially, only 40 units are available and reserved, so the system prevents delivering more than 40. +3. Later, additional stock arrives, increasing available inventory to 100 units. +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. +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.

+

Once confirmed, the system validates the picking and creates a backorder sale if any of the initially requested quantities cannot be delivered and the product has the ‘create backorder sale’ option enabled. This backorder sale will include the remaining quantities that could not be delivered and will be scheduled for the next available route day, allowing for future processing and fulfillment.

+

When all quantities have been delivered, the FSM order is marked as completed automatically.

+

Table of contents

+ +
+

Usage

+

To use this module, you need to:

+

For this module to work as intended, you need to enable the Auto Validate FSM Pickings setting in Field Service > Configuration > Settings.

+
    +
  1. Navigate to Sales > Orders.
    2. +
  2. Create a new sales order.
    3. +
  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). If you want this product to generate a backorder sale whenever it is not fully delivered, ensure the field Create Backorder Sale Order is checked on the product form
    4. +
  4. Set the Customer and FSM Location.
    5. +
  5. Make sure the FSM Location has a route set and this route has a person assigned and route days set.
    6. +
  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.
    7. +
  7. Confirm the sale order.
    8. +
  8. Enter the FSM order. A new ‘Adjust Delivery’ button is available in the header.
    9. +
  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.
    10. +
  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.
    11. +
  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.
    12. +
  12. When all quantities have been delivered, the FSM order will be marked as completed automatically.
    13. +
+
+
+

Bug Tracker

+

Bugs are tracked on GitHub Issues. +In case of trouble, please check there if your issue has already been reported. +If you spotted it first, help us to smash it by providing a detailed and welcomed +feedback.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • APSL-Nagarro
    • +
+
+
+

Contributors

+
+
+
APSL-Nagarro:
+
+
+
+
+
+
+

Maintainers

+

This module is maintained by the OCA.

+ +Odoo Community Association + +

OCA, or the Odoo Community Association, is a nonprofit organization whose +mission is to support the collaborative development of Odoo features and +promote its widespread use.

+

Current maintainer:

+

ppyczko

+

This module is part of the OCA/field-service project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+ + diff --git a/fieldservice_sale_stock_route_backorder/tests/__init__.py b/fieldservice_sale_stock_route_backorder/tests/__init__.py new file mode 100644 index 0000000000..5b756e722e --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/tests/__init__.py @@ -0,0 +1,4 @@ +# Copyright 2025 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import test_partial_delivery_wizard diff --git a/fieldservice_sale_stock_route_backorder/tests/test_partial_delivery_wizard.py b/fieldservice_sale_stock_route_backorder/tests/test_partial_delivery_wizard.py new file mode 100644 index 0000000000..5257df76aa --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/tests/test_partial_delivery_wizard.py @@ -0,0 +1,270 @@ +from odoo import fields +from odoo.exceptions import UserError +from odoo.tests.common import TransactionCase + + +class TestFSMPartialDeliveryWizard(TransactionCase): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.SaleOrder = cls.env["sale.order"] + cls.FSMPartialDeliveryWizard = cls.env["fsm.partial.delivery.wizard"] + + cls.partner = cls.env.ref("fieldservice.test_loc_partner") + cls.product = cls.env.ref("product.product_order_01") + cls.product.write({"field_service_tracking": "sale"}) + + cls.fsm_route_day = cls.env.ref("fieldservice_route.fsm_route_day_0") + cls.fsm_person = cls.env.ref("fieldservice.test_person") + cls.route = cls.env["fsm.route"].create( + { + "name": "Test Route", + "fsm_person_id": cls.fsm_person.id, + "day_ids": [(6, 0, [cls.fsm_route_day.id])], + "max_order": 1000, + } + ) + + cls.fsm_location = cls.env.ref("fieldservice.test_location") + cls.fsm_location.write({"fsm_route_id": cls.route.id}) + + cls.sale_order = cls.SaleOrder.create( + { + "partner_id": cls.partner.id, + "fsm_location_id": cls.fsm_location.id, + "order_line": [ + (0, 0, {"product_id": cls.product.id, "product_uom_qty": 70}) + ], + "state": "draft", + } + ) + cls.sale_order.action_confirm() + cls.fsm_order = cls.sale_order.fsm_order_ids + cls.picking = cls.fsm_order.picking_ids + + cls.env["stock.quant"].create( + { + "product_id": cls.product.id, + "location_id": cls.picking.location_id.id, + "quantity": 50.0, + } + ) + + cls.env["ir.config_parameter"].set_param( + "fieldservice_stock.auto_validate_pickings", True + ) + + def _is_isp_account_installed(self): + module = self.env["ir.module.module"].search( + [("name", "=", "fieldservice_isp_account")] + ) + return bool(module and module.state == "installed") + + def _add_timesheet_to_order(self, order): + analytic_account = self.env["account.analytic.account"].create( + {"name": "Test Analytic Account"} + ) + self.fsm_location.analytic_account_id = analytic_account.id + analytic_product = self.env["product.product"].search( + [("type", "=", "service")], limit=1 + ) + timesheet = self.env["account.analytic.line"].create( + { + "name": "timesheet_line", + "unit_amount": 1, + "account_id": analytic_account.id, + "user_id": self.env.ref("base.partner_admin").id, + "product_id": analytic_product.id, + } + ) + order.write( + { + "employee_timesheet_ids": [(6, 0, timesheet.ids)], + } + ) + return order + + def complete_fsm_order(self, fsm_order): + if self._is_isp_account_installed(): + self._add_timesheet_to_order(fsm_order) + fsm_order.write( + {"date_end": fields.Datetime.now(), "resolution": "Test Resolution"} + ) + + def test_wizard_initialization(self): + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=self.fsm_order.id + ).create({}) + self.assertEqual(wizard.fsm_order_id, self.fsm_order) + self.assertEqual(len(wizard.sale_line_ids), 1) + self.assertEqual(wizard.sale_line_ids[0].product_id, self.product) + self.assertEqual(wizard.sale_line_ids[0].requested_quantity, 70) + self.assertEqual(wizard.sale_line_ids[0].quantity_done, 0) + + def test_prevent_over_delivery(self): + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=self.fsm_order.id + ).create({}) + wizard.sale_line_ids[0].quantity_done = 100.0 + with self.assertRaises(UserError): + wizard.action_confirm_partial_delivery() + + def test_allow_over_delivery_with_sufficient_stock(self): + self.env["ir.config_parameter"].set_param( + "fieldservice_stock.auto_validate_pickings", True + ) + self.env["stock.quant"].create( + { + "product_id": self.product.id, + "location_id": self.picking.location_id.id, + "quantity": 100.0, + } + ) + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=self.fsm_order.id + ).create({}) + wizard.sale_line_ids[0].quantity_done = 75.0 + + self.complete_fsm_order(self.fsm_order) + wizard.action_confirm_partial_delivery() + + self.sale_order.order_line.refresh() + sale_line = self.sale_order.order_line.filtered( + lambda l: l.product_id == self.product + ) + self.assertEqual(sale_line.qty_delivered, 75.0) + self.assertEqual( + self.fsm_order.stage_id.id, + self.env.ref("fieldservice.fsm_stage_completed").id, + ) + + def test_allow_over_delivery_for_consumables(self): + self.env["ir.config_parameter"].set_param( + "fieldservice_stock.auto_validate_pickings", True + ) + + consumable = self.env["product.product"].create( + { + "name": "Test Consumable Product", + "detailed_type": "consu", + "field_service_tracking": "sale", + } + ) + + sale_order = self.SaleOrder.create( + { + "partner_id": self.partner.id, + "fsm_location_id": self.fsm_location.id, + "order_line": [ + (0, 0, {"product_id": consumable.id, "product_uom_qty": 70}) + ], + "state": "draft", + } + ) + sale_order.action_confirm() + fsm_order = sale_order.fsm_order_ids + + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=fsm_order.id + ).create({}) + wizard.sale_line_ids[0].quantity_done = 100.0 + + self.complete_fsm_order(fsm_order) + wizard.action_confirm_partial_delivery() + + sale_line = sale_order.order_line.filtered(lambda l: l.product_id == consumable) + self.assertEqual(sale_line.qty_delivered, 100.0) + self.assertEqual( + fsm_order.stage_id.id, self.env.ref("fieldservice.fsm_stage_completed").id + ) + + def test_create_backorder_sale_for_undelivered_qty(self): + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=self.fsm_order.id + ).create({}) + wizard.sale_line_ids[0].quantity_done = 20.0 + + self.complete_fsm_order(self.fsm_order) + self.product.write({"create_backorder_sale": True}) + wizard.action_confirm_partial_delivery() + + sale_line = self.sale_order.order_line.filtered( + lambda l: l.product_id == self.product + ) + self.assertEqual(sale_line.qty_delivered, 20.0) + + new_sales = self.env["sale.order"].search( + [("origin", "=", self.sale_order.name), ("id", "!=", self.sale_order.id)] + ) + self.assertTrue(new_sales) + + new_sale = new_sales[0] + new_line = new_sale.order_line.filtered(lambda l: l.product_id == self.product) + self.assertTrue(new_line) + self.assertEqual(new_line.product_uom_qty, 50.0) + + def test_full_delivery(self): + self.env["stock.quant"].create( + { + "product_id": self.product.id, + "location_id": self.picking.location_id.id, + "quantity": 100.0, + } + ) + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=self.fsm_order.id + ).create({}) + wizard.sale_line_ids[0].quantity_done = 70.0 + + self.complete_fsm_order(self.fsm_order) + wizard.action_confirm_partial_delivery() + + sale_line = self.sale_order.order_line.filtered( + lambda l: l.product_id == self.product + ) + self.assertEqual(sale_line.qty_delivered, 70.0) + self.assertEqual( + self.fsm_order.stage_id.id, + self.env.ref("fieldservice.fsm_stage_completed").id, + ) + + def test_deliver_new_product(self): + new_product = self.env["product.product"].create( + { + "name": "New Product", + "detailed_type": "product", + "field_service_tracking": "sale", + } + ) + self.env["stock.quant"].create( + { + "product_id": new_product.id, + "location_id": self.picking.location_id.id, + "quantity": 100.0, + } + ) + wizard = self.FSMPartialDeliveryWizard.with_context( + active_id=self.fsm_order.id + ).create({}) + + self.env["fsm.partial.delivery.line"].create( + { + "wizard_id": wizard.id, + "product_id": new_product.id, + "requested_quantity": 0.0, + "quantity_done": 5.0, + } + ) + + self.complete_fsm_order(self.fsm_order) + wizard.action_confirm_partial_delivery() + + sale_line = self.sale_order.order_line.filtered( + lambda l: l.product_id == new_product + ) + self.assertTrue(sale_line) + self.assertEqual(sale_line.product_uom_qty, 5.0) + self.assertEqual( + self.fsm_order.stage_id.id, + self.env.ref("fieldservice.fsm_stage_completed").id, + ) diff --git a/fieldservice_sale_stock_route_backorder/views/fsm_order_view.xml b/fieldservice_sale_stock_route_backorder/views/fsm_order_view.xml new file mode 100644 index 0000000000..6ac8f4d2cf --- /dev/null +++ b/fieldservice_sale_stock_route_backorder/views/fsm_order_view.xml @@ -0,0 +1,33 @@ + + + + + + Partial Delivery + fsm.partial.delivery.wizard + form + + new + + + + fsm.order.form.inherit.partial.delivery + fsm.order + + + + +