Deutsch
English
Español
Français
NederlandsEste artículo proporciona una guía sobre cómo leer e interpretar los registros del Channel Manager, para ayudar a la resolución de diferentes problemas que puedan surgir. Los registros del Channel Manager pueden incluir actualizaciones de inventario enviadas desde Mews, y nuevas reservas realizadas a través del Channel Manager. Los registros pueden ser importantes para el equipo de asistencia del Channel Manager para resolver las consultas. Para una explicación de cómo acceder a los registros de Channel Manager, consulta Cómo acceder a los registros del Channel manager.
Nota: los registros se almacenan durante un máximo de 30 días, por lo que no se puede acceder a los datos de más de 30 días.
|
Integraciones Channel Manager Nos referimos a la cola y a los registros de mensajes como la cola del Channel Manager y los registros de mensajes del Channel Manager. La mayoría de estas integraciones son, de hecho, a los Channel Managers, sin embargo hay que tener en cuenta que estas integraciones también podrían incluir canales directos como sistemas centrales de reservas o agencias de viajes en línea, que no son a través de un Channel Manager. Sin embargo, todas ellas funcionan de forma similar, enviando actualizaciones de tarifas, disponibilidad e inventario desde Mews al canal, y recibiendo las reservas desde el canal a Mews. |
Casos de uso general
Los siguientes ejemplo son sólo aplicables a integraciones generales que usen Mews Open API y no integraciones especiales como SiteMinder o SynXis. En todos los Casos de uso general, los datos están en formato JSON.
Contenido
- Actualización de inventario - comprobar el número de las habitaciones
- Actualización de inventario - comprobar el precio
- Actualización de inventario - ¿Qué habitaciones hemos cerrado?
- Reservas - ¿Faltan datos de los huéspedes?
- Reservas - resolución de problemas con tarjetas de pago
- Reservas - ¿Dónde puedo ver el precio por noche?
- Reservas - ¿Dónde puedo ver el recuento de huéspedes?
- Reservas - ¿Dónde puedo ver que productos están reservados?
- Reservas - ¿Dónde puedo ver el precio total?
- Reservas - ¿Hay un perfil de empresa vinculado?
- Reservas - ¿Qué canal se usó?
- Reservas - resolución de problemas con números de reserva
1. Actualización de inventario - comprobar el número de las habitaciones
|
Ejemplo de uso: "Quiero comprobar la cantidad de habitaciones disponibles para una categoría de habitación específica (por ejemplo, DBL) enviada al Channel Manager como parte de una actualización de inventario" |
La cantidad de habitaciones disponibles se muestra frente "availability" bajo el "spaceTypeCode" correspondiente. En el siguiente ejemplo, hay 16 habitaciones DBL disponibles:
{
"availabilities": [
{
"spaceTypeCode": "DBL",
"availability": 16,
"from": "2021-07-22",
"to": "2021-07-22"
}
],
"clientToken": "{ClientToken}",
"connectionToken": "{Token}"
}
2. Actualización de inventario - comprobar el precio
|
Ejemplo de uso: "Quiero revisar el precio de un plan de tarifas concreto enviado al Channel Manager como parte de una actualización de inventario" |
El precio se muestra para una cantidad determinada de huéspedes y en una moneda concreta, todo ello con un código de plan de tarifas y un código de tipo de habitación determinados. En el ejemplo siguiente, el precio es de 100,00 euros brutos o 93,46 euros netos, con el tipo de espacio "D1" y el plan de tarifas "FF":
"ratePrices": [
{
"spaceTypeCode": "D1",
"ratePlanCode": "FF",
"prices": [
{
"grossAmount": 100.00,
"netAmount": 93.46,
"currencyCode": "EUR",
"guestCount": 1
},
3. Actualización de inventario - ¿Qué habitaciones hemos cerrado?
|
Ejemplo de uso: "En una actualización de inventario, quiero ver qué habitaciones hemos cerrado y qué habitaciones tienen restricciones de tiempo de estancia" |
Las habitaciones o espacios cerrados son los que se muestran con el estado de restricciones "2", como en el ejemplo siguiente. Esto se describe en la documentación de la API.
"restrictions": [
{
"ratePlanCode": "BTR",
"spaceTypeCode": "RCS",
"state": [
2,
8
],
"minLos": null,
"maxLos": null,
"from": "2022-07-20",
"to": "2022-07-20"
},
En el caso de las habitaciones cerradas, también verás uno o varios estados adicionales "6", "7" u "8" para indicar si la habitación está cerrada a la llegada, a la salida, a la estancia o una combinación.
Estado de restricción
| Código | Descripción |
|---|---|
| 1 | Abierto |
| 2 | Cerrado |
| 3 | - |
| 4 | - |
| 5 | - |
| 6 | Cerrado a la llegada |
| 7 | Cerrado a la salida |
| 8 | Cerrado a la estancia |
Puedes encontrar más ejemplo en la documentación API.
4. Reservas - ¿Faltan datos de los huéspedes?
|
Ejemplos de uso: "Quiero comprobar el registro de reservas para ver si falta el número de teléfono de un huésped u otros datos del mismo en una reserva concreta" |
En este caso, puedes encontrar la reserva y comprobar los datos directamente. Si el campo "teléfono" no aparece o está en blanco, significa que el Channel Manager no ha enviado ningún número de teléfono, por lo que debes ponerte en contacto con el servicio de asistencia de Channel Manager.
Puedes encontrar la reserva específica filtrando los datos del registro de mensajes según los parámetros adecuados, como las horas de inicio y fin. Si utilizas varios Channel Managers, filtra también por nombre de Channel Manager.
El registro de datos de clientes o huéspedes se ven de esta manera:
"customer": {
"address": {
"addressLine1": "Some street 123",
"addressLine2": "Some other detail",
"city": "Some city",
"country": "US",
"latitude": 30,
"longitude": 20,
"region": "Some region",
"zip": "123 45"
},
"email": "[email protected]",
"firstName": "John",
"lastName": "Smith",
"nationalityCode": "US",
"languageCode": "en-US",
"telephone": "1-3526-88918"
},
5. Reservas - resolución de problemas con tarjetas de pago
|
Ejemplos de uso: "Quiero ver la información de la tarjeta de pago para una reserva en particular." |
Un registro de tarjeta de pago puede aparecer como parte de un registro de reserva, como en el ejemplo siguiente. Por razones de seguridad, el número de tarjeta nunca se mostrará en los registros, sino que se sustituirá por "XXXXXXXXXXXX" o por un texto aleatorio. Del mismo modo, el número CVV será un número ficticio. Los únicos datos válidos son el nombre del titular de la tarjeta y la fecha de caducidad de la misma.
"paymentCard": {
"cvv": "666",
"expireDate": "1222",
"holderName": "John Smith",
"number": "XXXXXXXXXXXXXX,
"type": 1
}
6. Reservas - ¿Dónde puedo ver el precio por noche?
|
Ejemplo de uso: "Quiero ver el precio de cada noche de la estancia, para una reserva concreta" |
Los precios por noche de estancia se muestran como "amounts" en el registro de la reserva, con un importe por noche del periodo total de estancia. Por ejemplo:
"reservations": [
{
"adultCount": 2,
"code": "02",
"from": "2020-05-06",
"to": "2020-05-09",
"amounts": [
{
"net": 81,
"gross": 100
},
{
"net": 97.2,
"gross": 120
},
{
"net": 97.2,
"gross": 120
}
],
"ratePlanCode": "NR",
"spaceTypeCode": "DBL",
"state": 2,
"totalAmount": {
"net": 275.4,
"gross": 340
}
En este ejemplo la reserva consiste en una estancia de tres noches, con precios de 100, 120 y 120 por cada noche respectivamente. El importe total de la estancia se muestra por separado como 340.
7. Reservas - ¿Dónde puedo ver el recuento de huéspedes?
|
Ejemplos de uso: "Quiero ver el número de huéspedes de una reserva concreta" |
Para ver cuántos adultos y niños han reservado, busca "adultCount" y "childCount" en el registro de la reserva.
Para una integración channel manager que tenga habilitada la opción "Usar categoría de edad en las reservas", puedes buscar 'GuestCounts' en el registro de la reserva.
8. Reservas - ¿Dónde puedo ver que productos están reservados?
|
Ejemplos de uso: "Quiero ver qué productos extras se han reservado en una reserva concreta" |
Para ver qué productos adicionales se reservaron como parte de la estancia, busca "extras" en el registro de la reserva.
"extras": [
{
"code": "1",
"count": 1,
"amount": {
"net": 16.2,
"gross": 20
},
"from": "2021-05-06",
"to": "2021-05-07",
"pricing": 3
}
El producto se identifica con "code", que se asignará a un producto específico en la configuración de integración de Channel Manager. El 'pricing' es un código que identifica la regla de cobro, por ejemplo, por persona y noche, o por estancia. El "amount" es el precio por unidad de producto.
Códigos de "pricing"
| Código | Descripción |
|---|---|
| 1 | Una vez para la reserva |
| 2 | Por persona |
| 3 | Por noche |
| 4 | Por persona y por noche |
Para la lista definitiva de códigos, consulta la documentación de la API.
9. Reservas - ¿Dónde puedo ver el precio total?
|
Ejemplos de uso: "Quiero ver el precio total de una reserva concreta" |
El precio total de la reserva aparece en "totalAmount". Esto incluye la suma de los importes de cada noche de la estancia, más el total de los productos extra. Mews recibe este valor desde el Channel Manager, el valor solo se alterará si el sistema está configurado con Reglas de Producto que indiquen que se debe añadir un importe adicional.
Como con todos los importes, si tu propiedad está configurada con precios brutos, se utilizará el importe bruto, sin embargo, si está configurada con precios netos, se tomará el importe neto y se calcularán los impuestos según tu entorno jurídico.
10. Reservas - ¿Hay un perfil de empresa vinculado?
|
Ejemplos de uso: "Quiero saber si hay un perfil de empresa vinculado a una reserva en concreto" |
Para ver si se ha enviado un perfil de empresa junto con los datos de la reserva, busca "company ". Un registro de empresa tiene el siguiente aspecto:
"company": {
"id": "MEWS",
"iata": "65893",
"name": "Mews Systems, s.r.o.",
"contact": {
"email": "[email protected]",
"phone": "+420 775 684 983",
"address": {
"zip": "110 00",
"city": "Prague",
"country": "Czech Republic",
"addressLine1": "586 Ulice Test",
"addressLine2": "Patro 2"
}
}
11. Reservas - ¿Qué canal se usó?
|
Ejemplos de uso: "Quiero ver a través de qué canal se realizó la reserva" |
Para ver a través de qué canal se realizó la reserva, busca 'channel'. Consejo: esto puede ser útil cuando no estás seguro de si un Channel Manager ha enviado el código de mapeado de canales correcto y ha afectado al mapeado de tu Agencia de Viajes.
"channel": {
"code": 1,
"name": "Expedia"
}
Puedes consultar una lista completa de códigos de canal aquí. No es necesario copiarlos cuando se asignan los perfiles de las agencias de viajes, simplemente hay que seleccionarlos en el menú desplegable cuando se configuran las agencias de viajes (tal y como se explica en el Método 1 de este enlace). Ya están conectados a los códigos de canal listados.
12. Reservas - resolución de problemas con números de reserva
|
Ejemplos de uso: "Quiero ver qué números de reserva se enviaron como parte de la reserva" |
Mews recibe dos números de reserva - uno viene del canal de origen ('channelId'), y otro viene del Channel Manager ('channelManagerId'). Los números pueden diferir.
{
"clientToken": "[Channel manager client token]",
"connectionToken": "[Token of a concrete connection]",
"channelId": "EXP-123456",
"channelManagerId": "123456",