Metadata-Version: 2.1
Name: odoo-addon-fieldservice_availability
Version: 19.0.1.0.0.4
Requires-Dist: odoo-addon-fieldservice_route==19.0.*
Requires-Dist: odoo==19.0.*
Summary: Provides models for defining blackout days, stress days, and delivery time ranges for FSM availability management.
Home-page: https://github.com/OCA/field-service
License: AGPL-3
Author: APSL-Nagarro, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=========================
Fieldservice Availability
=========================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:522bb3907293b2b412cfc9067bea9500c319fbc3412300d6d64ca35cc1470ba0
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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/19.0/fieldservice_availability
    :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-19-0/field-service-19-0-fieldservice_availability
    :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=19.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module defines blackout days (non-operational days), stress days
(high-demand periods), and delivery time ranges for field service
operations. It provides the necessary models to store this information,
which can be used by other modules to manage scheduling, availability,
and workload adjustments.

- **Blackout Days (\`fsm.blackout.day\`)**: Represent dates when field
  service operations are unavailable (e.g., holidays, company-wide
  closures).
- **Blackout Groups (\`fsm.blackout.group\`)**: Represent groups of days
  when field service operations are unavailable (e.g., holidays,
  company-wide closures).
- **Stress Days (\`fsm.stress.day\`)**: Indicate dates with increased
  service demand (e.g., peak business periods requiring additional
  workforce).
- **Delivery Time Ranges (\`fsm.delivery.time.range\`)**: Define
  available time slots for scheduling field service operations.
- **Restricts blackout days for Scheduled Start (ETA) orders with the
  same date**

This module validates Scheduled Start (ETA) dates on field service
orders against blackout days configured on their route. Orders with an
ETA that falls on a matching blackout day cannot be saved.

**Table of contents**

.. contents::
   :local:

Usage
=====

Navigate to Field Service > Configuration > Availability. Once there,
you can select Delivery Time Ranges, Blackout Days, Blackout Groups or
Stress Days to create new records.

Steps to restrict blackout days for Scheduled Start (ETA) orders with
the same date

1. Set up Blackout Days on Configuration > Blackout Groups and create or
   edit one with blackout days
2. Go to Field Service > Master Data > Routes > Create or edit route and
   assign Blackout Group Days and a Person
3. Create a Field Service order and set up Scheduled Start (ETA) with
   date that you put on blackout days and the Odoo will throw an error

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/field-service/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 <https://github.com/OCA/field-service/issues/new?body=module:%20fieldservice_availability%0Aversion:%2019.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

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

Credits
=======

Authors
-------

* APSL-Nagarro

Contributors
------------

- `APSL-Nagarro <https://www.apsl.tech>`__:

  - Patryk Pyczko <ppyczko@apsl.net>
  - Antoni Marroig <amarroig@apsl.net>
  - Bernat Obrador <bobrador@apsl.net>

- `CIT-Services <https://cit-services.in/>`__:

  - Linto Antony <l.antony@cit-services.eu>

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 <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-ppyczko| 

This module is part of the `OCA/field-service <https://github.com/OCA/field-service/tree/19.0/fieldservice_availability>`_ project on GitHub.

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