Nuvem Solution icon

Nuvem Solution

Interact with Nuvem Solution API

Actions120

Nota Fiscal → Get All

AI-generated

Overview

This node integrates with the Nuvem Solution API to retrieve invoice (Nota Fiscal) data. Specifically, the "Get All" operation under the "Nota Fiscal" resource allows users to fetch a paginated list of invoices with various filtering options such as branch (filial), issue date range, posting date range, and customer identification (CNPJ/CPF).

Use cases include:

  • Retrieving all invoices issued within a specific date range for reporting or auditing.
  • Filtering invoices by branch or customer to analyze sales or financial data.
  • Automating invoice data extraction for integration with other systems like accounting or ERP.

Example: Fetching all invoices from branch 5 issued between January 1 and January 31, 2024, with a page size of 50 items.

Properties

Name Meaning
Page Page number for pagination (default: 1).
Page Size Number of items per page (default: 20).
Filial Branch ID to filter invoices by (default: 0 means no branch filter).
Data Emissão Inicial Initial issue date filter (start date for invoice issue date).
Data Emissão Final Final issue date filter (end date for invoice issue date).
Data Lançamento Inicial Initial posting date filter (start date for invoice posting date).
Data Lançamento Final Final posting date filter (end date for invoice posting date).
CNPJ/CPF Cliente Customer's CNPJ or CPF identifier to filter invoices by customer.

Output

The output is a JSON array where each item represents an invoice record retrieved from the Nuvem Solution API. The structure corresponds directly to the API response for invoices, typically including fields such as invoice number, issue date, posting date, customer details, amounts, and status.

No binary data output is provided by this operation.

Dependencies

  • Requires an API key credential for Nuvem Solution API authentication.
  • The node uses bearer token authentication obtained via the configured credentials.
  • The base URL for the API and authentication tokens are managed internally.
  • No additional external dependencies beyond the Nuvem Solution API.

Troubleshooting

  • Authentication failures: If the node throws errors related to authentication, verify that the API key credential is correctly configured and valid.
  • Invalid parameter values: Ensure date filters are in proper ISO 8601 format and numeric IDs are valid integers.
  • Pagination issues: If no results are returned, check that the page and page size parameters are set appropriately and that filters do not exclude all data.
  • API errors: Errors from the API will be surfaced; review error messages for hints on invalid requests or server issues.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error messages in the output.

Links and References

Discussion