CLIENTE

Limitaciones y Comportamientos Conocidos

Validación de Fecha de Nacimiento: Fechas inválidas (ej: 1998-04-31) pueden causar problemas. En POST, los datos inválidos se ignoran silenciosamente. En PUT, se devuelve un error explícito.

Longitud del Teléfono: Teléfonos con más de 20 caracteres pueden causar errores en la API. Recomendamos validar la longitud antes de enviar.

Tipo de client_id: El campo client_id siempre debe enviarse como string. Valores numéricos puros pueden causar errores en algunos escenarios.

Endpoints

Buscar clientes

GET /customer

Descripción: Devuelve todos los clientes registrados, pudiendo filtrar por nombre, correo electrónico, teléfono, CPF, id externo, entre otros.

GET /public/customer?token=TU_TOKEN_USUARIO&name=Maria HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: TU_API_KEY
Accept: */*

Respuestas:

• 200 OK: Devuelve la lista de clientes.
• 422 Unprocessable Entity: Parámetros inválidos.

Criar cliente

POST /customer

Descripción: Crea un nuevo cliente.

POST /public/customer HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: TU_API_KEY
Content-Type: application/json
Accept: */*

{
  "name": "Maria",
  "email": "[email protected]",
  "phone": "11999999999",
  "cpf": "12345678900"
}

Respuestas:

• 200 OK: Cliente creado con éxito.
• 400 Bad Request: Parámetros inválidos.

Buscar cliente por id

GET /customer/{id}

Descripción: Devuelve un cliente por id.

GET /public/customer/{id} HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: TU_API_KEY
Accept: */*

Respostas:

• 200 OK: Devuelve el cliente.
• 404 Not Found: Cliente no encontrado.

Editar cliente

PUT /customer/{id}

Descripción: Edita un cliente existente.

PUT /public/customer/{id} HTTP/1.1
Host: api.solucx.com.br
x-solucx-api-key: TU_API_KEY
Content-Type: application/json
Accept: */*

{
  "name": "Nuevo Nombre",
  "email": "[email protected]"
}

Respostas:

• 201 Success: Cliente editado con éxito.
• 400 Bad Request: Parámetros inválidos.