Overview

This node integrates with the Nuvem Solution API to perform various operations related to salespersons ("Vendedor") and other resources. Specifically, for the Vendedor resource with the Get Carteira operation, it retrieves the wallet information of a salesperson by their ID.

This functionality is useful in scenarios where you need to fetch detailed wallet or portfolio data associated with a specific salesperson, such as tracking sales performance, commissions, or assigned clients.

Practical example:
You have a workflow that processes sales data and needs to enrich it with the current wallet details of a salesperson identified by their ID. Using this node operation, you can dynamically retrieve that data from the Nuvem Solution system and use it downstream in your automation.

Properties

Output

The output of this operation is a JSON object representing the wallet details of the specified salesperson. The exact structure depends on the API response but typically includes information about the salesperson's assigned clients, sales targets, commissions, or other wallet-related data.

The node returns this data as a JSON array (even if a single object), making it easy to use in subsequent n8n nodes.

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
• These credentials must be configured in n8n before using the node.

Troubleshooting

• Authentication errors:
  If authentication fails, ensure that the provided software key, secret, user ID, and user key are correct and have sufficient permissions.

• Invalid Vendedor ID:
  Providing an invalid or non-existent salesperson ID will likely result in an error or empty response. Verify the ID before running the node.

• API connectivity issues:
  Network problems or incorrect base URL configuration can cause request failures. Confirm network access and correct API endpoint.

• Unexpected API responses:
  If the API changes or returns unexpected data, the node might throw errors. Check the API documentation or contact support.

Links and References

• Nuvem Solution API Documentation (generic link, replace with actual if available)
• n8n Documentation: Creating Custom Nodes
• REST API concepts: RESTful API Design

Summary of execute() logic for Resource "Vendedor" and Operation "Get Carteira"

• The node authenticates with the Nuvem Solution API using stored credentials.
• It constructs a GET request to the endpoint:
  /erp/crm/vendedores/{vendedorId}/carteiras
• It sends the request with the appropriate authorization header.
• The response JSON is returned as the node output.

This allows retrieving the wallet information for the given salesperson ID.