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.