You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

90 lines
4.0 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. ====================
  5. POS Customer Display
  6. ====================
  7. This module adds support for Customer Display in the Point of Sale. As incredible as it may seem, the Odoo POS doesn't have native support for a customer display, even on Odoo 10. So, if the customer cannot see the screen of the cashier, he will not be able to check the price of each product scanned by the cashier, he won't be able to see the total amount, etc. This module provides a solution to this problem by adding support for good old POS LCDs, which are often made of 2 lines of 20 caracters.
  8. This module is designed to be installed on the *main Odoo server*. On the
  9. *POSbox*, you should install the module *hw_customer_display*. But you will certainly prefer to use `pywebdriver <https://github.com/akretion/pywebdriver>`__ instead of the POSbox. Compared to the POSbox, Pywebdriver has several advantages:
  10. * smaller footprint: no need to have a full-blown Odoo with PostgreSQL on the computer of the cashier (or his small Linux-based PC connected to the hardware, like the RaspberryPi for the POSbox),
  11. * availability of an Ubuntu package, for easier deployment,
  12. * native support for the customer display, payment terminal, etc.
  13. * nice test/diagnosis Web interface.
  14. It has been tested with a Bixolon BCD-1100
  15. (http://www.bixolon.com/html/en/product/product_detail.xhtml?prod_id=61),
  16. but should support most serial and USB-serial LCD displays
  17. out-of-the-box or with minor adaptations in the source code:
  18. * of the module *hw_customer_display* if you use the POSbox,
  19. * or of the Python lib `pyposdisplay <https://github.com/akretion/pyposdisplay>`__ if you use `pywebdriver <https://github.com/akretion/pywebdriver>`__.
  20. This module has been developped during a POS code sprint at
  21. `Akretion France <http://www.akretion.com/>`_ from July 7th to July 10th 2014.
  22. Configuration
  23. =============
  24. To configure this module, go to the menu *Point of Sale > Configuration > Point
  25. of Sale* and edit the point of sale for which you want to enable the LCD:
  26. * make sure you have configured the *IP address* and port of the POSbox or pywebdriver in the section *Hardware Proxy / PosBox*,
  27. * activate the option *Customer Display*,
  28. * configure the number of caracters on each line of your LCD (20 by default).
  29. At the end of the page, in the *Customer Display* section, you can customize the *Next customer* message and the *POS closed* message.
  30. Usage
  31. =====
  32. Once everything is configured, just start the POS as usual. You will see messages on the LCD when:
  33. * you start the POS,
  34. * you add or remove a product,
  35. * you press the Payment button: the LCD will display the total amount,
  36. * you enter the amount of cash you receive: the LCD will display the amount of the change to give back,
  37. * you validate an order and go to the next customer,
  38. * you close the POS.
  39. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  40. :alt: Try me on Runbot
  41. :target: https://runbot.odoo-community.org/runbot/184/10.0
  42. Bug Tracker
  43. ===========
  44. Bugs are tracked on `GitHub Issues
  45. <https://github.com/OCA/pos/issues>`_. In case of trouble, please
  46. check there if your issue has already been reported. If you spotted it first,
  47. help us smashing it by providing a detailed and welcomed feedback.
  48. Credits
  49. =======
  50. Contributors
  51. ------------
  52. * Aurélien Dumaine
  53. * Alexis de Lattre <alexis.delattre@akretion.com>
  54. * Father Odilon (`Barroux Abbey <http://www.barroux.org/>`_)
  55. * Daniel Kraft
  56. Maintainer
  57. ----------
  58. .. image:: https://odoo-community.org/logo.png
  59. :alt: Odoo Community Association
  60. :target: https://odoo-community.org
  61. This module is maintained by the OCA.
  62. OCA, or the Odoo Community Association, is a nonprofit organization whose
  63. mission is to support the collaborative development of Odoo features and
  64. promote its widespread use.
  65. To contribute to this module, please visit https://odoo-community.org.