Nuvem SolutionInstall

Overview

This node integrates with the Nuvem Solution API to perform various operations related to customer management, among many other resources. Specifically, for the Cliente resource and the Create Juridico operation, it allows users to create a new legal (juridical) customer in the system by sending a JSON request body with the customer's details.

This node is beneficial in scenarios where businesses need to automate the creation of customer records in their ERP or CRM systems, especially when dealing with legal entities (companies). For example, a company onboarding process can automatically create a legal customer profile in Nuvem Solution when a new client signs up.

Properties

The "Request Body" property expects a JSON string representing the customer data to be created. This typically includes fields such as company name, tax ID, address, contact information, and other relevant legal customer details as defined by the Nuvem Solution API.

Output

• The node outputs a JSON array containing the response from the Nuvem Solution API after creating the legal customer.
• The output JSON structure corresponds directly to the API's response for creating a juridical customer, which usually includes the newly created customer's ID, status, and any additional metadata returned by the API.
• There is no binary data output for this operation.

Dependencies

• Requires an active connection to the Nuvem Solution API.
• Requires credentials including:
  • Base URL of the API
  • Software key
  • Secret
  • User ID
  • User Key
• These credentials must be configured in n8n prior to using the node.
• The node uses bearer token authentication obtained via these credentials.

Troubleshooting

• Authentication failures: If the node throws errors about authentication, verify that the API credentials (software key, secret, user ID, user key) are correct and have not expired.
• Invalid JSON in Request Body: Ensure the JSON provided in the "Request Body" property is well-formed. Malformed JSON will cause the request to fail.
• Unsupported operation error: This node supports only predefined operations. Using an unsupported operation value will result in an error.
• API errors: Any errors returned by the Nuvem Solution API (e.g., validation errors, missing required fields) will be passed through. Check the API documentation for required fields and constraints.
• Network issues: Ensure the n8n instance has network access to the configured base URL of the Nuvem Solution API.

Links and References

• Nuvem Solution API Documentation (general reference; specific endpoints may require login)
• n8n documentation on HTTP Request Node for understanding how API calls are made internally.

Summary of execute() logic for Cliente - Create Juridico:

• Reads input items.
• Retrieves API credentials.
• Authenticates to get a bearer token.
• For each input item:
  • Checks if resource is "cliente" and operation is "createJuridico".
  • Parses the "requestBody" JSON parameter.
  • Sends a POST request to ${baseUrl}/erp/crm/clientes/juridico with the parsed JSON body.
  • Collects the API response.
• Returns all responses as JSON array output.