Primeros pasos

Objetivo

Dar la posibilidad a los clientes poder migrar la información de los clientes, tiendas, productos y ventas a través de una integración sencilla. Se puede elegir cualquiera de las integraciones, funcionan muy similares.

Proceso de Implementación vía FTP

El cliente debe confeccionar todos los documentos solicitados y enviarlos para su aprobación al equipo de Integración. Luego, se les dará acceso a un FTP con sus respectivas credenciales donde deberá alojar el grupo de archivos.

Recordá que todos los archivos deben contener todos los datos de cabeceras para que este procese sin problemas.

Aspectos Generales vía FTP

Nombre de Archivos

Los archivos CSV deberán tener los siguientes nombres:

Archivo de Clientes

clientes_#grupo_#fecha.csv

Archivo de Ventas

ventas_#grupo_#fecha.csv

Archivo de Productos

productos_#grupo_#fecha.csv

Archivo de Categorías

categorias*#grupo#fecha.csv*

Archivo de Tiendas

tiendas_#grupo_#fecha.csv

Archivo de Medios de pago (opcional)

payments_#grupo_#fecha.csv Archivo de Miembros de Familia (opcional)

member_family_#grupo_#fecha.csv

El #grupo solo aplica para multimarcas/multicuentas

Ejemplo:

• clientes_woowup_20200128.csv

• ventas_woowup_20200128.csv

• productos_woowup_20200128.csv

• tiendas_woowup_20200128.csv

• categorias_woowup_20200128.csv

• payments_woowup_20200128.csv

Si el archivo de ventas a procesar es histórico, debe agregarse el termino "historical" al nombre del archivo.

Ejemplo:

ventas_woowup_20200128_historical.csv

¿Como procesar los archivos vía FTP?

WoowUp les proveerá un ftp para que depositen los archivos que necesiten ser procesados, van a dejar el conjunto de archivos en la carpeta pending (con los nombres previamente acordados) y WoowUp tendrá un cron automático para procesar los archivos

Ruta: **<ftp_root>**/pending/juego_de_archivos_para_procesar/(todos los archivos)

Se enviarán los archivos históricos una sola vez y luego se enviaran la información actualizada de cada día, según el horario acordado en el blueprint.

Formato de Archivos vía FTP

Los archivos deben estar separados por ";" y en formato UTF 8. Todos los archivos deben respetetar las cabeceras. Se pueden alterar las cabeceras pero no cambiar el nombre.

El tamaño máximo de la suma de todos los archivos debe ser de 20 MB. Para procesar más de ese tamaño debe coordinarlo con el equipo de WoowUp.

Proceso de Implementación vía SQL

El cliente debe confeccionar todos las querys/Store Procedure/Vistas solicitados y enviarlos para su aprobación al equipo de Integración. Además, deberá dar acceso al equipo de WoowUp al SQL de forma lectura brindando la siguiente información:

• Host

• Port

• Username

• Password

• DatabaseName

Recordá que todos las querys deben contener todos los datos de cabeceras para que este procese sin problemas.

Aspectos Generales vía SQL

Las querys deben estar armadas para consultar de manera eficiente, por lo tanto, pedimos que tenga un campo de filtrado de fecha_update para no procesar más de una vez toda la información. Este campo debe agregarse en todas las tablas.

Se debe armar una query especial que tenga toda la información histórica para poder traer el histórico de cada entidad.

El procesamiento será acordado con el cliente el blueprint.

La conexión vía SQL NO contempla VPN