Imobzi icon

Imobzi

Interagir com a API da Imobzi
Join our community

Actions62

Overview

This node integrates with the Imobzi API to interact with financial account data under the "Financeiro" resource. Specifically, the "Get Many" operation allows users to retrieve multiple financial account records from Imobzi, optionally filtered, ordered, and paginated.

Common scenarios for this node include:

  • Fetching a list of financial accounts for reporting or analysis.
  • Retrieving filtered financial account data based on specific criteria such as description or status.
  • Integrating financial account data into workflows that require batch processing or synchronization.

Practical example:

  • A user wants to get all financial accounts where the description contains "rent" and order the results by creation date, limiting to 20 results starting from the 10th record.

Properties

Name Meaning
Filtros Filters to apply when retrieving financial accounts. Each filter consists of:
- Campo Name or ID: The field name in the financial account to filter by (loaded dynamically).
- Operador: Comparison operator to use. Options: starts_with, contains, neq, eq, gte, gt, lte, lt, not_contains, ends_with.
- Valor: The value to compare against.
Order By Field name to order the results by.
Limit Maximum number of results to return (minimum 1, default 50).
Offset Number of items to skip before starting to collect the result set (minimum 0, default 0).

Output

The output is an array of JSON objects representing financial account records retrieved from the Imobzi API. Each item corresponds to one financial account and includes all fields returned by the API under the json property.

Example structure of each output item (fields depend on Imobzi API response):

{
  "id": 123,
  "description": "Account description",
  "status": "active",
  "created_at": "2023-01-01T12:00:00Z",
  ...
}

No binary data is output by this node.

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests to the Imobzi API.
  • The node uses the Imobzi REST API endpoints corresponding to financial accounts (/financial/accounts).
  • Network access to the Imobzi API service is required.

Troubleshooting

  • Unsupported Resource Error: If the resource parameter is set incorrectly, the node will throw an error indicating the resource is not supported. Ensure "financeiro" is selected for financial accounts.
  • Invalid Operation Error: Only certain operations are supported; using an unsupported operation will cause an error.
  • API Authentication Errors: If the API key or authentication token is missing or invalid, requests will fail. Verify credentials in n8n settings.
  • Filter Misconfiguration: Filters must specify valid field names and operators. Using incorrect field names or unsupported operators may result in empty results or API errors.
  • Pagination Issues: Setting limit or offset incorrectly (e.g., negative numbers) may cause errors or unexpected results. Use minimum values as specified.

Links and References

Discussion