Actions12
Overview
The "Cloodo Finance" node integrates with the Cloodo Worksuite API to retrieve financial data related to invoices, payments, and recurring transactions. Specifically, the Invoice - Get Many operation fetches multiple invoice records from the system, supporting pagination and filtering options.
This node is useful in scenarios where users need to:
- Retrieve a list of invoices for reporting or analysis.
- Filter invoices by date range or category.
- Search invoices by keywords or other criteria.
- Automate financial workflows by integrating invoice data into other systems.
For example, a user might use this node to pull all invoices issued within a specific month or to search for invoices related to a particular project category.
Properties
| Name | Meaning |
|---|---|
| Page | The page number of results to retrieve (pagination). Defaults to "1". |
| Additional Fields | Optional filters and search parameters: |
| - Search | A text string to search invoices by keyword. |
| - From Date | Start date to filter invoices from (inclusive). |
| - To Date | End date to filter invoices up to (inclusive). |
| - Category ID | Filter invoices by a specific category identifier. |
Output
The node outputs JSON data containing an array of invoice objects matching the query parameters. Each invoice object includes details such as invoice ID, date, amount, category, and other relevant metadata as provided by the Cloodo Worksuite API.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Cloodo Worksuite API.
- Needs an API authentication token credential configured in n8n to authorize requests.
- The base URL for API requests is
https://erp-amz.cloodo.com/v4. - The node sends and expects JSON-formatted data.
Troubleshooting
- Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect date formats in "From Date" or "To Date" fields may result in errors or empty responses.
- Requesting pages beyond available data may return empty results.
- Error messages:
- Authentication errors typically indicate invalid or expired API tokens; reconfigure credentials.
- Validation errors on query parameters suggest checking the format and values of filters like dates and category IDs.
- Network or timeout errors may require verifying connectivity to the API endpoint.
Links and References
- Cloodo Worksuite API Documentation (Assumed based on base URL, verify actual docs)
- n8n Documentation on Creating Custom Nodes