Importação de Tarifas

A ferramenta de importação de tarifas permite que você faça o upload de tarifas para várias propriedades e temporadas de uma só vez a partir de um arquivo CSV. Isso é especialmente útil ao integrar novas propriedades, atualizar tarifas a partir de uma planilha de um parceiro ou carregar os preços de um ano inteiro em uma única etapa.

Visão Geral

Em vez de criar temporadas de propriedades uma por uma através da interface do usuário, você pode preparar um arquivo CSV com todas as suas tarifas e fazer o upload em Tarifas > Importar Tarifas. O sistema valida cada linha, associa propriedades e temporadas pelo nome e cria ou atualiza os registros de temporada da propriedade de acordo.

A importação também suporta um modo de simulação que valida seu arquivo sem salvar nada -- para que você possa detectar erros antes de confirmar as alterações.

Formato do Arquivo CSV

Seu arquivo CSV deve incluir uma linha de cabeçalho com os nomes das colunas. O sistema reconhece as seguintes colunas:

Colunas Obrigatórias

Coluna	Descrição	Exemplo
property_name	Nome da propriedade (deve corresponder a uma propriedade existente em sua conta)	Casa del Sol
season_name	Nome do modelo de temporada (correspondência sem distinção entre maiúsculas e minúsculas)	Alta Temporada 2026
nightly_rate	Tarifa diária de tabela	350.00

Colunas Opcionais

Coluna	Descrição	Exemplo
start_date	Data de início da temporada (AAAA-MM-DD ou MM/DD/AAAA)	2025-12-15
end_date	Data de término da temporada (AAAA-MM-DD ou MM/DD/AAAA)	2026-04-15
net_rate	Tarifa diária líquida paga ao proprietário/parceiro da propriedade	280.00
weekly_rate	Tarifa semanal de tabela (se diferente de 7x a diária)	2200.00
net_weekly_rate	Tarifa semanal líquida paga ao parceiro	1750.00
min_nights	Requisito de estadia mínima	5
cleaning_fee	Taxa de limpeza (para rastreamento de referência)	150.00
processing_fee	Taxa de processamento (para rastreamento de referência)	25.00

Exemplo de CSV

property_name,season_name,start_date,end_date,nightly_rate,net_rate,min_nights
Casa del Sol,High Season 2026,2025-12-15,2026-04-15,350.00,280.00,5
Casa del Sol,Green Season 2026,2026-04-16,2026-11-30,200.00,160.00,3
Villa Pacifica,High Season 2026,2025-12-15,2026-04-15,500.00,400.00,7
Villa Pacifica,Green Season 2026,2026-04-16,2026-11-30,300.00,240.00,3

Importando Tarifas

1. Navegue até Tarifas > Importar Tarifas.
2. Clique em Escolher Arquivo e selecione seu CSV.
3. Clique em Validar para executar uma simulação. O sistema verifica cada linha e relata quaisquer erros sem salvar.
4. Revise os resultados da validação. Corrija quaisquer erros em seu CSV e refaça o upload, se necessário.
5. Uma vez que a validação seja aprovada, clique em Importar para salvar as tarifas.

[Captura de tela: A página Importar Tarifas mostrando uma simulação bem-sucedida com 12 linhas válidas e 0 erros.]

Como Funciona a Associação

Associação de Propriedade

O sistema associa a coluna property_name às propriedades existentes em sua empresa usando uma comparação sem distinção entre maiúsculas e minúsculas. O nome deve corresponder exatamente (exceto pelas letras maiúsculas/minúsculas) -- correspondências parciais ou difusas não são suportadas.

Se um nome de propriedade não corresponder, a linha é sinalizada como um erro e ignorada.

Associação do Modelo de Temporada

A coluna season_name é associada aos modelos de temporada existentes em sua empresa (sem distinção entre maiúsculas e minúsculas).

• Se o modelo existir: O sistema o utiliza e ignora quaisquer valores start_date/end_date no CSV.
• Se o modelo não existir e as datas forem fornecidas: O sistema cria um novo modelo de temporada com o nome e intervalo de datas fornecidos, usando o ano da data de início como o ano do modelo.
• Se o modelo não existir e nenhuma data for fornecida: A linha é sinalizada como um erro.

Isso significa que você pode usar a ferramenta de importação para criar modelos de temporada e temporadas de propriedade em uma única etapa -- basta incluir as colunas de data.

Nova vs. Temporada de Propriedade Existente

• Nova combinação: Se não existir uma temporada de propriedade para o par propriedade + modelo de temporada fornecido, uma nova é criada com os valores do CSV.
• Combinação existente: Se uma temporada de propriedade já existir, seus valores são atualizados com os valores não vazios do CSV. Campos deixados em branco no CSV não são sobrescritos.

Validação e Tratamento de Erros

O serviço de importação valida cada linha individualmente. Uma única linha incorreta não impede a importação de outras linhas -- os erros são coletados e relatados ao final.

Erros de validação comuns:

Erro	Causa	Correção
Propriedade não encontrada	property_name não corresponde a nenhuma propriedade	Verifique a ortografia e certifique-se de que a propriedade existe
Modelo de temporada não encontrado, sem datas	season_name é novo, mas start_date/end_date estão ausentes	Adicione as datas ou crie o modelo de temporada primeiro
Formato de data inválido	A data não está no formato AAAA-MM-DD ou MM/DD/AAAA	Reformate a coluna de data
Decimal inválido	O valor da tarifa contém caracteres não numéricos	Remova símbolos de moeda, letras ou pontuação extra
Campo obrigatório ausente	property_name, season_name ou nightly_rate está em branco	Preencha o valor obrigatório

Trilha de Auditoria

Cada importação -- bem-sucedida ou com falha parcial -- cria um registro de auditoria que rastreia:

• O nome do arquivo original
• Total de linhas processadas
• Número de registros criados e atualizados
• Número de erros e seus detalhes
• Quem realizou a importação e quando

Você pode revisar importações anteriores a partir do histórico de importação na página Importar Tarifas.

Dicas para Importações Limpas

• Comece com uma simulação. Sempre valide antes de importar. Não custa nada e detecta problemas antecipadamente.
• Corresponda os nomes das propriedades exatamente. Copie os nomes das propriedades da página Propriedades para evitar erros de digitação. "Casa Del Sol" e "Casa del Sol" não corresponderão se a capitalização diferir em palavras que não sejam artigos.
• Use formatos de data consistentes. Escolha AAAA-MM-DD ou MM/DD/AAAA e mantenha-o em todo o arquivo.
• Remova símbolos de moeda. O analisador remove $ e vírgulas automaticamente, mas outros símbolos (por exemplo, prefixos EUR, USD) causarão erros.
• Inclua tarifas líquidas para propriedades de parceiros. Se você gerencia propriedades em nome de proprietários, inclua a coluna net_rate para rastrear sua margem de comissão.
• Mantenha um backup. Salve seus arquivos CSV para referência. A trilha de auditoria registra o que foi importado, mas ter o arquivo de origem é útil para depuração.

Conceitos-Chave

• Simulação -- Uma passagem apenas de validação que verifica cada linha sem salvar nenhum dado.
• Tarifa de Tabela -- A tarifa diária publicada cobrada dos hóspedes (a coluna nightly_rate).
• Tarifa Líquida -- A tarifa paga ao proprietário ou parceiro da propriedade (a coluna net_rate). A diferença é sua comissão.
• Registro de Auditoria -- Uma entrada de log criada para cada importação, rastreando linhas processadas, registros criados/atualizados e quaisquer erros.

Perguntas Frequentes

Posso importar sobreposições de tarifas de um CSV? Não. A ferramenta de importação cria apenas temporadas de propriedade. As sobreposições de tarifas devem ser criadas individualmente através da interface do usuário.

O que acontece se eu importar o mesmo arquivo duas vezes? A segunda importação atualiza as temporadas de propriedade existentes com os valores do CSV. Ela não cria duplicatas.

Posso excluir tarifas via importação? Não. A ferramenta de importação apenas cria e atualiza. Para remover uma temporada de propriedade, exclua-a na página Temporadas da Propriedade.

A importação dispara uma sincronização de canal? Sim. As temporadas de propriedade criadas ou atualizadas disparam os mesmos sinais de sincronização de tarifas que as edições manuais. Seus canais OTA conectados receberão as tarifas atualizadas.

Relacionado

• Guia de Preços -- Visão geral completa do sistema de tarifas em camadas e cálculos de preços de reserva.
• Tarifas Sazonais -- Configurando modelos de temporada e temporadas de propriedade através da interface do usuário.
• Sobreposições de Tarifas -- Criando substituições de preços específicas para feriados e eventos.
• Taxas e Impostos -- Configurando taxas de limpeza, taxas de serviço e alíquotas de impostos.