Ir al contenido

Paridad de precios para motores de reservas y grupos hoteleros.

Comparamos el precio en la web de cada hotel con Booking.com, Expedia y los vendedores que ese hotel sigue en los resultados de búsqueda de hoteles. Cuando dos lecturas coinciden, la disparidad entra en la lista del hotel. El webhook firmado que documentamos abajo envía cada nueva disparidad de precio a tu endpoint.

POSThttps://pms.example.com/hooks/paritydisparity.opened
Content-Type: application/json
webhook-id: ns4k8w2q7c1m9x5t3h6v0b2r8d7f4j1g
webhook-timestamp: 1791549711
webhook-signature: v1,Xq0c…e21a=
 
{
  "version": 4,
  "id": "ns4k8w2q7c1m9x5t3h6v0b2r8d7f4j1g",
  "event": "disparity.opened",
  "disparityId": "jn7cq2b1x9d8w4fzr3m6kt5v0h7s2e8a",
  "hotel": { "id": "kd72mbx0vy4p9s1c6tqh8wf3gr5n2j7e", "name": "Hotel Aurora" },
  "ota": "booking",
  "stayDate": "2026-10-16",
  "occupancy": 2,
  "currency": "EUR",
  "directPriceMinor": 18800,
  "otaPriceMinor": 17900,
  "deltaMinor": 900,
  "directPriceEurMinor": 18800, "otaPriceEurMinor": 17900, "deltaEurMinor": 900,
  "deltaPct": 4.79,
  "trust": "seen_twice",
  "findingKind": "rate_disparity",
  "evidence": { … },
  "detectedAt": "2026-10-09T12:02:00.000Z"
}

Ilustrativo. El Hotel Aurora es ficticio.

Sin depender de ningún motor de reservas.

Tomamos el precio en la web de cada hotel de los resultados de búsqueda de hoteles, así que hoy cubrimos hoteles con cualquier motor de reservas.

Desde los resultados de búsqueda de hoteles

Usamos el precio que la web oficial de cada hotel muestra en los resultados de búsqueda de hoteles (Google Hotels), para la misma noche y el mismo número de huéspedes que los vendedores.

Nada que instalar

Sin acceso al motor, al Channel Manager ni al PMS, y nada en la web del hotel. Nuestro equipo configura cada hotel.

Las mismas revisiones para todos los hoteles

Sea cual sea el motor con el que funcione un hotel, tiene las mismas revisiones, su propia lista y las mismas alertas.

Un evento firmado cuando se abre una disparidad de precio.

Se envía en JSON al endpoint de cada hotel, con la versión en el primer campo.

Campos del mensaje

version
Hoy siempre es 4. Pueden añadirse campos sin cambiar la versión, así que ignora los que no conozcas.
id
Identificador del envío. Cada reintento lleva el mismo, en el cuerpo y en la cabecera webhook-id: úsalo para no procesar duplicados.
event
disparity.opened indica una nueva disparidad. Es el único evento disponible.
disparityId
Identificador de la disparidad.
hotel
Identificador y nombre del hotel en StayParity.
ota
Código de canal en minúsculas: booking, expedia o el vendedor que aparezca en los resultados de búsqueda.
stayDate
Fecha de estancia en formato YYYY-MM-DD.
occupancy
Número de huéspedes por habitación.
currency
Moneda del hotel, código ISO 4217 como EUR o RON. Los tres campos siguientes se expresan en ella.
directPriceMinor
El precio en la web del hotel, en unidades menores de su moneda.
otaPriceMinor
Precio del canal en unidades menores de la moneda del hotel.
deltaMinor
Cuánto menos cobra el canal, en unidades menores de la moneda del hotel.
directPriceEurMinor
El precio en la web del hotel, en céntimos de euro.
otaPriceEurMinor
Precio del canal en céntimos de euro.
deltaEurMinor
Cuánto menos cobra el canal, en céntimos de euro.
deltaPct
La misma diferencia como porcentaje del precio en la web del hotel, con dos decimales.
trust
Siempre seen_twice: dos lecturas de los resultados de búsqueda de hoteles con al menos 30 minutos de diferencia, sobre la misma base, con precios a menos de un 1 % entre sí.
reason
now_over_threshold cuando una disparidad ya abierta por debajo de tus umbrales los ha superado después. No aparece en una nueva.
findingKind
Siempre rate_disparity: la misma habitación, en las mismas condiciones, más barata en el vendedor.
evidence
La primera lectura de la disparidad y la más reciente, cada una con las dos ofertas tal como se leyeron: precio, fuente, momento, habitación, régimen y condiciones de cancelación.
detectedAt
Momento de la primera detección en UTC.

Envío y reintentos

  • POST con Content-Type application/json a una dirección HTTPS pública
  • Una respuesta 2xx en 10 segundos confirma la recepción
  • Las respuestas 5xx y los tiempos de espera agotados generan reintentos con intervalos crecientes
  • Las respuestas 4xx son rechazos y no se reintentan
  • No seguimos redirecciones, así que indica la URL final

Qué disparidades se envían

  • La regla de alerta de cada hotel fija la diferencia mínima, en la moneda del hotel y en porcentaje
  • Se envían las disparidades de los vendedores que sigue el hotel, para la misma habitación que el hotel, ambas asignadas a uno de los tipos de habitación del hotel. Las que no indican ninguna habitación quedan en la lista y en el resumen por email
  • El evento se genera al abrir la disparidad, no repetidamente mientras sigue abierta
  • Cada hotel puede enviar a su propio endpoint, o varios al mismo

HMAC-SHA256 sobre el identificador, la marca de tiempo y el cuerpo original.

Sigue Standard Webhooks, así que la biblioteca oficial puede verificarla en la mayoría de lenguajes.

webhook-id: <the payload's id>
webhook-timestamp: <unix seconds>
webhook-signature: v1,<base64 HMAC‑SHA256>
  1. 1Lee tres cabeceras: webhook-id, webhook-timestamp (segundos Unix) y webhook-signature, que lleva v1, una coma y la firma en base64.
  2. 2Calcula HMAC-SHA256 sobre el id, un punto, la marca de tiempo, un punto y el cuerpo tal como llegó. La clave es tu secreto sin whsec_, decodificado desde base64.
  3. 3Compara las dos en tiempo constante y rechaza una marca de tiempo demasiado lejana, para que nadie pueda reenviar una petición capturada.
  4. 4Cada reintento conserva su webhook-id y se firma de nuevo, con su propia marca de tiempo.

Un solo secreto de firma por cuenta firma los envíos de todos los hoteles de la cuenta. Un administrador lo crea en la aplicación y lo ve una sola vez; crear uno nuevo sustituye al anterior.

Verificación en Node.js

JavaScript
import { createHmac, timingSafeEqual } from "node:crypto";

// Or let the official library do it: npm install standardwebhooks, then
// new Webhook(secret).verify(rawBody, headers) throws unless it checks out.
// rawBody: the request body exactly as it arrived, before JSON.parse.
// headers: the request headers, with Node's lower-case names.
// secret: your whole signing secret, whsec_ prefix included.
function verify(rawBody, headers, secret, toleranceSeconds = 300) {
  const id = headers["webhook-id"];
  const timestamp = Number(headers["webhook-timestamp"]);
  if (!id || !Number.isInteger(timestamp)) return false;
  if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;
  const key = Buffer.from(secret.replace(/^whsec_/, ""), "base64");
  const expected = createHmac("sha256", key).update(`${id}.${timestamp}.${rawBody}`).digest();
  return String(headers["webhook-signature"] ?? "").split(" ").some((entry) => {
    const [version, signature = ""] = entry.split(",", 2);
    const given = Buffer.from(signature, "base64");
    return version === "v1" && given.length === expected.length && timingSafeEqual(given, expected);
  });
}

Python, PHP, reintentos y pruebas en la documentación del webhook

Todos tus establecimientos en una cuenta.

Para un grupo hotelero, o para los hoteles que nos traes como socio.

Cada hotel, con su lista

Cada hotel tiene sus propias disparidades y su regla de alerta, y desde la aplicación pasas de uno a otro.

Tu equipo, con roles

Los administradores gestionan el equipo y el secreto de firma. Los miembros trabajan la lista y configuran las alertas.

Lo configuramos nosotros

Nuestro equipo da de alta cada hotel, su regla de alerta y los accesos de tu equipo. Tus hoteles no instalan nada.

Recomiéndanos a tus hoteles o revende StayParity.

Cuéntanos cómo trabajas con hoteles y acordamos juntos las condiciones.

Recomendar

Preséntanos los hoteles con los que trabajas. Nosotros los damos de alta y los atendemos.

Revender

Ofrece StayParity a tus hoteles como parte de lo que ya les vendes.

Lo primero que preguntan los socios.

No. Usamos el precio que los resultados de búsqueda de hoteles muestran para la web oficial de cada hotel, sea cual sea el motor con el que funcione.

Empieza tu prueba gratuita

Dinos tu web. Revisamos tus próximos 30 días.

Sin tarjeta ni instalación. Tus próximos 30 días, frente a Booking.com, Expedia y las demás grandes OTAs.