Rate shopping comparando lo comparable

Al terminar tendrás un comando que responde a "dónde estoy de verdad frente a mi compset esta noche" — producto a producto, en vez de la tabla de tarifa-más-barata-por-hotel que compara en silencio una flexible contra una no reembolsable.

Qué necesitas: el hotel en tu cuenta con su compset relleno, el feed de Accommodation Rates activo y un import terminado.

Lo que cuesta: nada por ejecución. Las lecturas Feed no se facturan por petición — los créditos se van en los imports que recogen las tarifas.

El informe que todo el mundo monta primero, y por qué miente

Tarifa más barata de cada hotel, una al lado de otra. Es la comparación evidente y falla sin llegar a parecer rota nunca.

Esta es una noche real del feed, puesta como toca:

La tarifa más barata por hotel dice: 411,40 · 567,40 · 1.010,90. Estás un 28 % por debajo del Competidor A. Buena noticia, y falsa.

El Competidor A no vende ninguna tarifa flexible. Esos 567,40 son no reembolsables. Estás comparando tu tarifa cancelable en cualquier momento contra una que el huésped no puede cancelar, y llamando gap de precio a la diferencia. En el producto que ambos vendéis de verdad no hay nada que comparar — y eso es en sí mismo el hallazgo, el que nunca sobrevive a un informe de un solo número.

Dos cosas más que se ven en la rejilla y son invisibles en la lista:

• La no reembolsable del Competidor B cuesta más que su flexible — 2.220,90 contra 1.010,90. "La no reembolsable es la barata" es una suposición, no una regla, y aquí está del revés.
• Tú no vendes nada en la columna de no reembolsable. Sea deliberado o un descuido, es una decisión que tomar — y no puedes tomarla si el informe promedia el hueco hasta hacerlo desaparecer.

1. Pon las tarifas a correr

Da de alta el hotel en Accommodations y rellena su compset — hasta diez competidores. Sin ellos esta receta imprime una lista de precios, no una comparación.

Después lanza un import en Accommodation Rates y pon un schedule. El feed solo responde por las fechas que ya haya cubierto un import: pide una noche que nadie importó y recibes un 404 limpio.

2. Lee el endpoint correcto

GET /v2/feed/accommodation/{slug}/rate/v7/{fecha}

Usa v7. La ruta antigua /rate hace de proxy contra el backend legacy y devuelve otra forma — una trampa que conviene conocer antes de montar un parser alrededor de la equivocada.

Lo que vuelve es { report: { [slug]: [tarifa, ...] } }: tu hotel y todos los competidores en la misma carga, cada tarifa con un bloque _meta que lleva is_primary, accommodation_name, rate_date, visitor_type y device_type.

Una tarifa tiene esta pinta:

{
  "room_type": "Habitación Doble Estándar",
  "price_per_night": 411.4,
  "price_total": 411.4,
  "currency": "EUR",
  "meal_plan": { "breakfast": false, "half_board": false, "full_board": false, "all_inclusive": false },
  "cancellation": { "free_cancellation": true, "free_cancellation_days": null, "no_refundable": false },
  "payment": { "no_prepayment": false },
  "is_genius": false,
  "available_rooms": 1,
  "minimum_nights": 1,
  "_meta": { "is_primary": true, "accommodation_name": "Tu Hotel", "rate_date": "2026-08-21" }
}

meal_plan y cancellation son los dos bloques que hacen posible toda la receta. El resto es detalle.

Existe además ?min_rates=true, que reduce cada hotel a su única tarifa más barata. Es cómodo, y es justo el atajo contra el que argumenta esta receta: es el parámetro que tira a la basura el mix de productos.

3. Define qué significa "comparable"

Dos tarifas son comparables cuando venden lo mismo. Eso es un régimen más una política de cancelación —BB/flex, RO/nr— y las reglas viven en un solo fichero para que se puedan discutir:

export function board(rate) {
  const meal = rate.meal_plan || {};
  if (meal.all_inclusive) return 'AI';
  if (meal.full_board) return 'FB';
  if (meal.half_board) return 'HB';
  if (meal.breakfast) return 'BB';
  return 'RO';
}

// free_cancellation es la que decide; no_refundable es solo el respaldo, porque
// una tarifa puede llegar sin ninguna de las dos banderas puesta.
export function cancellation(rate) {
  const policy = rate.cancellation || {};
  if (policy.free_cancellation) return 'flex';
  return 'nr';
}

export const productKey = (rate) => `${board(rate)}/${cancellation(rate)}`;

El régimen se comprueba del más inclusivo al menos porque las banderas se apilan: una tarifa de todo incluido también trae breakfast: true, y mirar el desayuno primero la archivaría como BB.

4. Monta la rejilla, y deja los huecos abiertos

const matrix = buildMatrix(report);   // producto × hotel
const standing = position(matrix);    // en qué puesto quedas en cada producto

La única regla que importa: una celda ausente se queda en null. Nunca en cero, nunca promediada, nunca rellenada con el precio que ese hotel tiene en otro producto. Una celda vacía significa que el competidor no vende ese producto esa noche, y tratarla como un cero es por donde empieza a mentir un informe de compset.

El ranking sale de ahí — el denominador cuenta solo a los hoteles que venden el producto:

Desayuno · Cancelación gratis   #1 de 2 · eres el más barato
Desayuno · No reembolsable      no vendes este — 2 competidor(es) sí
Solo alojamiento · Flexible     #1 de 2 · eres el más barato
Solo alojamiento · No reemb.    no vendes este — 2 competidor(es) sí

"#1 de 2" es una afirmación más pequeña y más verdadera que "#1 de 3". El compset de tres hoteles solo tiene dos en esa carrera.

5. Ejecútalo

node --env-file=.env index.mjs 2026-08-21
node --env-file=.env index.mjs 2026-08-21 --csv > rates.csv

El CSV da una fila por hotel y producto, listo para una hoja de cálculo o un almacén — y sigue omitiendo las celdas vacías en vez de ponerlas a cero.

Qué viene después

• Recorre un mes con /rate/v7/{año}/{mes} y observa cómo un competidor abre o cierra su inventario flexible según se acerca la fecha. Ese cambio de mix suele aparecer antes que el cambio de precio.
• La misma carga trae is_genius, available_rooms y minimum_nights: un competidor más barato solo en tarifa Genius, o solo con tres noches mínimo, no es realmente más barato.
• Maridala con el feed de paridad. El rate shopping te dice lo que cobra el mercado; la paridad te dice si tus propios canales están de acuerdo entre ellos.