Nuvem SolutionInstall

Overview

The node interacts with the Nuvem Solution API to perform various operations related to different resources. Specifically, for the resource Saída and operation Include Quilometragem, it allows users to include mileage information into an output record associated with a service order. This is useful in scenarios where tracking vehicle or equipment mileage is necessary for maintenance, billing, or operational records.

For example, a workshop or fleet management system can use this node to log initial and final mileage readings for a service performed on a vehicle, along with any applicable discount percentages. This helps maintain accurate service records and supports cost calculations based on mileage.

Properties

Note: Although the provided properties JSON includes some fields like mecanicoId (mechanic ID), these are not relevant for the "Include Quilometragem" operation and thus omitted here.

Output

The node returns a JSON object representing the response from the Nuvem Solution API after including the mileage data. This typically contains confirmation details about the mileage inclusion, such as success status, updated mileage values, or error messages if the operation failed.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the Nuvem Solution API.
• Requires credentials containing:
  • Base URL of the API.
  • Software key.
  • Secret.
  • User ID.
  • User key.
• The node uses bearer token authentication obtained via an internal authentication request before making API calls.
• Proper configuration of these credentials in n8n is necessary for successful execution.

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 not expired.
• Invalid IDs: Errors may occur if the provided ID da Saída or Ordem de Serviço ID do not exist or are incorrect. Double-check these identifiers.
• Missing required parameters: Ensure all required fields (ID da Saída, KM Inicial, KM Final, etc.) are provided; otherwise, the API may reject the request.
• API connectivity issues: Network problems or incorrect base URL settings can cause request failures. Confirm network access and correct API endpoint configuration.
• Unexpected API responses: If the API changes or returns unexpected data, the node might fail. Check the API documentation or contact support for updates.

Links and References

• Nuvem Solution API Documentation (Assumed official API docs URL)
• n8n Documentation on Creating Custom Nodes
• General REST API usage best practices

This summary focuses exclusively on the "Saída" resource with the "Include Quilometragem" operation as requested, based on static analysis of the provided source code and property definitions.