Actions18
- Create Person
- Create Product
- Create Sale
- Create Service
- 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 Product By ID
- Search Products By Filter
- Search Revenues By Filter
- Search Sale By ID
- Search Sales By Filter
- Search Service By ID
- Search Services By Filter
Create Person
AI-generatedOverview
This node operation allows creating a new person record in the Conta Azul system. It supports creating different types of persons such as Individual, Legal Entity, or Foreign. The node collects detailed information about the person including name, profiles (e.g., Customer, Supplier, Carrier), address details (CEP, street, number, neighborhood, city, state, country), and additional optional fields like email, phone, and address complement. It also supports entering CPF for individuals and CNPJ for legal entities. This operation is useful for automating the addition of new contacts or clients into the Conta Azul platform, facilitating customer management, supplier registration, or carrier information storage.
Use Case Examples
- Creating a new customer record with full address and contact details.
- Adding a supplier with legal entity information and CNPJ.
- Registering a foreign person with minimal required details.
Properties
| Name | Meaning |
|---|---|
| Person Type | Type of the person to create (Individual, Legal Entity, Foreign). Required. |
| Name | Full name of the person. Required. |
| Profiles | Profiles associated with the person such as Customer, Supplier, or Carrier. Required. |
| CEP | Postal code of the person's address. Required. |
| Street | Street name of the person's address. Required. |
| Number | Street number of the person's address. Required. |
| Neighborhood | Neighborhood of the person's address. Required. |
| City | City of the person's address. Required. |
| State | State of the person's address (e.g., SP, RJ, MG). Required. |
| Additional Fields (Person) | Optional additional fields for the person such as email, phone, and address complement. |
| CPF | CPF number of the physical person. Only shown if Person Type is Individual. |
| CNPJ | CNPJ number of the legal person. Only shown if Person Type is Legal Entity. |
| Country | Country of the person's address. Fixed to Brasil. Required. |
Output
JSON
id- Unique identifier of the created person.nome- Name of the created person.tipo_pessoa- Type of the person created (Individual, Legal Entity, Foreign).tipo_perfil- Profiles associated with the person.enderecocep- Postal code of the person's address.logradouro- Street name of the person's address.numero- Street number of the person's address.bairro- Neighborhood of the person's address.cidade- City of the person's address.estado- State of the person's address.pais- Country of the person's address.
email- Email address of the person, if provided.telefone- Phone number of the person, if provided.complemento- Address complement, if provided.cpf- CPF of the person if type is Individual.cnpj- CNPJ of the person if type is Legal Entity.
Dependencies
- Conta Azul API OAuth2 credentials
Troubleshooting
- Ensure all required fields are filled, especially address and person type fields.
- CPF must be provided if the person type is Individual; CNPJ must be provided if the person type is Legal Entity.
- The API credentials must be valid and have permissions to create persons in Conta Azul.
- Common errors include missing required fields or invalid document numbers (CPF/CNPJ). Verify input formats.
Links
- Conta Azul API Documentation - Official API documentation for Conta Azul, useful for understanding the person creation endpoint and required fields.