# Procedimientos operativos

Leé únicamente el procedimiento pertinente. Los ejemplos son intenciones de usuario; construí los argumentos con los esquemas actuales y los datos consultados, sin copiar IDs ficticios.

## 1. Preparar salidas de un día

Pedido: «Prepará la operación del 15 de septiembre: salidas, ocupación y recursos».

Consultá tours y grupos activos aplicables a esa fecha; respetá vigencias y días de semana. Consultá reservas del día con `desde=2026-09-15`, `hasta=2026-09-16`, recorriendo páginas. Relacioná por identificadores de grupo y tour, no por nombre. Consultá disponibilidad por grupo y fecha, y bloqueos que intersecten el período. Obtené recursos explícitos cuando la tarea necesite revisar asignaciones; su ausencia puede significar recurso heredado del grupo, no necesariamente falta de recurso.

Entregá horario, tour, reservas/ocupación, cupos calculados y observaciones comprobadas. Separá «sin asignación explícita» de «sin recurso». No prometas que un bloqueo de guía evita sobreventa. No cambies asignaciones ni estados por el simple pedido de preparar un resumen.

## 2. Crear una reserva de catálogo

Pedido: «Reservá esta salida para estos pasajeros».

Resolvé tour, grupo, fecha, tarifas y campos obligatorios con `tours_consultar`, `tours_grupos_consultar`, `tours_tarifas_consultar` y `tours_campos_consultar`. Buscá el cliente; crealo solo si corresponde y está autorizado. Identificá recursos y pasajeros según los tipos del esquema; no inventes nombres, edades, tarifas ni respuestas obligatorias.

Consultá disponibilidad actual. Si el pedido dice bote o lancha, consultá recursos con `tipo=embarcacion` y `familia=acuatico`; después validá el recurso concreto con la salida mediante `disponibilidad_consultar`. Construí la solicitud completa y una clave UUID. Ejecutá `reservas_crear`; dejá al sistema calcular precio, IVA y descuentos. Un conflicto comercial no se soluciona forzando cupos. Usá el recibo devuelto para informar número, negocio, fecha/hora efectiva, zona, tour, salida, recurso, estados, filtros y enlace al panel. Crear no equivale a cobrar ni a una confirmación del cliente. Generá un enlace únicamente si el usuario lo pidió y el permiso existe.

## 3. Editar pasajeros o recursos conservando el resto

Pedido: «Cambiá este pasajero y dejá lo demás igual».

Leé reserva, todos sus pasajeros y todos sus recursos; cada página debe compartir `reserva_version` y `colecciones_version`. Consultá las tarifas y la configuración del tour si son necesarias para representar los pasajeros. Guardá una copia completa del estado actual y aplicá solo la diferencia autorizada. Mantené cliente y otros pasajeros/recursos intactos.

Si faltan campos por privacidad o existen campos históricos que la herramienta no puede representar, detené el reemplazo y explicá la limitación. Ejecutá `reservas_editar` con ambas versiones y la colección completa. Ante conflicto, reiniciá la lectura y conciliá la diferencia; nunca conviertas un fallo de lectura en una colección vacía. Verificá el recibo, incluida la nueva fecha/hora, los filtros y `panel_url`; una reserva movida puede desaparecer de la vista anterior sin haberse perdido. Confirmá tanto el cambio pedido como la conservación de los demás datos.

## 4. Bloquear un recurso por mantenimiento

Pedido: «Bloqueá este recurso del 15 al 17 de septiembre, inclusive».

Identificá el recurso y consultá bloqueos/reservas que intersectan el período. Mostrá reservas afectadas sin cancelarlas automáticamente. Para consultar ese intervalo usá fin exclusivo 18 de septiembre; para guardar el bloqueo usá fin inclusivo 17. Ejecutá `disponibilidad_crear` si el alcance está autorizado, con tipo y referencias coherentes. Al editar, enviá alcance y rango completos según el esquema, evitando referencias del alcance anterior. Verificá el bloqueo; advertí si se trata de guía porque no reduce cupos del motor.

## 5. Revisar y registrar un cobro manual

Pedido de revisión: «Mostrame los reportes manuales pendientes de estas reservas».

Consultá reservas y `pagos_consultar` por reserva; compará importes, moneda y estado sin confirmar nada. Para un pedido posterior de registrar o confirmar, obtené las versiones actuales y evidencia de importe recibido aportada por la persona; un QR o enlace abierto no es evidencia de recepción. Las herramientas manuales aceptan USD: un ingreso en otra moneda requiere un flujo adecuado, sin conversión inventada.

Elegí registrar dinero nuevo o confirmar un reporte pendiente existente; no hagas ambas acciones para el mismo cobro. Usá `confirmar_reserva` conforme a la intención explícita, no como efecto supuesto. Presentá la aprobación humana y repetí la solicitud exacta una vez aprobada. Consultá el resultado y diferenciá pago registrado, reserva confirmada y cualquier saldo pendiente.

## 6. Cancelar, devolver dinero o eliminar

Pedido: «Cancelá esta reserva y devolvé el pago indicado».

Son dos operaciones independientes: consultá reserva y pagos, comprobá qué permite el estado y ejecutá solo las acciones pedidas. Para la devolución verificá pago, importe, moneda y versiones actuales después de cualquier cambio previo. Presentá la solicitud humana. Tras ejecutarla, conservá `operacion_id` y consultá `pagos_reembolso_estado`; no afirmes dinero devuelto hasta un estado terminal aprobado. Un resultado incierto se reconcilia, nunca se reenvía con otra clave.

La reconciliación la realiza el servidor; no hay una herramienta para forzarla. Un caso en atención requiere revisión humana del pago y del proveedor, con el identificador del intento para soporte.

Si el pedido es eliminar, comprobá elegibilidad, dependencias y versión; mostrale la aprobación al humano. No canceles ni borres cobros para fabricar elegibilidad sin autorización expresa. Eliminar no es una alternativa equivalente a cancelar.

## 7. Cierre mensual y exportación

Pedido: «Resumí septiembre de 2026 y prepará los CSV».

Usá `reportes_consultar` con `desde=2026-09-01`, `hasta=2026-10-01` y marca solo si corresponde al alcance pedido. No sumes una página de reservas para estimar ventas. Separá ventas por salida, caja por pago y gastos por fecha; mantené desglose por monedas, IVA y conversiones históricas disponibles. No interpretes ingreso de reservas como saldo de banco.

Con permiso e instrucción de exportación, usá `reportes_exportar`. Entregá sus tres CSV de agregados, identificados por período y criterio. Si tu cliente no puede crear archivos, indicá el límite y ofrecé el contenido permitido; no inventes enlaces de descarga ni una exportación de detalle que el servidor no produce.

## 8. Mantener catálogo, clientes y gastos

Buscá coincidencias antes de crear un cliente o recurso. Para editar campos básicos de un tour o recurso, leé su versión y preservá lo omitido. Crear un tour lo deja inactivo por defecto y no crea grupos ni tarifas: informá lo que falta configurar en el panel antes de venderlo. No prometas crear cuentas de guías o conectar calendarios externos.

En gastos, verificá fecha, concepto permitido, moneda e importe; conservá las referencias autorizadas a tour/reserva/marca. Las conversiones históricas devueltas por el sistema no se reemplazan por una tasa actual inventada. Para tareas con varios registros, llevá un recibo por intención, verificá cada resultado y distinguí éxitos, fallos y pendientes; no prometas una transacción global para un lote de herramientas independientes.