SFTP - Instruções para campos personalizados

ÍNDICE

• SFTP - Instruções para campos personalizados
  • Lógica de processamento dos ficheiros de respostas de campos personalizados
  • Formato dos ficheiros e regras de nomeação
  • Frequência e agendamento
  • Formato do ficheiro de campos personalizados

Neste tópico encontra informações úteis para garantir que os seus envios de ficheiros correm sem problemas.

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

Lógica de processamento dos ficheiros de respostas de campos personalizados

A Spotnana permite-lhe enviar um conjunto parcial ou total de respostas de campos personalizados sempre que carrega um ficheiro. O nome do ficheiro indica a que campo personalizado e lista de respostas se referem as respostas enviadas. Cada campo personalizado e respetivas respostas devem ser enviados num ficheiro separado (para mais detalhes sobre as regras de nomeação, veja abaixo). O processamento do seu ficheiro 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 registo correspondente na base de dados da Spotnana, essa linha será ignorada e não será feita nenhuma alteração.

Formato dos ficheiros e regras de nomeação

O nome de cada ficheiro .CSV de campos personalizados deve seguir este formato:

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

em que:

• [customFieldID] é uma variável que muda consoante o campo. Este ID está incluído no nome do ficheiro apresentado em passo 2 das instruções de importação SFTP na janela que faz parte das instruções de Importação a partir do diretório SFTP. 

• [optionGroupID] é uma variável que muda consoante a lista de respostas. Este ID está incluído no nome do ficheiro apresentado em passo 2 das instruções de importação SFTP na janela que faz parte das instruções de Importação a partir do diretório SFTP.  

• o * (wildcard) pode ser substituído por qualquer texto adicional que queira incluir no nome. 

• o “.” a seguir ao [optionGroupID] e o “.” antes de “csv” têm de estar presentes. 

O nome do ficheiro não distingue maiúsculas de minúsculas. Recomendamos que inclua a data e hora no nome do ficheiro (para facilitar eventuais pesquisas ou resolução de problemas). Por exemplo:

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

O ficheiro .CSV também deve seguir um formato específico. Os nomes das colunas têm de corresponder exatamente ao formato definido (consulte a secção Formato de campo personalizado em baixo). 

Frequência e agendamento

Sugerimos que envie um ficheiro diariamente para garantir que a Spotnana é informada de quaisquer adições, alterações ou eliminações que possam ter ocorrido (se os seus campos personalizados mudam com frequência, as atualizações diárias são recomendadas). Ao seguir esta prática: 

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

• as respostas descontinuadas deixam de estar disponíveis para seleção pelos viajantes. 

As respostas descontinuadas continuam visíveis nos relatórios.

Formato do ficheiro de campos personalizados

Utilize esta informação para garantir que os dados do seu ficheiro de campos personalizados estão devidamente preparados e formatados.