{"info":{"_postman_id":"e294b0ff-11fb-4512-898a-909467e4e9bd","name":"OpenFlow Coworking","description":"

OpenFlow Coworking API

Sistema de Control de Acceso a Coworkings Empresariales — Nelumbo Consultores

API REST para el control de ingreso y salida de personas en múltiples sedes de coworking, con histórico de accesos, generación de indicadores, facturación por tiempo de permanencia y sistema de cupones por fidelidad.

Autenticación

La API utiliza JWT (JSON Web Token) con expiración de 6 horas. Para obtener un token, utiliza el endpoint de Login en la carpeta Auth.

Usuario precargado:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Valor
Email	`admin@mail.com`
Password	`admin`

Incluye el token en el header Authorization: Bearer {{TOKEN}} para acceder a los endpoints protegidos.

Roles y Permisos

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Rol	Permisos
ADMIN	Crear usuarios OPERADOR, CRUD completo de sedes, asociar operadores a sedes, consultar accesos e indicadores globales, métricas financieras agregadas
OPERADOR	Registrar ingreso/salida de personas, consultar personas en su sede, visualizar indicadores de su sede

Variables de Entorno

Configura las siguientes variables en tu entorno antes de ejecutar las peticiones:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Variable	Descripción	Ejemplo
`HOST`	Host del servidor	`http://localhost`
`PORT`	Puerto del servidor	`8080`
`API_BASE_PATH`	Ruta base de la API	`api/v1`
`TOKEN`	JWT de autenticación	(se obtiene del Login)
`USER_ID`	ID del usuario objetivo	UUID
`BRANCH_ID`	ID de la sede	UUID
`OPERATOR_ID`	ID del operador	UUID
`CLIENT_DOCUMENT`	Documento del cliente	`1010101010`
`COUPON_CODE`	Código del cupón	String

Estructura de la Colección

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Carpeta	Descripción
User	Gestión de usuarios (ADMIN y OPERADOR)
Auth	Autenticación JWT (Login, Refresh, Logout)
Branch	CRUD de sedes y asignación de operadores
Access	Registro de ingresos (check-in) y salidas (check-out)
Indicators	Indicadores y métricas del sistema
Coupons	Gestión de cupones de fidelidad

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"OpenFlow Coworking API","slug":"openflow-coworking-api"}],"owner":"52872949","collectionId":"e294b0ff-11fb-4512-898a-909467e4e9bd","publishedId":"2sBXcKDdyN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-05T13:35:40.000Z"},"item":[{"name":"User","item":[{"name":"List","id":"3d626be8-30e2-4e4c-a0a6-9576f8f9f689","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users?q=xavi&page=1&limit=2","description":"

Listar Usuarios

Obtiene la lista paginada de usuarios del sistema con opción de búsqueda por texto.

Rol requerido: ADMIN

Query Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Requerido	Descripción
`q`	string	No	Texto de búsqueda (nombre o email)
`page`	number	No	Número de página (default: 1)
`limit`	number	No	Cantidad de resultados por página (default: 10)

Respuesta exitosa `200 OK`

Retorna un arreglo paginado de usuarios con sus datos básicos (id, nombre, email, documento, rol).

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","users"],"host":["{{HOST}}"],"query":[{"key":"q","value":"xavi"},{"key":"page","value":"1"},{"key":"limit","value":"2"}],"variable":[]}},"response":[],"_postman_id":"3d626be8-30e2-4e4c-a0a6-9576f8f9f689"},{"name":"Profile","id":"8c9f6d88-2c5a-4fb7-9f67-243100c86764","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users/me","description":"

Mi Perfil

Obtiene la información del usuario autenticado actualmente.

Rol requerido: ADMIN o OPERADOR

Respuesta exitosa `200 OK`

Retorna los datos del usuario autenticado: id, nombre, email, documento y rol.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","users","me"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8c9f6d88-2c5a-4fb7-9f67-243100c86764"},{"name":"Detail","id":"4467b22e-f747-4acd-92a4-22abd90d80d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users/{{USER_ID}}","description":"

Detalle de Usuario

Obtiene la información detallada de un usuario específico por su ID.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`USER_ID`	UUID	ID del usuario a consultar

Respuesta exitosa `200 OK`

Retorna los datos completos del usuario: id, nombre, email, documento y rol.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Usuario no encontrado

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","users","{{USER_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4467b22e-f747-4acd-92a4-22abd90d80d9"},{"name":"Operator branches","id":"2877e878-d4bd-42ec-a776-2b370ce969e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users/me/branches","description":"

Sedes del Operador

Obtiene la lista de sedes asignadas al operador autenticado.

Rol requerido: OPERADOR

Respuesta exitosa `200 OK`

Retorna un arreglo con las sedes asignadas al operador, incluyendo nombre, dirección, capacidad máxima y costo por hora de cada sede.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","users","me","branches"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2877e878-d4bd-42ec-a776-2b370ce969e9"},{"name":"Create","id":"af5f97c7-4fdf-451b-9d0f-56a9379d3a12","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Eduar\",\n \"email\": \"xavieravendano2@gmail.com\",\n \"document\": \"1111112111\",\n \"password\": \"123123223\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users","description":"

Crear Usuario

Crea un nuevo usuario con rol OPERADOR en el sistema.

Rol requerido: ADMIN

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`name`	string	✅	Nombre completo del usuario
`email`	string	✅	Correo electrónico (único)
`document`	string	✅	Número de documento (único)
`password`	string	✅	Contraseña del usuario

{\n  \"name\": \"Eduar\",\n  \"email\": \"xavieravendano2@gmail.com\",\n  \"document\": \"1111112111\",\n  \"password\": \"123123223\"\n}\n

Respuesta exitosa `201 Created`

Retorna el usuario creado con su ID asignado.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`400`	Datos inválidos o campos faltantes
`409`	Email o documento ya registrado

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","users"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"af5f97c7-4fdf-451b-9d0f-56a9379d3a12"},{"name":"Update","id":"1052d5f4-f0e9-4a45-be5a-2573c25e958c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Eduar Xavier\",\n \"email\": \"xavieravendano9@gmail.com\",\n \"password\": \"123123123\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users/{{USER_ID}}","description":"

Actualizar Usuario

Actualiza los datos de un usuario existente. Solo se envían los campos que se desean modificar.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`USER_ID`	UUID	ID del usuario a actualizar

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`name`	string	No	Nombre completo
`email`	string	No	Correo electrónico
`password`	string	No	Nueva contraseña

{\n  \"name\": \"Eduar Xavier\",\n  \"email\": \"xavieravendano9@gmail.com\",\n  \"password\": \"123123123\"\n}\n

Respuesta exitosa `200 OK`

Retorna el usuario con los datos actualizados.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Usuario no encontrado
`409`	Email ya registrado por otro usuario

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","users","{{USER_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1052d5f4-f0e9-4a45-be5a-2573c25e958c"},{"name":"Delete","id":"4c38ae81-ca1f-4621-aea8-a0e610318e8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/users/{{USER_ID}}","description":"

Eliminar Usuario

Elimina un usuario del sistema de forma permanente.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`USER_ID`	UUID	ID del usuario a eliminar

Respuesta exitosa `204 No Content`

El usuario ha sido eliminado exitosamente. No retorna contenido.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Usuario no encontrado

User

Gestión de usuarios del sistema. El rol ADMIN puede crear, listar, actualizar y eliminar usuarios con rol OPERADOR. Cada usuario tiene nombre, email, documento y contraseña.

Permisos requeridos: ADMIN para todas las operaciones de gestión. Cualquier usuario autenticado puede consultar su propio perfil.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Operación	Método	Endpoint	Rol
Listar usuarios	`GET`	`/users`	ADMIN
Ver perfil propio	`GET`	`/users/me`	ADMIN, OPERADOR
Detalle de usuario	`GET`	`/users/:id`	ADMIN
Sedes del operador	`GET`	`/users/me/branches`	OPERADOR
Crear usuario	`POST`	`/users`	ADMIN
Actualizar usuario	`PATCH`	`/users/:id`	ADMIN
Eliminar usuario	`DELETE`	`/users/:id`	ADMIN

","_postman_id":"74491e14-b512-439c-a183-ea7d0150bac7"},{"name":"Auth","item":[{"name":"Login","id":"8c56841a-cd0d-4896-83d7-e42be9503d6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"admin@mail.com\",\n \"password\": \"admin\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/tokens","description":"

Iniciar Sesión

Autentica un usuario y retorna un token JWT con expiración de 6 horas junto con un refresh token.

Autenticación: No requerida

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`email`	string	✅	Correo electrónico del usuario
`password`	string	✅	Contraseña del usuario

{\n  \"email\": \"admin@mail.com\",\n  \"password\": \"admin\"\n}\n

Respuesta exitosa `200 OK`

Retorna el accessToken y el refreshToken. Guarda el accessToken en la variable {{TOKEN}} para autenticar las demás peticiones.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`401`	Credenciales inválidas

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","tokens"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8c56841a-cd0d-4896-83d7-e42be9503d6b"},{"name":"Refresh Token","id":"64ebacd3-898a-4ddc-8a6e-bfe6153c24d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"X-Refresh-Token","value":"eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ4YXZpZXJhdmVuZGFubzlAZ21haWwuY29tIiwiaWF0IjoxNzcyNTU1NzQ5LCJleHAiOjE3NzI1OTg5NDl9.iBmwP9J9ynFYkgsqkWaGhOX4qR5_M62O03TXXIkBD1s","type":"text"}],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/tokens","description":"

Refrescar Token

Genera un nuevo par de tokens (access + refresh) utilizando un refresh token válido.

Autenticación: Bearer Token + Header personalizado

Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Header	Tipo	Requerido	Descripción
`Authorization`	string	✅	`Bearer {{TOKEN}}` — Token de acceso actual
`X-Refresh-Token`	string	✅	Refresh token obtenido en el login

Respuesta exitosa `200 OK`

Retorna un nuevo accessToken y refreshToken. Actualiza la variable {{TOKEN}} con el nuevo token.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`401`	Refresh token inválido o expirado

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","tokens"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"64ebacd3-898a-4ddc-8a6e-bfe6153c24d2"},{"name":"Logout","id":"3ca9b81b-0df3-4a17-b9ef-fb61c41ec6e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/tokens","description":"

Cerrar Sesión

Invalida el token actual del usuario, cerrando la sesión activa.

Autenticación: Bearer Token

Respuesta exitosa `204 No Content`

La sesión ha sido cerrada exitosamente. El token queda invalidado y no podrá usarse nuevamente.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`401`	Token inválido o ya expirado

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","tokens"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3ca9b81b-0df3-4a17-b9ef-fb61c41ec6e7"}],"id":"16790622-9d38-41cd-aa40-db2a1990dd7b","description":"

Auth

Endpoints de autenticación mediante JWT (JSON Web Token). El token tiene una expiración de 6 horas. Utiliza el endpoint de Login para obtener el token de acceso y el refresh token.

Usuario precargado:

Email: admin@mail.com
Password: admin

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Operación	Método	Endpoint	Autenticación
Login	`POST`	`/tokens`	No requerida
Refresh Token	`PUT`	`/tokens`	Bearer Token + Header `X-Refresh-Token`
Logout	`DELETE`	`/tokens`	Bearer Token

","_postman_id":"16790622-9d38-41cd-aa40-db2a1990dd7b"},{"name":"Branch","item":[{"name":"List","id":"33f5a946-4892-4a63-bd86-d38dd705e30e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches","description":"

Listar Sedes

Obtiene la lista completa de sedes de coworking registradas en el sistema.

Rol requerido: ADMIN

Respuesta exitosa `200 OK`

Retorna un arreglo con todas las sedes, incluyendo: id, nombre, dirección, capacidad máxima, costo por hora y ocupación actual.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"33f5a946-4892-4a63-bd86-d38dd705e30e"},{"name":"Detail","id":"2153cc2d-aeaf-4013-b738-da7a2a8f1010","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}","description":"

Detalle de Sede

Obtiene la información detallada de una sede específica.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede a consultar

Respuesta exitosa `200 OK`

Retorna los datos completos de la sede: id, nombre, dirección, capacidad máxima, costo por hora y ocupación actual.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2153cc2d-aeaf-4013-b738-da7a2a8f1010"},{"name":"List Operators","id":"1e86fd7b-205c-449c-95f4-37ab6f2b6e62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}/operators","description":"

Listar Operadores de Sede

Obtiene la lista de operadores asignados a una sede específica.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede

Respuesta exitosa `200 OK`

Retorna un arreglo con los operadores asignados a la sede, incluyendo sus datos básicos (id, nombre, email).

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}","operators"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1e86fd7b-205c-449c-95f4-37ab6f2b6e62"},{"name":"Create","id":"bfffb929-0035-455f-bb90-caada868705b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Sucursal de prueba\",\n \"address\": \"Calle 1, ceiba\",\n \"maxCapacity\": 10,\n \"hourlyRate\": 20000\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches","description":"

Crear Sede

Registra una nueva sede de coworking en el sistema.

Rol requerido: ADMIN

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre de la sede
`address`	string	Sí	Dirección física
`maxCapacity`	number	Sí	Capacidad máxima simultánea de personas
`hourlyRate`	number	Sí	Costo por hora de permanencia (COP)

{\n  \"name\": \"Sucursal de prueba\",\n  \"address\": \"Calle 1, ceiba\",\n  \"maxCapacity\": 10,\n  \"hourlyRate\": 20000\n}\n

Respuesta exitosa `201 Created`

Retorna la sede creada con su ID asignado.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`400`	Datos inválidos o campos faltantes

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bfffb929-0035-455f-bb90-caada868705b"},{"name":"Add operator","id":"1fee1aa5-9556-4e4e-891e-da9f0d2f272e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}/operators/{{OPERATOR_ID}}","description":"

Asignar Operador a Sede

Asocia un usuario con rol OPERADOR a una sede específica, permitiéndole gestionar los accesos de dicha sede.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede
`OPERATOR_ID`	UUID	ID del operador a asignar

Respuesta exitosa `200 OK`

Confirma la asignación del operador a la sede.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede u operador no encontrado
`400`	El usuario no tiene rol OPERADOR
`409`	El operador ya está asignado a esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}","operators","{{OPERATOR_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"1fee1aa5-9556-4e4e-891e-da9f0d2f272e"},{"name":"Update","id":"b20fc392-265b-4ceb-acd0-25d7ba417c03","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"Sucursal de prueba\",\n \"address\": \"Calle 1, ceiba\",\n \"maxCapacity\": 10,\n \"hourlyRate\": 20000\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}","description":"

Actualizar Sede

Modifica los datos de una sede existente. Solo se envían los campos que se desean actualizar.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede a actualizar

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`name`	string	No	Nombre de la sede
`address`	string	No	Dirección física
`maxCapacity`	number	No	Capacidad máxima simultánea
`hourlyRate`	number	No	Costo por hora (COP)

{\n  \"name\": \"Sucursal de prueba\",\n  \"address\": \"Calle 1, ceiba\",\n  \"maxCapacity\": 10,\n  \"hourlyRate\": 20000\n}\n

Respuesta exitosa `200 OK`

Retorna la sede con los datos actualizados.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b20fc392-265b-4ceb-acd0-25d7ba417c03"},{"name":"Delete","id":"0b7dd9e3-34c3-41dd-bf6c-e3f36c960891","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}","description":"

Eliminar Sede

Elimina una sede del sistema de forma permanente.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede a eliminar

Respuesta exitosa `204 No Content`

La sede ha sido eliminada exitosamente. No retorna contenido.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0b7dd9e3-34c3-41dd-bf6c-e3f36c960891"},{"name":"Delete operator","id":"0b4ed1e8-874f-4b01-88b1-c2e09c8225a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}/operators/{{OPERATOR_ID}}","description":"

Desasignar Operador de Sede

Remueve la asociación de un operador con una sede específica. El operador dejará de poder gestionar los accesos de dicha sede.

Rol requerido: ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede
`OPERATOR_ID`	UUID	ID del operador a desasignar

Respuesta exitosa `204 No Content`

El operador ha sido desasignado exitosamente.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede u operador no encontrado
`400`	El operador no está asignado a esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}","operators","{{OPERATOR_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"0b4ed1e8-874f-4b01-88b1-c2e09c8225a7"}],"id":"1033ed60-602e-4a81-8e6b-e2c1abf5dc2f","description":"

Branch (Sedes)

CRUD completo de sedes de coworking y gestión de operadores asignados. Cada sede contiene: nombre, dirección, capacidad máxima simultánea y costo por hora.

Permisos requeridos: ADMIN para todas las operaciones.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Operación	Método	Endpoint
Listar sedes	`GET`	`/branches`
Detalle de sede	`GET`	`/branches/:id`
Listar operadores de sede	`GET`	`/branches/:id/operators`
Crear sede	`POST`	`/branches`
Asignar operador	`POST`	`/branches/:id/operators/:operatorId`
Actualizar sede	`PATCH`	`/branches/:id`
Eliminar sede	`DELETE`	`/branches/:id`
Desasignar operador	`DELETE`	`/branches/:id/operators/:operatorId`

","_postman_id":"1033ed60-602e-4a81-8e6b-e2c1abf5dc2f"},{"name":"Access","item":[{"name":"List by branch","id":"3c8e43a3-2acc-4444-9ab5-53693b55d308","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}/accesses","description":"

Listar Accesos por Sede

Obtiene la lista de accesos activos (personas actualmente dentro) de una sede específica.

Rol requerido: OPERADOR (sede asignada) o ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede

Respuesta exitosa `200 OK`

Retorna un arreglo con los accesos activos, incluyendo: documento de la persona, email, fecha/hora de ingreso y tiempo transcurrido.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada
`403`	Operador no asignado a esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}","accesses"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3c8e43a3-2acc-4444-9ab5-53693b55d308"},{"name":"List All access","id":"fdfda188-e28b-4935-b91a-d3c05b6166ae","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/accesses","description":"

Listar Todos los Accesos

Obtiene la lista completa de todos los accesos activos en todas las sedes del sistema.

Rol requerido: ADMIN

Respuesta exitosa `200 OK`

Retorna un arreglo con todos los accesos activos del sistema, incluyendo la información de la sede, documento de la persona, email y fecha/hora de ingreso.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","accesses"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fdfda188-e28b-4935-b91a-d3c05b6166ae"},{"name":"Check-in","id":"d66e3f26-d8db-4c97-8332-eb075557f5b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"ingeeduar20@gmail.com\",\n \"document\": \"1010101010\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}/accesses","description":"

Registrar Ingreso (Check-in)

Registra el ingreso de una persona a una sede de coworking.

Rol requerido: OPERADOR (sede asignada) o ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede donde se registra el ingreso

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`email`	string	Sí	Correo electrónico de la persona
`document`	string	Sí	Número de documento de identidad

{\n  \"email\": \"ingeeduar20@gmail.com\",\n  \"document\": \"1010101010\"\n}\n

Reglas de negocio

No puede existir un ingreso activo del mismo documento en ninguna sede
Se valida que la sede tenga capacidad disponible antes de registrar
Se registra la fecha y hora exacta del ingreso

Respuesta exitosa `201 Created`

Retorna el registro de acceso creado con la información del ingreso.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`400`	La persona ya tiene un ingreso activo en alguna sede
`400`	La sede ha alcanzado su capacidad máxima
`404`	Sede no encontrada
`403`	Operador no asignado a esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}","accesses"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d66e3f26-d8db-4c97-8332-eb075557f5b9"},{"name":"Check-out","id":"a06461dd-7eb5-4e39-8707-98a8a9a995b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"document\": \"1010101010\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/branches/{{BRANCH_ID}}/accesses/checkout","description":"

Registrar Salida (Check-out)

Registra la salida de una persona de una sede de coworking, calculando el valor a pagar según el tiempo de permanencia.

Rol requerido: OPERADOR (sede asignada) o ADMIN

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede donde se registra la salida

Body (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Requerido	Descripción
`document`	string	Sí	Número de documento de la persona

{\n  \"document\": \"1010101010\"\n}\n

Reglas de negocio

Debe existir un ingreso activo de la persona en esta sede
Se registra la fecha y hora exacta de salida
Se calcula el valor a pagar: tiempo_permanencia x costo_por_hora
El registro se mueve al histórico de accesos
Se libera un cupo en la sede
Si la persona acumula más de 20 horas en esta sede, se genera un cupón de fidelidad y se envía notificación

Respuesta exitosa `200 OK`

Retorna el registro de acceso con la información de salida, tiempo de permanencia y valor a pagar.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`400`	No existe ingreso activo para este documento en esta sede
`404`	Sede no encontrada
`403`	Operador no asignado a esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","branches","{{BRANCH_ID}}","accesses","checkout"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a06461dd-7eb5-4e39-8707-98a8a9a995b0"}],"id":"f8c120ad-d315-4dc6-8165-d9b04440a3a1","description":"

Access (Control de Acceso)

Registro de ingresos (check-in) y salidas (check-out) de personas en las sedes de coworking.

Reglas de negocio:

No puede existir un ingreso activo del mismo documento en ninguna sede
Se valida la capacidad disponible de la sede antes del ingreso
Al registrar la salida, se calcula el valor a pagar según el tiempo de permanencia
Si una persona acumula más de 20 horas en una sede, se genera automáticamente un cupón de fidelidad
Se envía notificación al microservicio simulado cuando aplique

Permisos requeridos: OPERADOR (solo en sedes asignadas) y ADMIN.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Operación	Método	Endpoint
Listar accesos por sede	`GET`	`/branches/:id/accesses`
Listar todos los accesos	`GET`	`/accesses`
Check-in	`POST`	`/branches/:id/accesses`
Check-out	`PATCH`	`/branches/:id/accesses/checkout`

","_postman_id":"f8c120ad-d315-4dc6-8165-d9b04440a3a1"},{"name":"Indicators","item":[{"name":"Client top access","id":"3500d021-1e95-44e4-8aa2-835e19162a17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/indicators/clients/top-accesses","description":"

Top Clientes por Accesos (Global)

Obtiene el ranking de las 10 personas con más ingresos registrados en todo el sistema.

Rol requerido: ADMIN o OPERADOR

Respuesta exitosa `200 OK`

Retorna un arreglo ordenado con las 10 personas que más veces han ingresado al sistema, incluyendo: documento, nombre/email y cantidad total de ingresos.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","indicators","clients","top-accesses"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"3500d021-1e95-44e4-8aa2-835e19162a17"},{"name":"Branch client top access","id":"81537309-8502-4815-a049-3fdafdee7a96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/indicators/branches/{{BRANCH_ID}}/persons/top-accesses","description":"

Top Clientes por Accesos en Sede

Obtiene el ranking de las 10 personas con más ingresos en una sede específica.

Rol requerido: ADMIN o OPERADOR

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede

Respuesta exitosa `200 OK`

Retorna un arreglo ordenado con las 10 personas que más veces han ingresado a la sede indicada.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","indicators","branches","{{BRANCH_ID}}","persons","top-accesses"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"81537309-8502-4815-a049-3fdafdee7a96"},{"name":"Client first time","id":"c9177abc-5613-4379-a735-f3e5b55e1899","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/indicators/clients/first-time","description":"

Clientes Primera Vez

Obtiene la lista de personas que han ingresado por primera vez al sistema de coworking.

Rol requerido: ADMIN o OPERADOR

Respuesta exitosa `200 OK`

Retorna un arreglo con las personas que registran un único ingreso en el sistema, incluyendo: documento, email y fecha de su primer ingreso.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","indicators","clients","first-time"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c9177abc-5613-4379-a735-f3e5b55e1899"},{"name":"Revenue by branch","id":"e1360b9a-ade5-44be-b154-782e802adee7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/indicators/branches/{{BRANCH_ID}}/revenue","description":"

Ingresos Económicos por Sede

Obtiene los ingresos económicos (facturación) de una sede específica, desglosados por período de tiempo.

Rol requerido: OPERADOR (sede asignada)

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede

Respuesta exitosa `200 OK`

Retorna los ingresos económicos de la sede desglosados en: Hoy, Semana, Mes y Año.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada
`403`	Operador no asignado a esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","indicators","branches","{{BRANCH_ID}}","revenue"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"e1360b9a-ade5-44be-b154-782e802adee7"},{"name":"Top revenue operators weekly","id":"cb5fdbca-e8f2-4c0d-9b72-3b4c4171127e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/indicators/operators/top-revenue/weekly","description":"

Top Operadores por Ingresos Semanales

Obtiene el ranking de los 3 operadores que han registrado más ingresos (check-ins) durante la semana en curso.

Rol requerido: ADMIN

Respuesta exitosa `200 OK`

Retorna un arreglo ordenado con los 3 operadores más activos de la semana, incluyendo: nombre, email y cantidad de ingresos registrados.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","indicators","operators","top-revenue","weekly"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"cb5fdbca-e8f2-4c0d-9b72-3b4c4171127e"},{"name":"Top revenue branches weekly","id":"d2575294-42f3-459e-902b-7e93caab3d95","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/indicators/branches/top-revenue/weekly","description":"

Top Sedes por Facturación Semanal

Obtiene el ranking de las 3 sedes con mayor facturación durante la semana en curso.

Rol requerido: ADMIN

Respuesta exitosa `200 OK`

Retorna un arreglo ordenado con las 3 sedes que más han facturado en la semana, incluyendo: nombre de la sede, dirección y monto total facturado.

\n","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","indicators","branches","top-revenue","weekly"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"d2575294-42f3-459e-902b-7e93caab3d95"}],"id":"813c9d45-0177-43e1-b5e1-f003114ee92f","description":"

Indicators (Indicadores)

Métricas y estadísticas del sistema para la toma de decisiones. Los indicadores varían según el rol del usuario.

Indicadores disponibles para ADMIN y OPERADOR:

Top 10 personas con más ingresos (global)
Top 10 personas con más ingresos por sede
Personas que ingresan por primera vez

Solo OPERADOR:

Ingresos económicos por sede (hoy, semana, mes, año)

Solo ADMIN:

Top 3 operadores con más ingresos en la semana
Top 3 sedes con mayor facturación semanal

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Indicador	Método	Endpoint	Rol
Top accesos global	`GET`	`/indicators/clients/top-accesses`	ADMIN, OPERADOR
Top accesos por sede	`GET`	`/indicators/branches/:id/persons/top-accesses`	ADMIN, OPERADOR
Primera vez	`GET`	`/indicators/clients/first-time`	ADMIN, OPERADOR
Ingresos por sede	`GET`	`/indicators/branches/:id/revenue`	OPERADOR
Top operadores semanal	`GET`	`/indicators/operators/top-revenue/weekly`	ADMIN
Top sedes semanal	`GET`	`/indicators/branches/top-revenue/weekly`	ADMIN

","_postman_id":"813c9d45-0177-43e1-b5e1-f003114ee92f"},{"name":"Coupons","item":[{"name":"Coupons by branch","id":"a02e1310-15ca-48b2-9be9-25e986ae2483","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/coupons/branches/{{BRANCH_ID}}","description":"

Cupones por Sede

Obtiene la lista de todos los cupones de fidelidad generados para una sede específica.

Rol requerido: ADMIN o OPERADOR

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede

Respuesta exitosa `200 OK`

Retorna un arreglo con los cupones de la sede, incluyendo: código del cupón, documento del cliente, estado (ACTIVO, UTILIZADO, EXPIRADO), fecha de generación y fecha de vencimiento.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","coupons","branches","{{BRANCH_ID}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"a02e1310-15ca-48b2-9be9-25e986ae2483"},{"name":"Client coupon in branch","id":"46997cfd-c90b-4940-9dac-5586b7358c12","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/coupons/branches/{{BRANCH_ID}}/clients/{{CLIENT_DOCUMENT}}","description":"

Cupón de Cliente en Sede

Consulta el cupón de fidelidad de un cliente específico en una sede determinada.

Rol requerido: ADMIN o OPERADOR

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`BRANCH_ID`	UUID	ID de la sede
`CLIENT_DOCUMENT`	string	Número de documento del cliente

Respuesta exitosa `200 OK`

Retorna la información del cupón del cliente: código, estado, fecha de generación, fecha de vencimiento y fecha de uso (si aplica).

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Sede no encontrada o el cliente no tiene cupón en esta sede

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","coupons","branches","{{BRANCH_ID}}","clients","{{CLIENT_DOCUMENT}}"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"46997cfd-c90b-4940-9dac-5586b7358c12"},{"name":"Redeem coupon","id":"209803b5-12d6-4885-ba54-6fb778b63cc1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"url":"{{HOST}}:{{PORT}}/{{API_BASE_PATH}}/coupons/{{COUPON_CODE}}/redeem","description":"

Redimir Cupón

Marca un cupón de fidelidad como utilizado (redimido).

Rol requerido: ADMIN o OPERADOR

Path Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`COUPON_CODE`	string	Código único del cupón a redimir

Reglas de negocio

El cupón debe estar en estado ACTIVO para poder ser redimido
No puede redimirse un cupón ya UTILIZADO
No puede redimirse un cupón EXPIRADO (vencimiento de 10 días)
Una vez redimido, el estado cambia a UTILIZADO y se registra la fecha de uso

Respuesta exitosa `200 OK`

Retorna el cupón actualizado con estado UTILIZADO y la fecha de redención.

Errores comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descripción
`404`	Cupón no encontrado
`400`	El cupón ya fue utilizado
`400`	El cupón ha expirado

","urlObject":{"port":"{{PORT}}","path":["{{API_BASE_PATH}}","coupons","{{COUPON_CODE}}","redeem"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"209803b5-12d6-4885-ba54-6fb778b63cc1"}],"id":"0d3a61cf-9100-41aa-9c90-71e8876739d2","description":"

Coupons (Cupones de Fidelidad)

Gestión de cupones generados automáticamente por el sistema de fidelidad. Un cupón se genera cuando una persona acumula más de 20 horas de permanencia en una misma sede.

Reglas del cupón:

Se otorga una única vez por persona y por sede
Vigencia de 10 días calendario desde su generación
Puede marcarse como utilizado (redimido)
No puede reutilizarse una vez redimido
Si expira, se registra como EXPIRADO y no podrá redimirse

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Operación	Método	Endpoint
Cupones por sede	`GET`	`/coupons/branches/:id`
Cupón de cliente en sede	`GET`	`/coupons/branches/:id/clients/:document`
Redimir cupón	`POST`	`/coupons/:code/redeem`

","_postman_id":"0d3a61cf-9100-41aa-9c90-71e8876739d2"}]}

OpenFlow Coworking API

Autenticación

Roles y Permisos

Variables de Entorno

Estructura de la Colección

Listar Usuarios

Query Parameters

Respuesta exitosa 200 OK

Mi Perfil

Respuesta exitosa 200 OK

Detalle de Usuario

Path Parameters

Respuesta exitosa 200 OK

Errores comunes

Sedes del Operador

Respuesta exitosa 200 OK

Crear Usuario

Body (JSON)

Respuesta exitosa 201 Created

Errores comunes

Actualizar Usuario

Path Parameters

Body (JSON)

Respuesta exitosa 200 OK

Errores comunes

Eliminar Usuario

Path Parameters

Respuesta exitosa 204 No Content

Errores comunes

User

Iniciar Sesión

Body (JSON)

Respuesta exitosa 200 OK

Errores comunes

Refrescar Token

Headers

Respuesta exitosa 200 OK

Errores comunes

Cerrar Sesión

Respuesta exitosa 204 No Content

Errores comunes

Auth

Listar Sedes

Respuesta exitosa 200 OK

Detalle de Sede

Path Parameters

Respuesta exitosa 200 OK

Errores comunes

Listar Operadores de Sede

Path Parameters

Respuesta exitosa 200 OK

Errores comunes

Crear Sede

Body (JSON)

Respuesta exitosa 201 Created

Errores comunes

Asignar Operador a Sede

Path Parameters

Respuesta exitosa 200 OK

Errores comunes

Actualizar Sede

Path Parameters

Body (JSON)

Respuesta exitosa 200 OK

Errores comunes

Eliminar Sede

Path Parameters

Respuesta exitosa 204 No Content

Errores comunes

Desasignar Operador de Sede

Path Parameters

Respuesta exitosa 204 No Content

Errores comunes

Branch (Sedes)

Listar Accesos por Sede

Path Parameters

Respuesta exitosa 200 OK

Errores comunes

Listar Todos los Accesos

Respuesta exitosa 200 OK

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `201 Created`

Respuesta exitosa `200 OK`

Respuesta exitosa `204 No Content`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `204 No Content`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `201 Created`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `204 No Content`

Respuesta exitosa `204 No Content`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `201 Created`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`

Respuesta exitosa `200 OK`