Importação de Tarifas

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

Visão Geral

Em vez de criar temporadas de propriedades uma a uma pela interface, você pode preparar um arquivo CSV com todas as suas tarifas e carregá-lo na aba Tarifas e Preços › Importar. O sistema valida cada linha, associa propriedades e temporadas por nome e cria ou atualiza os registros de temporadas de propriedades conforme necessário.

O botão Validar executa uma simulação que verifica seu arquivo sem salvar nada, para que você possa identificar erros antes de alterar qualquer tarifa.

Formato do Arquivo CSV

Seu arquivo CSV deve incluir uma linha de cabeçalho com os nomes das colunas. Clique em Baixar um modelo na aba Importar para obter um arquivo inicial. O sistema reconhece as seguintes colunas:

Colunas Obrigatórias

Coluna	Descrição	Exemplo
property_name	Nome da propriedade (deve corresponder a uma propriedade existente na sua conta)	Casa del Sol
season_name	Nome do modelo de temporada (associado sem diferenciar maiúsculas de minúsculas)	High Season 2026
nightly_rate	Tarifa diária de balcão	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	280.00
weekly_rate	Tarifa semanal de balcão (se diferente de 7x a diária)	2200.00
net_weekly_rate	Tarifa semanal líquida paga ao parceiro	1750.00
min_nights	Estadia mínima exigida	5
cleaning_fee	Taxa de limpeza (para controle de referência)	150.00
processing_fee	Taxa de processamento (para controle 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. Acesse Tarifas e Preços › Importar.
2. Arraste seu CSV para a área de upload ou clique em Procurar Arquivos e selecione-o.
3. Clique em Validar para executar uma simulação. Resultados da Validação mostra o total de linhas, linhas válidas e erros, com o número da linha e o motivo de cada erro. Nada é salvo.
4. Corrija quaisquer erros no seu CSV e carregue-o novamente, se necessário.
5. Clique em Importar Tarifas para salvar as tarifas.
6. Quando a importação terminar, clique em Ver Temporadas de Propriedades para conferir as tarifas na aba Temporadas, ou em Importar Outro Arquivo.

Como Funciona a Associação

Associação de Propriedades

O sistema associa a coluna property_name com as propriedades existentes na sua empresa usando uma comparação que não diferencia maiúsculas de minúsculas. O nome deve corresponder exatamente (exceto pela capitalização) -- correspondências parciais ou aproximadas não são suportadas.

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

Associação de Modelos de Temporada

A coluna season_name é associada por nome com os modelos de temporada existentes na sua empresa (sem diferenciar maiúsculas de minúsculas). Dê a cada modelo um nome exclusivo entre seus parceiros, para que uma linha não possa corresponder ao modelo de outro parceiro.

• Se o modelo existir: O sistema o utiliza e ignora quaisquer valores de 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 o intervalo de datas informados, 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 erro.

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

Temporadas de Propriedades Novas vs Existentes

• Nova combinação: Se não existir uma temporada de propriedade para o par propriedade + modelo de temporada informado, 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 com problema não impede a importação das demais -- os erros são coletados e reportados 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 grafia 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	Reformatе 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

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 entre 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 acompanhar sua margem de comissão.
• Mantenha um backup. Salve seus arquivos CSV. O card Importações Recentes lista cada importação anterior com sua data, nome do arquivo e contagens de linhas criadas, atualizadas e com erro, mas não as tarifas em si.

Conceitos-Chave

• Simulação -- Uma passagem apenas de validação que verifica cada linha sem salvar nenhum dado.
• Tarifa de Balcão -- A tarifa diária publicada cobrada dos hóspedes (a coluna nightly_rate).
• Tarifa Líquida -- A tarifa paga ao proprietário ou parceiro (a coluna net_rate). A diferença é a sua comissão.

Perguntas Frequentes

Posso importar overlays de CSV? Não. A ferramenta de importação cria apenas temporadas de propriedades. Overlays de tarifas devem ser criados individualmente pela interface.

O que acontece se eu importar o mesmo arquivo duas vezes? A segunda importação atualiza as temporadas de propriedades existentes com os valores do CSV. 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 aba Temporadas (visualização Por villa).

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

Relacionados

• Guia de Preços -- Visão geral completa do sistema de tarifas em camadas e cálculos de preços de reservas.
• Tarifas Sazonais -- Configuração de modelos de temporada e temporadas de propriedades pela interface.
• Overlays de Tarifas -- Criação de substituições de preços específicas para feriados e eventos.
• Taxas e Impostos -- Configuração de taxas de limpeza, taxas de serviço e alíquotas de impostos.