Marvee icon

Marvee

Get data from Marvee API

Actions2

Fluxo De Caixa → Consultar

AI-generated

Overview

This node integrates with the Marvee API to retrieve financial and business data. Specifically, for the "Fluxo De Caixa" (Cash Flow) resource with the "Consultar" (Consult) operation, it fetches cash flow information for a specified year. This is useful for businesses or financial analysts who want to review or analyze cash flow data over time.

Practical examples include:

  • Generating yearly cash flow reports.
  • Integrating cash flow data into dashboards or other automation workflows.
  • Comparing cash flow across different years to identify trends.

Properties

Name Meaning
Ano (year) The year for which to consult the cash flow data. Must be a number between 2000 and 2025.

Output

The node outputs an array of JSON objects representing the cash flow data for the specified year. Each object typically contains detailed financial metrics related to cash inflows and outflows, structured according to the Marvee API response format.

If the node supports binary data output (not indicated in the provided code), it would represent associated files or documents related to the cash flow, but this is not evident here.

Dependencies

  • Requires connection to the Marvee API via an API key credential configured in n8n.
  • The node depends on several internal action handlers, specifically the handleGetCashFlow function from the cash-flow actions module, which performs the actual API call and data processing.
  • No additional external dependencies are indicated.

Troubleshooting

  • Unsupported Operation Error: If you select an operation other than "Consultar" (get-cash-flow) for the "Fluxo De Caixa" resource, the node will throw an error indicating the operation is not supported. Ensure you use the correct operation name.
  • API Authentication Errors: If the API key credential is missing or invalid, the node will fail to authenticate with the Marvee API. Verify that the API key is correctly set up in n8n credentials.
  • Invalid Year Input: Providing a year outside the allowed range (2000–2025) may cause errors or unexpected results. Always input a valid year within this range.
  • General Execution Errors: Any other errors during execution will be wrapped and reported as execution errors with messages prefixed by "Erro na execução do nó Marvee". Check the underlying message for details.

Links and References

Discussion