SFTP - Instruções para campos personalizados

ÍNDICE

• SFTP - Instruções para campos personalizados
  • Lógica de processamento do arquivo de respostas dos campos personalizados
  • Formato do arquivo e convenções de nomenclatura
  • Frequência e agendamento
  • Formato do arquivo de campos personalizados

Neste tópico, você encontra dicas importantes para garantir que seus uploads de arquivos sejam feitos com sucesso.

Para orientações e informações gerais sobre SFTP, veja SFTP - Instruções de configuração.

Lógica de processamento do arquivo de respostas dos campos personalizados

A Spotnana permite que você envie arquivos com dados completos ou parciais de respostas para campos personalizados a cada upload. O nome do arquivo indica para qual campo personalizado e lista de respostas as opções estão sendo enviadas. Cada campo personalizado e suas respostas devem ser enviados em arquivos separados (veja detalhes sobre nomes de arquivos mais abaixo). O processamento do seu arquivo CSV segue esta lógica:

• Se a coluna ACTION da linha estiver definida como CREATE, a opção de resposta será criada na lista de respostas.

• Se a coluna ACTION da linha estiver definida como UPDATE e a opção de resposta já existir, a descrição dessa resposta será atualizada.

Se a coluna ACTION da linha estiver definida como DELETE , a opção de resposta será removida. Caso não exista nenhum registro correspondente no banco de dados da Spotnana, a linha será ignorada e nada será alterado.

Formato do arquivo e convenções de nomenclatura

O nome de cada arquivo .CSV de campos personalizados deve seguir este padrão:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

onde:

• [customFieldID] é um identificador que muda conforme o campo. Esse ID aparece no nome do arquivo mostrado na etapa 2 das instruções de importação via SFTP na janela que faz parte das instruções de Importação do diretório SFTP. 

• [optionGroupID] é um identificador que muda para cada lista de respostas. Esse ID aparece no nome do arquivo mostrado na etapa 2 das instruções de importação via SFTP na janela que faz parte das instruções de Importação do diretório SFTP..  

• o * (coringa) representa qualquer caractere extra que você queira adicionar ao nome. 

• o “.” após o [optionGroupID] e o “.” antes do “csv” precisam estar presentes. 

O nome do arquivo não diferencia maiúsculas de minúsculas. Sugerimos incluir a data e o horário no nome do arquivo (isso facilita a identificação em caso de dúvidas no futuro). Por exemplo:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_<DateTime>.csv

O arquivo .CSV também precisa seguir um formato específico. Os nomes das colunas devem estar exatamente iguais ao formato definido (veja o tópico Formato do campo personalizado logo abaixo). 

Frequência e agendamento

Recomendamos que você envie um arquivo diariamente para garantir que a Spotnana seja avisada sobre qualquer inclusão, atualização ou exclusão que possa ter ocorrido (se seus campos personalizados mudam com frequência, o ideal é atualizar todos os dias). Seguindo essa rotina: 

• novas respostas já ficam disponíveis para seleção pelos viajantes no checkout, imediatamente. 

• respostas descontinuadas deixam de aparecer como opção e não podem mais ser escolhidas pelos viajantes. 

Respostas descontinuadas ainda aparecem nos relatórios.

Formato do arquivo de campos personalizados

Use essas orientações para garantir que os dados do seu upload de campos personalizados estejam no formato certo e prontos para uso.