n8n-nodes-comdirect
v1.0.2
Published
n8n community node for the comdirect REST API (accounts, depots, PostBox documents)
Maintainers
Readme
n8n-nodes-comdirect
This is an n8n community node. It lets you read accounts, depots and PostBox documents from comdirect in your n8n workflows.
n8n is a fair-code licensed workflow automation platform.
Installation Operations Credentials Compatibility Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
- Account
- Get Balance — single account by ID
- Get Many Balances — all linked accounts
- Get Many Transactions — with date and direction filters, paged
- Depot
- Get Many — list all depots
- Get Many Positions — positions held in a depot
- Get Position — single position by depot + position ID
- Get Many Transactions — with WKN/ISIN and date filters, paged
- Document (PostBox)
- Get Many — list documents
- Get — download a single document as binary PDF
Order placement, quote requests, instrument lookup and aggregated reports are out of scope for v0.1.
Credentials
This node uses a single comdirect API credential.
Prerequisites
- Register for API access at comdirect's developer portal. comdirect issues you a personal
client_idandclient_secret. - Activate photoTAN-Push on your comdirect account. This node only supports photoTAN-Push because it's the only TAN method that doesn't require typing a code mid-flow. SMS-TAN and manual photoTAN are not supported.
Setup
In n8n, create a new comdirect API credential with:
- Client ID / Client Secret — from the developer portal
- Zugangsnummer — your 8-digit comdirect customer number
- PIN — your 6-digit online-banking PIN
When you save the credential, comdirect sends a photoTAN-Push notification to your phone. Open the comdirect photoTAN app and approve the request within ~50 seconds. Once approved, the credential persists the resulting session tokens and your subsequent workflow runs are unattended.
Refresh window
comdirect's session tokens have a sliding 20-minute idle expiry: every authenticated request resets the timer. Workflows that fire more often than every 20 minutes will never trigger a re-bootstrap. If the window does lapse (long idle period, n8n restart with stale tokens, etc.), the node will surface a clear error — re-open and re-save the credential to re-authenticate via photoTAN-Push.
Compatibility
Compatible with n8n 1.60.0 or later.
