Superlogica icon

Superlogica

Consumir API do Superlogica Condomínios
Join our community

Actions42

Overview

This node integrates with the Superlogica Condomínios API to list delinquency (inadimplência) data for condominium units over a specified period. It is useful for property managers or administrators who need to monitor outstanding payments, track overdue invoices, and analyze financial delinquencies within their properties.

Typical use cases include:

  • Generating reports of all delinquent units in a condominium as of a certain date.
  • Filtering out entries that are under legal process or have agreements.
  • Obtaining summarized or detailed delinquency data including updated values and revenue information.
  • Paginating through large sets of delinquency records.

For example, a property manager could use this node to retrieve all units with unpaid fees as of the end of the previous month, excluding those already in legal proceedings, to prioritize collection efforts.

Properties

Name Meaning
ID do Condomínio The unique identifier of the condominium to query.
Posição Em (Data) Reference date for the query in MM/DD/YYYY format.
Sem Processo Whether to exclude invoices currently in judicial process (true/false).
Valores Atualizados por Composição Whether to include updated values calculated by composition (true/false).
Apenas Resumo Whether to return only a summary of the delinquency instead of full details (true/false).
Com Dados da Receita Whether to include revenue-related data in the response (true/false).
Tipo de Cobrança Type of charge to consider; default is "normal".
Sem Acordo Whether to exclude invoices that have an agreement (true/false).
ID da Unidade (Opcional) Optional: specific unit ID to filter the delinquency data.
Itens Por Página Number of items to return per request page (maximum 50).
Página Current page number for paginated results.

Output

The node outputs JSON objects representing delinquency data for the requested condominium and period. The structure includes detailed information about each delinquent unit or invoice, such as amounts owed, dates, status flags (e.g., in judicial process, has agreement), and optionally summarized data if requested.

If binary data were involved (not indicated here), it would typically represent files or documents related to the delinquency, but this node focuses on JSON data output.

Each output item corresponds to one input item processed, containing either the retrieved data or an error message if the operation failed.

Dependencies

  • Requires valid credentials for the Superlogica API, including an API URL, application token, and access token.
  • The node depends on the external Superlogica Condomínios API service being available and accessible.
  • No additional environment variables or n8n configurations beyond the API credentials are required.

Troubleshooting

  • Missing Credentials: If credentials are not provided or invalid, the node will throw an error indicating credentials are missing.
  • API Errors: Errors returned from the Superlogica API (e.g., invalid parameters, unauthorized access) will be surfaced as error messages in the node output.
  • Pagination Limits: Requesting more than 50 items per page may cause errors or truncated results; ensure Itens Por Página does not exceed 50.
  • Date Format: The Posição Em (Data) must be in MM/DD/YYYY format; incorrect formatting may lead to API rejection or empty results.
  • Filtering Flags: Using conflicting filters (e.g., excluding both judicial process and agreements) might result in no data returned; verify filter logic matches expectations.

To resolve common issues:

  • Double-check API credentials and permissions.
  • Validate input parameters, especially dates and IDs.
  • Use smaller page sizes when encountering timeouts or large datasets.
  • Review API documentation for any changes in parameter requirements.

Links and References

If you need further details on other operations or resources, feel free to ask!

Discussion