Conta Azul icon

Conta Azul

Allows interaction with Conta Azul API
Join our community

Actions4

Overview

This node integrates with the Conta Azul API to manage customers, contracts, and sales data. Specifically, for the Customer Create operation, it allows users to create a new customer record in the Conta Azul system by providing detailed customer information such as name, contact details, identification documents, and address.

Common scenarios where this node is beneficial include automating customer onboarding processes, synchronizing customer data from other systems into Conta Azul, or bulk-creating customers based on external data sources.

For example, a business could use this node to automatically add new customers collected from a web form into their Conta Azul account, ensuring that all relevant customer details are captured and stored consistently.

Properties

Name Meaning
Access Token A required API authentication token to authorize requests to the Conta Azul API.
Customer Name The full name of the customer to be created (required).
Company Name The company name associated with the customer (optional).
Email Customer's email address (optional).
Business Phone Customer's business phone number (optional).
Mobile Phone Customer's mobile phone number (optional).
Person Type Type of person: "Natural (Pessoa Física)" or "Legal (Pessoa Jurídica)".
Document (CPF/CNPJ) Tax identification number (CPF for individuals, CNPJ for companies) (optional).
Identity Document (RG) Additional identity document number (optional).
State Registration Number State registration number (optional).
State Registration Type Type of state registration: "No Contributor", "Contributor", or "Immune Contributor".
City Registration Number City registration number (optional).
Date of Birth Customer's date of birth (optional).
Notes Additional notes about the customer (optional).
Contacts JSON array of contact objects related to the customer, each with fields like name, phone, email, job title. Example: [{"name": "John", "business_phone": "9999-9999", "email": "john@example.com", "job_title": "Manager"}] (optional).
ZIP Code Postal code of the customer's address (optional).
Street Street name of the customer's address (optional).
Number Street number of the customer's address (optional).
Complement Additional address information (optional).
Neighborhood Neighborhood of the customer's address (optional).

Output

The node outputs an array of JSON objects representing the newly created customer(s) as returned by the Conta Azul API. Each object contains the full customer data including all fields sent and any additional metadata provided by the API.

If multiple input items are processed, the output will contain corresponding entries for each created customer.

The node does not output binary data.

Dependencies

  • Requires an active Conta Azul API access token for authentication.
  • The node makes HTTP requests to the Conta Azul REST API endpoints.
  • No additional external dependencies beyond standard n8n environment and Conta Azul API access.

Troubleshooting

  • API Request failed: This error indicates that the request to the Conta Azul API was unsuccessful. Common causes include:

    • Invalid or expired access token: Ensure the access token is correct and has not expired.
    • Missing required fields: Verify that all mandatory properties (e.g., Customer Name) are provided.
    • Incorrect JSON format in the Contacts field: Make sure the contacts JSON is valid and properly formatted.
    • Network issues or Conta Azul service downtime.

  • Unsupported resource or operation: This error occurs if the node configuration specifies a resource or operation not supported by the node. Double-check that "Customer" resource and "Create" operation are selected.

Links and References

Discussion