Clientes

🟢 Disponible. Requiere una API key con scope clients:read o clients:write.

No existe un endpoint para crear un cliente directamente. Un cliente en Valwisp es el resultado de un registro aprobado y una instalación completada — nunca algo que se crea de un solo paso. Esto garantiza que todo cliente facturable pasó por una validación real (cobertura, crédito) y tiene un servicio efectivamente activado, no solo una ficha con datos.

Si tu integración necesita dar de alta gente nueva, empieza en Registro.

Consultar un cliente

GET /clients/{id}

También puedes buscar por cédula: GET /clients?cedula=40245678901.

Actualizar un cliente

PATCH /clients/{id}

Acepta cualquier subconjunto de: nombre, correo, telefono, movil, direccion. La cédula no es editable por API — contacta soporte si necesitas corregirla.

Activar / Suspender

POST /clients/{id}/activate
POST /clients/{id}/suspend

{ "motivo": "pago_confirmado" }

motivo es opcional pero recomendado — queda en el historial del cliente. Suspender corta el acceso a internet del cliente de inmediato; activar lo restaura sin que el cliente tenga que reiniciar su equipo.

Listar clientes

GET /clients?page=1&limit=25&estado=activo

Filtros disponibles: estado (activo/suspendido/retirado), sucursalId, q (búsqueda por nombre/cédula/correo).