ing-ynab 2.0.2

通过 FinTS 将您的 ING 德国银行对账单导入 YNAB。

设置

在进行设置之前，请先 注册您的 FinTS 产品 ——它是免费的，只需几天时间。
如果您不这样做，应用程序将回 退到 python-fints库中的产品 ID，该库仅应用于评估。

由于此应用程序需要您的 ING 引脚和 YNAB 访问令牌，因此建议在您的本地网络中运行它（可能是 Raspberry Pi，它非常轻巧）。

启动应用程序有多种方式：

当地的

这可以在 Python 3.7 或更高版本的任何环境中运行。

$ python3 -m pip install ing-ynab
$ touch .env # see configuration section
$ ing-ynab

码头工人

$ cp .env.example .env # and customize fields
$ docker run --env-file .env docker.pkg.github.com/bahlo/ing-ynab/ing-ynab:2.0.2

码头工人撰写

version: "2.0"

services:
  ing-ynab:
    image: docker.pkg.github.com/bahlo/ing-ynab/ing-ynab:2.0.2
    environment:
      # Environment variables, see the configuration section

配置

配置是通过环境变量完成的：

• SLEEP_INTERVAL_SECONDS: 以秒为单位的间隔，直到下一次检查发生（默认为 5 分钟）。
• FINTS_PRODUCT_ID：您的 FinTS 产品 ID（默认为 python-fints 之一）。
• ING_LOGIN: 您的 ING 帐户的登录 ID。
• ING_IBAN：您要添加的帐户的 IBAN。
• ING_PIN: 您的 ING 帐户的 pin（留空以提示）。
• YNAB_ACCESS_TOKEN：转到您的预算设置以创建一个（留空以提示）。
• YNAB_BUDGET_ID：在您预算的网页上，路径中的第一个 UUID ( https://app.youneedabudget.com/<BUDGET_UUID>/budget/202109)。
• YNAB_ACCOUNT_ID：在银行帐户的网页上，路径中的最后一个 UUID ( https://app.youneedabudget.com/<BUDGET_UUID>/accounts/<BANK_ACCOUNT_UUID>)。
• YNAB_FLAG_COLOR：如果设置，则为导入的交易使用该颜色。
• DEBUG：设置为1启用调试输出和打印事务而不是导入它们。

安全

如果您愿意，可以通过环境变量传入您的银行密码和 YNAB 访问令牌。这样做的缺点是任何具有系统访问权限的人都可以阅读并可能使用它们，因此不鼓励（但支持）。

替代方法是不指定YNAB_ACCESS_TOKENand/or ING_PIN，这将导致应用程序在启动时提示您。这样做的缺点是每次应用程序重新启动时都需要输入它们。

对于 docker，您需要传递-it标志才能输入这些变量。对于 docker-compose，添加以下字段：

  tty: true
  stdin_open: true

启动后docker-compose up -d，运行docker attach $container_id 以附加到容器。请注意，pin 的提示可能会被隐藏，因此您必须直接输入 pin。

常问问题

为什么这是 ING-only？FinTS 不是通用协议吗？

是的，但是实现有很大不同。这实际上是作为一个通用库开始的，但我只能真正测试 ING，我宁愿拥有一个专门的库，而不是一个无法保证功能的多用途库。

你能支持我的银行吗？

python-fints库支持很多银行，所以可能。但是我们需要一起工作，因为我无法测试它。请随时联系：hallo@arne.me

如何注册 FinTS 产品？

1. 前往FinTS 产品注册
2. 单击Registrierungsprozess以获取 PDF 表单
3. 填写您的数据。如果你不知道还能放什么，这里有一些建议：
   • Firmenbezeichnung： 你的名字
   • Produktname：ing-ynab
   • Produktkategorie：Web-Server
4. 将表格发送到最后一页的电子邮件地址

一两周后，您将通过电子邮件获得您的产品 ID。