Nuvem Solution icon

Nuvem Solution

Interact with Nuvem Solution API

Actions120

Cliente → Get Parque Maquinas

AI-generated

Overview

This node interacts with the Nuvem Solution API to retrieve and manage customer-related data, specifically focusing on the "Cliente" resource and the "Get Parque Maquinas" operation. The "Get Parque Maquinas" operation lists the machine park associated with a specific customer, optionally filtered by date range and paginated.

Typical use cases include:

  • Fetching a list of machines owned or used by a particular customer.
  • Filtering the machine park data by date ranges to analyze historical or recent machine usage.
  • Paginating results when the machine park is large to efficiently handle data in workflows.

For example, a business could use this node to automate reporting on the equipment fleet of their customers or integrate machine park data into CRM or ERP systems for better asset management.

Properties

Name Meaning
Cliente ID The unique identifier (number) of the customer whose machine park is to be retrieved.
Page The page number for pagination of results (default is 1).
Page Size The number of items per page in the paginated response (default is 20).
Start At Optional start date filter (date-time) to limit results from a specific date onward.
End At Optional end date filter (date-time) to limit results up to a specific date.

Output

The output is a JSON array containing the machine park data for the specified customer. Each item in the array represents a machine entry associated with the customer, including details as provided by the Nuvem Solution API.

The structure typically includes fields such as machine identifiers, descriptions, status, and possibly timestamps related to the machine's association with the customer, depending on the API response.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Nuvem Solution API.
  • The node expects valid credentials configured in n8n with access to the Nuvem Solution service.
  • Network connectivity to the Nuvem Solution API endpoint is necessary.
  • The base URL and authentication tokens are managed internally by the node using the provided credentials.

Troubleshooting

  • Authentication Failures: If the node returns errors related to authentication, verify that the API key credential is correctly configured and has not expired.
  • Invalid Cliente ID: Providing an incorrect or non-existent customer ID will result in empty or error responses. Ensure the Cliente ID is valid.
  • Pagination Issues: If too many results are returned or none appear, check the Page and Page Size parameters to ensure they are set appropriately.
  • Date Filter Format: The Start At and End At properties must be valid ISO 8601 date-time strings. Incorrect formats may cause the API to reject the request.
  • API Endpoint Errors: Network issues or API downtime can cause request failures. Check connectivity and API status if errors persist.

Links and References

Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion