Solución de Problemas de Sincronización

Cuando surgen problemas de sincronización entre Argonautas y sus canales de OTA conectados, un diagnóstico rápido es fundamental para prevenir dobles reservas, tarifas desactualizadas o reservas faltantes. Esta guía explica cómo leer los registros de sincronización, resolver los errores más comunes y restaurar conexiones saludables.

Descripción General

La red de distribución sincroniza tres tipos de datos con sus canales conectados: contenido (detalles de la propiedad y fotos), precios (tarifas y cargos) y disponibilidad (calendario y reservas). Cada operación de sincronización se registra con un estado, una marca de tiempo y un mensaje detallado. Cuando algo sale mal, los registros de sincronización son su principal herramienta de diagnóstico.

Cómo Leer los Registros de Sincronización

Navegue a Distribución > Registros de Sincronización para ver el historial completo de las operaciones de sincronización. Cada entrada del registro incluye:

Campo	Descripción
Marca de tiempo	Cuándo ocurrió la operación de sincronización.
Propiedad	Qué propiedad estuvo involucrada.
Operación	El tipo de sincronización: Enviar Contenido, Enviar Tarifas, Enviar Disponibilidad, Recibir Reserva, Recibir Disponibilidad.
Dirección	Si los datos se enviaron al canal (Enviar) o se recibieron de él (Recibir).
Estado	Éxito, Error o Parcial.
Registros	Cuántos registros se procesaron en esta operación.
Mensaje	Un resumen legible, incluyendo detalles del error si la sincronización falló.

Utilice los filtros en la parte superior para acotar los registros por propiedad, tipo de operación, estado o rango de fechas. Para la solución de problemas, filtre por Estado: Error para ver solo las operaciones fallidas.

[Captura de pantalla: Vista de Registros de Sincronización filtrada para mostrar errores, con columnas para marca de tiempo, propiedad, operación, estado y mensaje.]

Errores Comunes de Sincronización

Fallas en la Sincronización de Tarifas

Síntoma: Las tarifas en la OTA no coinciden con las que ha configurado en Argonautas. El registro de sincronización muestra errores en las operaciones de "Enviar Tarifas".

Causas comunes:

• Divisa no coincidente -- La divisa de la propiedad en Argonautas no coincide con la divisa configurada en el listado de la OTA. Asegúrese de que ambos lados usen la misma divisa (por ejemplo, USD).
• Tarifa fuera de rango -- Algunas OTA rechazan tarifas por debajo o por encima de ciertos umbrales. Airbnb, por ejemplo, tiene requisitos mínimos de tarifa nocturna que varían según el mercado.
• Plan de tarifas faltante -- La OTA espera un plan de tarifas o estructura de precios que no ha sido mapeado. Verifique que sus períodos de tarifas cubran el rango de fechas completo que la OTA está solicitando.
• Brecha estacional -- Si su calendario de tarifas estacionales tiene brechas (fechas sin tarifa definida), la sincronización puede fallar porque la OTA requiere cobertura continua de tarifas.

Resolución: Revise su configuración de tarifas en Propiedades > [Propiedad] > Tarifas. Asegúrese de que cada fecha dentro de los próximos 12-24 meses tenga una tarifa definida, que la divisa coincida con la OTA y que ninguna tarifa esté fuera del rango aceptado por la OTA.

Conflictos de Disponibilidad

Síntoma: Una propiedad aparece como disponible en una OTA cuando debería estar bloqueada, o viceversa. Los registros de sincronización pueden mostrar errores o usted puede notar el problema a través de un intento de reserva.

Causas comunes:

• Calendario desactualizado -- Ocurrió un fallo de sincronización y no se reintentó, dejando a la OTA con una disponibilidad obsoleta.
• Bloqueo manual no enviado -- Se creó un bloqueo de fecha en Argonautas pero no se sincronizó con la OTA, posiblemente debido a un problema temporal de conexión.
• Riesgo de doble reserva -- Llegaron dos reservas simultáneamente desde diferentes canales antes de que la disponibilidad pudiera actualizarse.

Resolución: Vaya a Distribución > Control de Sincronización, encuentre la propiedad afectada y haga clic en Sincronizar Ahora para forzar un nuevo envío de disponibilidad. Luego verifique el registro de sincronización para confirmar que la operación se completó con éxito.

Errores al Enviar Contenido

Síntoma: Los detalles de la propiedad, fotos o comodidades en la OTA están desactualizados o incompletos.

Causas comunes:

• Foto demasiado grande -- Algunas OTA tienen límites de tamaño de archivo o resolución para las fotos del listado.
• Campo obligatorio faltante -- La OTA requiere un campo que está vacío o no mapeado en Argonautas (por ejemplo, una categoría específica de comodidad o un tipo de política de cancelación).
• Descripción demasiado larga -- Las OTA a menudo tienen límites de caracteres para títulos y descripciones que son más cortos de lo que permite Argonautas.

Resolución: Revise el mensaje de error en el registro de sincronización para identificar el campo o contenido específico que falló. Actualice la propiedad en Propiedades > [Propiedad] y active una sincronización manual de contenido desde el Control de Sincronización.

Errores de Conexión

Síntoma: Todas las operaciones de sincronización para una propiedad (o todas las propiedades) están fallando. El panel de control de Distribución muestra la conexión como inactiva.

Causas comunes:

• Credenciales de API caducadas -- La clave API o el token de acceso del proveedor del canal ha caducado o ha sido revocado.
• Inactividad del proveedor -- El proveedor del canal está experimentando una interrupción del servicio.
• Tiempo de espera de red agotado -- Un problema temporal de red impidió que la sincronización se completara.

Resolución: Verifique el panel de control de Distribución para conocer el estado general de la conexión. Si la conexión se muestra como inactiva, verifique sus credenciales de API en Configuración > Distribución. Para interrupciones del proveedor, consulte la página de estado del proveedor y espere a la resolución: las sincronizaciones se reanudarán automáticamente una vez que se restaure la conexión.

Monitoreo del Estado de la Conexión

El panel de control de Distribución proporciona indicadores de estado de un vistazo:

• Tarjeta de Estado de Conexión -- Muestra si la conexión de distribución está activa, junto con la marca de tiempo de la última comunicación exitosa.
• Indicador de Errores de Sincronización -- Muestra el recuento de propiedades que actualmente están en estado de error. Un valor distinto de cero significa que al menos una propiedad necesita atención.
• Indicador de Sincronizaciones Últimas 24h -- Si este número cae a cero inesperadamente, puede indicar un problema de conexión incluso si no aparecen errores explícitos.

Haga un hábito de revisar el panel de control de Distribución diariamente. Detectar un error de sincronización temprano, antes de que conduzca a una doble reserva o a precios desactualizados, ahorra un tiempo significativo y esfuerzo en las relaciones con los huéspedes.

Resincronizar una Propiedad

Si una propiedad ha perdido la sincronización, puede forzar una resincronización completa:

1. Navegue a Distribución > Control de Sincronización.
2. Encuentre la tarjeta de la propiedad.
3. Haga clic en Sincronizar Ahora.
4. Espere a que la operación se complete (normalmente unos segundos para disponibilidad, hasta un minuto para contenido completo).
5. Verifique los registros de sincronización para confirmar que los tres tipos de sincronización (contenido, tarifas, disponibilidad) se completaron con éxito.

El botón Sincronizar Todas las Propiedades en la parte superior de la página activa una resincronización para cada propiedad conectada a la vez. Úselo con moderación, ya que coloca una carga más pesada en la API del proveedor del canal y es mejor reservarlo para situaciones como recuperarse de una interrupción prolongada del servicio.

Cuándo Desconectar y Volver a Conectar

En casos raros, el mapeo de canal de una propiedad se corrompe y las sincronizaciones individuales continúan fallando a pesar de que los datos sean correctos. Si usted ha:

1. Verificado que todos los datos de la propiedad estén completos y sean válidos.
2. Confirmado que las credenciales de API funcionan (otras propiedades se sincronizan bien).
3. Intentado múltiples resincronizaciones manuales sin éxito.
4. Verificado con el soporte del proveedor del canal y descartado problemas de su parte.

Entonces, desconectar y volver a conectar la propiedad puede resolver el problema. Este proceso:

• Elimina el ID de Distribución de la propiedad y todos los mapeos de canal.
• Requiere volver a mapear la propiedad a sus listados de OTA.
• Puede causar un breve período en el que la propiedad aparezca como no disponible en las OTA.

Solo desconecte como último recurso. Contacte a su administrador antes de dar este paso, ya que afecta los listados activos en las OTA y puede requerir coordinación con el proveedor del canal.

Conceptos Clave

• Registro de sincronización -- Un registro con marca de tiempo de cada operación de envío y recepción entre Argonautas y su proveedor de canal.
• Enviar -- Enviar datos desde Argonautas a la OTA (por ejemplo, tarifas, disponibilidad, contenido).
• Recibir -- Recibir datos desde la OTA hacia Argonautas (por ejemplo, nuevas reservas, modificaciones).
• ID de Distribución -- El identificador único que vincula una propiedad en Argonautas con su contraparte en el sistema del proveedor de canal.

Preguntas Comunes

¿Con qué frecuencia se ejecuta la sincronización automática? La disponibilidad se sincroniza en tiempo real. Las tarifas se envían cada hora. El contenido se envía cada 24 horas. Puede activar cualquiera de estas manualmente en cualquier momento desde el Control de Sincronización.

Una propiedad muestra "Error" pero no puedo encontrar nada malo con los datos. ¿Qué hago? Haga clic en Ver Registros en la tarjeta de Control de Sincronización de la propiedad y lea el mensaje de error más reciente. A menudo apunta a un campo o valor específico. Si el mensaje no es claro, intente una resincronización manual; los errores transitorios a veces se resuelven en el siguiente intento.

¿Un error de sincronización causará una doble reserva? Puede. Si la disponibilidad falla al enviarse después de crear una reserva, otros canales aún pueden mostrar esas fechas como disponibles. Por eso es fundamental monitorear el indicador de Errores de Sincronización y resolver los errores con prontitud.

¿Puedo ver el historial de sincronización para un rango de fechas específico? Sí. Utilice el filtro de rango de fechas en la página de Registros de Sincronización para acotar los resultados al período que está investigando.

Relacionado

• Integración de Canales -- Configurar y gestionar conexiones de OTA.
• Calendario y Disponibilidad -- Cómo se gestiona y sincroniza la disponibilidad.
• Modificaciones de Reservas de OTA -- Cómo se sincronizan los cambios de reservas entre canales.