@koncile/n8n-nodes

n8n community nodes for the Koncile API. Manage folders, templates, fields, instructions, documents, and file uploads directly from your n8n workflows.

Installation

n8n Cloud / Self-hosted

1. Go to Settings > Community Nodes
2. Click Install a community node
3. Enter @koncile/n8n-nodes
4. Click Install

Manual

npm install @koncile/n8n-nodes

Credentials

1. In n8n, go to Credentials > Add Credential
2. Search for Koncile API
3. Enter your API key (get it from your Koncile account settings)
4. Click Test to verify, then save

Resources & Operations

| Resource | Operations | |---|---| | File | Upload | | Task | Get Status | | Folder | Get All, Get, Create, Update, Delete | | Template | Get, Create, Update, Delete | | Field | Get, Create, Update, Delete | | Instruction | Get, Create, Update, Delete | | Document | Get Many, Get Data, Download, Download Batch, Delete |

File - Upload

Uploads a binary file to Koncile. Requires selecting a folder and template. The binary property name defaults to data.

Task - Get Status

Returns the processing status and document ID for a given task ID (returned by file upload).

Folder

Full CRUD on folders. Delete supports an override flag to force-delete folders with contents.

Template

Full CRUD on templates within folders. Create supports duplicating from an existing template via an optional template ID.

Field

Full CRUD on fields within templates. Fields can be of type "General fields" or "Line fields".

Instruction

Full CRUD on instructions within fields.

Document

• Get Many - List documents with optional filters (folder, template, date range)
• Get Data - Retrieve extracted data from a processed document
• Download - Download a document file by document ID or task ID (binary output)
• Download Batch - Download multiple documents as a ZIP file
• Delete - Delete a document, optionally including the associated file

Example Workflow

HTTP Request (fetch PDF) -> Koncile (Upload File) -> Koncile (Get Task Status) -> Koncile (Get Document Data)

Compatibility

• Tested with n8n >= 1.0.0
• Requires Node.js >= 20.15

Resources

• n8n community nodes documentation
• Koncile API documentation

Development

pnpm install
pnpm run build
pnpm run lint
pnpm test

For local testing, use npm link in the package directory, then install in your local n8n instance.

License

MIT