Servicios y disponibilidad

Servicios, requisitos con varios recursos, horarios y cómo se calculan los slots.

Actualizado:

Servicios

Un servicio es lo que reserva el cliente.

CampoSignificado
duration_minDuración del servicio
step_minGrilla de inicio (cada 15, 30 minutos…)
buffer_before_min / buffer_after_minTiempo de preparación o limpieza bloqueado alrededor de la reserva
price_cents, currencyPrecio que informa el bot (siempre desde la base de datos)
deposit_centsSeña necesaria para confirmar (cobro en línea: próximamente)
booking_paymentQué se cobra al confirmar un turno: none, deposit (la seña) o total (el valor de la tarea)
lead_time_minAnticipación mínima (por ejemplo 60 minutos)
max_advance_daysCon cuánta anticipación máxima se puede reservar
window_modeEl slot es una ventana fija (entregas: 14:00–16:00)
fulfillment_modescheduled (default, con horario) o queue (despacho por cola, sin horario fijo)
location_modeDónde se presta: en el local, en la dirección del cliente, a elección o a distancia
colorColor que identifica al servicio en todas las vistas
intake_formJSON Schema de datos extra a pedir (obra social, dirección…)
requirementsQué recursos necesita el servicio al mismo tiempo

Ventana o despacho: dos modos de cumplimiento

Cada servicio define cómo se cumple lo reservado (fulfillment_mode):

  • scheduled (el default): la reserva ocupa un rango de tiempo conocido — un horario fijo o, con window_mode, una ventana (entregas de 14:00 a 16:00, con cupo por zona).
  • queue (despacho, para agua, gas o delivery on-demand): la reserva no tiene horario fijo — entra en la cola de pendientes de un repartidor. El motor la asigna al repartidor con menos tareas activas y cada repartidor tiene un cupo de tareas activas a la vez, garantizado en la base de datos. La cola usa los mismos estados que una reserva: pendiente → aceptada → iniciada → finalizada (o fallida).

Así, un mismo negocio de entregas puede ofrecer ventanas programadas, despacho inmediato o ambos.

Requisitos

Un requisito dice: de este equipo, necesito tantas unidades. Un servicio puede tener varios; un slot existe solo si todos están libres.

{
  "name": "Depilación láser",
  "duration_min": 45,
  "buffer_after_min": 10,
  "requirements": [
    { "resource_group_id": "grp_professionals", "units": 1 },
    { "resource_group_id": "grp_lasers", "units": 1 },
    { "resource_group_id": "grp_rooms", "units": 1 }
  ]
}

Con dos profesionales y un solo láser, Fiuit nunca ofrece dos sesiones de láser superpuestas.

Opciones avanzadas:

  • units: "party_size" — consume tantas unidades como personas (restaurantes, clases).
  • offset_min / duration_min en un requisito — usa un recurso solo en parte del servicio (por ejemplo el lavacabezas en los últimos 15 minutos de un color).

Horarios

Cada recurso tiene un horario: reglas semanales en la zona horaria del recurso más excepciones para fechas puntuales (cerrado u horario especial).

Horarios que cruzan medianoche. Si la hora de cierre es menor o igual que la de apertura, el tramo termina al día siguiente: ["20:00", "03:00"] se muestra 20:00 – 03:00 (+1). La noche pertenece al día en que abre: el viernes 20:00 – 03:00 (+1) sigue hasta el sábado a las 03:00 aunque el sábado esté cerrado, y cerrar el viernes quita esa noche entera. Las 24 horas se escriben ["00:00", "00:00"]. No se puede guardar un tramo que pise la madrugada del día siguiente. Una reserva puede cruzar las 00:00 sin cortarse, y al pedir los horarios de «un día» (bot, reserva pública, GET /v1/slots?day=) entran los de su noche después de las 00:00. Los cambios de horario de verano se respetan: una noche con cambio de hora dura sus horas reales.

{
  "tz": "America/Argentina/Buenos_Aires",
  "weekly": { "tue": [["09:00", "19:00"]], "sat": [["08:00", "12:00"], ["13:00", "16:00"]] },
  "overrides": [{ "date": "2026-12-24", "ranges": [["09:00", "13:00"]] }, { "date": "2026-12-25", "closed": true }]
}

Bloquear un horario

Un bloqueo es una excepción del día: todo el día (cerrado) o algunas horas (se guarda como los tramos que sí se atienden ese día: el horario semanal menos lo bloqueado). Desde el panel se bloquea con el mismo diálogo en el Calendario (tocando un hueco o arrastrando sobre la grilla), en la ficha de cada recurso (Horarios y bloqueos) y, aparte, en el servicio (Pausar por un rango, que cierra solo ese servicio y no bloquea a los recursos que lo atienden). Se puede elegir uno o varios recursos, un rango de días o repetirlo cada semana. Las tareas que ya estaban en ese horario se avisan y no se mueven solas. Si varios recursos comparten un mismo horario, el bloqueo vale para todos.

Días y horarios propios del servicio

Un servicio también puede tener su propia ventana: los días y rangos en que se presta, con el mismo editor semanal de los recursos. La oferta siempre es la intersección: la ventana del servicio recorta la disponibilidad del equipo, nunca la amplía. Si el servicio no define ventana, se ofrece cualquier horario que sus recursos tengan. El editor muestra una vista previa con la intersección real antes de guardar, y el bot explica la ventana cuando no hay turnos.

Color

Cada servicio elige un color de la paleta del tema. Lo ves en el calendario, en Hoy, en Trabajo, en el mapa y en las estadísticas, junto al nombre: el color identifica, pero no reemplaza al texto. Si no elegís uno, Fiuit asigna un color estable automáticamente.

Dónde se presta

Cada servicio define su destino:

  • En el local: la tarea ocurre en la dirección del negocio.
  • En la dirección del cliente: entregas, visitas, servicio en domicilio.
  • A elección del cliente: el cliente decide al reservar.
  • A distancia: una sesión por videollamada o teléfono. No se pide ni se muestra ninguna dirección: ni en el bot, ni en la reserva web, ni en los avisos. Podés cargar el enlace de la reunión del servicio (el de tu sala de videollamada): el bot lo comparte al confirmar y los recordatorios lo repiten. Fiuit no genera el enlace.

Cuando el destino es la dirección del cliente, al crear la tarea Fiuit propone la dirección que ya tiene guardada (con autocompletar o carga manual, ver Mapa y direcciones). Cada tarea guarda su propio destino: cambiarla en una tarea no toca las demás ni el perfil. Guardar la dirección nueva en el perfil del cliente es opcional y aparte: solo pasa si marcás la casilla de consentimiento. El bot confirma la dirección, el consentimiento y la reserva como pasos separados.

Formularios con cantidades y cálculos

Además de los campos de texto, el formulario de un servicio admite:

  • Cantidades: cuántas unidades de algo (bidones, metros, personas, equipos).
  • Campos calculados: una expresión simple que combina cantidades y precios para mostrar un total (por ejemplo agua * 1500 + gas * 3000). El cálculo se valida en el servidor y no puede tocar datos de otros módulos ni de otros negocios.

El panel tiene editor y vista previa: probá el resultado antes de guardar. Al crear la tarea, el formulario pide las cantidades, aplica el cálculo y muestra el total; el cliente ve un resumen claro con lo que pidió. La cotización queda congelada con la tarea: si el precio del catálogo cambia antes de confirmar, la tarea ya armada conserva su total; editar las cantidades a mano recalcula con el catálogo vigente.

Cómo se calculan los slots

  1. Expandir los horarios para el rango pedido, en la zona horaria de cada recurso.
  2. Restar reservas y pre-reservas activas (más los buffers) y bloqueos manuales.
  3. Cortar en slots candidatos según la duración y la grilla del servicio.
  4. Aplicar anticipación mínima y máxima, reglas de corte y tamaño del grupo.
  5. Cruzar todos los requisitos, probando los miembros de cada equipo según la estrategia de asignación.
  6. Devolver una lista corta y ordenada.

Cuando no hay nada disponible, la respuesta trae unavailable_reason (closed, no_staff, no_equipment, no_space, lead_time, max_advance, cutoff, full) para que el bot explique por qué.

Los resultados pasados de cada servicio —completadas, canceladas, facturación estimada, día pico y exportación CSV— están en Resultados y ventas.

Configurar un servicio en el panel

En Mi negocio → Catálogo, abrí el servicio y tocá Editar. Qué hace cada bloque:

  • Quién lo hace: elegí un equipo. Puede haber varios requisitos a la vez, por ejemplo un box y un mecánico durante parte del tiempo. La disponibilidad es la intersección del servicio, los recursos y el horario de la zona, menos los bloqueos.
  • Horario propio: un interruptor. Admite varios tramos por día (las pausas son el espacio entre ellos) y pausar por fechas.
  • Anticipación: el mínimo para reservar y Reservar hasta (días).
  • Intervalo entre turnos: la grilla de inicio (15, 30 minutos…).
  • Duración: fija, o varias duraciones (de 2 a 6) que elige el cliente, cada una con su precio. Los servicios de día completo dejan que el cliente elija solo el día. Hay colchón antes y después.
  • Precio: fijo, desde o calculado por el formulario (solo por formulario).
  • Al reservar: sin cobro, seña o pago total (el total requiere Mercado Pago).
  • Dónde: en el local, en la dirección del cliente (con zonas), a elección del cliente u online con enlace de reunión.
  • El bot ofrece: interruptor para sacar el servicio del bot sin pausarlo.

Ejemplo: «Revisión completa» de 2 h, equipo «Mecánicos» más un box, seña del 30 % y «El bot ofrece» encendido.

Crear un servicio desde un texto

En Mi negocio → Catálogo → Nuevo servicio → Agregar con IA, escribí el servicio con tus palabras, por ejemplo: «Corte 30 min $ 5000 con barba opcional».

  • La duración y el precio se leen por reglas; el nombre, por la IA.
  • Revisás y confirmás antes de crear.
  • Un extra opcional («con barba») se sugiere como otro servicio: los servicios no tienen adicionales integrados.

También podés importar varios servicios de una vez, desde una foto de la lista de precios o desde ejemplos, en la hoja del catálogo (importar desde foto / ejemplos).

Pausar y duplicar

Pausar deja de ofrecer el servicio para pedidos nuevos en bot, reserva pública, Wagy y MCP. Las tareas ya agendadas pueden reprogramarse, reasignarse, completarse y cancelarse con los permisos y validaciones habituales. La pausa no elimina los controles de horario ni capacidad. Reactivar vuelve a ofrecerlo. Pausar y desactivar son la misma acción.

Duplicar crea « (copia)» pausado con precio, reglas, requisitos, formulario, productos, horario independiente y etapas. No copia tareas, resultados ni opiniones. Requiere permiso de catálogo; sin permiso para editar etapas usa las etapas base del proyecto y lo avisa. Revisá la copia y reactivala cuando esté lista.

En el detalle abrí ⋯ → Duplicar o Pausar. En escritorio también hay un menú en la lista. Wagy propone ambas acciones y espera la confirmación del plan. MCP permite pausar con update_service(active=false, confirm=true); duplicar aún no tiene herramienta MCP.

Eliminar y archivar

Pausado y archivado no son lo mismo. Pausado es temporal: el servicio, producto, equipo o recurso se ve atenuado en el catálogo con «Reactivar» y no aparece en los filtros de trabajo ni en el bot. Archivado es definitivo para la vista: solo se ve en «Archivados» (al final del catálogo, plegado y oculto si está vacío), con «Restaurar».

⋯ → Eliminar borra de verdad si no tiene historial (ninguna tarea, cobro ni registro que lo use) y lo archiva si lo tiene; el diálogo dice cuál de las dos pasa. Un archivado desaparece de todo (catálogo, filtros, selectores, bot, web del negocio, Wagy y sugerencias), pero las tareas y cobros viejos siguen mostrando su nombre. Si tiene tareas futuras no se elimina: se muestran para reasignarlas o cancelarlas primero. Restaurar lo deja pausado.

Los filtros y selectores ofrecen solo lo activo; un pausado o archivado se ofrece únicamente si hay tareas con él, marcado «(pausado)» o «(archivado)». API y MCP: DELETE con ?mode=remove|archive|delete (permiso de administración; sin mode pausa, como siempre), GET …/removal para ver qué pasaría y POST …/restore.

Probar un flujo

En Mi negocio → Etapas, dentro de un flujo, ▶ Probar flujo (en el celular, ▶ Probar) recorre el borrador que tenés en pantalla, aunque no lo hayas guardado. Solo lo ve quien puede editar flujos (el Dueño).

  • Ver como: Equipo ve todas las pantallas; Cliente ve solo los ítems y botones marcados «Cliente». Si una etapa no tiene nada para el cliente, la prueba dice «El cliente no ve esta etapa: la completa el equipo» y ofrece seguir como equipo.
  • Datos: completá cada ítem o tocá Completar con ejemplo. Un botón no avanza si faltan los ítems que pide, y la prueba dice cuáles.
  • Caminos: los botones de la etapa y, para el equipo, las salidas fijas que corresponden a ese punto (Cancelar, Reprogramar, No vino y, en atención, Cerrar sin completar con su motivo).
  • Mapa y registro: el mapa marca por dónde va la prueba. Qué pasaría lista cada paso: el aviso al cliente o al equipo (con el texto de ejemplo del mensaje), la asignación y los datos que se guardarían.
  • Reiniciar vuelve a la primera etapa.

La prueba no guarda nada, no avisa a nadie, no cobra y no manda mensajes, y no deja tareas, historial ni auditoría. No simula tiempos ni recordatorios diferidos, ni el link del cliente ni el cobro.