Solução de Problemas de Sincronização
Quando surgem problemas de sincronização entre a Argonautas e seus canais de OTA conectados, um diagnóstico rápido é fundamental para evitar reservas duplicadas, tarifas desatualizadas ou reservas ausentes. Este guia explica como ler os logs de sincronização, resolver os erros mais comuns e restaurar conexões saudáveis.
Visão Geral
A rede de distribuição sincroniza três tipos de dados com seus canais conectados: conteúdo (detalhes e fotos da propriedade), precificação (tarifas e taxas) e disponibilidade (calendário e reservas). Cada operação de sincronização é registrada com um status, carimbo de data/hora e uma mensagem detalhada. Quando algo dá errado, os logs de sincronização são sua principal ferramenta de diagnóstico.
Lendo os Logs de Sincronização
Navegue até Distribuição > Logs de Sincronização para visualizar o histórico completo das operações de sincronização. Cada entrada de log inclui:
| Campo | Descrição |
|---|---|
| Carimbo de Data/Hora | Quando a operação de sincronização ocorreu. |
| Propriedade | Qual propriedade estava envolvida. |
| Operação | O tipo de sincronização -- Enviar Conteúdo, Enviar Tarifas, Enviar Disponibilidade, Receber Reserva, Receber Disponibilidade. |
| Direção | Se os dados foram enviados para o canal (Enviar) ou recebidos dele (Receber). |
| Status | Sucesso, Erro ou Parcial. |
| Registros | Quantos registros foram processados nesta operação. |
| Mensagem | Um resumo legível, incluindo detalhes do erro se a sincronização falhou. |
Use os filtros na parte superior para restringir os logs por propriedade, tipo de operação, status ou intervalo de datas. Para solução de problemas, filtre por Status: Erro para ver apenas as operações com falha.
[Captura de tela: Visualização de Logs de Sincronização filtrada para mostrar erros, com colunas para carimbo de data/hora, propriedade, operação, status e mensagem.]
Erros Comuns de Sincronização
Falhas na Sincronização de Tarifas
Sintoma: As tarifas na OTA não correspondem às configuradas na Argonautas. O log de sincronização mostra erros nas operações de "Enviar Tarifas".
Causas comuns:
- Incompatibilidade de moeda -- A moeda da propriedade na Argonautas não corresponde à moeda configurada na listagem da OTA. Certifique-se de que ambos os lados usam a mesma moeda (por exemplo, USD).
- Tarifa fora do intervalo -- Algumas OTAs rejeitam tarifas abaixo ou acima de certos limites. O Airbnb, por exemplo, tem requisitos mínimos de tarifa diária que variam por mercado.
- Plano de tarifas ausente -- A OTA espera um plano de tarifas ou estrutura de preços que não foi mapeada. Verifique se seus períodos de tarifa cobrem todo o intervalo de datas que a OTA está solicitando.
- Lacuna sazonal -- Se seu calendário de tarifas sazonais tiver lacunas (datas sem tarifa definida), a sincronização pode falhar porque a OTA requer cobertura contínua de tarifas.
Resolução: Revise sua configuração de tarifas em Propriedades > [Propriedade] > Tarifas. Certifique-se de que cada data dentro dos próximos 12-24 meses tenha uma tarifa definida, que a moeda corresponda à da OTA e que nenhuma tarifa esteja fora do intervalo aceito pela OTA.
Conflitos de Disponibilidade
Sintoma: Uma propriedade aparece como disponível em uma OTA quando deveria estar bloqueada, ou vice-versa. Os logs de sincronização podem mostrar erros ou você pode notar o problema através de uma tentativa de reserva.
Causas comuns:
- Calendário desatualizado -- Ocorreu uma falha de sincronização que não foi repetida, deixando a OTA com disponibilidade desatualizada.
- Bloqueio manual não enviado -- Um bloqueio de data foi criado na Argonautas, mas não foi sincronizado para a OTA, possivelmente devido a um problema temporário de conexão.
- Risco de reserva duplicada -- Duas reservas chegaram simultaneamente de canais diferentes antes que a disponibilidade pudesse ser atualizada.
Resolução: Vá para Distribuição > Controle de Sincronização, encontre a propriedade afetada e clique em Sincronizar Agora para forçar um novo envio de disponibilidade. Em seguida, verifique o log de sincronização para confirmar que a operação foi concluída com sucesso.
Erros no Envio de Conteúdo
Sintoma: Os detalhes da propriedade, fotos ou comodidades na OTA estão desatualizados ou incompletos.
Causas comuns:
- Foto muito grande -- Algumas OTAs têm limites de tamanho de arquivo ou resolução para fotos da listagem.
- Campo obrigatório ausente -- A OTA requer um campo que está vazio ou não mapeado na Argonautas (por exemplo, uma categoria de comodidade específica ou um tipo de política de cancelamento).
- Descrição muito longa -- As OTAs geralmente têm limites de caracteres para títulos e descrições que são mais curtos do que os permitidos pela Argonautas.
Resolução: Verifique a mensagem de erro no log de sincronização para o campo ou conteúdo específico que falhou. Atualize a propriedade em Propriedades > [Propriedade] e acione uma sincronização manual de conteúdo a partir do Controle de Sincronização.
Erros de Conexão
Sintoma: Todas as operações de sincronização para uma propriedade (ou todas as propriedades) estão falhando. O painel de Distribuição mostra a conexão como inativa.
Causas comuns:
- Credenciais de API expiradas -- A chave de API ou token de acesso do provedor do canal expirou ou foi revogado.
- Indisponibilidade do provedor -- O provedor do canal está passando por uma interrupção.
- Tempo limite de rede -- Um problema temporário de rede impediu a conclusão da sincronização.
Resolução: Verifique o painel de Distribuição para o status geral da conexão. Se a conexão aparecer como inativa, verifique suas credenciais de API em Configurações > Distribuição. Para interrupções do provedor, verifique a página de status do provedor e aguarde a resolução -- as sincronizações serão retomadas automaticamente assim que a conexão for restaurada.
Monitoramento da Saúde da Conexão
O painel de Distribuição fornece indicadores de saúde de relance:
- Cartão de Status da Conexão -- Mostra se a conexão de distribuição está ativa, juntamente com o carimbo de data/hora da última comunicação bem-sucedida.
- Medidor de Erros de Sincronização -- Exibe a contagem de propriedades atualmente em estado de erro. Um valor diferente de zero significa que pelo menos uma propriedade precisa de atenção.
- Medidor de Sincronizações nas Últimas 24h -- Se esse número cair para zero inesperadamente, pode indicar um problema de conexão, mesmo que nenhum erro explícito apareça.
Crie o hábito de verificar o painel de Distribuição diariamente. Detectar um erro de sincronização precocemente -- antes que leve a uma reserva duplicada ou a preços desatualizados -- economiza tempo significativo e esforço de relacionamento com hóspedes.
Ressincronizando uma Propriedade
Se uma propriedade ficou fora de sincronia, você pode forçar uma ressincronização completa:
- Navegue até Distribuição > Controle de Sincronização.
- Encontre o cartão da propriedade.
- Clique em Sincronizar Agora.
- Aguarde a operação ser concluída (normalmente alguns segundos para disponibilidade, até um minuto para conteúdo completo).
- Verifique os logs de sincronização para confirmar que todos os três tipos de sincronização (conteúdo, tarifas, disponibilidade) foram concluídos com sucesso.
O botão Sincronizar Todas as Propriedades na parte superior da página aciona uma ressincronização para cada propriedade conectada de uma só vez. Use isso com moderação -- ele coloca uma carga maior na API do provedor do canal e é melhor reservado para situações como recuperação de uma interrupção prolongada.
Quando Desconectar e Reconectar
Em casos raros, o mapeamento de canal de uma propriedade se corrompe e as sincronizações individuais continuam falhando, apesar dos dados estarem corretos. Se você:
- Verificou que todos os dados da propriedade estão completos e válidos.
- Confirmou que as credenciais de API estão funcionando (outras propriedades sincronizam bem).
- Tentou várias ressincronizações manuais sem sucesso.
- Verificou com o suporte do provedor do canal e descartou problemas do lado deles.
Então, desconectar e reconectar a propriedade pode resolver o problema. Este processo:
- Remove o ID de Distribuição da propriedade e todos os mapeamentos de canal.
- Requer remapear a propriedade para suas listagens de OTA.
- Pode causar um breve período em que a propriedade aparece como indisponível nas OTAs.
Apenas desconecte como último recurso. Entre em contato com seu administrador antes de tomar esta medida, pois ela afeta listagens de OTA ativas e pode exigir coordenação com o provedor do canal.
Conceitos-Chave
- Log de sincronização -- Um registro com carimbo de data/hora de cada operação de envio e recebimento entre a Argonautas e seu provedor de canal.
- Enviar -- Enviar dados da Argonautas para a OTA (por exemplo, tarifas, disponibilidade, conteúdo).
- Receber -- Receber dados da OTA para a Argonautas (por exemplo, novas reservas, modificações).
- ID de Distribuição -- O identificador exclusivo que vincula uma propriedade na Argonautas à sua contraparte no sistema do provedor de canal.
Perguntas Frequentes
Com que frequência a sincronização automática é executada? A disponibilidade sincroniza em tempo real. As tarifas são enviadas a cada hora. O conteúdo é enviado a cada 24 horas. Você pode acionar qualquer uma dessas manualmente a qualquer momento no Controle de Sincronização.
Uma propriedade mostra "Erro", mas não consigo encontrar nada de errado com os dados. O que faço? Clique em Ver Logs no cartão de Controle de Sincronização da propriedade e leia a mensagem de erro mais recente. Ela geralmente aponta para um campo ou valor específico. Se a mensagem não for clara, tente uma ressincronização manual -- erros transitórios às vezes são resolvidos na próxima tentativa.
Um erro de sincronização causará uma reserva duplicada? Pode causar. Se a disponibilidade não for enviada após a criação de uma reserva, outros canais ainda podem mostrar essas datas como disponíveis. É por isso que monitorar o medidor de Erros de Sincronização e resolver os erros prontamente é fundamental.
Posso ver o histórico de sincronização para um intervalo de datas específico? Sim. Use o filtro de intervalo de datas na página de Logs de Sincronização para restringir os resultados ao período que você está investigando.
Relacionado
- Integração de Canal -- Configurando e gerenciando conexões com OTAs.
- Calendário e Disponibilidade -- Como a disponibilidade é gerenciada e sincronizada.
- Modificações de Reserva de OTA -- Como as alterações de reserva são sincronizadas entre os canais.