Integración de datos accediendo a los servicios web de Demander
Propósito Describir las implementaciones necesarias para la integración directa (sin utilizar el Sincronizador Demander) entre el ERP y Demander.
Campos de control en ERP Para implementar la integración directa entre ERP y Demander es necesario crear dos campos de control, uno para registrar el token de la empresa en Demander (campo varchar con tamaño 200) y otro para registrar la última fecha/hora de búsqueda de datos en Demander (campo datetime)
Separador de campo El diseño de integración predeterminado de Demander es un archivo de texto en el que el separador de campos es |
Es importante considerar al generar datos, en los campos de texto, que existe la posibilidad de que el usuario haya utilizado un | al registrar cualquier información en el ERP, este | debe eliminarse al exportar datos para evitar causar problemas de integración.
Codificación de datos Demander trabaja con la codificación UTF8.
En la rutina de generación de datos para enviar a Demander es necesario observar la generación de archivos en UTF8, eventualmente algunos lenguajes de programación o incluso sistemas operativos funcionan por defecto con otros codificadores, por lo que sugerimos forzar la generación de datos a ser en UTF8 para asegurar que la integración no se vea afectada.
En la práctica, no utilizar la codificación UTF8 en los datos a enviar a Demander sólo provocará que los datos importados por Demander se importen con caracteres especiales y no con las letras adecuadas, por ejemplo: ç, ã, é, … que no se mostrarán y en su lugar se mostrarán caracteres especiales.
En la rutina de importación de datos al ERP, de la misma manera que al exportar datos, se sugiere que al abrir el archivo para leer la información se obligue a utilizar la codificación UTF8, asegurando que los datos se importen adecuadamente al ERP.
Creando empresas en Demander Si es necesario crear una empresa en la web de Demander para que se le genere un token, esta generación se puede realizar de dos formas, manualmente o vía integración.
Registro manual Esta documentación aún se está detallando y el enlace a ella se agregará en el futuro, mientras esto no suceda, siga las instrucciones a continuación.
En la web de Demander para registrar una empresa, utilice el siguiente enlace, si es necesario para completar los datos (solo el socio tiene acceso a esta pantalla, si es el ERP de una empresa que se está integrando, solicite el token para la empresa o para Demander: sistema.demander.com.br/dinamico/empresas
Luego de que la empresa se haya registrado será necesario generar el token (pestaña de integración) mediante el siguiente enlace, esta operación se realiza en dos pantallas ya que a la primera solo tiene acceso el socio o Demandante y la empresa también tiene acceso a la segunda, ya que esta es la pantalla de configuración del Demandante: sistema.demander.com.br/dinamico/configuracoes-da-empresa
Integración vía webservice Para la integración a través del servicio web, consulte la documentación a continuación: https://atendimento.demander.com.br/kb/article/140100/api-do-parceiro
Enviando datos desde ERP a Demander Solicitud de envío de datos El siguiente enlace describe cómo solicitar información de ENVÍO en Demander: https://atendimento.demander.com.br/kb/article/185185/api-demander-enviar-dados-para-o-demander?ticketId=&q=
Diseños a integrar Los diseños a integrar dependen de las funcionalidades que utilizará la empresa, debajo del enlace a todas las tablas de integración posibles de Demander, tenga en cuenta que hay tablas que Demander solo importa, otras que Demander solo exporta y otras que son importadas y exportadas por Demander. https://atendimento.demander.com.br/kb/pt-br/article/131110/layout-de-integracao
Generación de archivos mediante tablas Cada archivo a generar y enviar a Demander debe contener en la primera línea la versión en la que se basó la generación. Al iniciar la integración, pregunte al equipo de implementación qué código debería ser.
Al generar el archivo con los datos sugerimos que los archivos se generen por separado, ya que si el volumen de datos de la empresa es muy grande puede ocurrir un tiempo de espera al enviar datos, por lo que con archivos más pequeños esta posibilidad se vuelve mucho menor.Algunas tablas deben estar en el mismo archivo de datos, a continuación se muestra una lista de tablas, las que no se mencionan pueden estar en archivos diferentes. Cuadrícula de 16 pedidos + 17 artículos de pedido + 26 artículos de pedido 41-Tipo de cliente fiscal + 42-Fiscalidad 31-Niveles de comisión + 32-Comisión 51-Equipo comercial + 52-Comerciales del equipo comercial + 53-Responsables del equipo comercial 60-Metas de perspectiva + 61-Niveles objetivo + 62-Valores objetivo 09-Tabla de precios + 13-precios + 15-productos Clientes de 20 Rutas + 21 Rutas 19-Valores financieros 57-Stock listo para la entrega Gama 180-Flex según lista de precios
Exportar registros En el siguiente enlace podemos ver el listado de archivos que el ERP envió a Demander en los últimos 3 meses, que es el tiempo que mantenemos registros: sistema.demander.com.br/dinamico/arquivos-recedos-do-erp
Búsqueda de datos de demanda para solicitud de búsqueda de datos de ERP El siguiente enlace describe cómo realizar una solicitud de BÚSQUEDA de información en Demander: https://atendimento.demander.com.br/kb/article/185186/api-demander-receber-dados-do-demander?ticketId=&q=
Fecha de control de la última búsqueda En el archivo descargado, la primera línea contiene información importante, a continuación se muestra un ejemplo de la primera línea que tendrán todos los archivos que Demander pondrá a disposición: DADOS_SINCRONIZACIÓN|71408323|30/03/2021 13:07:42|30/03/2021 13:09:21|
donde: DADOS_SINCRONIZACAO -> primer campo, es un texto fijo 71408323 -> segundo campo, es el ID del log de integración en Demander, el archivo de texto puesto a disposición tiene el mismo nombre 30/03/2021 13:07:42 -> tercer campo, es la fecha/hora en que se envió (y que se guarda en el ERP como se describe en ‘Campos de control en el ERP’) en la solicitud de búsqueda de información en Demander. 30/03/2021 13:09:21 -> cuarto campo, es la fecha/hora en que la solicitud de búsqueda llegó a Demander, por lo que el archivo en cuestión tiene datos que fueron incluidos o cambiados entre la fecha/hora del campo 3 y el campo 4. Este contenido debe guardarse en el campo creado (como se describe en ‘Campos de control en ERP’), ya que esta fecha/hora debe enviarse en la siguiente solicitud de búsqueda de datos en Demander.
Importar registros En el siguiente enlace podemos ver la lista de archivos que el ERP sacó de Demander en los últimos 3 meses, que es el tiempo que mantenemos el registro: sistema.demander.com.br/dinamico/arquivos-recedos-do-erp
Registros devueltos en solicitudes de búsqueda y envío La devolución de las solicitudes de envío y recuperación es texto. Dependiendo del error, en el caso de enviar datos, es necesario enviar el archivo.
Posibles devoluciones: Retorno que comienza con ‘ERROR 01: No se encontró ninguna empresa con el token’ -> No hay ninguna empresa en Demander con este token
Retorno que comienza con ‘ERROR 02:’ -> Compañía inactiva en Demander (es necesario reenviar el archivo)
Retorno que comienza con ‘ERROR 03:’ -> El archivo de parámetros no está en la solicitud (es necesario reenviar el archivo)
Regrese comenzando con ‘ERROR 04:’ -> Problema al cargar el archivo (es necesario reenviar el archivo)
Retorno que comienza con ‘ERROR 05:’ -> Empresa incumplidora en Demander (es necesario reenviar el archivo)
Regrese comenzando con ‘ERROR 08:’ -> Compañía fuera del tiempo de prueba de Demander (es necesario reenviar el archivo)
Regrese comenzando con ‘ERROR: La primera línea del archivo debe ser la versión del diseño de integración’. -> Cada archivo a enviar a Demander debe contener la versión en la que se basó la generación de datos (es necesario reenviar el archivo)
Regresar comenzando con ‘ERROR en línea’ -> Hay un error en algún registro del archivo, por ejemplo: un cliente vino sin nombre comercial. Este error debe tratarse caso por caso, lo ideal es iniciar sesión e indicarle a alguien que mire este registro, o simplemente indicarle que mire los registros de vez en cuando a través de la web de Demander.
Volver que comienza con ‘La empresa no está configurada para importar pedidos, si es necesario, comuníquese con el soporte de Demander’. -> como la devolución de pedidos a Demander (provenientes del ERP) requiere aprobación, esta opción sólo se libera cuando se le solicita a Retta, incluso para monitorear esta integración. (activar configuración y reenviar el archivo)Retorno que comienza con ‘ERROR=La empresa no está configurada para calcular IPI y/o ICMS ST. La configuración no fue importada.’ -> Al enviar datos de tributación (tabla 41 y 42), solo los importaremos si la empresa está configurada para calcular impuestos. (activar configuración y reenviar el archivo)
Regrese comenzando con ‘El demandante omitió la importación de este archivo’. -> Cuando importamos datos de un archivo generamos un hash del contenido del archivo, y si este archivo ya ha sido importado en las últimas 6 horas se ignora, el objetivo de esto es mejorar el tiempo de respuesta de la solución, no procesando datos que ya han sido procesados anteriormente. Si la empresa envía solo cambios de datos, comuníquese con Demander Deployment para obtener orientación.
Regresar comenzando con ’ Tiempo de carga s3: ’ -> indica que el archivo se cargó exitosamente Retorno que comienza con ’Tiempo: ’ -> indica el tiempo que tomó procesar el archivo Regrese comenzando con ‘Archivo procesado’. -> significa que el archivo ha sido procesado Regresar comenzando con ‘SUCCESS=’ -> Significa que el proceso se completó exitosamente
En la práctica, la preocupación debería centrarse en los registros en los que el archivo en su totalidad no se procesó (excepto ignorando los archivos) y, en este caso, el archivo debería reenviarse por segunda vez.
Lo ideal es que el archivo esté en una carpeta y al iniciar el proceso, si un archivo está en la carpeta, primero se debe enviar y luego solo se enviará un nuevo archivo de datos.
También sugerimos que si ocurre un error, se notifique a alguien por correo electrónico del error, para que haya una evaluación proactiva.