GUIA DE INSTALACIÓN Conector CONTPAQi CRM
Contenido GUIA DE INSTALACIÓN... 1 Contenido... 2 Descripción General... 3 Creación de la cuenta CRM... 4 Instalación del conector... 5 Parámetros del conector... 7 Comandos SQL... 8 Soluciones a errores comunes... 9 Historial de versiones... 10
Descripción General El conector es un archivo ejecutable que permite sincronizar datos entre una base de datos de CONTPAQi Comercial y una cuenta de CONTPAQi que se encuentre activa. El conector podrá realizar las siguientes acciones: Enviar líneas de Comercial a CONTPAQi CRM por SalesUp! Enviar marcas de Comercial a CONTPAQi CRM por SalesUp! Enviar las listas de precios de Comercial a CONTPAQi CRM por SalesUp! Enviar productos de Comercial a CONTPAQi CRM por SalesUp! con sus precios e impuestos respectivos. Sincronizar clientes entre Comercial y Empresas en CONTPAQi CRM por SalesUp! Enviar ventas de SalesUp! a Comercial como pedidos. Consideraciones de uso Al utilizar el conector, tenga en cuenta lo siguiente: La única versión de SalesUp! que soporta la integración entre ambos sistemas es CONTPAQi CRM por SalesUp! CONTPAQi CRM cuenta con algunos campos especiales que son necesarios para realizar la integración, como el número de cliente y el RFC, mismos que se configurarán previamente. La versión de CONTPAQi Comercial debe ser 2 o superior.
Creación de la cuenta CRM El primer paso es tener una cuenta activa en CRM. No es necesario tener una licencia pagada para poder probar esta funcionalidad. Para crear dicha cuenta, visite la página de CONTPAQi CRM y proporcione los datos requeridos o solicite una cuenta demo en SalesUp! Una vez que dentro de la cuenta es necesario ingresar al menú Sistema->Integración CONTPAQi -> Comercial. Active el TOKEN y la pantalla se verá como se muestra a la izquierda.
Instalación del conector Para realizar la configuración del conector es necesario lo siguiente: Tener acceso a la máquina en donde se encuentra la base de datos (No es necesario que el conector esté instalado en la misma máquina que la base de datos, pero debe tener acceso a ella a través de TCP/IP). La máquina donde se encuentre instalado el conector debe contar con acceso a internet y tener libres los puertos 80 y 443. Para realizar el proceso de configuración siga los siguientes pasos: 1. Active la conexión en su cuenta de CONTPAQi CRM de SalesUp! y obtenga su TOKEN (Menú Sistema->Integración CONTPAQi-> Comercial 2016). 2. Descomprima el archivo ZIP del conector en el directorio de su preferencia. 3. Abra el archivo config.txt y agregue el valor del parámetro token. Especifique también el usuario y contraseña de la base de datos. A continuación se muestra un ejemplo del archivo config.txt correctamente configurado: Token=68CA89E0-6FA5-44B7-9AC5-3217D433790F GetDriverFunc=getSQLDriverSQLServer LibraryName=dbexpsda.dll VendorLib=oledb.dll HostName=Diego- VPC\Compac Database=adDemo User_Name=sa Password=compac BlobSize=- 1 SQLServer TransIsolation=ReadCommited LongStrings=true 4. Haga una copia del archivo config.txt solo por precaución, ya que esté se eliminará una vez realizada la primer conexión exitosa.
5. Ejecute una prueba de conexión ejecutando la sentencia que se muestra a continuación. Si el resultado de conexión es exitoso el archivo de configuración se cifrará y se renombrará a config.dat. C:/> ConectorSalesUp.exe /pruebabd Si la conexión se realiza correctamente, el resultado será el siguiente: 11/19/2015 11:54:21 AM Conexión exitosa a la BD [AdSalesUp] 6. Ejecute el programa sin ningún comando para hacer la primer sincronización (conectorssalesup.com). Deberá observar un resultado similar a esto: 11/19/2015 7:49:44 PM Actualizando registros en: AGENTES 11/19/2015 7:49:45 PM Enviados 562 bytes. 11/19/2015 7:49:45 PM Actualizando registros en: CLIENTES 11/19/2015 7:49:45 PM Enviados 3114 bytes. 11/19/2015 7:49:45 PM Actualizando registros en: LISTAS DE PRECIO 11/19/2015 7:49:46 PM Enviados 810 bytes. 11/19/2015 7:49:46 PM Actualizando registros en: LINEAS 11/19/2015 7:49:47 PM Enviados 306 bytes. 11/19/2015 7:49:47 PM Actualizando registros en: MARCAS 11/19/2015 7:49:47 PM Enviados 394 bytes. 11/19/2015 7:49:47 PM Actualizando registros en: IMPUESTOS 11/19/2015 7:49:48 PM Enviados 262 bytes. 11/19/2015 7:49:48 PM Actualizando registros en: PRODUCTOS 11/19/2015 7:49:49 PM Enviados 3334 bytes. 11/19/2015 7:49:49 PM Actualizando registros en: EXISTENCIAS 11/19/2015 7:49:49 PM Enviados 275 bytes. 11/19/2015 7:49:50 PM Total de clientes descargados: 0. 11/19/2015 7:49:51 PM Total de pedidos descargados: 0 11/19/2015 7:49:52 PM Actualizacion finalizada: 2015-11- 19 19:49:23.030 Consideraciones: De preferencia, utilice un usuario con privilegios limitados a la base de datos para proteger el acceso a la misma. Revise que la configuración de lenguaje del servidor sea Español México o Inglés Estados Unidos, ya que una configuración distinta podría generar problemas con los formatos de moneda, fecha y hora.
Parámetros del conector El archivo ejecutable acepta los siguientes parámetros: /version /pruebabd /test /regenera /t:agentes /t:lineas /t:marcas /t:impuestos /t:productos /t:precios /t:clientes Muestra la versión del conector. Realiza una prueba de conexión a la base de datos. Tomará los datos de conexión del archivo config.dat o config.txt, en ese orden de precedencia. El archivo con extensión dat es similar al txt, sólo que se encuentra cifrado para proteger los parámetros de conexión. Regenera el archivo config.txt para cambiar la configuración de acceso a la base de datos. Nota: Al ejecutar esta opción el conector eliminará el archivo config.dat. Actualiza exclusivamente la tabla de agentes en su totalidad. Actualiza exclusivamente la tabla de líneas en su totalidad. Actualiza exclusivamente la tabla de marcas en su totalidad. Actualiza exclusivamente la tabla de impuestos en su totalidad. Actualiza exclusivamente la tabla de productos en su totalidad. Actualiza exclusivamente la tabla de listas de precios en su totalidad. Actualiza exclusivamente la tabla de clientes en su totalidad.
Comandos SQL El conector esta diseñado de tal forma que permite que se editen las sentencias SQL que se utilizan para enviar datos a CRM o insertar la información en COMERCIAL que se descarga del CRM. Esto nos permite: Cambiar la forma en la que se calcula u obtiene la información antes de enviarla a CRM Pre-procesar la información antes de insertarla en comercial. Para realizar este cambio, es necesario editar el archivo CONTPAQi-COMERCIAL.SQL y modificar las sentencias acorde a lo deseado. A continuación la tabla de sentencias SQL: NO SENTENCIA DESCRIPCION 1 LISTA TOTAL DE AGENTES Genera la lista de comercial para enviar a CRM * 2 LISTA TOTAL DE CLIENTES Genera la lista total de clientes para enviar a CRM 3 LISTA TOTAL DE PRODUCTOS Genera la lista total de productos para enviar a CRM 4 ACTUALIZA AGENTES Genera la lista cualquier agente que haya sido modificado para enviar a CRM * 5 ACTUALIZA CLIENTES Genera la lista de clientes modificados para enviar a CRM. 6 ACTUALIZA PRODUCTOS Genera la lista de productos para enviarlos a CRM 7 INSERTA CLIENTES Inserta un cliente en COMERCIAL cuyo origen de creación haya sido CRM. 8 ACTUALIZA CLIENTES Actualiza un cliente en COMERCIAL que haya sido modificado en CRM. 9 CLASIFICACIONES Obtiene las clasificaciones de COMERCIAL para enviarlos a las líneas o marcas en CRM según corresponda. 10 CHECKSUM CLASIFICACIONES Detección de cambios en tablas que no tienen en COMERCIAL que no tienen CTIMESTAMP para obtener clasificaciones 11 CHECKSUM PARAMETROS Detección de cambios en tablas que no tienen en COMERCIAL que no tienen CTIMESTAMP para obtener parámetros adicionales. 12 LISTAS DE PRECIO Obtiene los nombres y monedas de las listas de precios que maneja COMERCIAL para agregarlos en CRM. 13 INSERTA PEDIDO CABECERA Esta sentencia inserta un pedido que se genera en CRM y que debe crearse en COMERCIAL. Solo modifica la tabla admdocumentos. 14 INSERTA PEDIDO DETALLE Esta sentencia inserta el detalle del pedido, modificando la tabla admmovimientos 15 ACTUALIZA EXISTENCIAS Esta sentencia obtiene las existencias de COMERCIAL para enviarlas a CRM 16 LISTA DE IMPUESTOS Esta sentencia obtiene la lista de impuestos de COMERCIAL para agregarlos como parte de la configuración inicial de CRM
Soluciones a errores comunes Tarda en conectar y después da un error Esto sucede debido a que la conexión a la base de datos está equivocada. Puede copiar la configuración de COMERCIAL, o bien, abrir su SQL Management Studio y copiar en el parámetro HOST lo que aparece en el NOMBRE DEL SERVIDOR, como se muestra en la siguiente imagen: Nota: Es indispensable crear un usuario de SQL Server para acceder a la base de datos, ya que el acceso a través del sistema operativo no está soportado. Error loading midas.dll Algunas versiones de Windows requieren que la DLL esté dada de alta en el registro. Dentro del directorio en donde se encuentra el conector, ejecute la siguiente sentencia: C:\<directorio>\regsvr32 midas.dll Esto insertará la información necesaria en el registro. Posteriormente, proceder normalmente.
Historial de versiones Versión 0.9.14 Se corrigió un error cuando se intentaba crear un cliente con un código existente en comercial. Se agregó mensaje de error descriptivo cuando el Token es incorrecto o ha sido regenerado. Versión 0.9.13 Modificación del query en productos con existencia en 0. (Se generaba una división entre cero). Corrección de la sincronización manual de marcas (traía líneas en lugar de marcas). Detección y alerta cuando la base de datos no es de Comercial. Versión 0.9.12 Se ha incluido activación o de-activación de tablas desde la aplicación de CRM. Ahora el conector solo sincronizará las tablas activas en la configuración (Menú Sistema->Integración CONTPAQi -> Comercial) Se corrigió un caso en el que se sincronizaban registros que no era necesario sincronizar. Versión 0.9.11 Protección de comillas simples en todos los campos de texto. Cuando el código del cliente está repetido o es nulo, crea un código nuevo tipo ERRXXXXX donde las X son letras aleatorias. Versión 0.9.10 Modificación en fechas para actualización. Para la detección correcta de registros que cambiaron deben ser estrictamente mayores a la fecha y no mayor o igual. Versión 0.9.9 Se agrega la actualización de existencias. Se cambia el query para obtener correctamente el costo y existencia, basado en la tabla admexistenciacosto Se agrega la descarga de impuestos para la primera actualización. Se modifica el formato de fechas de sincronización (SQL Server 121). Versión 0.9.8 Se agrega la base de datos en el parámetro /pruebadb, para facilitar identificar a que base se conecta una vez que ya se encuentra configurado.
Versión 0.9.7 Liberación para pruebas finas con distintos entornos y configuraciones de comercial.