documentation/iot/devices/printer.rst
Lau-Odoo e33715fb81
[ADD] iot: new docs about connecting devices (#449)
[ADD] iot: new docs about connecting devices
2019-10-18 09:54:44 +02:00

138 lines
4.0 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

=================
Connect a Printer
=================
When using your *IoT Box* in Odoo, you could need to use a printer.
Doing so is easy and convenient as it can be done in a few steps. Then,
you can use it to print receipts, orders or even reports in different
Odoo apps.
Connection
==========
To connect the printer to the *IoT Box*, you just have to combine the
two by cable.
.. note::
Sometimes, a serial to USB adapter may be needed.
If your printer is a `supported
one <https://www.odoo.com/page/iot-hardware>`__, there is no need to set up anything
because it will be automatically detected as soon as it is connected.
.. note::
The printer can take up to two minutes to appear in your devices list.
.. image:: media/printer_01.png
:align: center
In some cases, you may need to restart the box and download your
printers drivers from the box. To do so, go to the *IoT Box Home
Page* and click on *drivers list*. Then, click on load drivers.
.. image:: media/printer_02.png
:align: center
Link the Printer
================
To Work Orders
--------------
You can link *Work Orders* to printers via a *Quality Control Point*
to print labels for manufactured products.
To do so, you need to create a *Quality Control Point* from the
*Quality* app. Then, you can select the correct manufacturing
operation and the work order operation. In type, choose *Print Label*
and hit save.
.. image:: media/printer_03.png
:align: center
Now, each time you reach the quality control point for the chosen
product, a *Print Label* button will appear.
.. image:: media/printer_04.png
:align: center
To Reports
----------
You can also link a type of report to a certain printer. In the *IoT*
app, go to the *Devices* menu and select the printer you want to set
up.
.. image:: media/printer_05.png
:align: center
Now, go to the *Printer Reports* tab.
.. image:: media/printer_06.png
:align: center
Hit edit and then, click on *Add a line*. In the window that shows up,
check all the types of reports that should be linked to this printer.
Click on select and save.
.. image:: media/printer_07.png
:align: center
Now, each time you click on *Print* in the control panel, instead of
downloading a PDF, it will send it to the selected printer and
automatically print it.
Print Receipts from the PoS
---------------------------
You can link a printer to your *Point of Sale* app so you can print
receipts directly from your *PoS*.
Doing so is really easy. Go to your *Point of Sale* app and open your
*PoS* settings, under *Configuration*. There, click on *Edit* and
check the *IoT Box* feature. Then, enable the *Receipt Printer*.
.. image:: media/printer_08.png
:align: center
Now, on your *PoS* view, you will be able to print different kinds of
tickets: **receipts**, **sale details** and **bills**.
For the receipt, it will be printed once the order is validated. The
process is automated when you enable the feature in your *PoS*.
Sales details can be printed by clicking on the printer icon on the
navbar at the top of the *PoS*. It will print the details of the sales
of the current day.
.. image:: media/printer_09.png
:align: center
As for the bill, it is only available in restaurant mode. In your
restaurant settings, activate bills and a *Bill* button will appear in
the left panel. Click on it and it will print the bill.
.. image:: media/printer_10.png
:align: center
Print Orders in the kitchen
---------------------------
In restaurant mode, you can send order tickets to the kitchen.
To do so, go to the *PoS* app and open your *PoS* settings. Then,
tick *Order Printer*.
.. image:: media/printer_11.png
:align: center
Now, go to the *Printers* menu. Hit create and select the *IoT Box*
with all the categories of product that should be printed in the
*Printer Product Categories* field.
.. image:: media/printer_12.png
:align: center
In the *PoS*, when you add or remove a product from one of the
selected categories, the button *Order* will be green. If you click on
it, a ticket will be printed.