[IMP] point_of_sale: add Cashdro cash machine docs

This commit adds documentation on how to configure a Cashdro cash
machine in the POS. There are now two cash machines supported, Glory and
Cashdro.

task-5355208

Author: MaxTheWhale

content/applications/sales/point_of_sale/payment_methods/cash_machines.rst

@@ -13,7 +13,7 @@ Configuration
 =============
 
 Configure the cash machine itself before setting it up in Odoo. Currently, Odoo supports :doc:`Glory
-<cash_machines/glory>` cash machines. Once the cash machine is fully set up:
+<cash_machines/glory>` and :doc:`Cashdro<cash_machines/cashdro>` cash machines. Once the cash machine is fully set up:
 
 #. Create the associated :doc:`payment method <../payment_methods>`.
 #. Select the POS in the :guilabel:`Point of Sale` field.
@@ -37,3 +37,4 @@ Once the transaction is successful, the payment is automatically validated in Po
    :titlesonly:
 
    cash_machines/glory
+   cash_machines/cashdro

content/applications/sales/point_of_sale/payment_methods/cash_machines/cashdro.rst

@@ -0,0 +1,61 @@
+=======
+Cashdro
+=======
+
+**Cashdro** :doc:`cash machines <../cash_machines>` enable the automation of cash transactions.
+
+.. note::
+   - The integration with the Cashdro cash machine only supports payments and refunds.
+   - Tasks like filling and emptying the machine must be performed directly through the cash machine
+     interface.
+
+.. _pos/cashdro/configuration:
+
+Cash machine configuration
+==========================
+
+.. note::
+   - Setting up the Cashdro machine requires the Cashdro hardware administrator password and technical knowledge.
+     If needed, consult the Cashdro integration partner for configuration support.
+
+   - The IP address should be static to ensure long-term stable operation.
+
+To configure the Cash Machine as a :ref:`payment method in Odoo <pos/cashdro/payment_method>`, we must know its IP address. In addition, in order
+to use :doc:`Local Network Access (LNA) <../../hardware_network/pos_lna>`, we must enable HTTP on the cash machine.
+
+#. Find the IP address of the Cashdro machine.
+
+   To locate the Cashdro machine's IP address, remove one of the devices inside the machine
+   (for example the bill device on the left, which can be easily unlatched from the bottom and slid out).
+   This action displays a diagnostics screen with the IP address. Keep the IP address for the :ref:`payment method process
+   <pos/cashdro/payment_method>` and make sure to reconnect the device.
+
+#. To enable the HTTP setting on the Cashdro machine, follow the next steps:
+
+   #. Navigate to the login screen at `https://<cashdro-ip>/Cashdro3Web/#/login`.
+   #. Login as the support user.
+   #. Navigate to :menuselection:`Configuration --> General parameters`.
+   #. In the :guilabel:`Web Integration` section, ensure :guilabel:`Enable HTTP` is checked.
+   #. Restart the machine.
+
+.. _pos/cashdro/payment_method:
+
+Payment method
+==============
+
+#. :ref:`Install <general/install>` the POS Cashdro module.
+#. :doc:`Associate a cash payment method <../../payment_methods>`:
+
+   #. Go to :menuselection:`Point of Sale --> Configuration --> Payment Methods`. Create a new :guilabel:`Cash` payment method or update an existing payment method.
+   #. Select the associated POS in the :guilabel:`Point of Sale` field.
+   #. Set the :guilabel:`Integration` field to :guilabel:`Cash Machine (Cashdro)`.
+   #. Type the Cashdro machine's IP address in the :guilabel:`Cashdro IP` field under the :guilabel:`Cashdro Settings` tab.
+   #. Type your Cashdro user credentials in the :guilabel:`Cashdro Username` and :guilabel:`Cashdro Password` fields.
+   #. Enable the :guilabel:`Cashdro Local Network Access` checkbox.
+
+.. note::
+   - It is highly recommended to use the :doc:`Local Network Access <../../hardware_network/pos_lna>` setting,
+     as it bypasses the need for an :doc:`SSL certificate <../../hardware_network/epos_ssc>`.
+
+.. seealso::
+   :doc:`../../payment_methods`