​

Propiedades

Propiedades es el inventario de casas de VIVLA dentro del panel. El equipo de CX lo usa para consultar la ficha de una casa, encontrar datos operativos (acceso, wifi, proveedores…) y dar de alta casas nuevas. Desde el listado saltas al detalle de casa y al documento de check-in. Los estados de una casa y el glosario viven en Operativa.

​

Rutas

​

Listado de casas

Entra desde Propiedades en el menú lateral. Cada fila muestra la foto de portada, el nombre y el destino de la casa en una columna fija. El resto de columnas se desplaza en horizontal. Las columnas se agrupan así:

• Identificación: Estado, Link web, Dirección de la casa y Link Maps.
• Características: ocupación, dormitorios, baños, camas, Parking, Trastero, Acceso a la casa, wifi y Guía de la casa.
• Seguridad: palabras clave y códigos de la alarma.
• Alojamiento y licencias: email, envíos, welcome pack, supermercado, Cuenta bancaria, Licencia turística y los IDs de Hostaway y Airbnb.
• Proveedores: una columna por tipo de proveedor, más Admin comunidad y Conserje.
• Datos bancarios de comunidad.

Algunas celdas son atajos:

• Estado y Licencia turística llevan un icono (activa, pre-activa, inactiva; sí, no, pendiente).
• Parking y Guía de la casa muestran Ver listado y abren el detalle con esa tarjeta seleccionada.
• Cuenta bancaria se ve enmascarada (solo los últimos dígitos) y enlaza a su tarjeta en el detalle.
• Los enlaces externos (web, Maps, supermercado) se abren en otra pestaña.

​

Buscar y filtrar

• Escribe en Buscar propiedad para filtrar por nombre. La búsqueda espera 300 ms antes de lanzar la petición.
• Elige un destino en el selector de destinos (Todos los destinos por defecto).
• Pulsa Limpiar filtros para quitar nombre y destino. Solo aparece si hay algún filtro activo.
• Ajusta el tamaño de página y navega con el paginador. Por defecto ves 10 casas.

Todos los filtros viven en la URL (page, pageSize, name, location). Si sales a otra sección y vuelves desde el menú lateral, el panel recupera la última búsqueda.

​

Vista previa

Pulsa una fila para abrir la vista previa. Es un panel lateral (inferior en móvil) con las mismas secciones que el detalle y el mismo selector de sección.

• La URL añade ?homeId=:id, así que puedes compartirla.
• El botón de pantalla completa te lleva a /homes/:id.
• Si eliges Documento de Check in en el selector, navegas a la página del documento.
• Si la casa no existe, verás el aviso La casa que buscas no existe o ha sido eliminada y la vista previa se cierra.

Con edit:homes puedes usar en la vista previa lo que se edita en la propia tarjeta: estado, agente CX, licencia turística y guías en PDF. Si pulsas una tarjeta que tiene editor, el panel te lleva al detalle con esa tarjeta abierta.

​

Selector global de casa

En la parte superior del menú lateral hay un buscador de casas (HomesCollectionSelector). Por defecto muestra Todas las casas. Cuando eliges una casa:

• Si estás en /homes, el panel te lleva al detalle de esa casa.
• Si estás en el detalle de otra casa, cambia al de la casa elegida.
• En el detalle desaparece la flecha de volver, porque la casa está fijada.

Vuelve a Todas las casas para soltar la selección. El mismo contexto expone la lista simplificada de casas (GET /v2/admin/properties/names). La reutilizan otros módulos, por ejemplo:

• La calculadora del sistema de llaves.
• useHomeIdByName, que resuelve el id de una casa a partir de su nombre. Lo usa el documento de check-in que se abre desde una reserva.

​

Alta de casa

Con edit:homes verás el botón Añadir casa junto a los filtros. Te lleva a /homes/create. La portada se sube antes de crear la casa: el panel pide una URL firmada a la API, sube el archivo y manda la URL resultante en el alta.

​

Endpoints de vivla-api

​

Código