Manual de Moviventas

Seratic Ltda.

12/03/2010

2010

MoviVentas2 Manual de Usuario Manejo de Archivos Servidor de Móviles

V.0.1

MoviVentas2 Manual de Usuario Manejo de archivos Servidor de Móviles v.0.1 SERATIC ® 2010

Seratic Ltda. (Colombia) – Seratic SAC (Perú) [email protected] www.seratic.com

TABLA DE CONTENIDO

1. FUNCIONAMIENTO GENERAL ________________________________________________________________ 5

2. ESTRUCTURA DE LOS ARCHIVOS _____________________________________________________________ 7

3. ARCHIVOS DESCARGADOS A LA APLICACIÓN MÓVIL REQUERIDOS PARA MÓDULOS DE MOVIVENTAS2 ___________________________________________________________________________________ 10

4. ARCHIVOS GENERADOS POR EL SERVIDOR SEGÚN MÓDULOS DE MOVIVENTAS2 PARA INTEGRACIÓN CON EL SISTEMA EMPRESARIAL __________________________________________________ 12

1. FORMATO DE ARCHIVO Empresa.dat ________________________________________________________ 13

2. FORMATO DE ARCHIVOS DE LA CARPETA DATOS GENÉRICOS _______________________________ 14

a. Archivo Distribuidora.dat _________________________________________________________________________________ 14

b. Archivo Giro.dat _________________________________________________________________________________________ 15

3. FORMATO DE ARCHIVOS DE LA CARPETA DATOS PAGO ______________________________________ 16

a. Archivo Banco.dat _______________________________________________________________________________________ 16

b. Archivo Moneda.dat _____________________________________________________________________________________ 17

c. Archivo FormaPago.dat ___________________________________________________________________________________ 18

d. Archivo CondicionVenta.dat _______________________________________________________________________________ 19

4. FORMATO DE ARCHIVOS DE LA CARPETA DATOS MOTIVO ___________________________________ 20

a. Archivo Canje.dat _______________________________________________________________________________________ 20

b. Archivo NoPedido.dat ____________________________________________________________________________________ 22



c. Archivo AnulacionDistribucion.dat __________________________________________________________________________ 23

d. Archivo DistribucionParcial.dat ____________________________________________________________________________ 24

5. FORMATO DE ARCHIVOS DE LA CARPETA DATOS PRODUCTOS _______________________________ 25

a. Archivo Linea.dat ________________________________________________________________________________________ 25

b. Archivo Zona.dat ________________________________________________________________________________________ 26

c. Archivo Canal.dat _______________________________________________________________________________________ 27

d. Archivo Promocion.dat ___________________________________________________________________________________ 28

e. Archivo Producto.dat ____________________________________________________________________________________ 29

f. Archivo PreciosProducto.dat ______________________________________________________________________________ 30

g. Archivo UnidadesProducto.dat _____________________________________________________________________________ 31

6. FORMATO DE ARCHIVOS DE LA CARPETA DATOS RUTA ______________________________________ 32

a. Archivo Usuario.dat ______________________________________________________________________________________ 33

b. Archivo Cuota.dat _______________________________________________________________________________________ 34

c. Archivo Cliente.dat ______________________________________________________________________________________ 35

d. Archivo Ruta.dat ________________________________________________________________________________________ 38

e. Archivo DocumentosEntrega.dat ___________________________________________________________________________ 41

f. Archivo DocumentosCobro.dat_____________________________________________________________________________ 43

g. Archivo Encuesta.dat _____________________________________________________________________________________ 44

7. FORMATO DE ARCHIVOS DE LA CARPETA TRABAJOS ________________________________________ 48

a. Archivo Pedidos.dat______________________________________________________________________________________ 48



b. Archivo DetallePedido.dat ________________________________________________________________________________ 50

c. Archivo DetalleCanje.dat _________________________________________________________________________________ 51

d. Archivo Entregas.dat _____________________________________________________________________________________ 53

e. Archivo DetalleEntregaParcial.dat __________________________________________________________________________ 54

f. Archivo Cobranzas.dat____________________________________________________________________________________ 55

g. Archivo EncuestasAplicadas.dat ____________________________________________________________________________ 57

h. Archivo DetallePreguntaAbierta.dat ________________________________________________________________________ 58

i. Archivo DetallePreguntaSeleccion.dat _______________________________________________________________________ 59

j. Archivo Tercero.dat ______________________________________________________________________________________ 61

8. FORMATO DE ARCHIVOS DE LA CARPETA PROCESADOS _____________________________________ 62

a. Archivo EstadoPedidos.dat ________________________________________________________________________________ 62

9. ARCHIVO LOG DEL SERVIDOR PARA LECTURA Y ESCRITURA DE ARCHIVOS _________________ 63

LISTA DE FIGURAS

Figura 1. Estructura de carpetas de los archivos _____________________________________________________________________________ 8 Figura 2. Ruta de Acceso al Log del Servidor de Móviles para Procesamiento de Archivos ________________________________________ 64 Figura 3. Ejemplo del Log del Servidor de Móviles para Procesamiento de Archivos _____________________________________________ 65



1. FUNCIONAMIENTO GENERAL

MoviVentas2 Server es el servidor de móviles que se encarga de procesar las peticiones de MoviVentas2 Móvil (aplicación móvil) y entregar la información requerida para el funcionamiento adecuado de la aplicación móvil.

Si el cliente ha decidido no hacer el impacto de su data directamente sobre la base de datos del servidor de MoviVentas2, sino que ha decidido hacerlo a través de archivos, la primera vez el cliente deberá construir los archivos y ubicar en ellos toda la data maestra, según los módulos adquiridos del sistema MoviVentas2 (Pedidos, Entregas, Cobranza, Encuestas y Gestión o combinación de los mismos), para más información ver punto 3 (Archivos descargados a la aplicación móvil requeridos para módulos de MoviVentas2) y 4 (Archivos generados por el servidor de móviles según módulos de MoviVentas2 para integración con el Sistema Empresarial) de este manual. Los archivos deberán ser construidos según como se especifica en la estructura de los archivos más adelante y deberán ser ubicados en la ruta configurada en el servidor para este efecto (remitirse al punto 3.b. Parámetros de Conexión a Archivos, del manual MANUAL DE INSTALACION DEL SERVIDOR DE MOVILES DE MOVIVENTAS2.pdf.).

Por defecto, cada hora MoviVentas2 Server inicia un proceso de lectura de los archivos que se encuentran en la carpeta asequible por el mismo (ruta configurada en el servidor para alojamiento de archivos) para actualizar la información que se debe descargar a la aplicación móvil. Para obtener más información de cómo cambiar la configuración del tiempo de lectura o ruta de archivos remitirse al punto 3.b. Parámetros de Conexión a Archivos, del manual MANUAL DE INSTALACION DEL SERVIDOR DE MOVILES DE MOVIVENTAS2.pdf.

En adelante, cuando el cliente realice modificaciones sobre la data maestra, deberá ubicar la información nueva o modificada en un nuevo archivo con la estructura especificada para éste, como se detalla más adelante. El servidor de MoviVentas2 vuelve a procesar los archivos y si encuentra registros repetidos actualiza la data en su base de datos y, adiciona a su base de datos los nuevos registros encontrados. La eliminación de registros no está contemplada mediante el proceso de archivos, en este caso el cliente deberá ir manualmente a la base de datos del servidor de MoviVentas2 y



eliminar el registro correspondiente, para conocer la estructura de la base de datos del servidor de MoviVentas2 dirigirse al documento llamado Manual de Usuario MoviVentas2 Server_Diccionario Datos.pdf.

El servidor de MoviVentas2 una vez procesa los archivos, modifica el nombre de cada archivo poniéndole al final del nombre:

- Procesado: Indicando que todos los datos de este archivo fueron cargados exitosamente en la base de datos del servidor de MoviVentas2.

- Corrupto: Indicando que por algún motivo no se pudo cargar toda la data de este archivo en la base de datos del servidor de MoviVentas2. Esto se debe a que uno o varios registros del archivo no cumplen con el formato especificado.

Así como existen archivos para cargar datos al servidor de MoviVentas2 que serán descargados a los móviles para el trabajo del día a día, de igual manera existen otros archivos en los cuales la información de las labores realizadas en campo es recopilada por el servidor de MoviVentas2 y se deja disponible en una carpeta específica “Trabajos” (como se detalla más adelante) para ser interpretada por un proceso interno del cliente hasta integrar la información al sistema empresarial del cliente.

En este manual se explicará la forma como deben construirse los archivos de carga y descarga de data del servidor MoviVentas2, y cómo éstos deben ser interpretados.



2. ESTRUCTURA DE LOS ARCHIVOS

Para esta solución se tiene la estructura de carpetas de los archivos que se muestra en la Figura 1. Esta estructura de carpetas se definió para facilitar la organización de la información haciendo agrupaciones de acuerdo a como están relacionadas. La carpeta raíz puede tener cualquier nombre, pero se debe respetar la estructura interna de dicha carpeta, en este caso la hemos llamado MoviVentas2, en ella se encuentra una carpeta de nombre igual al código único asignado a la empresa por Movistar para el uso de MoviVentas2. Esta carpeta es la más importante, pues es en esta ruta (capeta de nombre igual al código único de la emrpesa) donde MoviVentas2 Server realizará la búsqueda de la información de la data para cargar la base de datos. Las demás carpetas internas a la carpeta de código de la empresa son útiles para organizar la información, sin embargo, no son indispensables para que MoviVentas2 Server realice la lectura de archivos y carga de datos en la base de datos. Lo que sí tiene que permanecer igual es el nombre de los archivos, y su estructura interna, tal como se describe más adelante en este manual, para que la información sea cargada adecuadamente.



Figura 1. Estructura de carpetas de los archivos

Internamente dentro de la carpeta con el código de la empresa se encuentran las siguientes carpetas:



• Datos Genericos: Agrupa los archivos que son propios de la empresa y que son utilizados por otros archivos. Los archivos contenidos en esta carpeta son: Distribuidora.dat y Grio.dat.

• Datos Pago: Agrupa los archivos que contienen la información de pagos. Los archivos contenidos en esta carpeta son: Banco.dat, Moneda.dat, FormaPago.dat y CondicionVenta.dat.

• Datos Motivo: Agrupa los archivos que contienen la información de los diferentes motivos que se usan en la aplicación Móvil. Los archivos contenidos en esta carpeta son: Canje.dat, NoPedido.dat, AnulacionDistribucion.dat y DistribucionParcial.dat.

• Datos Producto: Agrupa los archivos que tienen la información de los productos, sus precios y su posibilidad de venta en un canal. Los archivos contenidos en esta carpeta son: Linea.dat, Zona.dat, Canal.dat, Promocion.dat, Producto.dat, PreciosProducto.dat, UnidadesProducto.dat.

• Datos Ruta: Agrupa los archivos que tienen que ver con la ruta asignada a un usuario en sus diferentes labores. Los archivos contenidos en esta carpeta son: Usuario.dat, Cuota.dat, Cliente.dat, Ruta.dat, Encuesta.dat, DocumentosCobro.dat y DocumentosEntrega.dat.

• Trabajos: Agrupa los archivos que tienen que ver con todos los procesos trabajados en campo por los usuarios de la aplicación móvil. Los archivos contenidos en esta carpeta son: Pedidos.dat, DetallePedido.dat, DetalleCanje.dat, Cobranzas.dat, Entregas.dat, DetalleEntregaParcial.dat, EncuestasAplicadas.dat, DetallePreguntaAbierta.dat, DetallePreguntaSeleccion.dat y Tercero.dat.

• Procesados: Agrupa los archivos que tienen la información procesada por la empresa para consultas posteriores de la aplicación móvil. Los archivos contenidos en esta carpeta son: EstadoPedidos.dat



3. ARCHIVOS DESCARGADOS A LA APLICACIÓN MÓVIL REQUERIDOS PARA MÓDULOS DE MOVIVENTAS2

Una empresa puede adquirir uno o más módulos de MoviVentas2 (Módulo de Pedidos, Módulo de Cobranzas en Pedidos, Módulo de Entregas, Módulo de Cobranzas en Entregas, Módulo de Cobranzas y Módulo de Encuestas). Dependiendo de los módulos adquiridos, cada empresa deberá generar uno u otros archivos como se especifica en la siguiente tabla, donde cada archivo es marcado con una x al frente indicando si este archivo es requerido o no como insumo de información para cada uno de los módulos que conforma la solución MoviVentas2.

Archivo/Módulo Pedidos (Pedido, No Pedido, Canje)

Cobranzas en Pedidos

Entregas (Total, Parcial, Rechazada)

Cobranzas en Entregas

Cobranzas Encuestas Gestión

Datos Genericos

Distribuidora.dat X X X X X X X

Giro.dat X X X X X X Datos Pago Banco.dat X X X Moneda.dat X X X X X FormaPago.dat X X X CondicionVenta.dat X X X X Datos Motivo Canje.dat X NoPedido.dat X AnulacionDistribucion.dat X DistribucionParcial.dat X Datos Producto Linea.dat X X Zona.dat X Canal.dat X X X Promocion.dat X



Producto.dat X X PreciosProducto.dat X X UnidadesProducto.dat X X Datos Ruta Usuario.dat X X X X X X X Cuota.dat X Cliente.dat X X X X X X Ruta.dat X X X X X X DocumentosCobro.dat X X DocumentosDistribucion.dat X X Encuestas.dat X Procesados EstadosPedido.dat X



4. ARCHIVOS GENERADOS POR EL SERVIDOR SEGÚN MÓDULOS DE MOVIVENTAS2 PARA INTEGRACIÓN CON EL SISTEMA EMPRESARIAL

De acuerdo a los módulos adquiridos de la solución MoviVentas2, el servidor de móviles generará la información recolectada en campo en unos u otros archivos, como se especifica en la siguiente tabla. Los archivos marcados con x son los generados por el servidor por cada módulo utilizado en el aplicativo móvil de MoviVentas2.

Archivo/Módulo Pedidos (Pedido, No Pedido, Canje)

Cobranzas en Pedidos

Entregas

Cobranzas en Entregas

Cobranzas Encuestas

Trabajos Pedidos.dat X DetallePedido.dat X DetalleCanje.dat X Entregas.dat X DetalleEntregaParcial.dat X Cobranzas.dat X X X EncuestasAplicadas.dat X DetallePreguntaAbierta.dat X DetallePreguntaSeleccion.dat X Tercero.dat X



1. FORMATO DE ARCHIVO Empresa.dat Este archivo contiene el listado de todas las empresas que han adquirido uno o varios módulos de MoviVentas2, y por tanto hace uso de la aplicación.

El contenido del archivo Empresa.dat siempre debe tener el siguiente formato:

codEmpresa|nombreEmpresa

Cada línea del archivo corresponde a la información de una empresa diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la empresa se deben escribir de la siguiente manera:

Archivo: Empresa.dat Campo Descripción Tipo Dato Tamaño Obligatorio codEmpresa Código de la empresa asignado desde el servidor de descargas. VARCHAR 20 Sí nombreEmpresa Nombre de la empresa VARCHAR 100 Sí

Ejemplo:

Para las empresas que se encuentran en el servidor de descargas,

Código de la Empresa Nombre de la Empresa MV031 Distribuidora MOLI SAC MV021 Porteña, Comercializadora y Distribuidora

El archivo Empresa.dat debe escribirse:

Empresa.dat MV021|Porteña, Comercializadora y Distribuidora MV031|Distribuidora MOLI SAC



2. FORMATO DE ARCHIVOS DE LA CARPETA DATOS GENÉRICOS Corresponden a los datos genéricos que tiene la empresa que son utilizados en los archivos posteriores.

a. Archivo Distribuidora.dat Este archivo contiene cada una de las distribuidoras en las cuales se venden los productos que ofrece una empresa.

El contenido del archivo Distribuidora.dat siempre debe tener el siguiente formato:

codDistribuidora|nombreDistribuidora

Cada línea del archivo corresponde a la información de una distribuidora diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la distribuidora se deben escribir de la siguiente manera:

Archivo: Distribuidora.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codDistribuidora Código de la distribuidora VARCHAR 20 Sí nombreDistribuidora Descripción de la distribuidora VARCHAR 100 Sí

Ejemplo:

Para las Distribuidoras: Código de Distribuidora Nombre de Distribuidora DIS01 DISTRIBUIDORA DE PRODUCTOS 1 DIS02 DISTRIBUIDORA DE PRODUCTOS 2



El archivo Distribuidora.dat debe escribirse:

Distribuidora.dat DIS01|DISTRIBUIDORA DE PRODUCTOS 1 DIS02|DISTRIBUIDORA DE PRODUCTOS 2

b. Archivo Giro.dat Este archivo contiene cada uno de los giros definidos por la empresa para la agrupación de los clientes.

El contenido del archivo Giro.dat siempre debe tener el siguiente formato:

codGiro|nombreGiro

Cada línea del archivo corresponde a la información de un giro diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del canal se deben escribir de la siguiente manera:

Archivo: Giro.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codGiro Código del giro VARCHAR 20 Sí descripcion Descripción del giro VARCHAR 100 Sí

Ejemplo:

Para los Giros: Código de Distribuidora Nombre de Distribuidora GIR01 GIRO 2 GIR02 GIRO 1



El archivo Giro.dat debe escribirse:

Giro.dat GIR01|GIRO 1 GIR02|GIRO 2

3. FORMATO DE ARCHIVOS DE LA CARPETA DATOS PAGO Corresponden a los datos utilizados para registrar en los móviles los conceptos relacionados con pagos, son archivos que vienen con data maestra desde el sistema Empresarial para ser cargados en el Servidor de móviles.

a. Archivo Banco.dat Este archivo contiene el listado de bancos manejado por su empresa, para registrar labores de cobranzas por ejemplo en tipos de pago por consignación.

El contenido del archivo Banco.dat siempre debe tener el siguiente formato:

codBanco|nombreBanco

Cada línea del archivo corresponde a la información de un banco diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del banco se deben escribir de la siguiente manera:

Archivo: Banco.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codBanco Código del banco VARCHAR 20 Sí nombreBanco Nombre del banco VARCHAR 100 Sí



Ejemplo:

Código de Banco Nombre de Banco BBVA Banco BBVA BSTR Banco Santander El archivo Banco.dat debe escribirse:

Banco.dat BBVA|Banco BBVA BSTR|Banco Santander

b. Archivo Moneda.dat En este archivo se cargarán todas las monedas que son soportadas actualmente en el sistema empresarial para el precio de los productos o cobros.

El contenido del archivo Moneda.dat siempre debe tener el siguiente formato:

codMoneda|nombreMoneda

Cada línea del archivo corresponde a la información de una moneda diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la moneda se deben escribir de la siguiente manera:

Archivo: Moneda.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codMoneda Código de la moneda VARCHAR 20 Sí nombreMoneda Nombre de la moneda VARCHAR 100 Sí



Ejemplo:

Código de Moneda Nombre de Moneda PEN Nuevo Sol Peruano DOL Dólares El archivo Moneda.dat debe escribirse:

Moneda.dat PEN|Nuevo Sol Peruano DOL|Dólares

c. Archivo FormaPago.dat Este archivo contiene las formas de pago permitidas por la empresa. Ejemplo: Efectivo, Cheque, etc.

El contenido del archivo FormaPago.dat siempre debe tener el siguiente formato:

codFormaPago|nombreFormaPago|habNumero|habBanco|habFecha

Cada línea del archivo corresponde a la información de una forma de pago diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la forma de pago se deben escribir de la siguiente manera:

Archivo: FormaPago.dat Campo Descripción Tipo Dato Tamaño Obligatorio codFormaPago Código de la forma de pago VARCHAR 20 Sí nombreFormaPago Nombre de la forma de pago VARCHAR 100 Sí habNumero Bandera que especifica si la forma de pago requiere ingreso de número (transacción,

consignación, etc.). Puede tomar el valor: - 0: indica que no se requiere ingreso de número. - 1: indica que sí se requiere ingreso de número.

BIT Sí



habBanco Bandera que especifica si la forma de pago requiere ingreso de banco. Puede tomar el valor: - 0: indica que no se requiere ingreso de banco. - 1: indica que sí se requiere ingreso de banco.

BIT Sí

habFecha Bandera que especifica si la forma de pago requiere ingreso de fecha. Puede tomar el valor: - 0: indica que no se requiere ingreso de fecha. - 1: indica que sí se requiere ingreso de fecha.

BIT Sí

Ejemplo:

Código de Forma de Pago Nombre de Forma de Pago Hab. Número Hab. Banco Hab. Fecha EFE EFECTIVO No No No CHE CHEQUE Sí Sí No El archivo FormaPago.dat debe escribirse:

FormaPago.dat EFE|EFECTIVO|0|0|0 CHE|CHEQUE|1|1|0

d. Archivo CondicionVenta.dat Este archivo contiene las condiciones de venta permitidas por la empresa, donde se especifica la condición de venta acordada por el cliente para pagar sus pedidos, se usa en el módulo de pedidos, en el módulo de entregas (para visualización de la condición de venta acordada) y en el módulo de entregas con capacidad de cobrar las entregas (independiente del módulo de cobranzas). Ej: 1 Pago a 30 días, 1 pago a 60 días, cuotas mensuales a 6 meses, etc.

El contenido del archivo CondicionVenta.dat siempre debe tener el siguiente formato:

codCondicionVenta|nombreCondicionVenta



Cada línea del archivo corresponde a la información de una condición de venta diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la Condición de venta se deben escribir de la siguiente manera:

Archivo: CondicionVenta.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codCondicionVenta Código de la condición de venta VARCHAR 20 Sí nombreCondicionVenta Nombre de la condición de venta VARCHAR 100 Sí

Ejemplo:

Código de Condición de Venta Nombre de Condición de Venta 30D 30 días 60D 60 días El archivo CondicionVenta.dat debe escribirse:

CondicionVenta.dat 30D|30 días 60D|60 días

4. FORMATO DE ARCHIVOS DE LA CARPETA DATOS MOTIVO Corresponden a los datos utilizados para registrar los motivos relacionados con algunas acciones, son archivos que vienen desde el sistema Empresarial al Servidor de móviles.

a. Archivo Canje.dat Este archivo contiene cada uno de los motivos que justificarán la solicitud de canje realizada por el cliente para cada producto. Ej: Producto vencido, producto en mal estado, bajo nivel, producto defectuoso, etc.



El contenido del archivo Canje.dat siempre debe tener el siguiente formato:

codMotivoCanje|nombreMotivoCanje|habFecha

Cada línea del archivo corresponde a la información de un motivo de canje diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del motivo de canje se deben escribir de la siguiente manera:

Archivo: Canje.dat Campo Descripción Tipo Dato Tamaño Obligatorio codMotivoCanje Código del motivo de canje VARCHAR 20 Sí nombreMotivoCanje Nombre del motivo de canje VARCHAR 100 Sí habFecha Bandera que especifica si el motivo de canje requiere ingreso de fecha. Puede tomar

el valor: - 0: indica que no se requiere ingreso de fecha. - 1: indica que sí se requiere ingreso de fecha.

BIT Sí

Ejemplo:

Código de Motivo Canje Nombre de Motivo Canje Hab. Fecha 1 Está caducado 1 2 Mucha mercancía 0 El archivo Canje.dat debe escribirse:

Canje.dat 1|Está caducado|1 2|Mucha mercancía|0



b. Archivo NoPedido.dat Este archivo contiene cada uno de los motivos que justificarán un no pedido manifestado por el cliente, o registrado por el usuario en la visita al cliente. Ej: Local cerrado, No está el dueño, productos no rotan, productos caros, etc.

El contenido del archivo NoPedido.dat siempre debe tener el siguiente formato:

codMotivoNoPedido|nombreMotivoNoPedido

Cada línea del archivo corresponde a la información de un motivo de no pedido diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de los motivos de no pedido se deben escribir de la siguiente manera:

Archivo: NoPedido.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codMotivoNoPedido Código del motivo de no pedido VARCHAR 20 Sí nombreMotivoNoPedido Nombre del motivo de no pedido VARCHAR 100 Sí

Ejemplo:

Código de Motivo de No Pedido Nombre de Motivo de No Pedido 1 Local cerrado 2 Cliente no quiere El archivo NoPedido.dat debe escribirse:

NoPedido.dat 1|Local cerrado 2|Cliente no quiere



c. Archivo AnulacionDistribucion.dat Este archivo contiene cada uno de los motivos que justificarán el rechazo a la entrega de los productos manifestado por el cliente o registrado por el distribuidor al momento de efectuar la visita. Ej: Local cerrado, mala dirección, el cliente no pidió, sin dinero, etc.

El contenido del archivo AnulacionDistribucion.dat siempre debe tener el siguiente formato:

codMotivoAnulacionDist|nombreMotivoAnulacionDist

Cada línea del archivo corresponde a la información de un motivo de anulación de distribución diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de los motivos de anulación de distribución se deben escribir de la siguiente manera:

Archvio: AnulacionDistribucion.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codMotivoAnulacionDist Código del motivo de anulación de distribución (rechazo de entrega) VARCHAR 20 Sí nombreMotivoAnulacionDist Nombre del motivo de anulación de distribución (rechazo de entrega) VARCHAR 100 Sí

Ejemplo:

Código de Motivo de Anulación Dist. Nombre de Motivo de Anulación Dist 1 Dirección errada 2 Cliente no está El archivo AnulacionDist.dat debe escribirse:

AnulacionDistribucion.dat 1|Dirección errada 2|Cliente no está



d. Archivo DistribucionParcial.dat Este archivo contiene cada uno de los motivos que justificarán el por qué el usuario a la hora de recibir los productos (labor de distribución) no acepta recibir la totalidad de cada producto solicitada en el pedido. Ej: No pidió, productos en stock, fin de campaña, producto vencido, producto en mal estado, bajo nivel, producto defectuoso, etc.

El contenido del archivo DistribucionParcial.dat siempre debe tener el siguiente formato:

codMotivoDistParcial|nombreMotivoDistParcial

Cada línea del archivo corresponde a la información de un motivo de distribución parcial diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de los motivos de distribución parcial se deben escribir de la siguiente manera:

Archivo: DistribucionParcial.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codMotivoDistParcial Código del motivo de distribución parcial. VARCHAR 20 Sí nombreMotivoDistParcial Nombre del motivo de distribución parcial. VARCHAR 100 Sí

Ejemplo:

Código de Dist. Parcial Nombre de Dist. Parcial 1 Productos en stock 2 Producto vencido El archivo DistribucionParcial.dat debe escribirse:

DistribucionParcial.dat 1|Productos en stock 2|Producto vencido



5. FORMATO DE ARCHIVOS DE LA CARPETA DATOS PRODUCTOS Corresponden a los datos utilizados para registrar los datos de precio, descuento, unidad, canal y demás información necesaria para realizar la carga de productos, son archivos que vienen desde el sistema Empresarial al Servidor de móviles.

a. Archivo Linea.dat Este archivo contiene cada una de las líneas a las cuales corresponden los productos que ofrece la empresa.

El contenido del archivo Linea.dat siempre debe tener el siguiente formato:

codLinea|nombreLinea

Cada línea del archivo corresponde a la información de una línea de productos diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la línea se deben escribir de la siguiente manera:

Archivo: Linea.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codLinea Código de la línea VARCHAR 20 Sí nombreLinea Nombre de la línea VARCHAR 100 Sí

Ejemplo:

Para las Líneas: Código de Línea Nombre de Línea LIN01 Aseo y hogar LIN02 Comestibles



El archivo Linea.dat debe escribirse:

Linea.dat LIN01|Aseo y hogar LIN02|Comestibles

b. Archivo Zona.dat Este archivo contiene cada una de las zonas o ubicación geográfica que están registradas por la empresa y a la cual pertenecen los clientes; y los descuentos que cada zona tiene para ser aplicados en el momento de hacer un pedido.

El contenido del archivo Zona.dat siempre debe tener el siguiente formato:

codZona|nombreZona|descuento

Cada línea del archivo corresponde a la información de una zona diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la zona se deben escribir de la siguiente manera:

Archivo: Zona.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codZona Código de la zona VARCHAR 20 Sí nombreZona Nombre de la zona VARCHAR 100 Sí descuento Valor del descuento a ser aplicado medido en porcentaje. Los decimales se separan con “.”. DOUBLE Sí Ejemplo:

Código de Zona Nombre de Zona Descuento (%) ZON01 Lima 3.7 ZON02 Arequipa 4.2 El archivo Zona.dat debe escribirse:



Zona.dat ZON01|Lima|3.7 ZON02|Arequipa|4.2

c. Archivo Canal.dat Este archivo contiene cada uno de los canales a los cuales corresponden los productos que ofrece su compañía. Ej: Mayoristas, Minoristas, Clientes claves, etc.

El contenido del archivo Canal.dat siempre debe tener el siguiente formato:

codCanal|nombreCanal

Cada línea del archivo corresponde a la información de un canal diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del canal se deben escribir de la siguiente manera:

Archivo: Canal.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codCanal Código del canal VARCHAR 20 Sí nombreCanal Nombre del canal VARCHAR 100 Sí

Ejemplo:

Código de Canal Nombre de Canal C01 Tiendas C02 Supermercados El archivo Canal.dat debe escribirse:



Canal.dat C01|Tiendas C02|Supermercado

d. Archivo Promocion.dat Este archivo contiene cada una de las promociones que ofrece la empresa y que pueden ser accedidas desde la aplicación móvil.

El contenido del archivo Promocion.dat siempre debe tener el siguiente formato:

codPromocion|descripcion

Cada línea del archivo corresponde a la información de una promoción diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la promoción se deben escribir de la siguiente manera:

Archivo: Promocion.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codPromocion Código de la promoción VARCHAR 20 Sí descripcion Descripción de la promoción VARCHAR 100 Sí

Ejemplo:

Código de Promoción Descripción de Promoción PRO01 Pague 2 yogures y lleve 3 PRO02 Gratis 6 rollos de papel higiénico El archivo Promocion.dat debe escribirse:



Promocion.dat PRO01|Pague 2 yogures y lleve 3 PRO02|Gratis 6 rollos de papel higiénico

e. Archivo Producto.dat Este archivo contiene cada uno de los productos que ofrece la empresa.

El contenido del archivo Producto.dat siempre debe tener el siguiente formato:

codProducto|nombreProducto|codLinea|orden|factorGestion

Cada línea del archivo corresponde a la información de un producto diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del producto se deben escribir de la siguiente manera:

Archivo: Producto.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codProducto Código del banco VARCHAR 20 Sí nombreProducto Nombre del banco VARCHAR 100 Sí codLinea Código de línea VARCHAR 20 Sí orden Orden de visualización en aplicación móvil SHORT Sí factorGestion Porcentaje de precio que se tomará en cuenta para la gestión del usuario. DOUBLE Sí

Ejemplo:

Código de Producto Nombre de Producto Código de Línea Orden Factor de Gestión BOM03 Bananitas de sabores LIN02 10 0.8 MEC01 Papas fritas naturales LIN01 12 1 El archivo Producto.dat debe escribirse:



Producto.dat BOM03|Bananitas de sabores|LIN02|10|0.8 MEC01|Papas fritas naturales|LIN01|12|1

f. Archivo PreciosProducto.dat Este archivo especifica el precio de cada producto por canal. Ej: Si su empresa produce gaseosa X en tamaño 1lt (Unidad de medida de venta), esta puede tener un precio de s/3 para canal Mayoristas, s/3.5 para canal Minoristas, s/2.9 para Clientes claves, S/3.4 para canal Tiendas, etc.

El contenido del archivo PreciosProducto.dat siempre debe tener el siguiente formato:

codCanal|codDistribuidora|codProducto|codMoneda|codUnidad|precio

Cada línea del archivo corresponde a la información de un producto para un canal específico. Cada dato se encuentra separado del siguiente con |.

Los datos del producto canal se deben escribir de la siguiente manera:

Archivo: PreciosProducto.dat Campo Descripción Tipo Dato Tamaño Obligatorio codCanal Código del canal. Se debe escribir un código que se encuentre en la base de datos o que

se haya ingresado previamente en el archivo Canal.dat VARCHAR 20 Sí

codDistribuidora Código de la distribuidora. Se debe escribir un código que se encuentre en la base de datos o que se haya ingresado previamente en el archivo Distribuidora.dat

VARCHAR 20 Sí

codProducto Código del producto. Se debe escribir un código que se encuentre en la base de datos o que se haya ingresado previamente en el archivo Producto.dat

VARCHAR 20 Sí

codMoneda Código de la moneda en la que se vende el producto. Se debe escribir un código que se encuentre en la base de datos o que se haya ingresado previamente en el archivo Moneda.dat

VARCHAR 20 Sí

codUnidad Código de la unidad de medida de venta de referencia en la que se vende el producto para el canal y distribuidora especificados. Se debe escribir un código que se encuentre en la base de datos o que se haya ingresado en el archivo

VARCHAR 20 Sí



UnidadesProducto.dat precio Precio de referencia del producto para la moneda y unidad especificada. DOUBLE Sí Ejemplo:

Código Canal Código Distribuidora Código Producto Código Moneda Código Unidad Precio C01 DIS01 BOM03 DOL BOL 0.42 C01 DIS01 MEC01 PEN BOL 1.5 El archivo PreciosProducto.dat debe escribirse:

PreciosProducto.dat C01|DIS01|BOM03|DOL|BOL|0.42 C01|DIS01|MEC01|PEN|BOL|1.5

g. Archivo UnidadesProducto.dat Este archivo especifica la forma de calcular el precio para un producto según la unidad de medida de venta, además indica cuantas unidades hay en stock de este producto en el momento de la carga al servidor de MoviVentas2. Así por ejemplo, si su empresa produce gaseosa en tamaño 750ml y 1000ml (Unidades de medida de venta), y suponiendo que el precio que tiene cada una respectivamente es S/2 y S/3, entonces se puede decir que los precios de todas las gaseosas se darán basados en el precio de la gaseosa de 750ml (factor = 1), de esta manera el precio de la gaseosa de 1000ml tendría un factor de 1.5 respecto a la gaseosa de 750ml.

El contenido del archivo UnidadesProducto.dat siempre debe tener el siguiente formato:

codProducto|codUnidad|factor|stock

Cada línea del archivo corresponde a la información a la asignación de una unidad para un producto en específico. Cada dato se encuentra separado del siguiente con |.

Los datos de las unidades producto se deben escribir de la siguiente manera:



Archivo: UnidadesProducto.dat Campo Descripción Tipo Dato Tamaño Obligatorio codProducto Código del producto VARCHAR 20 Sí codUnidad Nombre de la unidad de medida del producto VARCHAR 100 Sí factor Especifica el valor de conversión del precio de una unidad de medida con respecto a la

unidad de medida de referencia. Si el producto se encuentra en la unidad de medida de referencia, el valor del factor es 1.

DOUBLE Sí

stock Especifica las cantidades disponibles del producto en la unidad de medida especificada. Debe ser un valor mayor o igual que 0.

DOUBLE Sí

Ejemplo:

Código de Producto Código de Unidad Factor Stock BOM03 BOL 0.5 500 MEC01 BOL 0.25 150 El archivo UnidadesProducto.dat debe escribirse:

UnidadesProducto.dat BOM03|BOL|0.5|500 MEC01|BOL|0.25|150

6. FORMATO DE ARCHIVOS DE LA CARPETA DATOS RUTA Corresponden a los datos utilizados para registrar las rutas de atención y la asignación de dichas rutas a un usuario, además especifican que procesos se les deben realizar a los clientes que se están visitando, son archivos que vienen desde el sistema Empresarial al Servidor de móviles.



a. Archivo Usuario.dat Este archivo contiene los usuarios que están habilitados para conectarse desde un dispositivo móvil a MoviVentas2. Sólo los usuarios que se definan a través de este archivo podrán autenticarse exitosamente en la aplicación de MoviVentas2.

El contenido del archivo Usuario.dat siempre debe tener el siguiente formato:

codDistribuidora|codUsuario|nombre|celular|codSuper|nivelJerarquico|numDiasHabiles

Cada línea del archivo corresponde a la información de un usuario diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del usuario se deben escribir de la siguiente manera:

Los usuarios deberán escribirse en el archivo organizados por nivel jerárquico de mayor a menor para garantizar que al momento de escribir usuarios de un tipo más bajo por ejemplo un vendedor asociado a un usuario de código más alto por ejemplo un supervisor, éste ya exista. De lo contrario se tendría el archivo como corrupto.

Archivo: Usuario.dat

Campo Descripción Tipo Dato Tamaño Obligatorio codDistribuidora Código de la distribuidora a la que pertenece el usuario VARCHAR 20 No codUsuario Código del usuario, utilizado para autenticación VARCHAR 20 Sí nombreUsuario Nombre del usuario VARCHAR 100 Sí Celular Número de celular asignado al usuario para uso de MoviVentas2, utilizado para

autenticación LONG No

codSuper Código del supervisor del usuario, es decir, código de la persona que está por encima del usuario en la jerarquía. Si el usuario no tiene supervisor, este campo no se coloca.

VARCHAR 20 No

nivelJerarquico Nivel de jerarquía que tiene el usuario. Puede tomar los siguientes valores: - 0: para un usuario tipo Vendedor, Distribuidor, Cobrador o Encuestador - 1: para un usuario tipo Supervisor - 2: para un usuario tipo Jefe - 3: para un usuario tipo Gerente

BYTE Sí

numDiasHabiles Número de días hábiles que se deben tomar en cuenta para los reportes diarios de cumplimiento de cuota del vendedor.

BYTE Sí



Ejemplo:

Código Distribuidora

Código de Usuario

Nombre Usuario Celular Código Súper Nivel Jerárquico

Número de Días Hábiles

10301572 Iván Mauricio Guzmán 3 22 DIS02 34318038 Claudia Patricia Acevedo 3013713834 10301572 2 24 El archivo Usuario.dat debe escribirse:

Usuario.dat |10301572|Iván Mauricio Guzmán|0||3|22 codDistribuidora|codUsuario|nombre|3013713834|10301572|2|24

b. Archivo Cuota.dat Este archivo contiene las cuotas de Ventas por línea de producto y moneda para cada uno de los usuarios que están habilitados para conectarse desde su dispositivo móvil a MoviVentas2. Permite hacer seguimiento del cumplimiento de las cuotas establecidas en dinero.

El contenido del archivo Cuota.dat siempre debe tener el siguiente formato:

codUsuario|codLinea|codMoneda|mes|año|cuota

Cada línea del archivo corresponde a la información de una cuota diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la cuota se deben escribir de la siguiente manera:



Archivo: Cuota.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codUsuario Código del usuario VARCHAR 20 Sí codLinea Código de la línea en la que aplica la cuota VARCHAR 20 Sí codMoneda Código de moneda en la que se mide la cuota VARCHAR 20 Sí Mes Mes en el que se fija la cuota. Los meses van de 1 a 12:

- Mes 1: Enero - Mes 12: Diciembre

BYTE Sí

Año Año en el que se fija la cuota SHORT Sí Cuota Valor de la cuota que debe cumplir el usuario para la línea y moneda especificadas DOUBLE Sí

Ejemplo:

Código de Usuario Código de Línea Código de Moneda Mes Año Cuota 34318038 LIN01 PEN 5 2010 13450.97 34318038 LIN02 DOL 4 2010 5289.65 El archivo Cuota.dat debe escribirse:

Cuota.dat 34318038|LIN01|PEN|5|2010|13450.97 34318038|LIN02|DOL|4|2010|5289.65

c. Archivo Cliente.dat Este archivo especifica la información requerida en la aplicación móvil de MoviVentas2 para cada uno de sus clientes que serán atendidos en los proceso de pedido, entregas, cobranzas o encuestas.

El contenido del archivo Cliente.dat siempre debe tener el siguiente formato:

codCliente|codGiro|razonSocial|ruc|tel|codZona|numLineaCredito|montoLineaCredito1|codMoneda|montoLineaCreditoN| codMoneda|numDir|Dir1|DirN|numCanal|codCanal1|codFormaPago|codCanalN|codFormaPago



Cada línea en el archivo corresponde a la información de un cliente diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del cliente se deben escribir de la siguiente manera:

Archivo: Clientes.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codCliente Código del cliente VARCHAR 20 Sí codGiro Código del giro al que pertenece el cliente VARCHAR 100 Sí razonSocial Nombre o razón social del cliente VARCHAR 100 Sí Ruc Identificación única del cliente VARCHAR 20 Sí Teléfono Teléfono del cliente VARCHAR 20 No codZona Código de la zona o ubicación geográfica a la que pertenece el

cliente VARCHAR 20 No

numLineasCredito Número de líneas de crédito que tiene el cliente en diferentes monedas

BYTE Sí

Si el número de líneas de crédito es mayor que 0, especificar:

Campo Descripción Tipo de Dato Tamaño Obligatorio montoLineaCredito Valor de crédito disponible que tiene el cliente en la

moneda especificada. DOUBLE Sí

codMoneda Código de la moneda de la línea de crédito VARCHAR 20 Sí .. numDirecciones Número de direcciones que tiene registradas

el cliente. Por lo menos debe estar registrada 1 dirección.

BYTE Sí

El número de direcciones debe ser mayor que 0, especificar:

Campo Descripción Tipo de Dato Tamaño Obligatorio Dir Dirección que tiene registrada el cliente VARCHAR 100 Sí

numCanal Número de canales que el cliente tiene registrados para venta de productos. Un cliente por lo menos debe tener registrado un canal.

BYTE Sí



El número de canales debe ser mayor que 0, especificar: Campo Descripción Tipo de Dato Tamaño Obligatorio codCanal Código del canal registrado VARCHAR 20 Sí codCondicionVenta Código de la condición de venta especificada para el canal VARCHAR 20 Sí

Ejemplo:

Cod. Cliente

Cod. Giro

Razón Social

Ruc Tel Cod. Zona

Núm. Líneas Crédito

Líneas Crédito # Dir

Direcciones Nun. Canal

Canales

34318038 GIR01 Claudia Acevedo

34318038 8317533 2 Monto Cod.

Moneda 100 DOL 167.5 PEN

1 Urb. La Playa

2 Cod Canal

Cod Cond. Venta

C01 30D C02 60D

34326016 GIR02 Isabel

Domínguez 34326016 ZON01 0

Monto Cod. Moneda

1 CC Anarkos Plaza Local 2C – 06 Cra 19 # 16N - 02

1 Cod Canal

Cod Cond. Venta

C01 60D

El archivo Cliente.dat debe escribirse:

Cliente.dat 34318038|GIR01|Claudia Acevedo|34318038|8317533||2|100|DOL|167.5|PEN|1|Urb. La Playa|2|C01|30D|C02|60D 34326016|GIR02|Isabel Domínguez|34326016||ZON01|0|1|CC Anarkos Plaza Local 2C-06|Cra 19 # 16N-02 |1|C01|60D



d. Archivo Ruta.dat Este archivo contiene la información relacionada a los clientes que aparecerán en las rutas de los módulos de pedidos, o encuestas de la aplicación móvil de MoviVentas2.

El contenido del archivo Ruta.dat siempre debe tener el siguiente formato:

codRuta|codUsuario|fecha|numClientes|codCliente|orden|dirVisita|habVender|diaVisita|numEnc|nomEnc1|nomEncK

Cada línea del archivo corresponde a la información de una ruta diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la ruta se deben escribir de la siguiente manera:

Archivo: Ruta Campo Descripción Tipo de Dato Tamaño Obligatorio codRuta Código de ruta VARCHAR 20 Sí codUsuario Código de usuario VARCHAR 20 Sí fecha Fecha a partir de la cual se encuentra disponible la ruta. La ruta sólo

estará disponible en el día que especifica la fecha hasta las 11:59:59 pm o hasta que exista una ruta en el mismo día que inicie en una hora posterior a la especificada en la ruta actual. La fecha debe estar escrita en el formato: “dd/mm/aaaa hh:mm”. Las horas deben estar en formato 24 horas (0 a 23)

DATETIME Sí

numClientes Número de clientes incluidos en la ruta. Si el número de clientes es 0, significa que se quiere asignar a un usuario una ruta creada previamente, la cual estará disponible a partir de la fecha especificada.

Si el número de clientes es mayor que 0, especificar: Campo Descripción Tipo de Dato Tamaño Obligatorio codCliente Código del cliente incluido en la ruta VARCHAR 20 Sí orden Orden de visita del cliente BYTE Sí dirVisita Dirección de visita del cliente VARCHAR 100 Sí



habVender Bandera que especifica si al cliente se le debe registrar pedidos. Puede tomar el valor: - 0: indica que no se requiere registro de pedido. - 1: indica que sí se requiere registro de pedido.

BIT Sí

diaVisita Día en que el cliente será visualizado en el rutero. Toma valores de 1 a 7: - 1: Día Lunes - 7: Día Domingo

Si MoviVentas2 está configurado para que trabaje teniendo en cuenta el día de visita, el cliente sólo se visualizará en el rutero correspondiente al día especificado. Si se especifica el valor 0, el cliente nunca se mostrará en el rutero. Si MoviVentas2 no está configurado para que trabaje teniendo en cuenta el día de visita, el cliente se mostrará en el rutero del día en que se descargó independientemente del valor especificado en diaVisita.

BYTE Sí

numEnc Número de encuestas que deben aplicarse al cliente BYTE Sí Si el número de encuestas es mayor que 0, especificar:

Campo Descripción Tipo de Dato Tamaño Obligatorio nomEncuesta Nombre de la encuesta que debe ser aplicada. VARCHAR 20 Sí

Ejemplo:



Cod. Ruta

Cod. Usuario

Fecha Num. Clientes

Clientes en la ruta

1 34318038 11/03/2010 08:00

3 Cod. Cliente

Orden Dirección Visita Hab. Vender

Día Visita

Num. Enc.

Nombre Encuestas

25478863 1 Carrera 6 # 6-75 Of 303

Sí 5 1 Satisfacción

4301582 2 Anselmo Solar 41 2C No 3 2 Satisfacción Sondeo de Mercado

34317085 3 Condominio Campo Verde

Sí 1 0

2 10301572 18/03/2010

10:30 2

Cod. Cliente


Día Visita

Num. Enc.

Nombre Encuestas

34529342 1 Calle 3N # 10-15 Sí 1 0 4301582 2 Anselmo Solar 41

2C No 2 1 Sondeo de

Mercado

1 34318038 23/03/2010 14:00

0 Cod. Cliente


Día Visita

Num. Enc.

Nombre Encuestas

El archivo Ruta.dat debe escribirse:

Ruta.dat 1|34318038|11/03/2010 08:00|3|25478863|1|Cra 6 # 6-75 Of. 303|1|5|1|Satisfacción|4301582|2|Anselmo Solar 41 2C|0|3|2|Satisfacción| Sondeo de Mercado|34317085|3|Condominio Campo Verde|1|1|0 2|10301572|18/03/2010 10:30|2|34529342|1|Calle 3N # 10-15|1|1|0|301582|2|Anselmo Solar 41 2C|0|2|1|Sondeo de Mercado 1|34318038|23/03/2010 14:00|0



e. Archivo DocumentosEntrega.dat Este archivo contiene información de cada uno de los documentos de entrega que especifican los productos asociados al documento que los distribuidores deben entregar a los clientes que pertenecen a una determinada ruta.

El contenido del archivo DocumetosEntrega.dat siempre debe tener el siguiente formato:

codDocEntrega|codRuta|codCliente|codMoneda|valor|tipoEntrega|codCondicionVenta|codOrden|diaEntrega|direccionEntrega| codProducto1|codUnidad1|cantidad1|precio1|codProductoN|codUnidadN|cantidadN|precioN

Cada línea del archivo corresponde a la información de un documento de entrega diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del documento de entrega se deben escribir de la siguiente manera:

Archivo: DocumentosEntrega.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codDocEntrega Código del documento de entrega VARCHAR 20 Sí codRuta Código de la ruta VARCHAR 20 Sí codCliente Código del cliente VARCHAR 20 Sí codMoneda Código de la moneda VARCHAR 20 Sí Valor Valor total a pagar DOUBLE 20 Sí tipoEntrega Tipo de entrega del documento. Puede tomar los siguientes valores:

- E: Tipo entrega generada de un pedido - C: Tipo entrega generada de un canje

CHAR 20 Sí

codCondicionVenta Código de la condición de venta VARCHAR 20 Sí codOrden Código de la orden de entrega expedida por la empresa VARCHAR 20 Sí diaEntrega Día en que el documento de entrega de un cliente es visualizado. Este

día especifica si el cliente con documento de entrega para el diaEntrega debe ser visualizado en el rutero de entregas para el diaEntrega especificado. Toma valores de 1 a 7: - 1: Día Lunes

BYTE Sí



- 7: Día Domingo Si MoviVentas2 está configurado para que trabaje teniendo en cuenta el diaEntrega, el cliente sólo se visualizará en el rutero de entregas correspondiente al día especificado. Si se especifica el valor 0, el cliente nunca se mostrará en el rutero.

Si MoviVentas2 no está configurado para que trabaje teniendo en cuenta el díaEntrega, el cliente se mostrará en el rutero del día en que se descargó independientemente del valor especificado en diaEntrega.

direccionEntrega Dirección de donde se debe realizar la entrega de los productos especificados en el documento de entrega en el diaEntrega definido.

VARCHAR 100 Sí

Por lo menos debe existir un producto en el documento. Por cada producto especificar:

Campo Descripción Tipo de Dato Tamaño Obligatorio codProducto Código del producto a entregar VARCHAR 20 Sí codUnidad Código de la unidad de medida de venta en la que se debe

entregar el producto VARCHAR 20 Sí

cantidad Cantidad del producto a entregar DOUBLE Sí precio Precio unitario de venta del producto correspondiente a la unidad

de medida de venta especificada. DOUBLE Sí

Ejemplo: Cod. Doc. Entrega

Cod. Ruta

Cod. Cliente

Cod. Moneda

Valor Tipo Entrega

Cod. Cond. Venta

Cod. Orden

Día Entrega

Dirección Entrega

Productos

MVC452 3 34326016 PEN 55897.20 E 30D 2135 2 Corin Tellado 6 1C

Cod. Prod.

Cod. Ud.

Cant. Precio

MEC01 BOL 50 800.45 BOM03 CAJ 10 1500



ST5241 5 13068931 DOL 2523.41 C 60D 8540 5 Anselmo Solar 41 Local 2C

Cod. Prod.

Cod. Ud.

Cant. Precio

MEC01 BOL 42.5 800.45

El archivo DocumentosEntrega.dat debe escribirse:

DocumentosEntrega.dat MVC452|3|34326016|PEN|55897.20|E|30D|2135|2|Corin Tellado 6 1C|MEC01|BOL|50|800.45|BOM03|CAJ|10|1500 ST5241|5|13068931|DOL|2523.41|C|60D|8540|5|Anselmo Solar 41 Local 2C|MEC01|BOL|42.5|800.45

f. Archivo DocumentosCobro.dat Este archivo contiene la información relacionada a los documentos de cobro asociados a cada cliente que serán atendidos en el proceso de cobranza de MoviVentas2.

El contenido del archivo DocumetosCobro.dat siempre debe tener el siguiente formato:

codDocCobro|codCliente|codMoneda|valor

Cada línea del archivo corresponde a la información de un documento de cobro diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del documento de cobro se deben escribir de la siguiente manera:

Archivo: DocumentosCobro.dat Campo Descripción Tipo de Dato Tamaño Obligatorio codDocCobro Código del documento de cobro VARCHAR 20 Sí codCliente Código del cliente. VARCHAR 20 Sí codMoneda Código de la moneda en la que se debe cobrar el documento VARCHAR 20 Sí Valor Valor a cobrar del documento DOUBLE Sí



Ejemplo:

Cod. Documento Cobro Código del Cliente Código de la Moneda Valor DOCOB1 10525435 PEN 13527 DOCOB2 25478863 DOL 3500.57 El archivo DocumentosCobro.dat debe escribirse:

DocumentosCobro.dat DOCOB1|10525435|PEN|13527 DOCOB2|25478863|DOL|3500.57

g. Archivo Encuesta.dat Este archivo carga en cada registro (línea) los datos necesarios para presentar una encuesta en el dispositivo móvil, incluyendo: nombre de la encuesta, descripción de la encuesta, enunciado de preguntas, definición del tipo de respuestas, las respuestas y definición de preguntas habilitadas y preguntas deshabilitadas.

La generación de este archivo es opcional, ya que las encuestas pueden ser creadas vía Web y así obviar este procedimiento para la carga de encuestas al servidor de MoviVentas2.

El contenido del archivo Encuesta.dat siempre debe tener el siguiente formato:

nomEnc|descripcion|numPreg|enunciadoPreg|tipo|numResp|enunciadoRes|numHab|ordenPregHab1|ordenPregHabN| numDeshab|ordenPregDeshab1|ordenPregDeshabN

Cada línea corresponde a los datos de una encuesta diferente. Cada dato se encuentra separado del siguiente con |.

El orden de visualización de las preguntas de la encuesta corresponde al orden en que fueron adicionadas al archivo. El orden de visualización de las respuestas de una pregunta, corresponden al orden en que fueron adicionadas al archivo.



Toda encuesta debe tener al menos una pregunta. Las preguntas tipo 3 (Pregunta de respuesta abierta) no tienen opciones de respuesta.

Los datos de la encuesta se deben escribir de la siguiente manera:

Archivo: Encuesta.dat Campo Descripción Tipo Dato Tamaño Obligatorio nomEnc Nombre de la encuesta VARCHAR 20 Sí descripcion Descripción de la encuesta VARCHAR 100 Sí numPreg Número de preguntas que tendrá la encuesta BYTE Sí Por cada pregunta de la encuesta se especifica:

Campo Descripción Tipo de Dato Tamaño Obligatorio enunciadoPreg Enunciado de la pregunta VARCHAR 100 Sí tipoPreg Tipo de pregunta. Toma los siguientes valores:

- 1: Pregunta única - 2: Pregunta múltiple - 3: Pregunta abierta

BYTE Sí

numResp Número de respuesta que tendrá la pregunta. Si la pregunta es tipo 3, este valor es 0.

BYTE Sí

Por cada respuesta de una pregunta única o múltiple se especifica:

Campo Descripción Tipo Dato Tamaño Obligatorio enunciadoResp Enunciado de la respuesta VARCHAR 100 Sí numHab Número de preguntas que esta respuesta habilita BYTE Sí

Si numHab es mayor que 0, especificar:



Campo Descripción Tipo Dato Tamaño Obligatorio ordenPregHab Orden de visualización de la pregunta que se

habilita. El orden de las preguntas inicia en 1 BYTE Sí

numDeshab Número de preguntas que esta respuesta deshabilita BYTE Sí

Si numDeshab es mayor que 0, especificar: Campo Descripción Tipo Dato Tamaño Obligatorio ordenPregDeshab Orden de visualización de la pregunta que se

deshabilita. El orden de las preguntas inicia en 1. BYTE Sí

Ejemplo:

Nombre Encuesta

Descripción Num. Preg.

Preguntas de la encuesta

Satisfacción Mide la satisfacción del cliente frente a los servicios de la cámara de comercio

3 enunciado tipo Num.

Resp Respuestas

Conoce los servicios de la CC?

1 2 enunciado numH Pregs

Hab numD Pregs

Deshab Si 0 0 No 1 2

Cómo califica el servicio de asesoría


Hab numD Pregs

Deshab Excelente 0 0



jurídica? Bueno 0 0 Regular 0 0

Cuáles servicios utiliza desde la página web


Hab numD Pregs

Deshab Consulta empresas 0 0 Actualización de datos

0 0

Consulta de eventos

0 0

Quejas y reclamos 0 0

Sondeo de Mercado

Realiza un sondeo de mercado

2 enunciado tipo Num

Resp Respuestas

Cómo describe la sensación en la boca del nuevo producto?


Hab numD Pregs

Deshab

Qué entiende con la imagen del paquete?


Hab numD Pregs

Deshab

El archivo Encuesta.dat debe escribirse:



Encuesta.dat Satisfacción|Mide la satisfacción del cliente frente a los servicios de la cámara de comercio|3|Conoce los servicios de la CC?|1|2|Si|0|0|No|0|1|2|Cómo califica el servicio de asesoría jurídica?|1|3|Excelente|0|0|Bueno|0|0|Regular|0|0 Sondeo de Mercado|Realiza un sondeo de mercado|2|Cómo describe la sensación en la boca del nuevo producto?|3|0|Qué entiende con la imagen del paquete?|3|0

7. FORMATO DE ARCHIVOS DE LA CARPETA TRABAJOS Esta carpeta reúne toda la información trabajada en campo y enviada por los usuarios de la aplicación móvil de MoviVentas2 en los procesos de pedidos, entregas, cobranzas y/o encuestas. La información es ubicada estratégicamente en unos archivos tal cual como se especifica más adelante según la labor registrada.

Estos archivos son los que contienen la información que va desde el Servidor de móviles de MoviVentas2 al sistema Empresarial, y que para tal efecto deberán ser procesados por la empresa.

a. Archivo Pedidos.dat Este archivo contiene la información de cada pedido que ha sido registrado por los vendedores desde el dispositivo móvil usando MoviVentas2 y que ha sido enviada al servidor de móviles de MoviVentas2.

El contenido del archivo Pedidos.dat siempre tendrá el siguiente formato:

idPedido|codCliente|codUsuario|codCanal|tipoPedido|codMotivo|observacion|direccion|codMoneda|codFormaPago|fechaEntrega|fechaActividad|fecha

Cada línea del archivo corresponde a la información de un pedido diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del pedido se deben escribir de la siguiente manera:



Archivo: Pedidos.dat Campo Descripción Tipo de

Dato Tamaño Obligatorio

idPedido Identificador único de la labor (pedido, no pedido, canje) en base de datos. LONG Sí codCliente Código del cliente al que se le registró el pedido. VARCHAR 100 Sí codUsuario Código del usuario que registró la labor (pedido, no pedido, canje). 20 Sí codCanal Código del canal utilizado para el registro de un pedido o un canje. VARCHAR 20 No tipoPedido Tipo de pedido registrado. El tipo de pedido puede tomar los siguientes valores:

- P: Pedido - N: No pedido - C: Canje

CHAR 1 Sí

codMotivo Código del motivo de no pedido seleccionado en el registro de un no pedido. VARCHAR 20 No observacion Observación ingresada por el usuario en el momento de registrar la labor. VARCHAR 100 No direccionEntrega Dirección de entrega especificada por el cliente para la entrega del pedido o canje. VARCHAR 100 No codMoneda Código de la moneda especificada por el cliente para el pago del pedido. VARCHAR 20 No codCondicionVenta Código de la Condición de venta especificada por el cliente para el pago del pedido. VARCHAR 20 No fechaEntrega Fecha especificada para la entrega del pedido o del canje. Tiene el siguiente

formato: “dd/mm/aaaa”. DATE No

fechaActividad Fecha y hora en la que se inicio el registro de la labor (pedido, no pedido, canje) en la aplicación móvil. Tiene el siguiente formato: “dd/mm/aaaa hh:mm:ss”. Las horas son escritas en formato 24 horas (00:00:00 a 23:59:59).

DATETIME Sí

Fecha Fecha y hora de finalización del registro de la labor (pedido, no pedido, canje). Tiene el siguiente formato: “dd/mm/aaaa hh:mm:ss”. Las horas son escritas en formato 24 horas (00:00:00 a 23:59:59).

DATETIME Sí

Para los siguientes pedidos:

Ejemplo:



Id Ped

Cod. Cliente

Cod. Usuario

Cod. Canal

Tipo Ped

Cod. Moti

Observación Dir Entrega

Cod. Moneda

Cod. Cond. Venta

Fecha Entrega

Fecha Actividad

Fecha

35 25478863 34318038 C01 P Corin Tellado 6 1C

PEN 60D 17/03/2010 05/03/2010 10:35:07

05/03/2010 10:38:52

37 10525435 34318038 N 2 El jefe salió de viaje

05/03/2010 17:12:22

05/03/2010 17:15:04

38 34015342 10301572 N 1 05/03/2010 09:05:21

05/03/2010 09:08:53

40 34326016 10301572 C02 C Anselmo Solar 41 2C

21/03/2010 05/03/2010 13:21:27

05/03/2010 13:24:49

El archivo Pedido.dat debe escribirse:

Pedido.dat 35|25478863|34318038|C01|P|||Corin Tellado 6 1C|PEN|60D|17/03/2010|05/03/2010 10:35:07|05/03/2010 10:38:52 37|10525435|34318038||N|2|El jefe salió de viaje|||||05/03/2010 17:12:22|05/03/2010 17:15:04 38|34015342|10301572||N|1||||||05/03/2010 09:05:21|05/03/2010 09:08:53 40|34326016|10301572|C02|C|||Anselmo Solar 41 2C|||21/03/2010|05/03/2010 13:21:27|05/03/2010 13:24:49

b. Archivo DetallePedido.dat Este archivo contiene la información detallada de los productos solicitados en cada pedido que ha sido registrado por los vendedores desde el dispositivo móvil usando MoviVentas2 y que ha sido enviada al servidor de móviles de MoviVentas2.

El contenido del archivo DetallePedido.dat siempre tendrá el siguiente formato:

idPedido|codProducto|cantidad|codUnidad|precio|descuento



Cada línea del archivo corresponde a la información de un detalle de pedido diferente. El detalle de pedido complementa la información de un pedido con tipo de pedido P. Cada dato se encuentra separado del siguiente con |.

Los datos del detalle de pedido se deben escribir de la siguiente manera:

Archivo: DetallePedido.dat Campo Descripción Tipo de Dato Tamaño Obligatorio idPedido Identificador único del pedido en base de datos. LONG 20 Sí codProducto Código del producto solicitado por el cliente. VARCHAR 20 Sí cantidad Cantidad solicitada del producto en la unidad de medida especificada. DOUBLE Sí codUnidad Unidad de medida de venta del producto escogida en el registro del pedido. VARCHAR 20 Sí precio Precio unitario del producto para la unidad de medida especificada. DOUBLE Sí descuento Descuento aplicado al producto en el momento de registrar el pedido. DOUBLE Sí

Ejemplo:

Id Pedido Cod. Producto Cantidad Cod. Unidad Precio Descuento 35 MEC03 5 BOL 800.42 1.5 35 BOM01 3 CAJ 1500 0.3 El archivo DetallePedido.dat debe escribirse:

DetallePedido.dat 35|MEC03|5|BOL|800.42|1.5 35|BOM01|3|CAJ|1500|0.3

c. Archivo DetalleCanje.dat Este archivo contiene la información detallada de los productos asociados a cada solicitud de canje que haya sido registrada por los vendedores desde el dispositivo móvil usando MoviVentas2 y que haya sido enviada al servidor de móviles de MoviVentas2.



El contenido del archivo DetalleCanje.dat siempre tendrá el siguiente formato:

idPedido|codProducto|cantidad|codUnidad|codMotivo|observacion|fecha|tipoCanje

Cada línea del archivo corresponde a la información de un detalle de canje diferente. El detalle de canje complementa la información de un pedido con tipo de pedido C. Cada dato se encuentra separado del siguiente con |.

Los datos del detalle de canje se deben escribir de la siguiente manera:

Archivo: DetalleCanje.dat Campo Descripción Tipo de


idPedido Identificador único del pedido en base de datos. LONG Sí codProducto Código del producto a canjear. VARCHAR 20 Sí Cantidad Cantidad canjeada del producto en la unidad de medida especificada. DOUBLE Sí codUnidad Unidad de medida de venta del producto escogida en el registro del canje. VARCHAR 20 Sí codMotivoCanje Código del motivo de canje seleccionado en el registro de un canje. Si el tipo de canje

es E (canje por entrega de productos) no se requiere ingresar motivo de canje. VARCHAR 20 No

observacion Observación ingresada por el usuario en el momento de registrar el canje de un producto.

VARCHAR 100 No

Fecha Fecha de vencimiento del producto. Tiene el siguiente formato “dd/mm/aaaa”. Esta fecha sólo se especifica si el motivo de canje seleccionado lo requiere.

DATE No

tipoCanje Tipo de canje registrado. Puede tomar los siguientes valores: - C: Indica un canje o cambio por el mismo producto. - E: Indica un canje por entrega de productos. - R: Indica un canje por recepción de productos.

CHAR 1 Sí

Ejemplo:

Id Pedido Cod. Producto Cantidad Cod. Unidad Cod. Motivo Canje Observación Fecha Tipo Canje 40 BOM03 2 BOL 1 12/02/2010 C 40 MEC01 1.5 BOL E 40 BOM01 2 CAJ 2 Producto defectuoso R



El archivo DetalleCanje.dat debe escribirse:

DetalleCanje.dat 40|BOM03|2|BOL|1||12/02/2010|C 40|MEC01|1.5|BOL||||E 40|BOM03|2|CAJ|2|Producto defectuoso||R

d. Archivo Entregas.dat Este archivo contiene la información general de la labor de entrega realizada por el distribuidor sobre un documento de entrega desde el dispositivo móvil usando MoviVentas2 y que hayan sido enviada al servidor de móviles de MoviVentas2.. Mediante este archivo podrá saber si el documento de entrega fue total o parcialmente aceptado o rechazado por el cliente.

El contenido del archivo Entregas.dat siempre tendrá el siguiente formato:

idEntrega|codCliente|codUsuario|codDoc|codTipoEntrega|codMotivoRechazo|observacion|fecha

Archivo: Entregas.dat Campo Descripción Tipo Dato Tamaño Obligatorio idEntrega Identificador único de la entrega (entrega total, entrega parcial, entrega rechazada)

registrada en base de datos. LONG Sí

codCliente Código del cliente al que se le registró la entrega (entrega total, entrega parcial, entrega rechazada).

VARCHAR 20 Sí

codUsuario Código del usuario que registró la entrega (entrega total, entrega parcial, entrega rechada).

VARCHAR 20 Sí

codDoc Código del documento de entrega. VARCHAR 20 Sí tipoEntrega Tipo de entrega registrada. El tipo de entrega puede tomar los siguientes valores:

- T: Entrega total - P: Entrega parcial - R: Entrega rechazada

CHAR 1 Sí

codMotivoRechazo Código del motivo de rechazo de la entrega. Se debe especificar para una entrega VARCHAR 20 No



tipo R. observacion Observación ingresada en el momento de registrar una entrega rechazada. VARCHAR 100 No Fecha Fecha y hora de finalización de registro de la entrega (entrega total, entrega

parcial, entrega rechazada). Tiene el siguiente formato: “dd/mm/aaaa hh:mm:ss”. Las horas deben escribirse en formato 24 horas (00:00:00 – 23:59:59).

DATETIME Sí

Ejemplo:

Id Entrega Cod. Cliente Cod. Usuario Cod. Documento Tipo Entrega Cod. Motivo Observación Fecha 125 34326016 34318038 MVC452 T 05/03/2010 09:25:46 325 13068931 10301572 ST5241 P 05/03/2010 10:41:23 452 10525435 34318038 TF2135 R 1 No es el mejor momento 05/03/2010 11:18:13 1857 25478863 10301572 UNIC123 R 2 05/03/2010 14:29:37 El archivo Entregas.dat debe escribirse:

Entregas.dat 125|34326016|34318038|MVC452|T|||05/03/2010 09:25:46 325|13068931|10301572|ST5241|P|||05/03/2010 10:41:23 452|10525435|34318038|TF2135|R|1|No es el mejor momento|05/03/2010 11:18:13 1857|25478863|10301572|UNC123|R|2||05/03/2010 14:29:37

e. Archivo DetalleEntregaParcial.dat Este archivo contiene el detalle de los productos que han sido aceptados a un documento de entrega, cuando el documento de entrega fue aceptado parcialmente.

El contenido del archivo DetalleEntregaParcial.dat siempre tendrá el siguiente formato:

idEntrega|codProducto|cantidad|codMotivoParcial|observacion

Cada línea del archivo corresponde a la información de un detalle de entrega parcial diferente. Cada dato se encuentra separado del siguiente con |.



Los datos de la entrega se escriben de la siguiente manera:

Archivo DetalleEntregaParcial.dat Campo Descripción Tipo de Dato Tamaño Obligatorio idEntrega Identificador único de la entrega parcial registrada en base de datos. LONG Sí codProducto Código del producto aceptado parcialmente. VARCHAR 20 Sí cantidad Cantidad aceptada del producto. DOUBLE Sí codMotivoParcial Código del Motivo de aceptación parcial de la entrega de un producto. VARCHAR 20 Sí observacion Observación ingresada en el momento de registrar la entrega parcial de un producto. VARCHAR 100 No

Ejemplo:

Id Entrega Cod. Producto Cantidad Cod. Motivo Parcial Observación 325 BOM03 3 1 325 MEC01 0 2 Inconformidad total del producto El archivo DetalleEntregaParcial.dat debe escribirse:

DetalleEntregaParcial.dat 325|BOM03|3|1| 325|MEC01|0|2|Inconformidad total del producto

f. Archivo Cobranzas.dat Este archivo contiene la información de cada uno de los cobros registrados a un documento de cobranza realizados por los cobradores desde el dispositivo móvil usando MoviVentas2 y que hayan sido enviados al servidor de móviles de MoviVentas2.

El contenido del archivo Cobranzas.dat siempre tendrá el siguiente formato:

idCobranza|codCliente|codUsuario|codDocumento|pago|codMoneda|codTipoPago|numero|codBanco|fechaTransaccion|fecha



Cada línea del archivo corresponde a la información de una cobranza diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de la cobranza se escriben de la siguiente manera:

Archivo: Cobranzas.dat Campo Descripción Tipo Dato Tamaño Obligatorio idCobranza Identificador único de la cobranza en base de datos. LONG Sí codCliente Código del cliente al que se le registró el cobro. VARCHAR 20 Sí codUsuario Código del usuario que registró el cobro. VARCHAR 20 Sí codDocumento Código del documento de cobro. VARCHAR 20 Sí pago Valor pagado por el cliente. DOUBLE Sí codMoneda Código de la moneda en la que se realiza el pago. VARCHAR 20 Sí codFormaPago Código de la forma de pago escogida por el cliente para realizar el pago. VARCHAR 20 Sí numero Número de transacción en que se realizó el pago. Este dato sólo se especifica si la

forma de pago seleccionada lo requiere. VARCHAR 20 No

codBanco Código del banco en el cual se realizó el pago. Este campo sólo se especifica si la forma de pago seleccionada lo requiere.

VARCHAR 20 No

fechaTransaccion Fecha en que el cliente realizó la transacción. Tiene el siguiente formato: “dd/mm/aaaa”. Este campo sólo se especifica si la forma de pago seleccionada lo requiere.

DATE No

fecha Fecha y hora de finalización del registro del cobro. Tiene el siguiente formato: “dd/mm/aaaa hh:mm:ss”. Las horas son escritas en formato 24 horas (00:00:00 a 23:59:59).

DATETIME Sí

Ejemplo:

Id Cobranza

Cod. Cliente

Cod. Usuario

Cod. Documento

Pago Cod. Moneda

Cod. Forma Pago

Número Cod. Banco

Fecha Transacción

Fecha

25 25478863 34318038 DOCOB2 750 DOL EFE 05/03/2010 08:17:43

37 10525435 34318038 DOCOB1 4275.28 PEN CHE 123456 BDAV 05/03/2010 10:29:07



42 34326016 10301572 DOCOB3 1365.87 PEN DEP 165428 BBVA 03/03/2010 14:10:47

05/03/2010 18:01:47

El archivo Cobranza.dat debe escribirse:

Cobranza.dat 25|25478863|34318038|DOCOB2|750|DOL|EFE||||05/03/2010 08:17:43 37|10525435|34318038|DOCOB1|4275.28|PEN|CHE|123456|BDAV||05/03/2010 08:17:43 42|34326016|10301572|DOCOB3|1365.87|PEN|DEP|165428|BBVA|03/03/2010 14:10:47|05/03/2010 08:17:43

g. Archivo EncuestasAplicadas.dat Este archivo contiene información general de las encuestas que han sido aplicadas a un cliente de ruta de encuestas o un nuevo cliente creado para esta labor (tercero) desde el dispositivo móvil usando MoviVentas2 y que hayan sido enviada al servidor de móviles de MoviVentas2.

El contenido del archivo EncuestasAplicadas.dat siempre tendrá el siguiente formato:

idEncuestaAplicada|codCliente|codUsuario|nomEncuesta|direccion|tercero|fecha Cada línea del archivo corresponde a la información de una encuesta aplicada diferente. Cada dato se encuentra separado del siguiente con |.

Los datos de las encuestas aplicadas se escriben de la siguiente manera:

Archivo: EncuestasAplicadas.dat Campo Descripción Tipo de


idEncuestaAplicada Identificador único de la encuesta aplicada en base de datos. LONG Sí codCliente Código del cliente que respondió la encuesta. VARCHAR 20 Sí codUsuario Código del usuario que aplicó la encuesta al cliente. VARCHAR 20 Sí nombreEncuesta Nombre de la encuesta que se aplicó. VARCHAR 20 Sí direccion Dirección del cliente en la cual se aplicó la encuesta. VARCHAR 100 Sí



tercero Bandera que especifica si el cliente que responde la encuesta fue creado por el usuario desde la aplicación móvil. Puede tomar los siguientes valores:

- 0: El cliente que respondió la encuesta NO fue creado desde la aplicación móvil.

- 1: El cliente que respondió la encuesta fue creado desde la aplicación móvil.

BIT Sí

fecha Fecha y hora de finalización de registro de la encuesta aplicada. Tiene el siguiente formato: “dd/mm/aaaa hh:mm:ss”. Las horas deben escribirse en formato 24 horas (00:00:00 – 23:59:59).

DATETIME Sí

Ejemplo:

Id Encuesta Aplicada Cod. Cliente Cod. Usuario Nombre Encuesta Dirección Tercero Fecha 120 25478863 34318038 Satisfacción Cra 19 # 16N 02 No 08/03/2010 09:25:12 152 10525435 10301572 Sondeo Mercado Cll 27N 7A-34 Local 103 Sí 08/03/2010 15:28:37 El archivo EncuestaAplicada.dat debe escribirse:

EncuestaAplicada.dat 120|25478863|34318038|Satisfacción|Cra 19 # 16N 02|0|08/03/2010 09:25:12 152|10525435|10301572|Sondeo Mercado|Cll 27N 7A – 34 Local 103|1|08/03/2010 15:28:37

h. Archivo DetallePreguntaAbierta.dat Este archivo contiene todas las respuestas a las encuestas que fueron categorizadas como de campo abierto.

El contenido del archivo DetallePreguntaAbierta.dat siempre tendrá el siguiente formato:

idEncuestaAplicada|ordenPregunta|respuesta

Cada línea del archivo corresponde a la información de un detalle de pregunta abierta diferente. El detalle de pregunta abierta complementa la información de una encuesta aplicada con preguntas de tipo 3 (pregunta abierta). Cada dato se encuentra separado del siguiente con |.



Los datos del detalle de pregunta abierta se deben escribir de la siguiente manera:

Archivo: DetallePreguntaAbierta.dat Campo Descripción Tipo de


idEncuestaAplicada Identificador único de la encuesta aplicada en base de datos LONG Sí ordenPregunta Orden de la pregunta que fue respondida BYTE Sí respuesta Respuesta abierta dada por el cliente a la pregunta de orden ordenPregunta

especificada VARCHAR 100 Sí

Ejemplo:

Id Encuesta Aplicada Orden Pregunta Respuesta 152 1 Suave, esponjoso, delicioso 152 2 Divertido, atractivo, elegante El archivo DetallePreguntaAbierta.dat debe escribirse:

DetallePreguntaAbierta.dat 152|1|Suave, esponjoso, delicioso 152|2|Divertido, atractivo, elegante

i. Archivo DetallePreguntaSeleccion.dat Este archivo contiene todas las respuestas a las preguntas de las encuestas que fueron categorizadas como de única o múltiple respuesta.

El contenido del archivo DetallePreguntaSeleccion.dat siempre tendrá el siguiente formato:

idEncuestaAplicada|ordenPreguta|ordenResp1|ordenRespN



Cada línea del archivo corresponde a la información de las respuestas de selección escogidas en una pregunta. Cada línea representa las respuestas de una pregunta diferente. El detalle de pregunta de selección complementa la información de una encuesta aplicada con preguntas de tipo 1 (pregunta de única respuesta) o 2 (pregunta de múltiple respuesta). Cada dato se encuentra separado del siguiente con |.

Los datos del detalle de pregunta de selección se deben escribir de la siguiente manera:

Archivo: DetallePreguntaSeleccion.dat Campo Descripción Tipo Dato Tamaño Obligatorio idEncuestaAplicada Identificador único de la encuesta aplicada en base de datos LONG Sí ordenPregunta Orden de la pregunta que fue respondida BYTE Sí

Por cada respuesta seleccionada especificar:

Campo Descripción Tipo Dato Tamaño Obligatorio ordenRespuesta Orden de la respuesta que fue seleccionada para la

pregunta de orden ordenPregunta especificada. BYTE Sí

Ejemplo:

Id Encuesta Aplicada Orden Pregunta Respuesta 120 1

Orden Respuesta 1

120 3

Orden Respuesta 1 3 4

El archivo DetallePreguntaSeleccion.dat debe escribirse:



DetallePreguntaSeleccion.dat 120|1|1 120|3|1|3

j. Archivo Tercero.dat Este archivo contiene información de todos los clientes creados fuera de ruta para la aplicación de encuestas.

El contenido del archivo Tercero.dat siempre tendrá el siguiente formato:

idTercero|razonSocial|ruc|telefono|direccion|codCanal|fecha

Cada línea en el archivo corresponde a la información de un cliente creado (que no exista en la base de datos) diferente. Cada dato se encuentra separado del siguiente con |.

Los datos del tercero se deben escribir de la siguiente manera:

Archivo: Tercer.dat Campo Descripción Tipo de


idTercero Identificador único del cliente creado en base de datos. VARCHAR 20 Sí razonSocial Nombre o razón social del cliente creado. VARCHAR 100 Sí ruc Ruc del cliente creado. VARCHAR 20 Sí telefono Teléfono del cliente creado VARCHAR 20 No direccion Dirección del cliente creado. VARCHAR 100 Sí codCanal Código del canal asociado al cliente creado. VARCHAR 20 Sí fecha Fecha y hora de creación del cliente en la aplicación móvil. Tiene el siguiente formato:

“dd/mm/aaaa hh:mm:ss”. Las horas deben escribirse en formato 24 horas (00:00:00 – 23:59:59).

DATETIME Sí



Ejemplo:

Id Tercero Razón Social Ruc Teléfono Dirección Código Canal Fecha 125 Florentina Sáenz Martínez 23154875 975497389 Anselmo Solar 41 Portal 7 2C C01 08/03/2010 09:37:41 452 María Isabel Caicedo Castro 12235547 Begoña 15 Jovellanos3 C02 08/03/2010 17:37:26 El archivo Tercero.dat debe escribirse:

Tercero.dat 125|Florentina Sáenz Martínez|23154875|975497389|Anselmo Solar 41 Portal 7 2C|C01|08/03/2010 09:37:41 452|María Isabel Caicedo Castro|12235547||Begoña 15 Jovellanos 3|C02|08/03/2010 17:37:26

8. FORMATO DE ARCHIVOS DE LA CARPETA PROCESADOS Esta carpeta contiene la información que ha sido procesada por la empresa y que debe ser notificada al Servidor para futuras consultas desde la aplicación móvil de MoviVentas2.

a. Archivo EstadoPedidos.dat Este archivo contiene el estado de un pedido después que la empresa lo ha procesado.

El contenido del archivo EstadoPedidos.dat siempre tendrá el siguiente formato:

idPedido|estado Cada línea del archivo corresponde a la información del estado de un pedido diferente. Cada dato se encuentra separado del siguiente con |.

Los datos se deben escribir de la siguiente manera:



Archivo: EstadoPedidos.dat Campo Descripción Tipo de Dato Tamaño Obligatorio idPedido Identificador único de la labor (pedido, no pedido, canje) en base de datos LONG Sí estado Estado de la labor después de ser procesada por la empresa VARCHAR 100 Sí

Ejemplo:

Id Pedido Estado 35 Pedido en bodega. 37 Procesado. 40 Revisión de artículos para aceptación de canje. El archivo EstadoPedidos.dat debe escribirse:

EstadoPedidos.dat 35|Pedido en bodega 37|Procesado 40|Revisión de artículos para aceptación de canje

9. ARCHIVO LOG DEL SERVIDOR PARA LECTURA Y ESCRITURA DE ARCHIVOS En algunas ocasiones es necesario verificar las acciones que se están generando en el servidor de móviles, por esta razón, el servidor lleva un registro de las acciones que se realizan y de los errores ocurridos. Si llega a ocurrir un error en el proceso de lectura o escritura de los archivos, se debe revisar el archivo de log para obtener un mayor detalle de lo que generó el error.



El nombre del archivo log del servidor es MoviVentas2BatchProcess.log. Para acceder a él diríjase a la carpeta de instalación del Tomcat e ingrese a la siguiente ruta:

c:|Archivos de programa|Apache Software Foundation|Tomcat 6.0.18\logs

Una vez allí, abra el archivo MoviVentas2BatchProcess.log. (¡Error! No se encuentra el origen de la referencia.)

Figura 2. Ruta de Acceso al Log del Servidor de Móviles para Procesamiento de Archivos

Ruta de la Carpeta de Instalación del Tomcat Ruta de verificación



En el log de errores se encuentran dos tipos de mensajes.

INFO: corresponde a mensajes informativos de algunos procesos que lleva el servidor de móviles. Este tipo de mensajes sirve para llevar un seguimiento del proceso de lectura y escritura de los archivos.

ERROR: corresponde a mensajes de error en el proceso de lectura de archivos. Los mensajes de error indican la fecha de ocurrencia, un mensaje de error y el trace desde donde se originó el error. Cuando ocurre un error en el proceso de lectura, este error se muestra en el log y adicionalmente el Servidor de Móviles marca el archivo como CORRUPTO.

En la ¡Error! No se encuentra el origen de la referencia. se muestra un ejemplo de un log:

Figura 3. Ejemplo del Log del Servidor de Móviles para Procesamiento de Archivos

Date post:	29-Mar-2016
Category:	Documents
Upload:	manuel-zevallos
View:	228 times
Download:	8 times

Manual de Moviventas

Documents