Odoo POS Driver

此工具旨在与Odoo销售点应用程序一起使用。它替代了Odoo IoT Box 或社区 pywebdriver 库。

一旦在收银员电脑上本地安装，工具将发现设备，一旦插入，就可以通过Odoo销售点模块进行通信。

目录

1. 运行
2. 用法
3. 安装
4. 相关Odoo模块
5. 兼容设备
6. 如何贡献
7. 开发
8. 路线图和已知问题
9. 致谢

运行

odoo-tools-grap\
  --address 0.0.0.0\
  --port 8069\
  --secure\
  --refresh-devices-delay 1\
  --log-level INFO\
  --log-folder false\
  --options EXTRA_OPTIONS

（上显示的值是默认值。

• -a / --address：web服务可用的地址

• -p / --port：web服务可用的端口

• --secure/--unsecure：通过https（或http，如果选择--unsecure）公开webservice。

• -r / --refresh-devices-delay：两次检查连接到USB端口的设备之间的秒间隔。

• -l / --log-level: 可选值: TRACE / DEBUG / INFO / SUCCESS / WARNING / ERROR / CRITICAL。注意

  • TRACE 将记录所有的 HTTP 请求。
  • DEBUG 将记录所有接收到的数据，包括打印机设备接收到的图像。
  • 在生产环境中，在没有调试情况下，请使用 INFO 级别或更高。

• -f / --log-folder: 可选的目录，其中包含日志。如果定义，则必须存在且可写。

• --options: 传递给设备的 JSON 格式数据。例如：'{"scale": {"polynomial": 123456}}' 将将多项式值传递给秤设备。注意：不要忘记在字典的开始和结束处添加简单的引号。

用法

访问工具的主页，通过 https://:8069。

如果您选择 https 部署，您应该在浏览器中接受第一次安全异常。

提供了测试连接、查看错误等的页面。

安装

安装（手动运行）

• 安装最新发布的版本

pipx install odoo-pos-driver

• 或 安装最新版本

pipx install git+https://gitlab.com/grap-rhone-alpes/odoo-pos-driver.git

注意：如果您的默认 Python 环境低于 Python 3.9 版本，请使用 --python python3.9（或更高）选项。

安装（作为服务）

这将创建一个服务（通过 systemd），在后台执行 odoo-pos-driver 并在启动时启动。

wget https://gitlab.com/grap-rhone-alpes/odoo-pos-driver/-/raw/main/install_debian.sh
# (OPTIONAL) adapt the installation script before execution
# adding specific argument in the call of odoo-pos-driver in the .service file
sudo sh install_debian.sh

安装完成后，您可以运行以下系统命令。

# Get status of the service
sudo systemctl status odoo-pos-driver.service

# Follow the logs of the service
sudo journalctl -fu odoo-pos-driver.service

相关Odoo模块

根据版本，库与 Odoo 模块的兼容性。

V16

• 打印机（+ 现金箱）：point_of_sale（Odoo CE）

• 显示：pos_odoo_driver_display

• 支付：pos_odoo_driver_payment

• 秤：point_of_sale（Odoo CE）

兼容设备

打印机
Epson - TM-T20II Epson - TM-T20III
显示
Aures - OCD 300
支付终端
Ingenico - Move/5000
秤
Mettler Toledo - Ariva S

如何贡献

欢迎贡献

• 如果项目未翻译成您的语言，您可以提出翻译。

• 如果您遇到问题或错误并已解决，欢迎提交补丁！

不受欢迎的贡献

如果您想添加新功能、新设备等，请在 gitlab 上打开问题之前，请不要提出合并请求。

如果您没有设备，维护驱动库是一项不可能的任务。如果您提出的设备或功能不在 GRAP 公司的路线上，将被拒绝，以避免增加技术债务。

在这种情况下，请不要犹豫，将项目分支，以在专用分支中实施您的更改。

开发

请参阅专门的章节 这里。

路线图和已知问题

请参阅专门的章节 这里。

致谢

作者

• GRAP https://www.grap.coop

贡献者

• Sylvain LE GAL sylvain.legal@grap.coop

额外著作权

此项目中的部分代码来自以下项目，包括

• Pywebdriver（AGPL-3.0），由 GRAP 提供。主要贡献者是

  • Sylvain LE GAL sylvain.legal@grap.coop
  • Sylvain CALADOR sylvain.calador@akretion.com
  • Sébastien BEAU sebastien.beau@akretion.com
  • Carmen BIANCA BAKKER carmen@coopiteasy.be
  • Alexis DE LATTRE alexis.delattre@akretion.com
  • Quentin DUPONT quentin.dupont@grap.coop
  • Pierrick BRUN pierrick.brun@akretion.com
  • Hugues DE KEYZER hugues@coopiteasy.be

• hw_dialog06_scale（AGPL-3.0），由 Coop It Easy 提供。主要贡献者是

  • Vincent Van Rossem vincent.vanrossem@camptocamp.com

• pyposdisplay (AGPL-3.0)，由 Akretion 提供。主要贡献者是

  • Alexis DE LATTRE alexis.delattre@akretion.com
  • Sébastien BEAU sebastien.beau@akretion.com

以下项目也被认为很有用，并研究了这些项目以实现该库。

• Odoo (AGPL-3.0，直到版本 8.0，然后从版本 9.0 开始使用 LGPL-3.0)，由 Odoo SA 提供，特别是 "hw_" 模块。

图片

• 主应用程序图标，由 AbtoCreative (Flaticon) 提供。

• 信用卡支付终端图标，由 ToZ Icon (Flaticon) 创建。

• LCD 客户显示屏图标，由 Iconic Panda (Flaticon) 创建。

• 热敏打印机图标，由 Icongeek26 (Flaticon) 创建。

• 秤图标，由 itim2101 (Flaticon) 创建。