Guía para integración de sucursales.

Tabla de contenido

GUÍA PARA INTEGRACIÓN DE SUCURSALES. ...................................................................................................................................... 1

INTRODUCCIÓN .......................................................................................................................................................................................... 3

DESCRIPCIÓN DEL MODO DE OPERACIÓN ......................................................................................................................................................... 4

Esquema General .............................................................................................................................................................................. 4 Sucursales .......................................................................................................................................................................................................... 4 Franquicias ......................................................................................................................................................................................................... 4

Diagrama de red ............................................................................................................................................................................... 5 Sucursales y Franquicias ..................................................................................................................................................................................... 5

Procesos de negocio por nodo/ubicación .......................................................................................................................................... 5

REQUERIMIENTOS Y CONSIDERACIONES PREVIAS............................................................................................................................................... 5

Software ............................................................................................................................................................................................ 5

Hardware .......................................................................................................................................................................................... 6

Red .................................................................................................................................................................................................... 6

Consideraciones................................................................................................................................................................................. 6

PROCESO DE IMPLEMENTACIÓN ..................................................................................................................................................................... 6

Pasos ................................................................................................................................................................................................. 6 1.- Base de datos Central ................................................................................................................................................................................... 6

1.1.- Creación de la Base de Datos Central. ................................................................................................................................................... 6 1.2.- Creación o Importación de catálogos. ................................................................................................................................................... 7 1.3.- Configuración de Catálogos................................................................................................................................................................... 7

2.- Base de Datos Local. ..................................................................................................................................................................................... 7 2.1.- Replicar Entidades Globales. ................................................................................................................................................................. 7

a.- mc_rmt_cfg.exe ................................................................................................................................................................................... 7 b.- Revisar Catálogos Base Local ............................................................................................................................................................. 10

2.2.- Configurar Integración Programada .................................................................................................................................................... 10 Información de conexión ........................................................................................................................................................................ 11 mc_rpl_cat.exe ....................................................................................................................................................................................... 11 mc_snd_tran.exe .................................................................................................................................................................................... 11 mc_sinc_inv.exe ..................................................................................................................................................................................... 11 mc_sinc_cxc.exe ..................................................................................................................................................................................... 11 Consideraciones ..................................................................................................................................................................................... 11 Proceso ................................................................................................................................................................................................... 11

2.3.- Revisar Catálogos. ............................................................................................................................................................................... 11 TAREAS IMPORTANTES RELACIONADAS .......................................................................................................................................................... 12

Replicación Exclusiva ....................................................................................................................................................................... 12 Línea de Comando ........................................................................................................................................................................................... 12

mc_rpl_cat.exe ............................................................................................................................................................................................ 12 Argumentos ............................................................................................................................................................................................ 12

mc_proc_vnt.exe ......................................................................................................................................................................................... 12 Argumentos ............................................................................................................................................................................................ 12

rp_Fiedls.exe ............................................................................................................................................................................................... 13 Argumentos ............................................................................................................................................................................................ 13

Depuración .................................................................................................................................................................................................. 13 Argumento -i .......................................................................................................................................................................................... 13

Herramienta IIBD ......................................................................................................................................................................................... 13

Introducción Seguramente se presentará la necesidad (o al menos inquietud) de “enlazar” distintos establecimientos (sucursales) o bien acceder a través de Internet al sistema de información basado en MaxiComercio.

Generalmente el usuario final propone “tener controlados todos sus establecimientos desde una oficina central” o bien, desea tener la posibilidad de “monitorear” las operaciones desde su equipo portátil independientemente de su ubicación geográfica.

Si la implantación de MaxiComercio incluye su despliegue en múltiples establecimientos y la interconexión o centralización de los datos, es importante que se utilice una estrategia de conversión de sistemas gradual en donde se contempla como primer objetivo la puesta en operación de un local y luego los demás.

Por favor procure asegurarse que la implantación en un establecimiento es satisfactoria antes de replicarla en los demás e intentar intercomunicarlos, de lo contrario replicará sus problemas y será difícil determinar la causa de los mismos.

Descripción del modo de operación Para la planificación del despliegue de MaxiComercio más allá de los límites de la red de área local es importante comprender la estructura organizacional.

Esquema General

Sucursales

Matriz

Sucursal C

Sucursal A

Sucursal B

Sucursal D

Franquicias

Franquicia Modelo

Franquicia 2

Franquicia 3

Franquicia 1

Franquicia 4

Diagrama de red

Sucursales y Franquicias

Internet

TCP/IP

TCP/IP

TCP/IP

TCP/IP

TCP/IP

TCP/IP

TCP/IP

TCP/IP

TCP/IP

Servidor Central de Base de Datos

Usuarios Remotos Directos

Establecimiento 1 Establecimiento 2 Establecimiento N

Procesos de negocio por nodo/ubicación Consulte el Módulo 4: Gestión de ubicaciones remotas y alcance del SDK en el siguiente enlace.

En la sección Implementaciones comunes.

Requerimientos y Consideraciones Previas Es importante que tome en cuenta cada una de las consideraciones abajo listadas, dimensionando el alcance que pudiera tener pasar por alto una de ellas.

Software mysql-connector-odbc-3.51.27-win32. Controlador basado en estándares para ODBC que permite la

conectividad necesaria para que Maxicomercio pueda establecer comunicación con la base de datos. Necesario para cada equipo.

mysql-essential-5.0.83-win32. Gestor de Base de Datos necesario para los equipos destinados a servidores. Necesario solo para los equipos servidores.

mysql-gui-tools-5.0-r17-win32. Herramienta necesaria para la administración de las bases de datos que se pretenda controlar. (Opcional)

Maxicomercio. Sistema punto de venta y administración comercial. Necesario para cada equipo punto de venta o Administrativo.

Kit de replicación de Mysql. La replicación e integración de datos es un proceso parcialmente bidireccional entre dos bases de datos. (mc_rpl_cat.exe, mc_snd_tran.exe, mc_sinc_inv.exe, mc_sinc_cxc.exe). Necesario solo en los equipos servidores locales.

Hardware Para punto de venta. PC compatible con procesador Pentium o similar, 128 MB de RAM, Resolución de video

mínima de 800x600px, Sistema operativo Microsoft Windows XP, Windows Vista o Windows Server 2000/2003/2008.

Para Servidor. PC Compatible con procesador Pentium o similar, 2 GB de RAM, Resolución de video mínima de 800x600px, Sistema operativo Microsoft Windows XP, Windows Vista o Windows Server 2000/2003/2008.

Red Es importante tener presente que la arquitectura de red estará en función a las posibilidades económicas que cada empresa tenga y destine para tener enlaces estables y seguros.

Local. Su extensión está limitada físicamente a un edificio o a un entorno de 200 metros, con repetidores podría llegar a la distancia de un campo de 1 kilómetro. Su aplicación más extendida es la interconexión de computadoras personales y estaciones de trabajo en oficinas, fábricas, etc.

WAN. Capaz de cubrir distancias desde unos 100 hasta unos 1000 km, proveyendo de servicio a un país o un continente. Un ejemplo de este tipo de redes sería Internet o cualquier red en la cual no estén en un mismo edificio todos sus miembros.

VPN. Es una tecnología de red que permite una extensión de la red local sobre una red pública o no controlada, con esta se tiene la posibilidad de conectar dos o más sucursales de una empresa utilizando como vínculo Internet, permitir a los miembros del equipo de una empresa la conexión desde su casa al centro de cómputo, o que un usuario pueda acceder a su equipo doméstico desde un sitio remoto, como por ejemplo un hotel. Todo ello utilizando la infraestructura de Internet.

Consideraciones Objetivo. Es importante que se fije un objetivo en relación a lo que espera de la replicación e integración de la

información, el éxito o fracaso depende en gran medida de tener claros y bien definidos estos objetivos.

Alcance. Visualice el escenario de su empresa en el corto, mediano y largo plazo de tal forma que contemple el

crecimiento de esta.

Tiempo. Aunque la configuración del kit de replicación es un proceso relativamente corto cubrir los

requerimientos para el buen funcionamiento requiere de una planificación de cada una de las tareas

involucradas principalmente los catálogos, inventario y facturación electrónica.

Proceso de Implementación Ponga mucha atención a la hora de ejecutar cada uno de los pasos que a continuación se describen, siga detenidamente cada una de las indicaciones y solamente bajo su responsabilidad omita la que considere necesaria.

Pasos

1.- Base de datos Central

En esta base de datos estará concentrada e integrada la información de cada una de las sucursales que intervengan en el

proceso de replicación e integración de información.

1.1.- Creación de la Base de Datos Central.

Usando la herramienta “configurar o conectar a servidor” incluida en el paquete de instalación de maxicomercio puede

crear sus bases de datos. Siga la Guía Creación Base de Datos.

1.2.- Creación o Importación de catálogos.

Para la creación de catálogos desde maxicomercio use el manual de usuario de maxicomercio backoffice en este

encontrará información necesaria para cumplir con dicho objetivo. En caso de que pretenda importar los catálogos se

sugiere lea la información contenida en el siguiente enlace Bajar.

Desde aquí puede bajar las plantillas necesarias para cumplir con dicho objetivo.

Para conocer las consideraciones a tener presente se recomienda siga la Guía Creación o Importación de Catálogos.

1.3.- Configuración de Catálogos.

Los catálogos de Clientes, Proveedores, cajas, cajeros, almacén, centros de consumo, series de documentos tienen que

contemplar en cada uno de ellos el total de elementos involucrados.

Si voy a controlar N sucursales debo tener presente que creare todos los clientes, proveedores, cajas, cajeros, almacén,

centros de consumo y series de documentos que se usaran en cada una de las N terminales.

Consulte la Guía Configuración de Catálogos en el apartado Base Central para asegurarse que tiene sus catálogos bien

definidos.

2.- Base de Datos Local.

Contiene la base de datos correspondiente a la sucursal en la que haya instalado. Las terminales punto de venta

instalada en cada sucursal deberán configurarse para que apunten al servidor local. Consulte la Guía Creación de Base

de Datos para crear su base de datos y repositorio local.

2.1.- Replicar Entidades Globales.

La replicación en las bases de datos locales requiere el uso de la herramienta mc_rmt_cfg.exe que permite hacer una

copia de las entidades globales exclusivas para cada base de datos local.

Necesitará el kit de replicación mismo que podrá descargar desde el área de descarga de maxicomercio.net.

a.- mc_rmt_cfg.exe

Ejecute esta aplicación en el equipo que realizará la integración y marque únicamente las entidades que desea asignar a

esta base de datos local.

1.1.- Ejecute la aplicación mc_rmt_cfg.

1.1.1.- Si es la primera vez que ejecuta la herramienta vera uno de estos mensajes. Presione aceptar y vera la interfaz de

la herramienta vacía y será necesario configurar las conexiones.

1.1.2.- Si es la primera vez que ejecuta la herramienta, haga clic en los botones Configurar correspondientes para la base

de datos central y local respectivamente. Verá una dialogo como este. Pulse la pestaña conexión >> Seleccione de la lista

la conexión de la base correspondiente >> presione el botón Probar conexión.

1.1.3.- Sin es la primera vez que ejecuta la herramienta, vera el resultado de la prueba de conexión en un mensaje como

este, asegúrese que el mensaje es una prueba satisfactoria antes de continuar con los pasos siguientes.

1.1.4. Después de hacer la configuración correspondiente podrá verificar en la ubicación desde donde ejecuto la

herramienta mc_rmt_cfg el archivo source.oledbstr correspondiente a la base de datos central y target.oledbstr

correspondiente a la base de datos local.

1.2.- Marcar Casillas

Marque las casillas correspondientes para la sucursal que se encuentre configurando.

1.2.1.- Vea las siguientes imágenes para darse una idea de cómo debe hacerlo. Solo debe marcar las casillas que

corresponderán a la base de datos local de la sucursal que este configurando.

Consideraciones

a).- El rubro serie de documentos tiene esta forma [AAA] cDocumento, AAA es la serie configurada en la base de datos

central correspondiente a cada sucursal. cDocumento es el tipo de documento.

b).- En el rubro cajeros elija los que corresponden a la sucursal que este configurando.

c).- En el rubro vendedores elija los que correspondan a la sucursal que este configurando. Solo en caso de que no use

vendedores y por tal motivo no haya configurado el catálogo correspondiente en la base de datos central este se

mostrará vacío.

d).- En el rubro repartidores elija los que correspondan a la sucursal que este configurando. Solo en caso de que no use

repartidores y por tal motivo no haya configurado el catálogo correspondiente en la base de datos central este se

mostrará vacío.

1.3.- Ejecutar

Presione el botón Aceptar para hacer la replicación global desde la base de datos central hacia la base de datos local

correspondiente a la sucursal que este configurando.

b.- Revisar Catálogos Base Local

Es importante que después de haber configurado el replicador con la herramienta mc_rmt_cfg revise detenidamente las

entidades globales, como se muestra en la Guía Configuración de Catálogo.

2.2.- Configurar Integración Programada

Los programas mc_rpl_cat.exe, mc_snd_tran.exe, mc_sinc_inv.exe y mc_sinc_cxc.exe respectivamente pueden en su

momento ejecutarse asíncronamente y dependiendo de varios factores puede elegir la periodicidad que mejor le

funcione.

Para programar la ejecución de los programas use las facilidades del sistema operativo Windows, Programador de

Tareas.

Los catálogos compartidos de las bases de datos deben contener las mismas entidades para que los procesos de

integración y sincronización funcionen adecuadamente.

Los siguientes programas se ejecutan en segundo plano por lo que de manera predeterminada no muestra ninguna

interfaz y pudiera dar la sensación de que no se está ejecutando nada sin embargo el proceso estará en operación hasta

que termine las operaciones que le corresponden.

Información de conexión

Los programas de replicación e integración obtienen la información de conexión OLE DB de los archivos source.oledbstr

para la base de datos central y target.oledbstr para la base de datos local. Estos archivos deben encontrarse en la misma

carpeta que el programa.

mc_rpl_cat.exe

Replica las entidades globales compartidas desde la base de datos central hacia la base de datos local.

mc_snd_tran.exe

Envía las ventas, ordenes de producción y nuevos clientes desde la base de datos local hacia la base de datos central.

mc_sinc_inv.exe

Sincroniza los movimientos de inventario entre la base de datos local y la central dando como resultado que las

existencias y saldos para los almacenes asignados a la base de datos local coinciden.

mc_sinc_cxc.exe

Sincroniza los movimientos a cuentas por cobrar entre las dos bases de datos dejando saldos iguales en la base de datos

local y central.

Consideraciones

Si realiza muchos cambios de precios o a los catálogos compartidos en la base de datos central a lo largo del día puede

que programar la replicación (mc_rpl_cat.exe) cada 30 minutos sea adecuado para su caso.

Por el contrario, si son pocos los cambios puede que sea suficiente con la ejecución una vez al día.

En lo que respecta al envío de transacciones (ventas) y sincronización de inventarios es recomendable que el proceso se

realice con una periodicidad continua de entre 20 y 60 minutos, de lo contrario (en intervalos más largos) habría

posiblemente demasiadas operaciones por enviar y ralentizaría el proceso.

Proceso

Una tarea programada se ejecuta de manera predeterminada dentro del contexto de seguridad del usuario que

programó la tarea y únicamente se ejecuta si ese usuario tiene una sesión iniciada cuando se desencadene la tarea.

El siguiente proceso se describe tomando como referencia el programador de tareas de su sistema operativo Windows,

por lo tanto es posible que los pasos descritos aquí no sean precisos si su sistema operativo es diferente a Windows

seven pues se usó este en los pasos descritos a continuación.

Use la Guía Programación de Tareas del Replicador para configurar la replicación programada.

2.3.- Revisar Catálogos.

Consulte la Guía Configuración de Catálogo en el apartado Base Local para asegurarse que tiene los catálogos bien

definidos.

Tareas importantes relacionadas Algunas tablas de la base de datos central no pueden replicarse “en caliente” porque requieren acceso exclusivo como la definición de ensambles, recetas o componente variables.

Replicación Exclusiva

Para que los cambios realizados en la base de datos central se repliquen debe ejecutar el programa mc_rpl_cat.exe con el argumento –exclusive al menos una vez al día. Como se muestra en este ejemplo: mc_rpl_cat.exe –exclusive

Línea de Comando

mc_rpl_cat.exe

Realiza la replicación de algunos catálogos de una base de datos a otra, los catálogos replicados son: Divisas, Zonas, Categorías, Configuraciones de impuestos, Departamentos, líneas y marcas, Productos (servicios, artículos, ensambles y recetas), Grupos de productos, Promociones, Países, estados y ciudades, Clientes y tipos de clientes, Grupos de clientes.

Argumentos

mc_rpl_cat.exe [-Exclusive] [-Exclude:Clientes] [-Exclude:Productos] [-Exclude:Promociones] [-Exclude:Otros]

Dónde:

-Exclusive. Obliga la replicación de objetos que requieren acceso exclusivo como la especificación de componentes de ensambles, listas de precios por cliente y recetas.

-Exclude:Clientes. Excluye la replicación del catálogo de clientes y sus tablas relacionadas

-Exclude:Productos. Excluye la replicación del catálogo de productos y sus tablas relacionadas

-Exclude:Promociones. Excluye la replicación del catálogo de promociones

-Exclude:Otros. Excluye la replicación del catálogo de divisas, zonas y categorías

La replicación implica sobre-escritura de registros en la base de datos destino.

El campo identidad para los registros es Sys_GUID.

mc_proc_vnt.exe

Ejecuta los movimientos de almacén de las ventas que los han dejado pendientes. La salida se realiza del almacén

asociado al centro de consumo al que pertenece la venta. Esta utilidad no puede procesar salidas de productos que

requieran números de serie o control de lotes. Deja un archivo de log en la misma ubicación de la aplicación con el

nombre [GUID].log

Argumentos

mc_proc_vnt.exe [Source] [-p] [-d] [-k] [-s] [-i:valor] [-f:valor]

Dónde:

Source. Es el nombre y ubicación de un archivo de texto que contiene la cadena de conexión OLE DB a la base de datos.

Si se omite, la aplicación buscará el archivo source.oledbstr en su misma carpeta.

-p. Indica que antes de intentar realizar las salidas de almacén ejecute las ordenes de producción asociadas a la venta.

-d. Establece que el rango de valores indicados por –i: y –f: corresponde a fechas

-k. Establece que el rango de valores indicados por –i: y –f: corresponde a claves primarias

-s. Indica que si existen órdenes de producción se ejecuten, pero no se realicen las salidas por ventas.

-i. Establece la fecha o clave primaria inicial para las ventas a procesar, si se omite se iniciará desde la prime venta que

se encuentre sin procesar.

-f. Establece la fecha o clave primaria final para el rango de ventas a procesar, si se omite se continuará procesando

desde el inicio hasta el final.

rp_Fiedls.exe

Esta herramienta tiene como propósito replicar datos de campos específicos de una tabla desde una base de datos

origen a una base de datos destino. Es útil para enviar información de campos nuevos que no forman parte de la

estructura principal de la base de datos del sistema.

Argumentos

rp_Fiedls.exe [-s] [-g] -t -f

Dónde:

-s: Ubicación del archivo de cadena de conexión de la base de datos origen. Si se omite busca source.oledbstr en la

ubicación del programa.

-g: Ubicación del archivo de conexión de la base de datos destino. Si se omite busca target.oledbstr en la ubicación del

programa.

-t: Nombre de tabla.

-f: Lista de campos separados por coma (,).

Ejemplo:

rp_fields.exe –s C:\cn1.txt –g C:\cn2.txt –t Producto –f codigo,precio,visible,uf_micampo

Depuración

En caso ocurrir algún problema y desea obtener más detalles de las tareas que realizan las herramientas mc_rpl_cat.exe,

mc_snd_trans.exe, mc_sinc_inv.exe y mc_sinc_cxc.exe, entonces ejecute estos programas incluyendo el argumento de

línea de comandos -i.

Argumento -i

mc_snd_trans.exe -i

mc_rpl_cat.exe -i

mc_sinc_inv.exe -i

mc_sinc_cxc.exe -i

El argumento –i debe ser el primero en la lista de argumentos de línea de comandos.

Al ejecutar las herramientas con esta opción le permitirá ver en pantalla los procesos que se están realizando al enviar o

recibir información entre base de datos.

Herramienta IIBD

Esta herramienta le permite comparar información de dos bases de datos para ayudarle a encontrar la causa de

inconsistencias en la información. Al igual que las herramientas de replicación de datos esta aplicación requiere una

conexión al servidor de base de datos central (source.oledbstr) y una a la base de datos local (target.oledbstr).

Esta aplicación tiene dos procesos principales:

1. Búsqueda de registros que existen solo en una base de datos (local o central), lo cual podría causar errores al

momento de actualizar la segunda base de datos.

Tabla: Escriba el nombre de la tabla a comparar.

Datos para mostrar: Escriba el nombre los campos que desea ver en pantalla para los registros encontrados.

Buscar primero en base de datos central: Marque la casilla para comparar los registros que están en la base de datos

local y buscar si existen en la base de datos central. Si desmarca la casilla la búsqueda se hará primero en el servidor

central y luego se comparará la base de datos local.

Presione el botón “No existen en la base de datos” para comenzar la búsqueda.

2. Búsqueda de registros que existen en ambas base de datos con el mismo código pero tiene un identificador

(Sys_GUID) diferente, lo cual indica que fueron duplicados.

Tabla: Escriba el nombre de la tabla a comparar.

Datos para mostrar: Escriba el nombre los campos que desea ver en pantalla para los registros encontrados.

Buscar primero en base de datos central: Marque la casilla para comparar los registros que están en la base de datos

local y buscar si existen en la base de datos central. Si desmarca la casilla la búsqueda se hará primero en el servidor

central y luego se comparará la base de datos local.

Presione el botón “Duplicados” para comenzar la búsqueda.