Qonto icon

Qonto

Consume Qonto API

Actions46

Overview

This node integrates with the Qonto API to create supplier invoices in bulk, including associating attachments with each invoice. It is useful for automating the process of submitting multiple supplier invoices to an organization's accounting system, especially when invoices come with supporting documents that need to be linked.

Typical use cases include:

  • Uploading batches of supplier invoices received from vendors.
  • Attaching scanned or digital copies of invoices as proof.
  • Streamlining accounts payable workflows by programmatically creating invoices and linking their attachments.

For example, a finance team can use this node to automatically create supplier invoices after receiving them via email, attaching the scanned PDFs stored in the workflow.

Properties

Name Meaning
Authentication Method of authenticating with the Qonto API: either "Login and Secret-Key" or "OAuth2".
Organization ID The unique identifier of the organization for which supplier invoices will be created.
Supplier Invoices A collection of supplier invoice details to create. Each invoice includes:
- Invoice Number Unique number identifying the supplier invoice.
- Invoice Date Date when the supplier invoice was issued.
- Amount Monetary amount of the supplier invoice.
- Currency Currency code (e.g., EUR) of the invoice amount.
- Attachment IDs Comma-separated string of attachment IDs associated with the invoice (linking supporting documents).

Output

The node outputs an array of JSON objects representing the response from the Qonto API after creating the supplier invoices. Each object corresponds to a created supplier invoice and contains details such as invoice identifiers, status, and any metadata returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Qonto API.
  • Requires valid authentication credentials configured in n8n, either via an API key credential or OAuth2 token.
  • The node uses UUID generation internally to handle idempotency keys for safe API requests.
  • The user must provide valid organization IDs and attachment IDs that exist in Qonto.

Troubleshooting

  • Missing or invalid Organization ID: The API call will fail if the organization ID is not provided or incorrect. Ensure the correct organization identifier is used.
  • Invalid Attachment IDs: If attachment IDs do not correspond to existing attachments in Qonto, the API may reject the request. Verify attachment existence before referencing.
  • Authentication errors: Incorrect or expired credentials will cause authentication failures. Re-authenticate or update credentials as needed.
  • API rate limits or network issues: Requests may fail due to rate limiting or connectivity problems. Implement retry logic or check network status.
  • Malformed input data: Required fields like invoice number, date, amount, currency, and attachment IDs must be correctly formatted; otherwise, the API will return validation errors.

Links and References

Discussion