pretix的命令行客户机,允许将银行交易报表同步到pretix
pretix-banktool的Python项目详细描述
这是一个用于pretix的命令行工具,允许您自动查询银行帐户并同步 到pretix服务器的事务数据。它使用pretix 1.5或更新版本提供的api。
当前限制:
- 目前仅限于实施fints协议(以前称为hbci)的银行,该协议主要适用于德国。 银行。
- 只支持pin/tan认证,不支持芯片卡。
- 当前仅支持在每个组织者级别上载银行事务,而不支持在每个事件级别上载银行事务。
目前,此工具将您的银行密码以明文形式存储在磁盘上,或随时询问您。我们建议您使用 只读银行登录或事务的强二元身份验证。我们将在 稍后的时间点。
安装和使用
首先,确保系统上最近安装了python。如果python -V为您提供2.x版, 尝试改用python3,或者安装一个新的python。我们建议使用python 3.6+,但3.4+也应该可以工作。
然后,我们建议创建一个虚拟环境,将此包与其他包的python依赖项隔离开来 系统上的python程序:
$ pyvenv env $ source env/bin/activate
现在您应该看到shell提示符前面有一个(env)。你必须这么做 在使用pretix的每一个shell中(或者配置shell 自动)。根据python版本的不同,您可能需要将pyvenv替换为python -m venv。 如果您使用的是ubuntu或debian,我们建议您在内部升级pip和setuptools安装 虚拟环境:
(env)$ pip3 install -U pip setuptools
现在您可以安装银行工具:
(env)$ pip3 install pretix-banktool
要配置它,请运行以下命令:
(env)$ pretix-banktool setup
你将被问到一些关于你的网上银行访问以及你的pretix的url的问题。 安装和您的api密钥。提示还将告诉您如何获取该api密钥。
最后,这个命令会将配置文件写入您选择的位置。需要指定此配置文件 所有进一步的行动。命令:
(env)$ pretix-banktool test configfile-path.cfg
将测试与银行的连接以及与pretix的连接,但不会执行任何操作。到 实际上传数据,使用:
(env)$ pretix-banktool upload --days 30 configfile-path.cfg
--days选项指定要从银行提取的事务的时间范围。如果你省略它,这个工具会 取过去30天。
转到Pretix中Organizer设置的“导入银行数据”选项卡,查看无法 自动分配给票务订单。
许可证
版权所有2017 Raphael Michel
根据GNU通用公共许可3.0版的条款发布。