n8n-nodes-contaazul
This is an n8n community node that allows integration with the Conta Azul API in your workflows.
Conta Azul is a business management platform that offers solutions for financial control, sales, products, services, and customer management. This node allows you to automate operations such as sales searches, product creation, customer management, and financial queries.
n8n is a workflow automation platform with fair-code license.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Version History
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
Services
- Search service by filter: Lists services with text search filters and pagination
- Search service by ID: Gets details of a specific service
- Create service: Creates a new service
Sales
- Search sale by filter: Lists sales with text search filters and pagination
- Search sale by ID: Gets details of a specific sale
- Create sale: Creates a new sale with items, customer, and payment method
People - Customers/Suppliers
- Search people by filter: Lists customer/supplier people with search filters
- Search person by ID: Gets details of a specific person
- Create person: Creates a new customer/supplier person
Products
- Search products by filter: Lists products with search filters
- Search product by id : Get details of a specific product
- Create product: Creates a new product
Financial
- Search financial accounts: Lists all financial accounts
- Search revenues by filter: Lists revenues with filters
- Search expenses by filter: Lists expenses with filters
- Search installment by ID: Gets details of a specific installment
- Search categories: Lists all available categories
- Search cost centers: Lists all cost centers
Credentials
To use this node, you need a Conta Azul account and configure OAuth2 credentials.
Prerequisites
- Have an active Conta Azul account
- Access the Conta Azul developer panel
- Create an application to get the Client ID and Client Secret
Credential Configuration
- In n8n, go to Settings > Credentials
- Click Add Credential
- Select Conta Azul OAuth2 API
- Fill in the fields:
- Client ID: Your Conta Azul Client ID
- Client Secret: Your Conta Azul Client Secret
- Scope:
openid profile aws.cognito.signin.user.admin(default) - Auth URL:
https://api-v2.contaazul.com/oauth/authorize(default) - Access Token URL:
https://api-v2.contaazul.com/oauth/token(default)
- Click Save and authorize the application
Compatibility
- Minimum n8n version: 1.0.0
- Tested versions: 1.0.0, 1.1.0, 1.2.0
- Node.js: >=20.15
Usage
Example: Search Recent Sales
- Add the Conta Azul node to your workflow
- Configure credentials
- Select the Search sale by filter operation
- Configure search parameters (optional)
- Execute the workflow
Example: Create a New Sale
- Add the Conta Azul node to your workflow
- Configure credentials
- Select the Create sale operation
- Fill in required data:
- Customer ID
- Payment method
- Sale items
- Execute the workflow
Example: Sync Products
- Use the Conta Azul node with Search products by filter operation
- Connect with other nodes to process data
- Use webhooks for automatic synchronization
Resources
Version History
v0.3.2
- Fixed n8n-workflow dependency configuration
- Removed postinstall script
- Removed resolutions and overrides
- Updated to latest n8n-workflow version
v0.3.1
- Initial implementation of the node
- Support for basic operations: search services, sales, people, products, categories, cost centers, and financial
- Integration with Conta Azul OAuth2