n8n DATEVConnect

This repository provides custom n8n nodes for integrating with the DATEVconnect APIs. It requires the Klardaten DATEVconnect Gateway to be set up.

Available Nodes

| Node | Description | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | | Accounting | Access DATEV Accounting API for clients, fiscal years, accounts receivable, account postings, and accounting sequences. | | MasterData | Fetches master data entities from DATEV using the configured credentials. | | Document Management | Access DATEV Document Management or DMS for documents, structure items, property templates. | | Identity & Access Management | Manage SCIM-based DATEV IAM resources such as service configuration, schemas, users, and groups. |

Refer to the node descriptions inside the n8n editor for input parameters and output structure.

Installation

Through the n8n UI

1. Navigate to Settings → Community Nodes → Install inside your n8n instance.
2. Enter @klardaten/n8n-nodes-datevconnect as the package name.
3. Confirm the warning prompt and restart n8n so the nodes are registered.

Manual (filesystem) installation

cd ~/.n8n
npm install @klardaten/n8n-nodes-datevconnect

Copy or symlink the contents of the installed node_modules/@klardaten/n8n-nodes-datevconnect/dist/{nodes,credentials} directories into your ~/.n8n/custom/ folder if you prefer the legacy custom-nodes workflow, then restart n8n.

Development

1. Install dependencies

   npm install

2. Build (optional during development; n8n compiles on the fly)

   npm run dev

Required Credentials

You need a Klardaten account and an instance id (of the DATEV instance you want to access).

• email
• password
• clientInstanceId

Running Tests

Use the npm test runner to execute the automated tests:

npm test

Usage in n8n

1. Create a new workflow in n8n.
2. Add the Klardaten DATEVconnect: Master Data or Accounting etc. node and choose the credential you configured.
3. Select the desired operation (e.g., list client entries) and configure any filters.
4. Execute the workflow or schedule it as part of a larger automation.

All nodes authenticate using the stored credentials and interact with their respective DATEVconnect APIs.

Additional Notes

DATEV provides endpoint reference details under

• Accounting
• Client Master Data.
• Document Management
• Identity & Access Management – User Administration