Superlogica icon

Superlogica

Consumir API do Superlogica Condomínios

Overview

This node integrates with the Superlogica Condomínios API to create a new supplier ("Fornecedor") record within a condominium management system. It is useful for property managers or administrators who need to automate adding suppliers to their condominium's database, ensuring consistent and up-to-date supplier information.

Typical use cases include:

  • Automatically registering new suppliers when onboarding vendors.
  • Synchronizing supplier data from external systems into Superlogica.
  • Streamlining supplier management workflows by integrating with other automation processes.

Properties

Name Meaning
ID do Condomínio The unique identifier of the condominium where the supplier will be registered.
Nome/Razão Social The full name or corporate name of the supplier.
CPF/CNPJ The Brazilian individual (CPF) or company (CNPJ) tax identification number (numbers only).
Email The email address of the supplier (optional).
Telefone The telephone number of the supplier (optional).
Celular The mobile phone number of the supplier (optional).
CEP The postal code (CEP) of the supplier's address (numbers only, optional).
Endereço The street address of the supplier (optional).
Número The street number of the supplier's address (optional).
Complemento Additional address details such as apartment or suite number (optional).
Bairro The neighborhood of the supplier's address (optional).
Cidade The city of the supplier's address (optional).
Estado The state abbreviation (sigla) of the supplier's address (optional).

Output

The node outputs an array of JSON objects, each representing the response from the Superlogica API after attempting to create a supplier. The JSON typically contains the newly created supplier's data as returned by the API, including identifiers and any metadata provided by Superlogica.

If an error occurs during execution and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message describing what went wrong.

No binary data output is produced by this node.

Dependencies

  • Requires valid credentials for the Superlogica API, including an application token and access token.
  • The node uses the Superlogica API endpoint, defaulting to https://api.superlogica.net/v2/condor if not overridden in credentials.
  • Proper configuration of these credentials in n8n is necessary for successful API communication.

Troubleshooting

  • Missing Credentials: If credentials are not provided or invalid, the node will throw an error indicating that credentials were not supplied.
  • API Errors: Errors returned by the Superlogica API (e.g., invalid CPF/CNPJ format, missing required fields) will cause the node to fail unless "Continue On Fail" is enabled.
  • Invalid Input Data: Ensure all required fields (ID do Condomínio, Nome/Razão Social, and CPF/CNPJ) are correctly filled and formatted.
  • Network Issues: Connectivity problems to the Superlogica API endpoint can cause timeouts or failures; verify network access and API availability.
  • Error Messages: When errors occur, the node returns messages that can help identify issues such as authentication failure, validation errors, or quota limits.

Links and References

Discussion