Superlogica icon

Superlogica

Consumir API do Superlogica Condomínios
Join our community

Actions42

Overview

This node integrates with the Superlogica Condomínios API to add a new bank transaction ("Movimentação Bancária"). It allows users to record financial movements related to condominium bank accounts, such as income (Entrada) or expenses (Saída). This is useful for automating bookkeeping and financial management tasks within condominium administration workflows.

Typical use cases include:

  • Automatically logging payments or receipts into the condominium's bank account.
  • Recording expenses or other financial transactions linked to specific accounting categories.
  • Synchronizing external payment systems or financial software with Superlogica’s platform.

For example, when a payment is received from a resident, this node can be used to add an "Entrada" transaction with details like date, amount, description, and associated accounting account.

Properties

Name Meaning
ID da Conta Bancária Identifier of the bank account where the transaction will be recorded.
ID do Condomínio Identifier of the condominium related to the transaction.
Descrição Description of the bank transaction (e.g., "Payment from Resident X").
Valor Amount of the transaction; decimal separator must be a dot (e.g., "1234.56").
Data da Movimentação Date of the transaction in MM/DD/YYYY format.
Tipo de Movimentação Type of transaction: "Entrada" (1) for income, "Saída" (2) for expense.
ID da Conta Contábil Identifier of the accounting account associated with this transaction.

Output

The node outputs an array of JSON objects, each representing the result of adding a bank transaction. Each output item corresponds to one input item processed.

  • The json field contains the response data from the Superlogica API about the created transaction, typically including identifiers, status, and details of the added movimentação bancária.
  • There is no binary data output.

Example output structure (simplified):

{
  "id": "transaction_id",
  "descricao": "Payment from Resident X",
  "valor": "1234.56",
  "dataMovimentacao": "MM/DD/YYYY",
  "tipoMovimentacao": "1",
  "idContaBancaria": "bank_account_id",
  "idContaContabil": "accounting_account_id",
  ...
}

Dependencies

  • Requires connection to the Superlogica Condomínios API.
  • Needs valid API credentials including an application token and access token.
  • The node expects these credentials to be configured in n8n prior to execution.
  • Uses the base URL https://api.superlogica.net/v2/condor by default unless overridden in credentials.

Troubleshooting

  • Missing Credentials: If API credentials are not provided or invalid, the node will throw an error indicating credentials are missing.
  • Invalid Date Format: The Data da Movimentação must be in MM/DD/YYYY format; incorrect formats may cause API errors.
  • Decimal Separator: The Valor property must use a dot as the decimal separator; using commas may lead to parsing errors.
  • API Errors: Any errors returned by the Superlogica API (e.g., invalid IDs, permission issues) will be surfaced as node errors.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output JSON.

Links and References

Discussion