Gestor Clientes Max - Cliente icon

Gestor Clientes Max - Cliente

Gerenciar clientes: criar, buscar, atualizar e deletar clientes via API. Use para operações relacionadas a cadastro de clientes.

Actions4

Overview

This node, "Gestor Clientes Max - Cliente," manages client records through an API. It supports creating, retrieving, updating, and deleting clients. The "Create" operation allows users to add new clients with detailed personal and payment information.

Common scenarios include:

  • Adding new clients to a customer management system.
  • Automating client registration workflows.
  • Integrating client data collection into broader business processes.

Practical example: Automatically create a new client record when a form is submitted on a website, including their contact details, CPF (Brazilian individual taxpayer registry identification), birth date, consultation price, and payment status.

Properties

Name Meaning
User ID ID of the user creating the client; mandatory for Super Admin users.
Nome Client's full name; required field.
Email Client's email address.
Telefone Client's phone number.
CPF Client's CPF number (Brazilian tax ID).
Data de Nascimento Client's birth date in YYYY-MM-DD format.
Endereço Full address of the client.
Preço da Consulta Consultation price in Brazilian reais (BRL).
Status de Pagamento Payment status with options: "A Pagar" (To Pay), "Pago" (Paid), "Cancelado" (Cancelled).
Observações Additional notes or remarks about the client.

Output

The node outputs JSON data representing the created client object as returned by the API. This includes all the fields sent during creation plus any additional metadata or identifiers assigned by the backend service.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Gestor Clientes Max API.
  • The node uses HTTP requests to communicate with the external API endpoint specified in the credentials.
  • Proper configuration of the API base URL and authentication token is necessary in n8n credentials settings.

Troubleshooting

  • Common issues:

    • Missing required fields such as "User ID" or "Nome" will cause errors.
    • Incorrect API key or expired token will result in authentication failures.
    • Invalid date formats for "Data de Nascimento" may cause request rejection.

  • Error messages:

    • "Unknown operation: create" indicates the operation parameter was not correctly set.
    • HTTP errors from the API (e.g., 400 Bad Request) usually mean invalid or incomplete input data.

  • Resolutions:

    • Ensure all required properties are provided and correctly formatted.
    • Verify API credentials and permissions.
    • Use ISO date format (YYYY-MM-DD) for birth dates.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion