mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-03 01:28:58 +00:00
83 lines
2.6 KiB
Markdown
83 lines
2.6 KiB
Markdown
---
|
|
layout: page
|
|
title: "FinTS Sensor"
|
|
description: "Instructions on how to use the FinTS sensor."
|
|
date: 2018-03-25 13:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
ha_category: Finance
|
|
ha_release: "0.70"
|
|
ha_iot_class: "Local Push"
|
|
---
|
|
|
|
With the FinTS sensor, you can fetch your account information from your bank. This only works with banks that support the FinTS (aka. HBCI) standard. The FinTS standard used by many German banks. So if you do not have a German bank account, this will most likely not work for you. To find out if your bank supports FinTS, check the bank's website or call their hotline.
|
|
|
|
## {% linkable_title Configuration %}
|
|
|
|
To find out the configuration for your bank, check their website or call their hotline. Do not use random information you find on the Internet! As you're storing your bank account information in the Home Assistant configuration: Make sure that this configuration is not accessible to anyone.
|
|
|
|
For each account you have with the bank, a separate sensor is created. If you have several accounts with a bank, you can select which ones you want to have, and you can also give the accounts a name.
|
|
|
|
{% raw %}
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
- platform: fints
|
|
bank_identification_number: ID_FOR_YOUR_BANK
|
|
username: YOUR_FINTS_USERNAME
|
|
pin: YOUR_PIN
|
|
url: URL_FOR_YOUR_BANK
|
|
```
|
|
{% endraw %}
|
|
|
|
{% configuration %}
|
|
name:
|
|
description: Name of the bank.
|
|
required: false
|
|
type: string
|
|
bank_identification_number:
|
|
description: Bank identification number, in most cases the "Bankleitzahl".
|
|
required: true
|
|
type: string
|
|
username:
|
|
description: Your FinTS username.
|
|
required: true
|
|
type: string
|
|
pin:
|
|
description: Your FinTS PIN or password.
|
|
required: true
|
|
type: string
|
|
url:
|
|
description: URL of your bank's FinTS server.
|
|
required: true
|
|
type: string
|
|
accounts:
|
|
description: The balance accounts to show. If not set then all accounts will show up.
|
|
required: false
|
|
type: list
|
|
keys:
|
|
account:
|
|
description: The IBAN of the blance account.
|
|
required: true
|
|
type: string
|
|
name:
|
|
description: Use this field to give the account a meaningful name.
|
|
required: false
|
|
type: string
|
|
holdings:
|
|
description: The holding accounts of your bank. If not set then all accounts will show up.
|
|
required: false
|
|
type: list
|
|
keys:
|
|
account:
|
|
description: The classic account number.
|
|
required: true
|
|
type: string
|
|
name:
|
|
description: Use this field to give the account a meaningful name.
|
|
required: false
|
|
type: string
|
|
{% endconfiguration %}
|