Actions45
- Attachment Actions
- Beneficiary Actions
- Business Account Actions
- Card Actions
- Client Actions
- Client Invoice Actions
- Credit Note Actions
- External Transfer Actions
- Insurance Contract Actions
- Internal Transfer Actions
- Label Actions
- Membership Actions
- Organization Actions
- Quote Actions
- Request Actions
- SEPA Transfer Actions
- Statement Actions
- Supplier Invoice Actions
- Team Actions
- Transaction Actions
Overview
The node interacts with the Qonto API to retrieve multiple client invoices based on user-defined criteria. Specifically, the "Get Many" operation for the "Client Invoice" resource fetches a list of client invoices, supporting pagination, filtering by status and creation date, and sorting options.
This node is beneficial in scenarios where users need to automate financial workflows, such as:
- Retrieving all unpaid or paid client invoices within a specific date range.
- Generating reports on client invoice statuses.
- Integrating invoice data into other systems for accounting or CRM purposes.
For example, a user could configure this node to fetch all unpaid client invoices created in the last month, sorted by creation date descending, to follow up on outstanding payments.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with the Qonto API. Options: "API Key". |
| Return All | Whether to return all matching results or limit the number of results returned. |
| Limit | Maximum number of results to return when "Return All" is false. Range: 1 to 100. Default: 100. |
| Page | Page number to retrieve when limiting results. Starts at 1. |
| Filters | Collection of filters to narrow down results: |
| - Status | Filter invoices by their status. Options: Draft, Unpaid, Canceled, Paid. |
| - Created From | Minimum creation date (inclusive) to filter invoices. |
| - Created To | Maximum creation date (inclusive) to filter invoices. |
| Options | Additional options for result customization: |
| - Sort By | Sort order of results by creation date. Options: Created At (Ascending), Created At (Descending). |
Output
The node outputs an array of JSON objects representing client invoices that match the specified criteria. Each object contains the invoice details as provided by the Qonto API, including fields such as invoice ID, status, creation date, amounts, and related metadata.
If binary data were involved (e.g., invoice PDFs), it would be included in a separate binary property, but this operation focuses on JSON data retrieval only.
Dependencies
- Requires access to the Qonto API via an API key credential.
- The node expects the user to provide valid authentication credentials configured in n8n.
- Network connectivity to Qonto's API endpoints is necessary.
- No additional external dependencies beyond the Qonto API and n8n environment.
Troubleshooting
Common Issues:
- Invalid or missing API key will cause authentication failures.
- Requesting pages beyond available data may return empty results.
- Using invalid filter values (e.g., unsupported status) may cause errors or no results.
- Exceeding the maximum limit (over 100) will be rejected; ensure limits are within allowed range.
Error Messages:
"Unknown resource: clientInvoice": Indicates misconfiguration of the resource parameter.- API errors related to authentication typically indicate invalid or expired credentials.
- Timeout or network errors suggest connectivity issues with the Qonto API.
Resolutions:
- Verify API key validity and permissions.
- Adjust filters and pagination parameters to valid ranges.
- Ensure stable internet connection and correct base URL configuration (sandbox vs production).
Links and References
- Qonto API Documentation
- n8n Documentation - Creating Nodes
- Qonto API Client Invoices Endpoint (for detailed API schema and parameters)