@klardaten/n8n-nodes-datevconnect 1.0.1

package/README.md

@@ -0,0 +1,78 @@
+# n8n DATEVConnect
+
+This repository provides custom n8n nodes for integrating with the DATEVconnect APIs. It requires the [Klardaten DATEVconnect Gateway](https://klardaten.com/products/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
+
+```bash
+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.
+
+## Configuration
+
+1. **Install dependencies**
+   ```bash
+   bun install
+   ```
+2. **Build TypeScript** (optional during development; n8n compiles on the fly)
+   ```bash
+   bun run build
+   ```
+3. **Link the nodes into n8n**
+   - Copy or symlink the contents of the `nodes/` and `credentials/` directories into your n8n custom directory (e.g., `~/.n8n/custom/`).
+   - Restart the n8n instance so it detects the new nodes.
+
+## 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 Bun test runner to execute the automated tests:
+
+```bash
+bun test
+```
+
+## Usage in n8n
+
+1. Create a new workflow in n8n.
+2. Add the **Klardaten DATEVconnect: Master Data** or **Accounting** 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](https://developer.datev.de/en/product-detail/accounting/1.7.4/reference)
+- [Client Master Data](https://developer.datev.de/en/product-detail/client-master-data/1.7.0/reference).
+- [Document Management](https://developer.datev.de/en/product-detail/document-management/2.3.0/reference)
+- [Identity & Access Management – User Administration](https://developer.datev.de/en/product-detail/identity-and-access-management-user-administration/1.1.2/reference)

package/dist/credentials/DatevConnectApi.credentials.js

@@ -0,0 +1,98 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// credentials/DatevConnectApi.credentials.ts
+var exports_DatevConnectApi_credentials = {};
+__export(exports_DatevConnectApi_credentials, {
+  DatevConnectApi: () => DatevConnectApi
+});
+module.exports = __toCommonJS(exports_DatevConnectApi_credentials);
+
+class DatevConnectApi {
+  name = "datevConnectApi";
+  displayName = "DATEVconnect API";
+  properties = [
+    {
+      displayName: "Host",
+      name: "host",
+      type: "string",
+      default: "https://api.klardaten.com",
+      required: true,
+      description: "Base URL of the Klardaten DATEVconnect service, e.g. https://api.klardaten.com"
+    },
+    {
+      displayName: "Email",
+      name: "email",
+      type: "string",
+      default: "",
+      required: true,
+      description: "Klardaten user login"
+    },
+    {
+      displayName: "Password",
+      name: "password",
+      type: "string",
+      default: "",
+      required: true,
+      typeOptions: {
+        password: true
+      },
+      description: "Klardaten user password"
+    },
+    {
+      displayName: "Client Instance ID",
+      name: "clientInstanceId",
+      type: "string",
+      default: "",
+      required: true,
+      description: "Klardaten client instance identifier"
+    }
+  ];
+  test = {
+    request: {
+      baseURL: "={{ $credentials.host }}",
+      url: "/api/auth/login",
+      method: "POST",
+      json: true,
+      body: {
+        email: "={{ $credentials.email }}",
+        password: "={{ $credentials.password }}"
+      }
+    },
+    rules: [
+      {
+        type: "responseSuccessBody",
+        properties: {
+          key: "access_token",
+          value: undefined,
+          message: "Login successful response must include a access_token."
+        }
+      }
+    ]
+  };
+}