Nuvem SolutionInstall

Overview

This node integrates with the Nuvem Solution API, providing access to a wide range of business-related resources and operations. Specifically, for the resource "Política de Prazo" (Term Policy), it supports operations such as retrieving a term policy by its ID.

The node is useful in scenarios where you need to automate or integrate term policy data retrieval within workflows, such as fetching payment terms or credit terms details from an ERP system to use in financial processes, reporting, or validation steps.

For example, you can use this node to:

• Retrieve detailed information about a specific term policy by its ID.
• Automate decision-making based on term policies in sales or finance workflows.
• Synchronize term policy data between systems.

Properties

This property is required when using the "Consultar por ID" operation on the "Política de Prazo" resource. It specifies the unique identifier of the term policy you want to fetch.

Output

The node outputs JSON data representing the term policy details retrieved from the Nuvem Solution API.

• The output JSON structure corresponds directly to the API response for the term policy identified by the given ID.
• The exact fields depend on the API but typically include attributes describing the term policy's conditions, durations, and related metadata.
• No binary data output is involved in this operation.

Example output (simplified):

{
  "id": 123,
  "name": "Standard Payment Terms",
  "description": "Net 30 days",
  "days": 30,
  "active": true,
  ...
}

Dependencies

• Requires an API key credential for authenticating with the Nuvem Solution API.
• The node uses OAuth-like token management internally, obtaining and caching an access token before making requests.
• The base URL and credentials (software key, secret, user ID, user key) must be configured properly in the node credentials.
• Network connectivity to the Nuvem Solution API endpoint is necessary.

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 ID errors: When querying by term policy ID, ensure the ID exists and is valid in the target system.
• API request errors: Network issues or incorrect base URL configuration can cause request failures. Confirm the base URL and network access.
• JSON parsing errors: Input properties like IDs must be correctly typed (number) and provided; malformed inputs may cause errors.

If the node returns an error message indicating an unsupported operation or unknown resource, double-check that the selected resource and operation match those supported by the node.

Links and References

• Nuvem Solution API Documentation (general reference, actual docs URL may vary)
• n8n documentation on Creating Custom Nodes
• REST API best practices for authentication and error handling

This summary focuses on the "Política de Prazo" resource and the "Consultar por ID" operation as requested.