Cloodo Project icon

Cloodo Project

Get data from Cloodo Worksuite API

Actions26

Overview

The "Project Invoices" operation within the "Project" resource of this node interacts with the Cloodo Worksuite API to retrieve invoice-related data for projects. This node is useful for users who want to programmatically access project invoice information such as payment records, proposals, milestones, or invoices themselves from the Cloodo platform.

Typical use cases include:

  • Fetching a list of invoices or payments associated with a specific project.
  • Filtering invoices by date ranges or limiting the number of results returned.
  • Integrating project financial data into other workflows or reporting tools.

For example, a user might configure this node to get all invoices for a project within a certain date range to generate financial reports or trigger notifications when new invoices are available.

Properties

Name Meaning
ID The unique identifier of the project or related entity (e.g., invoice) to fetch data for.
Page The page number of results to retrieve when fetching multiple records (pagination).
Additional Fields A collection of optional parameters to refine the query:
- Limit Limits the number of results returned. Options: 10, 25, 50.
- From Date Start date filter for the query in string format (e.g., "YYYY-MM-DD").
- To Date End date filter for the query in string format (e.g., "YYYY-MM-DD").

Output

The node outputs JSON data representing the requested project invoice information retrieved from the Cloodo API. The structure typically includes details about invoices, payments, proposals, or milestones depending on the exact operation invoked.

If binary data were involved (e.g., PDF invoice files), it would be included in the binary output field; however, based on the provided code and properties, the output is primarily JSON-formatted data describing project invoices and related financial records.

Dependencies

  • Requires an active connection to the Cloodo Worksuite API.
  • Users must provide valid API authentication credentials (an API key or token) configured in n8n to authorize requests.
  • The base URL for API requests is https://erp-amz.cloodo.com/v4.
  • The node expects JSON responses and sends requests with appropriate headers (Accept: application/json, Content-Type: application/json).

Troubleshooting

  • Invalid or missing ID: If the ID property is empty or incorrect, the API may return errors or no data. Ensure the correct project or invoice ID is provided.
  • Authentication errors: Missing or invalid API credentials will cause authorization failures. Verify that the API key/token is correctly set up in n8n credentials.
  • Pagination issues: Requesting pages beyond the available range may result in empty responses. Adjust the "Page" and "Limit" properties accordingly.
  • Date format errors: The "From Date" and "To Date" fields should be in a valid string date format (e.g., ISO 8601). Incorrect formats may cause the API to reject the request.
  • API rate limits or downtime: If the Cloodo API is unavailable or rate-limited, the node will fail to retrieve data. Check API status and retry later if needed.

Links and References

Discussion