n8n-nodes-qonto

This is an n8n community node. It lets you use Qonto in your n8n workflows.

Qonto is a business finance solution that simplifies banking, bookkeeping, and expense management for SMEs and freelancers. It provides powerful APIs for managing invoices, transactions, and financial data.

n8n is a fair-code licensed workflow automation platform.

Note: This is a custom n8n node developed by General Dexterity and is not officially affiliated with or endorsed by Qonto.

Table of Contents

• Installation
• Operations
• Credentials
• Compatibility
• Usage
• Resources
• Version History

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Installation

1. In n8n, go to Settings > Community Nodes
2. Select Install a community node
3. Enter @general-dexterity/n8n-nodes-qonto
4. Select Install

Manual Installation (self-hosted)

npm install @general-dexterity/n8n-nodes-qonto

After installation, restart your n8n instance.

Operations

This node supports the following operations:

Client Invoice

• Get Many: Retrieve multiple client invoices with optional filtering and pagination
  • Filter by status (draft, unpaid, canceled, paid)
  • Filter by date range (created from/to)
  • Sort by creation date (ascending or descending)
  • Control pagination with page size and current page

Credentials

Prerequisites

1. You need a Qonto business account. Sign up at qonto.com
2. Ensure you have the necessary permissions to access API features or create OAuth applications

Authentication Methods

This node supports the following authentication methods:

API Key Authentication

1. Log in to your Qonto account
2. Navigate to Settings > API Integration
3. Click Generate API Key
4. Set the required permissions for your use case
5. Copy the generated login and secret key
6. In n8n, add new Qonto API Key credentials:
   • Environment: Select Production or Sandbox (default: Production)
   • Login: Your Qonto login (from step 5)
   • Secret Key: Your generated secret key (from step 5)

OAuth2 Authentication

1. Log in to your Qonto account
2. Navigate to the OAuth applications section
3. Register a new OAuth application
4. Set the redirect URI to your n8n OAuth callback URL
5. Copy the Client ID and Client Secret
6. In n8n, add new Qonto OAuth2 credentials:
   • Environment: Select Production or Sandbox (default: Production)
   • Client ID: Your OAuth application's Client ID
   • Client Secret: Your OAuth application's Client Secret
   • Scopes: The node will automatically request organization.read and client_invoices.read
7. Complete the OAuth authorization flow when prompted

Environment Selection

Both authentication methods support environment selection:

• Production (default): Uses the live Qonto API
  • API Base URL: https://thirdparty.qonto.com
  • OAuth URLs: https://oauth.qonto.com
• Sandbox: Uses the testing environment for development and testing
  • API Base URL: https://thirdparty-sandbox.qonto.com
  • OAuth URLs: https://oauth-sandbox.qonto.com

Important: Make sure to select the correct environment that matches your Qonto account and use case. Sandbox credentials will not work with the production environment and vice versa.

Compatibility

• Minimum n8n version: 1.0.0
• Tested up to: 1.0.0

Known Issues

• None reported at this time

Usage

Example: Get Client Invoices

1. Add the Qonto node to your workflow
2. Select the "Client Invoice" resource
3. Choose the "Get Many" operation
4. Configure the optional filters:
   • Status: Select one or more invoice statuses to filter by
   • Created From: Set a start date for the date range filter
   • Created To: Set an end date for the date range filter
   • Sort Order: Choose ascending or descending by creation date
5. Configure pagination options:
   • Page Size: Number of invoices per page (default: 10)
   • Current Page: Which page to retrieve (default: 1)
6. Execute the node

Tips and Best Practices

• Use pagination when dealing with large numbers of invoices to avoid timeouts
• The API returns a maximum of 100 invoices per page
• Date filters use ISO 8601 format (YYYY-MM-DD)
• Status filters can be combined to retrieve invoices in multiple states

Common Issues

Error: "Authentication failed"

• Solution: Verify your API credentials are correct and have the necessary permissions

Error: "Invalid date format"

• Solution: Ensure dates are in YYYY-MM-DD format

Error: "Page not found"

• Solution: Check that the current page number doesn't exceed the total number of pages

Resources

• n8n community nodes documentation
• Qonto API documentation
• Qonto OAuth documentation
• Qonto Sandbox Environment
• Qonto official website

Version History

0.1.0 (Initial Release)

• Initial release with Client Invoice operations
• Support for API Key and OAuth2 authentication
• Get Many operation with filtering and pagination