# 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.

{% hint style="info" %}
Recordá que todos los archivos deben contener todos los datos de cabeceras para que este procese sin problemas.
{% endhint %}

## 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&#x20;**_**Medios de pago (opcional)**_

_payments\_#grupo\_#fecha.csv_\
\
**Archivo de&#x20;**_**Miembros de Familia (opcional)**_

_member\_family\_#grupo\_#fecha.csv_

{% hint style="info" %}
_El #grupo solo aplica para multimarcas/multicuentas_
{% endhint %}

**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.&#x20;

{% hint style="danger" %}
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.
{% endhint %}

## 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

{% hint style="info" %}
Recordá que todos las querys deben contener todos los datos de cabeceras para que este procese sin problemas.
{% endhint %}

## 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.

{% hint style="info" %}
La conexión vía SQL **NO** contempla VPN
{% endhint %}

###

