Reonic n8n Custom Node

This is a custom n8n node for integrating with the Reonic REST API.

Features

This node provides access to the following Reonic resources:

• Contacts - Create, get, and list contacts
• Offers - Create, get, list, update offers and create notes
• Requests - Create H360 and B360 requests
• Users - Get and list users
• Teams - Get and list teams
• Status - Create, get, and list statuses
• Files - Get files by ID or parent entity
• Tasks - Get tasks by ID or parent entity
• Calendar Events - List calendar events with filters
• Components - Get and list components
• Tags - List tags

Installation

Option 1: Community Node (Recommended for n8n Cloud/Docker)

1. In n8n, go to Settings → Community Nodes
2. Click Install a community node
3. Enter the package name: n8n-nodes-reonic (if published to npm)
4. Click Install

Option 2: Manual Installation (Local Development)

1. Navigate to your n8n custom nodes directory:

   cd ~/.n8n/custom

2. Create a directory for the Reonic node:

   mkdir -p n8n-nodes-reonic
   cd n8n-nodes-reonic

3. Copy the node files:

   • Reonic.node.ts
   • ReonicApi.credentials.ts
   • reonic.svg (optional icon file)

4. Install dependencies:

   npm install n8n-workflow

5. Restart n8n:

   n8n restart

Option 3: Development Installation

1. Clone or download the files to your custom nodes directory
2. Build the TypeScript files:

   npm run build

3. Restart n8n

Configuration

Setting up Credentials

1. In n8n, create a new Reonic API credential

2. Enter your credentials:

   • API Key: Your Reonic API key (found in your Reonic account settings)
   • Client ID: Your Reonic Client ID (UUID format)

3. Click Create to save

Testing Credentials

The credentials will automatically test the connection by attempting to fetch users from your Reonic account.

Usage Examples

Example 1: Create a Contact

1. Add the Reonic node to your workflow
2. Select Resource: Contact
3. Select Operation: Create
4. Fill in:
   • First Name: John
   • Last Name: Doe
   • Additional Fields:
     • Email: [email protected]
     • Telephone: +49123456789

Example 2: Create an H360 Offer

1. Add the Reonic node to your workflow
2. Select Resource: Offer
3. Select Operation: Create
4. Fill in:
   • First Name: Jane
   • Last Name: Smith
   • Installation Address: 123 Main St, Berlin, Germany
   • Additional Fields as needed

Example 3: Get All Offers with Filters

1. Add the Reonic node to your workflow
2. Select Resource: Offer
3. Select Operation: Get Many
4. Add filters:
   • State: open
   • Page: 0

Example 4: Create an H360 Request

1. Add the Reonic node to your workflow
2. Select Resource: Request
3. Select Operation: Create H360
4. Fill in required fields and additional fields as needed

Example 5: Update an Offer

1. Add the Reonic node to your workflow
2. Select Resource: Offer
3. Select Operation: Update
4. Enter the Offer ID
5. Configure update fields:
   • Notify: true
   • Key Account Manager ID: (optional)
   • Team IDs: (optional, comma-separated)
   • Status ID: (optional)

Workflow Examples

Contact to Offer Workflow

Webhook → Reonic (Create Contact) → Reonic (Create Offer)

This workflow receives contact information via webhook, creates a contact in Reonic, then creates an offer.

Calendar Sync Workflow

Schedule Trigger → Reonic (Get Calendar Events) → Send Email

This workflow runs daily to fetch calendar events and sends a summary email.

API Reference

For detailed information about the Reonic API, visit: https://api.reonic.de/rest/v2/

Supported Operations

Contact

• Create: Create a new contact
• Get: Get a contact by ID
• Get Many: Get all contacts (with pagination)

Offer

• Create: Create a new H360 offer
• Get: Get an offer by ID
• Get Many: Get all offers (with filters)
• Update: Update an offer
• Create Note: Create a note for an offer

Request

• Create H360: Create a new H360 request
• Create B360: Create a new B360 request

User

• Get: Get a user by ID
• Get Many: Get all users (with filters)

Team

• Get: Get a team by ID
• Get Many: Get all teams (with filters)

Status

• Create: Create a new status
• Get: Get a status by ID
• Get Many: Get all statuses (with filters)

File

• Get: Get a file by ID
• Get by Parent Entity: Get files by parent entity

Task

• Get: Get a task by ID
• Get by Parent Entity: Get tasks by parent entity

Calendar Event

• Get Many: Get calendar events (with filters)

Component

• Get: Get a component by ID
• Get Many: Get all components

Tag

• Get Many: Get all tags (with filters)

Troubleshooting

Node not appearing in n8n

1. Make sure the files are in the correct directory (~/.n8n/custom/)
2. Restart n8n completely
3. Check n8n logs for any errors

Authentication Errors

1. Verify your API key is correct
2. Verify your Client ID is in UUID format
3. Test the credentials using the built-in credential test

API Errors

• Check the error message returned by the API
• Verify all required fields are filled
• Ensure UUIDs are in the correct format
• Check the Reonic API documentation for field requirements

Contributing

If you find bugs or want to add features:

1. Create an issue describing the bug/feature
2. Submit a pull request with your changes

License

MIT

Support

For issues with this node, please create an issue in the repository. For Reonic API support, contact Reonic at [email protected]

Version History

• 1.0.0: Initial release with full API support