API Conta Azul

Overview

This node integrates with the Conta Azul API, a financial and business management platform. Specifically, the "Buscar centros de custos" (Search cost centers) operation allows users to query cost centers by name or code, filter them by status (active, inactive, or all), and paginate through results.

This operation is useful for businesses that want to automate retrieval of their cost center data for reporting, accounting, or integration with other systems. For example, a company could use this node to fetch active cost centers periodically to synchronize with an internal ERP system or to generate financial reports segmented by cost centers.

Properties

Output

The output is a JSON array containing the list of cost centers matching the search criteria and filters. Each item in the array represents a cost center with its details as returned by the Conta Azul API.

The node does not output binary data.

Dependencies

• Requires an API key credential for Conta Azul OAuth2 authentication.
• The node depends on the Conta Azul API being accessible and the credentials having permission to read cost center data.
• No additional environment variables are required beyond the configured API credentials.

Troubleshooting

• Common issues:

  • Invalid or expired API credentials will cause authentication errors.
  • Providing invalid pagination parameters (e.g., negative page numbers) may result in API errors.
  • Network connectivity problems can prevent successful API calls.

• Error messages:

  • "Operação não suportada" ("Operation not supported"): This error occurs if an unsupported operation is selected; ensure "Buscar centros de custos" is chosen.
  • Authentication failures typically indicate issues with the API key or OAuth token; reconfigure credentials if needed.
  • API rate limits or quota exceeded errors require checking Conta Azul account limits.

Links and References

• Conta Azul API Documentation
• n8n Documentation on Creating Custom Nodes