Actions16
- Create Person
- Create Product
- Create Sale
- Search Categories
- Search Cost Centers
- Search Expenses By Filter
- Search Financial Accounts
- Search Installment By ID
- Search Person By ID
- Search Persons By Filter
- Search Products By Filter
- Search Revenues By Filter
- Search Sale By ID
- Search Sales By Filter
- Search Service By ID
- Search Services By Filter
Overview
The node integrates with the Conta Azul API to perform various operations related to business management, such as managing persons, products, sales, categories, cost centers, financial accounts, revenues, and expenses. Specifically, the "Search Categories" operation allows users to search for financial categories by name or code, filter by category type (Revenue or Expense), and paginate through results.
This node is beneficial in scenarios where you need to automate retrieval of categorized financial data from Conta Azul, for example:
- Fetching a list of revenue or expense categories to populate dropdowns in other workflows.
- Searching for specific categories by name or code to link transactions or reports.
- Paginating through large sets of categories for batch processing or synchronization.
Properties
| Name | Meaning |
|---|---|
| Search (Category) | Text to search categories by name or category code. |
| Type | Category type to filter by: "Receita" (Revenue) or "Despesa" (Expense). |
| Page (Category) | Page number of the results to retrieve (for pagination). |
| Page Size (Category) | Number of category items to return per page. |
Output
The node outputs JSON data containing the search results for categories. The structure typically includes an array of category objects matching the search criteria, along with pagination metadata such as total count, current page, and page size.
No binary data output is indicated for this operation.
Dependencies
- Requires an OAuth2 API credential configured for Conta Azul to authenticate requests.
- Depends on the Conta Azul API service being available and accessible.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
Common Issues:
- Invalid or expired API credentials will cause authentication failures.
- Providing invalid page numbers or sizes may result in empty responses or errors.
- Network connectivity issues can prevent successful API calls.
Error Messages:
"Operation not supported": This error occurs if an unsupported operation is requested; ensure the operation parameter is set correctly to "getCategories".- Authentication errors usually indicate problems 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