vitexsoftware / abraflexi-reminder
用 PHP 编写的 AbraFlexi 提醒发送器
Requires
- hsp-dev/huawei-api: dev-master
- spipu/html2pdf: ^5.2
- spojenet/flexibee: ^2.24
- tecnickcom/tcpdf: ^6.4
- vitexsoftware/abraflexi-bricks: *
Requires (Dev)
- phpunit/phpunit: ^9
This package is auto-updated.
Last update: 2024-09-17 01:11:33 UTC
README
- PDF ISDOC 附件
- QR 支付(可选)
- 您的模块目录,例如发送 SMS 或断开欠款人的连接
- 定义最大电子邮件大小
- 黑名单以忽略某些类型的文件
- 标签管理(例如,NEUPOMINKOVAT 标签)
- 支持外币
- 您的公司标志
- 捷克语和英语本地化。(gettext 翻译系统)
- 适用于 Debian/Ubuntu 的软件包,但也可以在 Windows 上运行
abraflexi-show-debts 命令仅在 Linux 上运行,并且仅打印每个债务人的应收账款。
abraflexi-reminder 命令在启动时(创建必要的标签并)检查预置公司中的应收账款。在发送提醒时,如果客户没有设置 NEUPOMINKOVAT 标签,则发送提醒。该命令旨在每天自动运行。
abraflexi-inventarize 命令向客户发送其义务的概述。预计每月自动运行一次。
搜索“已发出发票”和“应收账款”记录
标签功能
标签既有信息功能,又有控制功能。启动提醒器后,首先遍历所有客户,对于没有未偿还应收账款的客户,将删除 UPOMINKA1、UPOMINKA2、UPOMINKA3 和 NEPLATIC 标签。发送提醒的日期将记录在各个发票的 datUp1、datUp2 和 datSmir 列中 - 发票中 abraflexi 没有那么多列。但是提醒的是客户而不是发票,因此需要以某种方式记录这一事实。这正是通过标签来完成的。也就是说,如果客户设置了 UPOMINKA1 和 UPOMINKA2 标签,这意味着已经向客户发送了两份提醒。对于程序来说,这意味着即将发送的提醒将是和解尝试。同时,也有提醒已被发送的信息。即,如果不知道客户的电子邮件,或者邮件服务器刚好在重新启动,则不会设置。发送第三份提醒后的下一周,将为客户设置 NEPLATIC 信息标签
电子邮件提醒
提醒文本在 abraflexi 记录中更改 sablona-upominky,并记录其发送日期,同时为客户分配 UPOMINKA1-3 标签。已发送的提醒包含所有逾期项目的概述和相关附件(pdf 和 isdocx 格式)
短信提醒
目前可以通过以下方法发送提醒
- 本地 gnokii - 在运行提醒器的同一台机器上安装了 gnokii 应用程序。
- 远程 gnokii - gnokii 安装在其他机器上。通过 SSH 和密钥启动该命令。
- Axfone SMS 网关 - 在配置文件中将您的登录凭据输入到 AXFONE_USERNAME 和 AXFONE_PASSWORD 键下
- 华为 E5180 API - 设置 MODEM_PASSWORD(如果与 192.168.8.1 不同,则设置 MODEM_IP)
提醒时的其他操作
可以在 src/AbraFlexi/Reminder/Notifier 目录中添加其他执行操作的模块(/usr/lib/abraflexi-reminder/Reminder/Notifier/ 如果从 Debian 软件包安装)。例如,断开欠款人的服务。如何编写此类插件应从 ByEmail.php 中清楚看出
Debian/Ubuntu
对于 Linux,提供了 .deb 软件包。请使用仓库。
sudo apt install lsb-release wget echo "deb http://repo.vitexsoftware.com $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/vitexsoftware.list sudo wget -O /etc/apt/trusted.gpg.d/vitexsoftware.gpg http://repo.vitexsoftware.cz/keyring.gpg apt update apt install abraflexi-reminder
安装软件包后,系统中将提供以下新命令
- abraflexi-show-debts - 打印找到的应收账款
- abraflexi-reminder - 遍历债务人
- abraflexi-notify-customers - 向客户发送其债务清单
- abraflexi-reminder-init - 为使用提醒功能准备预定义公司
配置
在文件 /etc/abraflexi/reminder.json 中设置,或将值放入环境变量中
"EASE_MAILTO": "info@yourdomain.net", "REMIND_FROM": "noreply@yourdomain.net", "EASE_LOGGER": "syslog|mail", "QR_PAYMENTS": true, "MAX_MAIL_SIZE": 1250000 "SKIPLIST": "DOBROPIS,ZDD", "MUTE": false, "SMS_SENDER": "+420739778202", "SMS_ENGINE": "gnokii"
- EASE_MAILTO - 如果允许将日志记录到邮件,则将协议发送到此处
- MAIL_CC - 将发送的每条消息的副本也发送到此电子邮件
- REMIND_FROM - 提醒中的发件人地址
- EASE_LOGGER - 如何记录日志?(可用的方法有:memory,console,file,syslog,email,std,eventlog)
- MAX_MAIL_SIZE - 最终邮件的最大大小(以字节为单位)。(1250000 = 10Mb) 如果超过此大小,则不再附加任何附件。
- QR_PAYMENTS - 是否在提醒中添加用于 QR Payments 的 QR 代码
- ADD_LOGO - 是否在提醒中添加提醒公司的标志
- REMINDER_SKIPDOCTYPE - 不考虑这些类型的文件
- MUTE - 不向客户发送通知。检查邮件发送到 EASE_MAILTO
- SMS_SENDER - 短信发件人的电话号码。例如:+420739778202
- SMS_ENGINE - 短信发送方法。可能的值:none:不发送短信,gnokii:本地 Gnokii,sshgnokii:位于远程服务器上的 Gnokii(GNOKII_HOST),axfone Axfone API
- SMS_SIGNATURE - 附加在发送的短信末尾的签名
- GNOKII_HOST - 模拟器的服务器规格。可以是 login@host 格式
- AXFONE_USERNAME - AXFONE API 的登录名
- AXFONE_PASSWORD - AXFONE API 的密码
- MODEM_PASSWORD - 华为 E5180 网络界面密码
- MODEM_IP - 模拟器的 IP 地址(可选)
- JSON_REPORT_FILE - 将债务人概述保存到 Json 文件中
- NO_REMIND_LABEL - 如果未指定,则使用 NEUPOMINAT
- OVERDUE_PATIENCE - 在发送库存之前的天数耐心等待
如果您不使用 Debian 软件包,而是仅克隆存储库,则在首次使用之前需要运行 Init.php 脚本,它将创建标签 'UPOMINKA1','UPOMINKA2','UPOMINKA3','NEPLATIC','NEUPOMINKOVAT'
AbraFlexi/Reminder/ 中的类
依赖关系
此工具用于其功能,使用了以下库
- EasePHP Framework core - 辅助功能,例如记录
- PHP AbraFlexi - 与 AbraFlexi 的通信
- PHP AbraFlexi Bricks - 使用客户类
你可能还感兴趣
- https://github.com/VitexSoftware/php-abraflexi-matcher - 发票配对器
- https://github.com/VitexSoftware/AbraFlexi-Digest - 定期摘要
感谢
本项目的创建离不开 Spoje.Net s.r.o. 的支持
对于 HTML 提醒版本和包含其他付款请求,由 Medinet .s.r.o. 支付
MultiFlexi
AbraFlexi Reminder 作为 MultiFlexi 应用程序准备就绪。
请在应用列表页面查看MultiFlexi平台内可立即运行的应用程序的全列表。