Actions12
Overview
The node "Cloodo Finance" integrates with the Cloodo Worksuite API to retrieve financial data related to invoices, payments, and recurring transactions. Specifically, for the Recurring - Get Many operation, it fetches a paginated list of recurring financial entries. This is useful for scenarios where users want to analyze or report on multiple recurring transactions over time, filter them by date ranges, categories, or search terms.
Practical examples include:
- Retrieving all recurring subscriptions active within a specific date range.
- Searching recurring transactions by keywords or category IDs.
- Paginating through large sets of recurring financial records for batch processing or export.
Properties
| Name | Meaning |
|---|---|
| Page | The page number of results to retrieve (pagination). Defaults to "1". |
| Additional Fields | Optional filters to refine the query: |
| - Search | A text string to search recurring entries by keyword. |
| - From Date | Start date to filter recurring entries from (inclusive). |
| - To Date | End date to filter recurring entries up to (inclusive). |
| - Category ID | Filter recurring entries by a specific category identifier. |
Output
The node outputs JSON data representing a list of recurring financial records matching the query parameters. Each item in the output array corresponds to a recurring transaction with its associated details as provided by the Cloodo Worksuite API.
If binary data were supported, it would typically represent file attachments or documents related to the recurring entries, but this node focuses on JSON data only.
Dependencies
- Requires an API key credential for authenticating requests to the Cloodo Worksuite API.
- The base URL for API requests is
https://erp-amz.cloodo.com/v4. - Proper configuration of the API key credential in n8n is necessary for successful authentication.
Troubleshooting
- Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Incorrect page numbers may result in empty responses if the page exceeds available data.
- Date filters must be in a valid format accepted by the API; otherwise, no results or errors may occur.
- Error messages:
- Authentication errors typically indicate invalid credentials—verify and update the API key.
- Validation errors on query parameters suggest incorrect formats or unsupported values—check input formatting.
- Network or timeout errors may require checking connectivity or API service status.
Links and References
- Cloodo Worksuite API Documentation (Assumed based on base URL, verify actual docs link)
- n8n documentation on Creating Custom Nodes