Nuvem SolutionInstall

Overview

This node integrates with the Nuvem Solution API to perform various operations related to customers ("Cliente") and other resources. Specifically, for the Cliente resource and the Create Endereco operation, it allows users to create a complementary address (endereço) for an existing customer by sending the required data to the API.

This node is beneficial in scenarios where you need to automate customer address management within your workflows, such as adding new addresses to customer profiles in bulk or integrating address creation into larger CRM or ERP automation processes.

Practical example:
You have a list of customers and their new addresses stored in a database or spreadsheet. Using this node, you can automatically create these addresses in the Nuvem Solution system without manual entry, ensuring data consistency and saving time.

Properties

The Request Body property expects a JSON string representing the address data according to the API's expected schema for creating a customer address.

Output

The node outputs a JSON array containing the response from the Nuvem Solution API after attempting to create the address. This typically includes details of the newly created address or error information if the creation failed.

No binary data output is involved in this operation.

Dependencies

• Requires an API key credential for authenticating with the Nuvem Solution API.
• The node uses the base URL and authentication tokens obtained from the credentials to make authorized HTTP requests.
• Proper configuration of the API credentials in n8n is necessary before using this node.

Troubleshooting

• Common issues:

  • Invalid or missing Cliente ID may cause the API to reject the request.
  • Malformed JSON in the Request Body will result in parsing errors or API validation failures.
  • Authentication failures due to incorrect API credentials or expired tokens.
  • Network connectivity issues preventing access to the Nuvem Solution API endpoint.

• Error messages and resolutions:

  • "Authentication failed: Invalid response from server": Check that the API credentials are correct and have not expired.
  • "The operation "createEndereco" is not supported!": Ensure the operation and resource parameters are correctly set to "Create Endereco" under "Cliente".
  • JSON parsing errors: Verify that the Request Body contains valid JSON.
  • HTTP errors (e.g., 400 Bad Request, 401 Unauthorized): Review the input parameters and credentials.

Links and References

• Nuvem Solution API Documentation (general reference; specific endpoints used by the node are under /erp/crm/clientes/{clienteId}/endereco)
• n8n documentation on HTTP Request Node for understanding how API calls are made internally.

If you need further details about the JSON structure expected in the Request Body or examples of address data, please consult the official Nuvem Solution API docs or provide sample data for more tailored guidance.