Nuvem Solution icon

Nuvem Solution

Interact with Nuvem Solution API

Actions120

Produto → Get Saldo Por Filial

AI-generated

Overview

This node integrates with the Nuvem Solution API to retrieve product stock balance information filtered by branch (Filial). Specifically, the "Get Saldo Por Filial" operation under the "Produto" resource fetches the inventory balance of products for a specified branch within optional date ranges.

This node is useful in scenarios where businesses need to monitor or report on product stock levels at different branches or locations. For example, a retail chain can use this node to track inventory availability per store, enabling better stock management and replenishment decisions.

Properties

Name Meaning
Filial ID The numeric identifier of the branch (Filial) for which to retrieve product balances.
Start At Optional start date filter to limit the balance data from this date onward (ISO datetime).
End At Optional end date filter to limit the balance data up to this date (ISO datetime).

Output

The output is a JSON array containing the product stock balance data for the specified branch. Each item typically includes details about individual products and their respective stock quantities or balances as returned by the Nuvem Solution API endpoint /erp/estoque/produtos/saldoPorFilial/{filialId}.

The exact structure depends on the API response but generally includes product identifiers, stock quantities, and possibly timestamps or other metadata related to stock status.

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 the base URL and authentication tokens obtained via the configured credentials.
  • Network access to the Nuvem Solution API endpoints is necessary.
  • Proper configuration of the API credentials in n8n is required before using this node.

Troubleshooting

  • Authentication Failures: If the node throws errors related to authentication, verify that the API key credential is correctly set up with valid software key, secret, user ID, and user key.
  • Invalid Filial ID: Providing an incorrect or non-existent branch ID may result in empty responses or errors. Confirm the branch ID is valid.
  • Date Format Issues: Ensure that the "Start At" and "End At" dates are in proper ISO 8601 format. Incorrect formats might cause the API to reject the request.
  • API Rate Limits or Downtime: If requests fail intermittently, check for API rate limits or service availability issues on the Nuvem Solution side.
  • Error Messages: The node throws descriptive errors if the operation or resource is unsupported or if the API returns an error. Review the error message for clues and adjust parameters accordingly.

Links and References

Discussion