Overview

The node "Nuvem Solution" integrates with the Nuvem Solution API, providing access to a wide range of business-related resources and operations. Specifically, for the resource Máquina (Machine), the Get All operation allows users to retrieve a paginated list of all machines available in the system.

This node is beneficial in scenarios where you need to automate workflows involving machine data management, such as inventory tracking, maintenance scheduling, or integration with other systems that require up-to-date machine information.

Practical example:
You can use this node to fetch all machines from your ERP system, then process or filter them within n8n to trigger alerts for upcoming maintenance or to synchronize machine data with another database or application.

Properties

These properties control pagination when fetching the list of machines.

Output

• The output is a JSON array containing machine objects retrieved from the API.
• Each item in the array represents a machine with its associated details as provided by the Nuvem Solution API.
• The exact structure of each machine object depends on the API response but typically includes identifiers, descriptions, and related metadata.
• The node does not output binary data.

Dependencies

• Requires an API key credential for authentication with the Nuvem Solution API.
• The node uses the base URL and credentials (software key, secret, user ID, user key) configured in the credentials section.
• The API token is managed internally with automatic renewal based on expiration.
• No additional external dependencies are required beyond the configured API credentials.

Troubleshooting

• Authentication failures:
  If the node throws errors related to authentication, verify that the API credentials (software key, secret, user ID, user key) are correct and have sufficient permissions.

• Pagination issues:
  If you receive empty results or fewer items than expected, check the Page and Page Size parameters to ensure they are set correctly.

• Unsupported operation error:
  This node supports only predefined operations per resource. Using an unsupported operation will result in an error indicating the operation is not supported.

• Network or API errors:
  Ensure the base URL is reachable and the API service is operational. Check network connectivity and firewall settings if requests fail.

Links and References

• Nuvem Solution API Documentation (Assumed official API docs; replace with actual link if available)
• n8n Documentation: Creating Custom Nodes
• Pagination concepts: REST API Pagination

Summary of execute() logic for Resource "Máquina" and Operation "Get All"

When the node executes with resource "maquina" and operation "getAll":

1. It retrieves the page and pageSize parameters from the node input.
2. Constructs a GET request to the endpoint ${baseUrl}/erp/maquinas with query parameters page and pageSize.
3. Sets HTTP headers including an Authorization Bearer token obtained via internal authentication.
4. Sends the request to the Nuvem Solution API.
5. Returns the JSON response containing the list of machines.

This flow enables efficient retrieval of machine data with pagination support.