Clientes de pensión

Los clientes de pensión son registros asociados a un establecimiento y se utilizan únicamente para crear y administrar pensiones.

Antes de crear una pensión, primero debe existir un cliente. Ese cliente será referenciado en la pensión mediante el campo establishment_customer_id.

Flujo recomendado

Crear cliente
    ↓
Obtener ID del cliente
    ↓
Crear pensión usando establishment_customer_id

¿Para qué sirve un cliente?

Un cliente permite identificar a la persona, empresa o usuario operativo que tendrá una pensión dentro de un establecimiento.

El cliente puede incluir:

Nombre completo.
Teléfono.
Correo electrónico.
Notas internas.
Establecimiento asociado.

Los clientes documentados en esta sección se utilizan para el módulo de pensiones. No representan usuarios de acceso al portal ni credenciales de integración.

Crear cliente

Ejemplo de datos para crear un cliente:

{
  "establishment_id": 6,
  "full_name": "Carlos Emiliano Gutierrez Del Razo",
  "phone": "7222470147",
  "email": "[email protected]",
  "notes": "Cliente mensual"
}

Listar clientes

Puedes listar los clientes de un establecimiento usando el parámetro establishment_id.

GET /api/customers?establishment_id=1

Este endpoint es útil para localizar el id del cliente antes de crear una pensión.

Actualizar cliente

La actualización de cliente es parcial.

Sólo se actualizan los campos enviados en la solicitud. Los campos omitidos conservan su valor actual.

{
  "phone": "7222470147",
  "notes": "Cliente mensual actualizado"
}

Referencia API

POST /api/customers

Crear cliente de pensión.

GET /api/customers

Listar clientes por establecimiento.

PUT /api/customers/{customer_id}

Actualizar datos de un cliente.