Use Cases (Actualizado: 21/8/2026)

Preflight de CSV de reservas hoteleras para nube con Claude Code

Revisa CSV hoteleros antes de entregarlos a la nube: datos personales, consentimiento, claves y aprobación.

Preflight de CSV de reservas hoteleras para nube con Claude Code

Es viernes por la tarde, recepción prepara un fin de semana completo y el proveedor de marketing pide la exportación de reservas más reciente. Alguien descarga un CSV del sistema del hotel y lo coloca en una carpeta compartida, pero antes de subirlo descubre que la clave prevista en la nube todavía contiene el correo de una huésped. Otra fila incluye una nota de cancelación con información familiar. El problema no es saber usar el botón de carga; el problema es decidir qué filas pueden salir del hotel, qué valores deben eliminarse y quién aprobó la entrega.

Los datos de reservas hoteleras mezclan mucho más que fechas y habitaciones. Pueden incluir nombres, correos, teléfonos, acompañantes, planes, importes, peticiones de comida, necesidades de accesibilidad y notas libres. Una entrega en la nube significa colocar archivos en una ubicación accesible por red para otro equipo o proveedor. Es útil, pero el CSV, la clave de objeto, el enlace firmado y el correo de aviso son superficies distintas de exposición.

Este artículo muestra cómo usar Claude Code para crear un contrato de preflight antes de subir un CSV de reservas. Contrato aquí no significa contrato legal, sino acuerdo técnico repetible sobre columnas obligatorias, valores aceptados, nombres de objeto, consentimiento, fecha de eliminación y revisión humana. El título está limitado a una revisión previa. El código usa solo una fixture local y no llama a AWS S3, Google Cloud Storage, Cloudflare R2 ni otro servicio real.

Puntos clave

  • El flujo sirve para hoteles y turismo que preparan CSV de reservas antes de entregarlos por nube.
  • Claude Code puede comprobar columnas, fechas, consentimiento, claves de objeto y crear un manifiesto seudonimizado.
  • Las personas deciden propósito, alcance del proveedor, retención, contrato y tratamiento de notas sensibles.
  • Lo probado es solo sintaxis JavaScript y ejecución local con fixture. No se probaron autenticación, red, carga, permisos ni eliminación.
  • La CTA principal es formación y consultoría para convertir esto en una regla interna.

Flujo de trabajo: convertir el CSV en un manifiesto de entrega

Los artefactos iniciales son concretos: CSV exportado del sistema de reservas, propósito de negocio, regla de nombres para claves de objeto, fecha de eliminación y checklist del responsable. En lugar de adjuntar el CSV bruto o soltarlo en un bucket compartido, el equipo ejecuta una comprobación local y genera un manifiesto. Ese manifiesto lista los archivos previstos, la fecha de borrado y el estado de revisión sin mostrar nombres de huéspedes.

Conviene revisar fuentes oficiales porque el flujo está entre un agente de código y almacenamiento en nube. Para permisos de Claude Code, lee la documentación de permisos de Anthropic. Para almacenamiento, revisa las buenas prácticas de seguridad de AWS S3 y la documentación de URL firmadas de Google Cloud Storage. Sirven para convertir caducidad corta, mínimo privilegio y revisión de accesos en puntos explícitos.

flowchart TD
  A[Colocar el CSV localmente] --> B[Claude Code inspecciona columnas y valores]
  B --> C[Comprobar claves y consentimiento]
  C --> D[Crear manifiesto seudonimizado]
  D --> E[Persona aprueba propósito y proveedor]
  E --> F[Subir solo tras aprobación]

Flujos cercanos están en agencias de viaje y metadatos de imágenes turísticas en nube. Aquí nos centramos en el paso intermedio: impedir errores antes de entregar un CSV de reservas a terceros.

Qué hace Claude Code y qué decide una persona

Claude Code funciona bien con verificaciones repetibles de contrato de entrada. Puede detectar columnas faltantes, fecha de salida anterior a la entrada, importes no numéricos, consentimiento distinto de yes, claves que parecen contener correos, y filas que requieren revisión. También puede crear un manifiesto con ID de reserva, clave de objeto, fechas, fecha de borrado y bandera de revisión.

Las personas deciden si la entrega es adecuada. Un responsable debe saber qué explicación recibió el huésped, si el contrato del proveedor cubre almacenamiento y subprocesadores, si las notas libres son necesarias, si hay datos de salud, religión, familia o accesibilidad, y si el proveedor necesita datos fila por fila o solo un informe agregado. La salida de Claude Code es material de revisión, no una conclusión legal ni una aprobación de privacidad.

El patrón seguro es no entregar credenciales de carga a Claude Code durante el preflight. Empieza con una carpeta local de solo lectura y una muestra ficticia o anonimizada. El comando de carga, las credenciales, la creación de URL firmadas y los cambios de permisos quedan en un paso separado con aprobación humana. Reglas de denegación y un directorio de trabajo estrecho reducen lecturas accidentales y comandos no previstos.

Tres casos de uso

Caso de uso 1: Encontrar columnas faltantes en exportaciones OTA

Entrada: CSV con ID de reserva, nombre, correo, entrada, salida, importe, consentimiento y clave de objeto. OTA significa agencia de viajes en línea, y los hoteles con varios canales reciben nombres de columnas y formatos distintos.

Salida: Tabla de columnas faltantes, valores vacíos, fechas inválidas, estancia invertida e importes no numéricos. El responsable decide si reexporta, corrige una muestra local o excluye una fila.

Revisión humana: Confirmar que cada canal tiene el mismo propósito permitido. El consentimiento para instrucciones de estancia no equivale a consentimiento para marketing, análisis o procesamiento por proveedor.

Caso de uso 2: Quitar datos personales de claves de objeto

Entrada: Claves candidatas como hotel-a/2026-08/[email protected], junto con nombres, correos y teléfonos. Una clave de objeto es el identificador del archivo en el almacenamiento.

Salida: Se marcan claves con correo, teléfono o fragmento de nombre. Una clave más segura usa hotel-a/2026-08/booking-BK001.csv y evita datos personales en la ruta.

Revisión humana: Decidir si el ID de reserva es seguro para el proveedor. Si permite volver al PMS, puede hacer falta un ID de entrega separado.

Caso de uso 3: Crear el manifiesto para el proveedor

Entrada: CSV revisado, propósito, fecha de eliminación, nombre del proveedor y checklist de aprobación.

Salida: Manifiesto seudonimizado, fecha de borrado, estado de revisión y número de errores abiertos. No es el cuerpo del CSV, sino el registro para aprobar o detener la carga.

Revisión humana: Antes de enviar, confirmar contrato, finalidad, retención, contacto de soporte y ruta de escalado. También decidir si el proveedor necesita todas las filas o basta un resumen.

Prompt para copiar y pegar

Actúa como responsable de preflight para un CSV de reservas hoteleras antes de una entrega en la nube.

Objetivo:
Revisar CSV, claves de objeto, consentimiento y fecha de eliminación, y producir un manifiesto aprobable por una persona antes de subir.

Entrada:
- Nombres de columnas CSV:
- Muestra del CSV:
- Propósito de negocio:
- Proveedor:
- Fecha de eliminación:
- Regla de nombres de claves:
- Criterios de aprobación humana:

Salida:
1. Columnas faltantes y valores inválidos
2. Claves que parecen contener datos personales
3. Filas con consentimiento faltante
4. Manifiesto seudonimizado
5. Asuntos que requieren juicio humano
6. Checklist previo a la carga

Restricciones:
- No conectar con un servicio real de nube
- No conservar datos personales en ejemplos
- No afirmar conclusiones legales
- No insertar ClaudeCodeLab, /training/ ni CTA del sitio en el artefacto generado

Código de comprobación ejecutable

Si quieres guardarlo, usa una ruta como tools/hotel-booking-handoff-preflight.mjs en tu propio repositorio. Este artículo no implica que el archivo exista en este repositorio. El código solo lee una fixture fija; no usa SDK, CLI, API, credenciales ni red.

const requiredColumns = [
  "booking_id",
  "guest_name",
  "email",
  "checkin",
  "checkout",
  "amount_jpy",
  "consent",
  "object_key"
];

const bookingCsv = `booking_id,guest_name,email,checkin,checkout,amount_jpy,consent,object_key
BK001,Aoi Sato,[email protected],2026-09-01,2026-09-03,42000,yes,hotel-a/2026-09/booking-BK001.csv
BK002,Ren Mori,[email protected],2026-09-05,2026-09-04,31000,yes,hotel-a/2026-09/booking-BK002.csv
BK003,Mika Ito,[email protected],2026-09-08,2026-09-10,not-a-number,no,hotel-a/2026-09/[email protected]`;

function parseCsv(text) {
  const [headerLine, ...rows] = text.trim().split("\n");
  const headers = headerLine.split(",");
  return rows.map((line) => {
    const values = line.split(",");
    return Object.fromEntries(headers.map((header, index) => [header, values[index] ?? ""]));
  });
}

function isIsoDate(value) {
  return /^\d{4}-\d{2}-\d{2}$/.test(value) && !Number.isNaN(Date.parse(value));
}

function validateRows(rows) {
  const errors = [];
  const manifest = [];

  for (const [index, row] of rows.entries()) {
    for (const column of requiredColumns) {
      if (!(column in row) || row[column].trim() === "") {
        errors.push(`row ${index + 1}: missing ${column}`);
      }
    }

    if (isIsoDate(row.checkin) && isIsoDate(row.checkout) && row.checkin >= row.checkout) {
      errors.push(`row ${index + 1}: checkout must be after checkin`);
    }

    if (!Number.isFinite(Number(row.amount_jpy))) {
      errors.push(`row ${index + 1}: amount_jpy must be numeric`);
    }

    if (row.consent !== "yes") {
      errors.push(`row ${index + 1}: consent must be yes before handoff`);
    }

    const hasPersonalKeyPattern = /@|(?:^|[^\d])(?:\+?\d{2,}[- ]\d{2,}[- ]\d{3,})(?:[^\d]|$)/.test(row.object_key);
    if (hasPersonalKeyPattern || row.object_key.includes(row.guest_name.split(" ")[0].toLowerCase())) {
      errors.push(`row ${index + 1}: object_key may contain personal data`);
    }

    manifest.push({
      booking_id: row.booking_id,
      object_key: row.object_key,
      checkin: row.checkin,
      checkout: row.checkout,
      delete_after: "2026-10-31",
      reviewer_required: true
    });
  }

  return { errors, manifest };
}

const rows = parseCsv(bookingCsv);
const result = validateRows(rows);
console.log(JSON.stringify(result, null, 2));

Este código solo demuestra que una fixture local se puede revisar por columnas, fechas, importes, consentimiento y patrones de clave. No demuestra permisos de nube, creación de URL firmada, éxito de carga, recepción por proveedor, retención ni eliminación. Mezclar esos límites hace que el equipo confunda “revisado localmente” con “compartido de forma segura”.

Pitfall: causas y correcciones concretas

Causa 1: cada canal usa nombres de columna distintos. Un origen usa guest_name y otro name; uno usa arrival y otro checkin. Sin una tabla de mapeo, Claude Code no debe asumir equivalencia. Corrige con una tabla de columnas de una página y revisión antes y después de la conversión.

Causa 2: claves demasiado legibles para humanos. Nombres, correos, teléfonos, notas de habitación o motivos de cancelación en la ruta exponen datos incluso sin abrir el archivo. Corrige usando ID de reserva, carpetas por mes y nombres neutrales, sin nombres de huéspedes en el manifiesto.

Causa 3: un único checkbox de consentimiento. Instrucciones de estancia, marketing, tratamiento por proveedor, reenvío de encuestas y análisis entre propiedades son finalidades distintas. Corrige separando columnas por finalidad y deteniendo filas sin permiso para el uso pedido.

Causa 4: tratar una carga exitosa como control de seguridad. La carga solo prueba que el servicio aceptó el objeto. No prueba privacidad, caducidad breve del enlace ni eliminación futura. Corrige separando preflight local, revisión posterior de permisos y revisión de retención.

Medición pequeña de ROI

No inventes ahorros. Durante una semana registra reexportaciones de CSV, correos de rechazo del proveedor, filas corregidas antes de subir, minutos de aprobación y filas detenidas por falta de consentimiento. Con eso basta para ver si baja el retrabajo.

El ROI debe mirar primero reducción de retrabajo y riesgo, no ingresos inmediatos. Compara minutos por entrega, minutos de corrección por archivo rechazado, filas sin resolver al aprobar y problemas capturados antes de que el proveedor viera el archivo. Cada hotel tiene volumen distinto, por eso no se afirma ningún benchmark.

Preguntas frecuentes

Q. ¿Puedo pegar el CSV real en Claude Code?

A. Empieza con una muestra mínima seudonimizada. Si hay que usar producción, define reglas internas, contratos, permisos, logs y retención antes.

Q. ¿Una URL firmada es segura por defecto?

A. Limita tiempo y acción, pero siguen importando destinatario, caducidad, permisos y reenvío. Lee la documentación oficial y diseña con caducidad corta y mínimo privilegio.

Q. ¿Qué nube debería elegir un hotel?

A. Este artículo no compara productos. Elige por plataforma estándar, logs de auditoría, modelo de permisos, operación de borrado y forma de recepción del proveedor.

Q. ¿Cuándo conviene pedir ayuda?

A. Antes de reutilizar CSV de reservas para outsourcing, campañas, análisis o varias propiedades. Si el equipo discute las mismas comprobaciones cada semana, formación y consultoría puede convertir el flujo en una regla clara.

Qué probé realmente

El 2026-08-21 mantuve el JavaScript ejecutable con node --input-type=module -e y confirmé que la fixture fija emite lista de errores y JSON de manifiesto. Es una comprobación de sintaxis y ejecución local. No probé autenticación de nube, URL firmadas, carga, cambios de permisos, recepción por proveedor ni eliminación.

También seleccioné heroImage como /images/hero/hero-040.webp, que corresponde a site/public/images/hero/hero-040.webp, y revisé slug, fechas de frontmatter, enlaces internos, CTA y URL oficiales. El siguiente paso práctico es crear una muestra de tres filas seudonimizada y adaptar columnas obligatorias y regla de claves a la política del hotel.

#claude-code #hotel #csv-reservas #nube #privacidad
Gratis

PDF gratis: cheatsheet de Claude Code

Introduce tu email y descarga una hoja con comandos, hábitos de revisión y flujos seguros.

Cuidamos tus datos y no enviamos spam.

Masa

Sobre el autor

Masa

Ingeniero enfocado en workflows prácticos con Claude Code.