Update configuration sample

This commit is contained in:
Fabian Affolter 2018-09-18 09:14:11 +02:00
parent 69820f0e03
commit 900ad16bb5
No known key found for this signature in database
GPG Key ID: E23CD2DD36A4397F

View File

@ -10,13 +10,14 @@ footer: true
ha_category: Finance ha_category: Finance
ha_release: "0.70" ha_release: "0.70"
ha_iot_class: "Local Push" ha_iot_class: "Local Push"
logo: home-assistant.png
--- ---
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. 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 %} ## {% 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. 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 %} {% raw %}
@ -24,52 +25,51 @@ For each account you have with the bank, a separate sensor is created. If you ha
# Example configuration.yaml entry # Example configuration.yaml entry
sensor: sensor:
- platform: fints - platform: fints
bank_identification_number: <for your bank> sensors:
username: <your FinTS user name> - bank_identification_number: ID_FOR_YOUR_BANK
pin: <your FinTS pin> username: YOUR_FINTS_USERNAME
url: <FinTS url of your bank> pin: YOUR_PIN
url: URL_FOR_YOUR_BANK
``` ```
{% endraw %} {% endraw %}
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.
{% configuration %} {% configuration %}
sensors: sensors:
description: List of your sensors. description: List of your sensors.
required: true required: true
type: map type: map
keys: keys:
name: name:
description: (optional) name of the bank. description: (optional) name of the bank.
required: false required: false
type: string type: string
bank_identification_number: bank_identification_number:
description: Bank identification number, in most cases the "Bankleitzahl". description: Bank identification number, in most cases the "Bankleitzahl".
required: true required: true
type: string type: string
username: username:
description: Your FinTS username. description: Your FinTS username.
required: true required: true
type: string type: string
pin: pin:
description: Your FinTS PIN or password. description: Your FinTS PIN or password.
required: true required: true
type: string type: string
url: url:
description: URL of your bank's FinTS server. description: URL of your bank's FinTS server.
required: true required: true
type: string type: string
accounts: accounts:
description: (optional) You can configure with of the accounts of your bank shall be shown in Home Assistant. If this attribute is set, only the accounts listed here are shown. description: (optional) You can configure with of the accounts of your bank shall be shown in Home Assistant. If this attribute is set, only the accounts listed here are shown.
required: false required: false
type: list type: list
keys: keys:
account: account:
description: For balance accounts use the IBAN of the account for holdings accounts use the classic account number. description: For balance accounts use the IBAN of the account for holdings accounts use the classic account number.
required: true required: true
type: string type: string
name: name:
description: (optional) Use this field to give the account a meaningful name. description: (optional) Use this field to give the account a meaningful name.
required: false required: false
type: string type: string
{% endconfiguration %} {% endconfiguration %}