Nuvem SolutionInstall

Overview

This node integrates with the Nuvem Solution API to perform various operations related to customers, suppliers, and other business entities. Specifically, for the Cliente resource and the Get Fornecedores operation, it retrieves a paginated list of suppliers (fornecedores) filtered optionally by CPF/CNPJ and date ranges.

Typical use cases include:

• Fetching supplier data associated with customers for reporting or analysis.
• Integrating supplier information into workflows that require supplier validation or enrichment.
• Automating supplier data retrieval based on pagination and filters like date or identification numbers.

Example: A user wants to get all suppliers linked to customers, filtering by a specific CPF/CNPJ and within a certain date range, retrieving results page by page.

Properties

Output

The node outputs JSON data representing the list of suppliers matching the specified filters and pagination parameters. The structure corresponds directly to the API response from the endpoint:

GET /erp/crm/clientes/fornecedores?page={page}&pageSize={pageSize}&cpfCnpj={cpfCnpj}&startAt={startAt}&endAt={endAt}

The output JSON typically includes supplier details such as identifiers, names, contact info, and other relevant metadata as provided by the Nuvem Solution API.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for authenticating with the Nuvem Solution API.
• The node uses bearer token authentication obtained via a prior authentication step using software key, secret, user ID, and user key.
• The base URL for the API and credentials must be configured in n8n.
• Network access to https://api.nuvemsolution.com or the configured base URL is required.

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 parameter errors: Ensure that the CPF/CNPJ filter is correctly formatted (only alphanumeric characters) as the code strips non-alphanumeric characters before sending.
• Pagination issues: If no results are returned, check if the page number and page size are set appropriately and that the date filters do not exclude all data.
• API errors: Any unexpected API errors will be surfaced; check the error message for details and confirm the API service status.

Links and References

• Nuvem Solution API Documentation (general reference, actual docs URL may vary)
• Brazilian CPF/CNPJ format references for proper filtering input.

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.