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
This node integrates with the Conta Azul API to perform various operations related to business management, such as managing sales, products, persons, financial accounts, and more. Specifically, the "Search Sales By Filter" operation allows users to search for sales records filtered by customer name, sale number, or customer email, with pagination support.
This node is beneficial in scenarios where you need to automate retrieval of sales data from Conta Azul based on specific search criteria, enabling workflows like sales reporting, customer follow-up, or integration with other systems.
Example use cases:
- Retrieve a paginated list of sales matching a customer's name or email.
- Automate sales data extraction for analytics or CRM updates.
- Filter sales records dynamically during workflow execution.
Properties
| Name | Meaning |
|---|---|
| Text Search (Sale) | Text search filter applied to customer name, sale number, or customer email. |
| Page (Sale) | The page number of the results to retrieve (pagination). |
| Page Size (Sale) | Number of sales items to return per page (pagination size). |
Output
The node outputs JSON data containing the list of sales that match the provided filter criteria. Each item in the output typically includes details about individual sales such as sale identifiers, customer information, sale date, status, payment details, and other relevant sale attributes.
No binary data output is indicated for this operation.
Dependencies
- Requires an active Conta Azul API OAuth2 credential configured in n8n for authentication.
- Depends on the Conta Azul API service being accessible and the user having appropriate permissions to query sales data.
Troubleshooting
Common issues:
- Invalid or expired API credentials will cause authentication failures.
- Providing invalid pagination parameters (e.g., negative page numbers) may result in errors or empty responses.
- Network connectivity issues can prevent successful API calls.
Error messages:
"Operation not supported": This error occurs if an unsupported operation value is set; ensure the operation is correctly set to "Search Sales By Filter".- API errors returned from Conta Azul (e.g., unauthorized, bad request) should be checked for correct input parameters and valid credentials.
Links and References
- Conta Azul API Documentation
- n8n documentation on OAuth2 Credentials