Conta Azul icon

Conta Azul

Allows interaction with Conta Azul API

Actions4

Overview

This node integrates with the Conta Azul API, enabling users to manage various resources such as Customers, Sales, and Contracts within the Conta Azul system. Specifically for the Customer resource with the list operation, it allows retrieving a list of customers optionally filtered by a customer document identifier.

Common scenarios include:

  • Fetching customer data for reporting or synchronization with other systems.
  • Filtering customers by their document number to find specific records.
  • Automating workflows that require up-to-date customer information from Conta Azul.

Example use case:

  • A business wants to automatically retrieve all customers or search for a customer by their document number to update their CRM system daily.

Properties

Name Meaning
Access Token The API authentication token required to authorize requests to the Conta Azul API.
Customer Document Optional filter to specify the customer's document number (e.g., CPF/CNPJ) to narrow down the list of customers returned.

Output

The node outputs JSON data representing the response from the Conta Azul API for the requested operation. For the Customer - list operation, the output JSON contains an array of customer objects matching the query parameters.

Each item in the output corresponds to a customer record retrieved from the API, including fields such as name, company name, contact details, and document identifiers.

No binary data is output by this node.

Dependencies

  • Requires an active Conta Azul account with API access.
  • Needs a valid API access token provided as an input property.
  • The node makes HTTP requests to the Conta Azul REST API endpoints.
  • No additional external libraries beyond those bundled with n8n are required.

Troubleshooting

  • API Request failed: [error message]
    This error indicates a failure in communicating with the Conta Azul API. Common causes include:

    • Invalid or expired access token: Ensure the token is correct and has not expired.
    • Network connectivity issues: Verify internet connection and firewall settings.
    • Incorrect parameter values: Check that the document number format matches Conta Azul's expectations.
    • API rate limits exceeded: Wait and retry later if too many requests were sent.

  • Unsupported resource or operation errors
    These occur if the node configuration specifies a resource or operation not implemented in the code. Confirm that "Customer" resource and "list" operation are selected correctly.

Links and References

Discussion