Skip to content

[FW][IMP] pos: basic and advanced rights for employees #13000

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: saas-18.1
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions content/applications/sales/point_of_sale.rst
Original file line number Diff line number Diff line change
Expand Up @@ -175,6 +175,36 @@ the **POS dashboard**.
- To look at all your previous sessions, go to :menuselection:`Point of Sale --> Orders -->
Sessions`.

.. _pos/analytics:

Analytics
=========

Once you :ref:`close and post the POS session <pos/session-close>`, access the comprehensive report
to review all session activities, including who initiated the session and who handled specific
orders. To access the session's report:

#. Click :icon:`fa-ellipsis-v` (:guilabel:`vertical ellipsis`) on the POS card.
#. Click :guilabel:`Sessions` under the :guilabel:`View` section.
#. From that list view, you can see all the sessions and who initiated them under the
:guilabel:`Opened By` column.
#. Select a POS session to open a detailed session report.
#. Click the :guilabel:`Orders` smart button to display a list of all orders placed during that
session.
#. From that view, you can retrieve the following information:

- The :guilabel:`Order Ref`
- The :guilabel:`Date` of the order.
- The :guilabel:`Point of Sale` where that order was made.
- The :guilabel:`Receipt Number`.
- The :guilabel:`Customer`.
- The :guilabel:`Employee` that placed this order.
- The :guilabel:`Total` paid amount.
- The order :guilabel:`Status`.

To get an overview of all orders, regardless of the session, click the vertical ellipsis button
(:guilabel:`⋮`) on the POS card and select :guilabel:`Orders` from the :guilabel:`View` section.

.. toctree::
:titlesonly:

Expand Down
147 changes: 99 additions & 48 deletions content/applications/sales/point_of_sale/employee_login.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,74 +2,125 @@
Multi-employee management
=========================

Odoo Point of Sale allows you to manage access to a specific POS by enabling the **Multi Employees
per Session** feature. When activated, :ref:`you can select which users can log into the POS
<employee_login/use>` and :ref:`keep track of the employees involved in each order
<employee_login/analytics>`.
Odoo Point of Sale (POS) offers a **Multi Employees per Session** feature, allowing multiple users
to :ref:`log into a POS session <pos/employee_login/use>`. Activating this feature enables the
following actions:

.. _employee_login/configuration:
- Select specific users who can :ref:`log into the POS <pos/employee_login/use>`.
- :ref:`Assign basic or advanced permissions <pos/employee_login/configuration>` to these users.
- :ref:`Track the employees involved in each order for enhanced analytics <pos/analytics>`.

.. _pos/employee_login/configuration:

Configuration
=============

:ref:`Access the POS settings <configuration/settings>` and select your POS, or click the vertical
ellipsis button (:guilabel:`⋮`) on a POS card and click :guilabel:`Edit`. Then, enable
:guilabel:`Multi Employees per Session`, and add the allowed employees in the :guilabel:`Allowed
Employees` field.
Access the multi-employee setting from the :guilabel:`PoS Interface` section of the :ref:`POS
settings <configuration/settings>`. Then,

#. Activate the :guilabel:`Multi Employees per Session` feature.
#. Add the employees with **basic POS functionality** access in the :guilabel:`Basic rights` field.
#. Add the employees with **extended POS functionalities** in the :guilabel:`Advanced rights` field.

.. image:: employee_login/setting.png
.. image:: employee_login/activate-setting.png
:alt: setting to enable multiple cashiers in POS

.. _employee_login/use:
.. note::
- Leaving the :guilabel:`Basic rights` field empty allows all employees to log in.
- Leaving the :guilabel:`Advanced rights` field empty grants extended rights to Odoo users only.

.. tip::
Click the :icon:`fa-ellipsis-v` (:guilabel:`vertical ellipsis`) button on the top right corner of
a POS card and :guilabel:`Edit` to access the setting from the main POS dashboard.

.. seealso::
:doc:`../../general/users/access_rights`

.. tabs::
.. tab:: Basic rights

Employees with basic rights can perform the following actions within the POS:

**Session management:**

- :ref:`Open a POS session <pos/session-start>`.
- Lock the current POS session.
- Toggle the visibility of product and category images.

**Sales transactions:**

- :ref:`Process standard sales transactions <pos/sell>`.
- :ref:`Process refunds <pos/refund>`.
- :doc:`Access and handle sales orders <shop/sales_order>`.
- :ref:`Set customers <pos/customers>`.
- Access past and current order history.

**Pricing and discounts:**

- Manually select another :doc:`pricelist <pricing/pricelists>`.
- Enter promotional codes.
- :doc:`Manually apply discounts <pricing/discounts>`.
- Manually :ref:`change a product's price <pos/sell>`.

.. tab:: Advanced rights

In addition to the basic rights, employees with advanced rights can also:

- :ref:`Perform cash-in and cash-out operations <pos/cash-register>`.
- Access the Odoo backend interface.
- :ref:`Close the current POS session <pos/session-close>`.

.. _pos/employee_login/use:

Practical application
=====================
Usage guidelines
================

Once the feature is activated, cashiers can log in :ref:`by scanning their badge
<employee_login/badge>` or selecting their name from the list of allowed employees to :ref:`open the
session <pos/session-start>`.
Logging in
----------

.. image:: employee_login/open-session.png
:alt: window to open a session when the multiple cashiers feature is enabled
Once the **Multi Employees per Session** feature is enabled, employees must log in to :ref:`open a
POS session <pos/session-start>` and access the POS interface. They can :ref:`scan their employee
badge <pos/employee_login/badge>` or click :guilabel:`Select Cashier` to select their name from the
list of authorized users.

To switch to another user :ref:`from an open session <pos/session-start>`, click the employee name
at the top-right of the screen and select the employee to swap with from the list.
.. image:: employee_login/log-in.png
:alt: Login window to open a session when the multiple cashiers feature is active

.. image:: employee_login/switch-user.png
:alt: button to switch from one cashier to another.
To switch between users during an :ref:`active session <pos/session-start>`, click on the currently
logged-in employee's name at the top right of the POS screen and select the user to switch to.

You can also require your employees to enter a pin code every time they log into a POS to prevent
them from logging in as someone else. To define the code, go to the **Employees** app, open the
employee form, and click the :guilabel:`HR settings` tab. Then, enter a pin code of your choice in
the :guilabel:`PIN Code` field of the :guilabel:`Attendance/Point of Sale` category.
.. _pos/employee_login/badge:

.. image:: employee_login/pin-and-badgeid.png
:alt: setting on the employee form to assign a badge ID and a PIN code.
Logging in with badges
----------------------

.. _employee_login/badge:
Employees can log in using their badge. To configure badge-based login, assign a unique badge ID to
the employee's profile in the **Employees** module:

Log in using badges
-------------------
#. Navigate to the **Employees** module.
#. Open the form view of the specific employee.
#. Go to the :guilabel:`HR Settings` tab.
#. The :guilabel:`Attendance/Point of Sale` category offers two options:

For your employees to be able to log in by scanning their badge, they must have a badge ID assigned.
To do so, go to the **Employees** app, open the employee form, and click the :guilabel:`HR settings`
tab. Then, enter the badge ID of your choice in the :guilabel:`Badge ID` field of the
:guilabel:`Attendance/Point of Sale` category or click :guilabel:`Generate`.
- Manually enter any badge ID in the :guilabel:`Badge ID` field.
- Click :guilabel:`Generate` to create a unique badge ID automatically.
#. Click :guilabel:`Print Badge` to generate a barcode representation of the assigned badge ID.

To switch to another user, lock the session by clicking the lock-shaped icon (:guilabel:`🔓`) at the
top-right of the screen and scan your badge.
To switch users within an open POS session using a badge, you must first lock the session. To do so,
click the :icon:`fa-bars` icon (:guilabel:`hamburger menu`) and :guilabel:`Lock` to return to the
login screen. Then, the new employee can scan their badge to log in.

.. _employee_login/analytics:
Adding a PIN Code
-----------------

Analytics
=========
For enhanced security, employees may be forced to enter a PIN code each time they log into a POS
session. To set up a PIN code for an employee:

Once you close and post the POS session, access the comprehensive report to review all session
activities, including who initiated the session and who handled specific orders. To access the
session's report, click the vertical ellipsis button (:guilabel:`⋮`) on the POS card and select
:guilabel:`Sessions` from the :guilabel:`View` section. Then, select a specific session for more
detailed information, and click the :guilabel:`Orders` button to view a list of all orders placed
during that session.
#. Navigate to the **Employees** module.
#. Open the form view of the relevant employee.
#. Go to the :guilabel:`HR Settings` tab.
#. Enter a desired numerical code in the :guilabel:`PIN Code` field of the
:guilabel:`Attendance/Point of Sale` category.

To get an overview of all orders, regardless of the session, click the vertical ellipsis button
(:guilabel:`⋮`) on the POS card and select :guilabel:`Orders` from the :guilabel:`View` section.
.. note::
The PIN code must consist of a sequence of digits only.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
4 changes: 2 additions & 2 deletions content/applications/sales/point_of_sale/shop/barcode.rst
Original file line number Diff line number Diff line change
Expand Up @@ -58,5 +58,5 @@ Log employees
-------------

You can also use a barcode scanner to log your employees. To do so, :ref:`restrict access
<employee_login/configuration>` to the POS and :ref:`use barcodes to log your employees in
<employee_login/badge>` your POS.
<pos/employee_login/configuration>` to the POS and :ref:`use barcodes to log your employees in
<pos/employee_login/badge>` your POS.