SFTP - Instrucciones para campos personalizados

TABLA DE CONTENIDOS

• SFTP - Instrucciones para campos personalizados
  • Lógica de procesamiento de archivos de respuestas de campos personalizados
  • Formato de archivo y convenciones de nombres
  • Frecuencia y programación
  • Formato de archivo para campos personalizados

En este tema encontrarás información útil para que tus cargas de archivos sean exitosas.

Para conocer las recomendaciones e información general sobre SFTP, consulta SFTP - Instrucciones de configuración.

Lógica de procesamiento de archivos de respuestas de campos personalizados

Spotnana te permite subir archivos de respuestas de campos personalizados, ya sea con datos parciales o completos, cada vez que cargues el archivo. El nombre del archivo indica el nombre del campo personalizado y la lista de respuestas que se están cargando. Cada campo personalizado y sus respuestas deben enviarse en un archivo separado (para más detalles sobre los nombres de archivo, revisa la sección de abajo). El sistema procesa el contenido de tu archivo CSV de la siguiente manera:

• Si la columna ACTION de la fila está configurada como CREATE, se creará la opción de respuesta para la lista correspondiente.

• Si la columna ACTION de la fila está configurada como UPDATE y la opción de respuesta ya existe, se actualizará la descripción de esa respuesta.

Si la columna ACTION de la fila está configurada como DELETE , se eliminará la opción de respuesta. Si no hay un registro en la base de datos de Spotnana que coincida con la opción de respuesta, la fila se omitirá y no se realizará ninguna acción.

Formato de archivo y convenciones de nombres

El nombre de cada archivo .CSV de campos personalizados debe seguir este formato:

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

donde:

• [customFieldID] es una variable que cambia para cada campo. Este ID aparece en el nombre del archivo que se muestra en paso 2 de las instrucciones de importación por SFTP en la ventana que forma parte de las instrucciones para importar desde el directorio SFTP. 

• [optionGroupID] es una variable que cambia para cada lista de respuestas. Este ID aparece en el nombre del archivo que se muestra en paso 2 de las instrucciones de importación por SFTP en la ventana que forma parte de las instrucciones para importar desde el directorio SFTP.  

• el * (comodín) representa cualquier carácter adicional que quieras agregar al nombre. 

• el “.” después de [optionGroupID] y el “.” antes de “csv” deben estar presentes. 

El nombre del archivo no distingue entre mayúsculas y minúsculas. Te recomendamos incluir la fecha y hora en el nombre del archivo (esto ayuda a resolver problemas en el futuro). Por ejemplo:

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

El archivo .CSV también debe tener un formato específico. Los nombres de las columnas deben coincidir exactamente con el formato definido (consulta la sección de formato de campos personalizados que aparece abajo). 

Frecuencia y programación

Te recomendamos subir un archivo diario para asegurarte de que Spotnana reciba cualquier alta, actualización o eliminación que haya ocurrido (si tus campos personalizados cambian con frecuencia, lo ideal es hacerlo a diario). Si sigues esta práctica: 

• las nuevas respuestas estarán disponibles para que los viajeros las seleccionen de inmediato al momento de reservar. 

• las respuestas que ya no se usan se eliminarán como opción y los viajeros ya no podrán seleccionarlas. 

Las respuestas eliminadas seguirán apareciendo en los reportes.

Formato de archivo para campos personalizados

Utiliza esta información para asegurarte de que los datos que subas en tus campos personalizados estén bien preparados y con el formato correcto.