Nuvem SolutionInstall

Overview

This node integrates with the Nuvem Solution API to perform various operations across multiple resources. Specifically, for the Produto resource and the Get By Codigos operation, it allows users to retrieve detailed product information by providing one or more product codes.

This operation is useful in scenarios where you have a list of product codes (e.g., SKUs or internal product identifiers) and want to fetch their corresponding product details from the Nuvem Solution system. For example, an e-commerce platform or inventory management system can use this node to synchronize product data or validate product codes against the central database.

Practical example: You have a comma-separated string of product codes like "ABC123, DEF456, XYZ789" and want to get detailed information about these products such as descriptions, stock levels, pricing, etc., directly from the ERP system.

Properties

Output

The output is a JSON array containing the product details returned by the Nuvem Solution API for each requested product code. Each item in the array corresponds to a product and includes all available fields provided by the API, such as product identifiers, descriptions, stock balances, prices, and other relevant product attributes.

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 OAuth-like token authentication internally, obtaining an access token before making requests.
• The base URL for the API and credentials (software key, secret, user ID, user key) must be configured in the node's credentials.
• Network connectivity to the Nuvem Solution API endpoint is required.

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 product codes: If no results are returned or errors occur, ensure the product codes are valid and correctly formatted (comma-separated, no extra spaces).
• API rate limits or downtime: Temporary API unavailability or rate limiting may cause request failures; retry after some time.
• Malformed input: The "Códigos" property must be a non-empty string of comma-separated codes; empty or malformed input will cause errors.
• Error messages: The node throws descriptive errors if the operation or resource is unsupported or if the API returns an error response. Review the error message for clues and check API documentation or credentials.

Links and References

• Nuvem Solution API Documentation (general reference)
• Nuvem Solution Authentication Guide (for setting up credentials)

Summary of execute() logic for Produto - Get By Codigos

• Reads the "codigos" parameter (string of comma-separated product codes).
• Splits the string into an array of trimmed codes.
• Sends a POST request to the endpoint /erp/estoque/produtos/codigos with JSON body { codigos: [...] }.
• Uses bearer token authentication obtained via prior authentication call.
• Returns the API response JSON as the node output.