Superlogica icon

Superlogica

Consumir API do Superlogica Condomínios

Overview

This node integrates with the Superlogica Condomínios API to generate payment slips ("boletos") for residents within a condominium. The "Gerar Boleto" operation under the "Boleto" resource allows users to create a new boleto specifying details such as the resident, amount, due date, description, and accounting information.

Common scenarios include automating billing processes in property management systems, generating payment requests for residents, or integrating boleto generation into financial workflows.

For example, a property manager can use this node to automatically issue monthly payment slips to residents based on their outstanding balances, streamlining collections and record-keeping.

Properties

Name Meaning
ID do Condomínio Identifier of the condominium where the boleto will be generated.
ID do Morador Identifier of the resident for whom the boleto is being generated.
Valor Amount of the boleto to be paid (use dot as decimal separator).
Data de Vencimento Due date of the boleto in MM/DD/YYYY format.
Descrição Description or purpose of the boleto.
ID da Conta Contábil Identifier of the accounting account associated with the boleto.

Output

The node outputs an array of JSON objects, each representing the result of the boleto generation request. Each output item contains the boleto data returned by the Superlogica API, which typically includes identifiers, status, and possibly URLs or codes related to the generated boleto.

If an error occurs during execution and the node is configured to continue on failure, the output will contain an error field with the error message.

No binary data output is indicated for this operation.

Dependencies

  • Requires valid credentials for the Superlogica API, including an API URL (defaulting to https://api.superlogica.net/v2/condor), an application token, and an access token.
  • The node depends on the external Superlogica Condomínios API service to perform boleto generation.
  • Proper configuration of these credentials in n8n is necessary for successful operation.

Troubleshooting

  • Missing Credentials: If credentials are not provided or invalid, the node throws an error indicating that credentials were not supplied. Ensure that the API authentication tokens are correctly set up in n8n.
  • Invalid Input Data: Providing incorrectly formatted dates (not MM/DD/YYYY) or invalid numeric values for the amount may cause API errors. Validate input formats before execution.
  • API Errors: Network issues or API-side validation failures will result in error messages returned from the API. Review the error message in the output to identify the cause.
  • Continue On Fail Behavior: When enabled, the node will output error messages per item instead of stopping execution, allowing partial processing of multiple inputs.

Links and References

Discussion