MANUAL TCNICO

n-store

MANUAL TCNICO
1

MANUAL TCNICO

Contenido
1. CARGA DE DATOS .......................................................................................................... 3 1.1. 1.2. Introduccin ............................................................................................................ 3 Archivos de carga .................................................................................................... 4 RUTA.TXT .......................................................................................................... 4 GRUPO.TXT ....................................................................................................... 5 PRODUCTO.TXT ................................................................................................ 5 USUARIO.TXT .................................................................................................... 7 PUNTO_VENTA.TXT ........................................................................................... 8 NO_VISITA.TXT.................................................................................................. 9

1.2.1. 1.2.2. 1.2.3. 1.2.4. 1.2.5. 1.2.6. 1.3. 1.4. 2.

Archivo de carga Excel ........................................................................................... 10 Archivo de descarga............................................................................................... 12

REQUERIMIENTOS DEL SISTEMA ................................................................................. 14

MANUAL TCNICO
1. CARGA DE DATOS
1.1. Introduccin
El siguiente manual, describe el detalle de cada uno de los archivos de carga y descarga, es importante que considere los siguientes puntos: Los archivos deben tener el nombre exacto que figura en este manual. El contenido de los archivos deben seguir las sintaxis y el orden descrito en este manual. Los datos en los archivos de carga y descarga estn separados por una barra vertical (|). Los dos iconos usados para algunos de los campos del archivo significan lo siguiente:

ICONO

DESCRIPCION Cdigo identificador. Valor nico En archivo de carga, dato ingresado por el usuario. En archivo de descarga, dato generado por el sistema. Cdigo proveniente de otro maestro, proveniente de una carga de datos o de una configuracin web.

MANUAL TCNICO
1.2. Archivos de carga
1.2.1. RUTA.TXT Lista de los puntos de venta programados en un determinado da y usuario.

CODIGO_PUNTO_VENTA venta CODIGO_USUARIO

Cdigo del

punto de

Alfanumrico(50) Alfanumrico(50)

Cdigo de usuario

RUTA

Ruta del punto de venta. Es un dato que tiene los valores 1 y 0. 1 = Esta dentro de la ruta 0 = No est en la ruta Existe un valor para cada da de la semana. La semana empieza con el da lunes. Ejemplo: Ruta = 1010000 Indica que el punto de venta est en la ruta del da lunes y mircoles.

Alfanumrico(7)

A continuacin se puede muestra un ejemplo de RUTA.TXT:

1|25|1000000 2|26|1100110
1 2 3
CODIGO_PUNTO_VENTA CODIGO_USUARIO RUTA

MANUAL TCNICO
1.2.2. GRUPO.TXT
Los distintos grupos utilizados en la configuracin de las actividades.

GRUPO CODIGO NOMBRE

Nombre del grupo. Cdigo del tem de un grupo determinado. Nombre de un tem de un grupo determinado.

Alfanumrico (100) Alfanumrico (50) Alfanumrico (100)

A continuacin se muestra un ejemplo de la estructura del archivo GRUPO.TXT:

ESTADOVI|1|BUENAS CONDICIONES ESTADOVI|2|MALOGRADO

1 GRUPO 2 CODIGO 3 NOMBRE

1.2.3. PRODUCTO.TXT
Lista de productos pertenecientes a cada una de las cuentas.

CODIGO_CUENTA ES_PROPIO CODIGO_CATEGORIA1 NOMBRE CATEGORIA1 CODIGO_CATEGORIA2 NOMBRE CATEGORIA2 CODIGO_CATEGORIA3 NOMBRE CATEGORIA3 CODIGO NOMBRE

Cdigo de la cuenta Producto propio. Es un dato que tiene los valores T y F. T = Si es producto propio F = No es producto propio Cdigo de la categora 1 Nombre de la categora 1 Cdigo de la categora 2 Nombre de la categora 2 Cdigo de la categora 3 Nombre de la categora 3 Cdigo del producto Nombre del producto

Alfanumrico(50)

Alfanumrico(1)

Alfanumrico(50) Alfanumrico(100) Alfanumrico(50) Alfanumrico(100) Alfanumrico(50) Alfanumrico(100) Alfanumrico(50) Alfanumrico(100)

MANUAL TCNICO

A continuacin se muestra un ejemplo de la estructura de PRODUCTO.TXT:

10

001|T|CAT_1|NOM_1|CAT_1_1|NOM_1_1|CAT_1_1_1|NOM_1_1_1|PR1|PROD1 001|T|CAT_1|NOM_1|CAT_1_1|NOM_1_1|CAT_1_1_1|NOM_1_1_1|PR2|PROD2
1 2 3 4 5 CODIGO_CUENTA ES_PROPIO CODIGO_CATEGORIA1 NOMBRE_CATEGORIA1 CODIGO_CATEGORIA2 6 7 8 9 10 NOMBRE_CATEGORIA2 CODIGO_CATEGORIA3 NOMBRE_CATEGORIA3 CODIGO NOMBRE

NOTA
Si la cuenta no utiliza todos los niveles de categora, estas pueden ser dejadas en blanco. Por ejemplo, si una cuenta solo tiene dos niveles de categoras (Familia de Productos y Marcas) la estructura sera de la siguiente manera: 001|T|CAT_1|NOM_1|CAT_1_1|NOM_1_1| | |PR3|PROD3

NOTA
Si solo se desea cargar categoras y no productos, dejar en blanco los espacios correspondientes a producto: 001|T|CAT_1|NOM_1|CAT_1_1|NOM_1_1| CAT_1_1_1| NOM_1_1_1 | |

MANUAL TCNICO
1.2.4. USUARIO.TXT
Lista de usuarios de perfil mercaderistas de la aplicacin.

CODIGO_CUENTA

Cdigo de la cuenta

Alfanumrico (50) Alfanumrico(50) Alfanumrico(50) Alfanumrico(100) Alfanumrico(50) Alfanumrico(100) Alfanumrico(50)

CODIGO_CAMPANHA Cdigo de la campaa CODIGO NOMBRE CODIGO_EQUIPO CLAVE LOGIN

Cdigo del usuario Nombre del usuario Cdigo del equipo Clave del usuario Login del usuario

A continuacin se muestra un ejemplo de la estructura de USUARIO.TXT:

001|CMP01|USR001|CHRISTIAN SAAVEDRA|100|PASS|1 001|CMP02|USR002|STEFANY CERRADAS|100|PASS|2

1 2 3 4 5 CODIGO_CUENTA CODIGO_CAMPANHA CODIGO NOMBRE CODIGO_EQUIPO 6 7 CLAVE LOGIN

NOTA
El cdigo de equipo es opcional, en caso no se utilice, dejar los espacios correspondientes en blanco: 001|CMP01|USR001|CHRISTIAN SAAVEDRA||PASS|1

MANUAL TCNICO
1.2.5. PUNTO_VENTA.TXT
Lista de puntos de venta que podrn ser visitados por los usuarios mercaderistas.

CODIGO NOMBRE DIRECCION OBSERVACION LATITUD LONGITUD

Cdigo del punto de venta Nombre del punto de venta Direccin del punto de venta Observacin sobre el punto de venta Latitud del punto de venta Longitud del punto de venta Cdigo del canal del punto

Alfanumrico (50) Alfanumrico(100) Alfanumrico(100) Alfanumrico(250) Alfanumrico(50) Alfanumrico(50) Alfanumrico(50)

CODIGO_CANAL de venta

A continuacin se muestra un ejemplo de la estructura de PUNTO_VENTA.TXT:

3113|GUITARRA MARTICONERA|JR. JULIO ARCE #432|Ninguna|-34.6432|-58.4732|MAY 3114|SERNA GARCIA |AV. STA LAURA #255 |Presentarse en vigilancia|-19.425 |-99.128|MAY
1 2 3 4 5

CODIGO NOMBRE DIRECCION OBSERVACION LATITUD

6 LONGITUD 7 CODIGO_CANAL

NOTA
La direccin, observacin, la latitud, la longitud y el canal son opcionales, en caso no se utilicen, dejar los espacios correspondientes en blanco: 311468|SERNA GARCIA OLGA|||||

MANUAL TCNICO
1.2.6. NO_VISITA.TXT
Lista de motivos de no visita.

CDIGO_CUENTA CODIGO NOMBRE

Cdigo de la cuenta Cdigo de No Visita Nombre del tem No Visita

Alfanumrico (50) Alfanumrico (50) Alfanumrico (100)

A continuacin se muestra un ejemplo de la estructura de NO_VISITA.TXT:

COO001|001|CLAUSURADO COO001|002|ACCESO RESTRINGIDO |001|CERRADO*

1 2 3

CODIGO_CUENTA CODIGO NOMBRE

NOTA
El campo CODIGO_CUENTA puede ser dejado en blanco, en este caso el motivo de no visita ser general y aplicar a todas las cuentas.

MANUAL TCNICO
1.3. Archivo de carga Excel
La carga de datos se puede realizar tambin mediante un archivo de Excel (versin 97 2003) (Ver Figura 1.0).

FIGURA

1.0

La informacin deber ser llenada en cada una de las hojas de Excel teniendo cuidado con la estructura de la misma. La primera fila de cada hoja contendr los campos a cargar y sus nombres correspondern a los mostrados en las tablas de la seccin anterior (Ver seccin 1.2. Archivos de carga). Por ejemplo, la cabecera de la hoja encargada de cargar los motivos de no visita tendr como cabecera de columnas, en su primera fila, los siguientes: CODIGO_CUENTA CODIGO NOMBRE Respetando los nombres, incluyendo guiones, que se muestran en la seccin 1.2.6. Debe haber una hoja de Excel por cada tipo de carga y cada hoja debe tener un nombre especfico indicando que tipo de datos contiene, por ejemplo para la carga de puntos de venta la hoja deber llamarse PUNTO_VENTA (Ver Figura 2.0).

FIGURA

2.0

10

MANUAL TCNICO
Las hojas de Excel debern llamarse de la siguiente manera:

PUNTO_VENTA RUTA USUARIO GRUPO NO_VISITA PRODUCTO

Hoja que carga los puntos de venta. Hoja que carga las rutas. Hoja que carga los usuarios. Hoja que carga los grupos. Hoja que carga los motivos de no visita. Hoja que carga los productos.

11

MANUAL TCNICO

1.4. Archivo de descarga 1.4.1. NOMBRE_ACTIVIDAD.TXT Al realizar la descarga, esta devolver un archivo de texto con los datos registrados por cada una de las actividades relacionadas durante un periodo seleccionado.

CDIGO_CUENTA NOMBRE_CUENTA CODIGO_CAMPANHA NOMBRE_CAMPANHA ID_ACTIVIDAD NOMBRE_ACTIVIDAD NOMBRE_CANAL CODIGO_CLIENTE NOMBRE_CLIENTE CODIGO_USUARIO NOMBRE_USUARIO CATEGORIA1 CATEGORIA2 CATEGORIA3 CODIGO_PRODUCTO NOMBRE_PRODUCTO CODIGO_EQUIPO NOMBRE_EQUIPO FECHAREGFIN LATITUD LONGITUD CAMPOS ACTIVIDAD

Cdigo de la cuenta Nombre de la cuenta Cdigo de la campaa Nombre de la campaa Cdigo autogenerado de la actividad Nombre de la actividad Nombre del canal Cdigo del punto de venta Nombre del punto de venta Cdigo del usuario Nombre del usuario Nombre de la categora 1 Nombre de la categora 2 Nombre de la categora 3 Cdigo del producto Nombre del producto Cdigo del equipo Nombre del equipo Fecha y hora del registro Latitud GPS del registro Longitud GPS en la registro El archivo adjuntar los valores registrados para cada campo de la actividad a la que corresponde el archivo txt.

Alfanumrico (50) Alfanumrico (100) Alfanumrico (50) Alfanumrico(100) Entero Alfanumrico(100) Alfanumrico(100) Alfanumrico (50) Alfanumrico(100) Alfanumrico (50) Alfanumrico(100) Alfanumrico(100) Alfanumrico(100) Alfanumrico(100) Alfanumrico(50) Alfanumrico(100) Alfanumrico(50) Alfanumrico(100) Fecha Alfanumrico(50) Alfanumrico(50) Alfanumrico

12

MANUAL TCNICO
Ejemplo: Una actividad con existencias nos generar el siguiente tipo de registro:

10

11

12

CT1|ALIN|CP1|ALIN_VERANO|100|EXISTENCIA|MAYORISTA|CC001|RIPLEY_S.A.|CU001|USUA0|CAT01| CAT02|CAT03|CP001|NP003|ZO01|STYRKA|02/11/2011 19:29:59|-12.0524|-77.0005|SI|152|12.5

13 14 15 5 16 5 17 5 18 5 19 5 20 5 21 5 22 5

1 2 3 4 5 6 7 8

CODIGO_CUENTA NOMBRE_CUENTA CODIGO_CAMPANHA NOMBRE_CAMPANHA ID_ACTIVIDAD NOMBRE_ACTIVIDAD CANAL CODIGO_CLIENTE

9 10 11 12 13 14 15 5 16 5

NOMBRE_CLIENTE CODIGO_USUARIO NOMBRE_USUARIO CATEGORIA1 CATEGORIA2 CATEGORIA 3 CODIGO_PRODUCTO NOMBRE_PRODUCTO

17 5 18 5 19 5 20 5 21 5 22 5

CODIGO_EQUIPO NOMBRE_EQUIPO FECHAREGFIN LATITUD LONGITUD CAMPOS ACTIVIDAD*

NOTA
En este caso los controles de la actividad son: EXISTENCIA|STOCK|PRECIO

13

MANUAL TCNICO

2. REQUERIMIENTOS DEL SISTEMA

Cliente Web
Explorador de Internet: Internet Explorer v.7.0 o superior, Mozilla Firefox 5.0, Google Chrome 6.0 o superior.

Cliente Mvil
El equipo mvil debe contener las siguientes configuraciones LCD 1.1 o superior MIDP 2.0 o superior Web Services 1.0 o superior El equipo debe tener activo el servicio de transmisin de datos El equipo debe tener el servicio GPS activado (si es deseable el registro de posiciones GPS en las operaciones realizadas.) El equipo debe tener un espacio de datos mnimo: 186 KB El equipo debe tener un espacio de programa mnimo : 383 KB

NOTA
Mientras la aplicacin se encuentre en uso, los servicios de voz (conexin directa y llamadas telefnicas) podran no estar disponibles. La disponibilidad, precisin y validez de las aplicaciones y servicios dependientes en localizacin utilizando GPS o triangulacin variarn de acuerdo al entorno en el cual se utilice esa funcin. En algunas situaciones, donde no sea posible obtener seales adecuadas, es posible que los sistemas de GPS o triangulacin no funcionen. Vea su gua del usuario para saber maneras de aumentar el rendimiento del sistema de GPS.

14