Actions16
- Buscar serviço por filtro
- Buscar serviço por ID
- Buscar venda por filtro
- Buscar venda por ID
- Buscar pessoas por filtro
- Buscar pessoa por ID
- Buscar centros de custos
- Buscar categorias
- Buscar contas financeiras
- Buscar produtos por filtro
- Buscar receitas por filtro
- Buscar despesas por filtro
- Buscar parcela por ID
- Criar produto
- Criar pessoa
- Criar venda
Overview
This node integrates with the Conta Azul API, a financial and business management platform. It allows users to perform various operations such as searching for services, sales, people, cost centers, categories, financial accounts, products, revenues, expenses, installments, and also creating products, people, and sales.
Specifically, the "Buscar pessoa por ID" (Search person by ID) operation retrieves a summary of a person's record using their unique ID (UUID). This is useful in scenarios where you need to fetch detailed information about a specific client, supplier, or contact registered in Conta Azul, for example, to verify customer data before processing an order or updating records.
Properties
| Name | Meaning |
|---|---|
| ID da Pessoa | The unique identifier (UUID) of the person’s record to retrieve a summary from Conta Azul. |
Output
The node outputs JSON data containing the details of the requested person record fetched from the Conta Azul API. The structure typically includes personal information such as name, contact details, type of person (individual or company), profiles (client, supplier, transporter), address, and identification numbers (CPF/CNPJ).
If the node supports binary data output, it would be related to attachments or documents linked to the person, but this is not indicated in the provided code.
Dependencies
- Requires an OAuth2 API credential configured in n8n to authenticate requests to the Conta Azul API.
- Internet access to reach the Conta Azul API endpoints.
- The node depends on internal service modules (e.g.,
pessoas) that implement the actual API calls.
Troubleshooting
Common issues:
- Invalid or missing person ID (UUID) will cause the API call to fail or return no data.
- Authentication errors if the OAuth2 credentials are not set up correctly or have expired.
- Network connectivity problems preventing access to the Conta Azul API.
Error messages:
"Operação não suportada"("Operation not supported"): This error occurs if an unsupported operation value is passed; ensure the operation parameter is set to"getPersonById"for this use case.- API errors returned from Conta Azul (e.g., 404 Not Found if the person ID does not exist) should be handled by checking the input ID and API response.