Índice de contenidos

• Introducción
• Sistema de colas de Dispongo
• Seguimiento y control de los datos enviados
• Gestión de errores
• Recepción de errores por email
• Parámetros de configuración y mapeos
• Informes de control
• Preguntas frecuentes

Introducción

La integración de exportación de datos de Dispongo a TANGO se basa en el envió de datos de facturas de venta y cobros de cliente en formato JSON a la API de Tango.

Sistema de colas de Dispongo

La integración a TANGO se estructura en sistemas de colas de exportaciones de Dispongo. Las tareas de exportación son automáticas y se ejecutan como trabajos de servidor diariamente.

Estas tareas sigue el siguiente flujo para enviar la información:

1. Encolado: Los datos son preparados para enviar, se comprueba que información está pendiente de enviar y se añade a la cola de envíos.

2. Envío de datos: Se prepara toda la información pendiente y se genera un fichero txt. Este fichero se envía al repositorio de destino en el servidor FTP.

3. Re-intento de errores: en este tercer paso se desmarcan los errores que pueda tener la cola de exportación para tratar de enviar de nuevo los datos pendientes.

Seguimiento y control de los datos enviados

Es necesario realizar un seguimiento periódico del estado de las exportaciones para conocer si hay algún problema o sí existe algún datos pendiente de enviar que se ha quedado con error por cualquier problema.

El cuadro de mando del sistema de exportaciones nos permite hacer este seguimiento de los datos que estamos enviando y nos permite conocer de un solo vistazo si existe algún problema en los envíos a Business Central.

Para acceder al cuadro de mando del sistema de exportación iremos al menú: Integraciones >> Exportaciones>> Cuadro de Mando

Gestión de errores

El proceso a seguir cuando encontremos un error en la cola de exportación es el siguiente:

1. Comprobar el mensaje de error para conocer el origen del problema
2. Validar si el fichero se ha enviado al repositorio de destino y regenerar el contenido si se han realizado cambios por ejemplo en los mapeos.
3. Cambiar el número de re-intentos a 0 y desmarcar el error para que vuelva a re-enviarse

Recepción de errores por email

Es posible configurar el envío de errores a una dirección de email, de esta forma cuando se produce un error en los envíos del sistema de exportación nos llegará un correo a la cuenta que hayamos configurado con los detalles del error.

Configuraremos esta opción en el formulario del sistema de exportación dentro de la solapa de "Errores por email" tal como se muestra en la siguiente imagen.

Parámetros de configuración y mapeos

La configuración de mapeos es un paso muy importante en el proceso de integraciones externas en cualquier sistema pues nos permite poder relacionar datos entre diferentes plataformas. Por ejemplo, para poder indicar a TANGO la cuenta contable del banco realizado mediante un cobro consolidados  corresponde a la cuenta 572721 esta previamente la tendremos que informar en su maestro dentro de Dispongo.

De la misma forma en el momento que creamos nuevos datos en TANGO y Dispongo (por ejemplo añadir un nuevo proveedor) es necesario añadir los datos de mapeo necesarios para que estos puedan pasar a TANGO y no se produzcan errores.

La API de Tango requiere multitud de campos obligatorios que no tienen correspondencia en DISPONGO por lo que será necesario realizar la configuración de todos los parámetros que se indican a continuación

Parámetros de configuración generales

En el formulario de configuración del sistema de exportación de TANGO encontraremos los parámetros de configuración general como son:

• TNG_RETRIES: Número de re-intentos que realizará el sistema de exportación ante un error. Pasado este número de re-intentos se deja como error en la cola para que lo revise el operador.
• TNG_CREAR_CONTACTOS_SINO_EXISTE: Realiza el alta del cliente si este no existe en el entorno de destino de TANGO

Mapeos de empresa y conexión a API de Tango

Dentro del formulario de Empresa (menú Aplicación >> Implantación >> Empresas >> Empresas) encontramos los parámetros de configuración y conexión al entorno de Tango entre los que podemos destacar:

Parámetros de conexión al entorno:

• URL_SW_TANGO: Url/EndPoint de conexión a la API de TANGO
• APIKEY_TANGO: Cadena//Key de conexión al entorno
• COMPANY_CODE_TANGO: número o código de empresa 

Para el resto de parámetros encontraremos en la descripción a que dato corresponden en TANGO.

Mapeos de bancos/cuentas bancarías

Encontraremos el formulario maestro de bancos/cuentas bancarías en el menú Administración >> Bancos

En este formulario configuraremos la cuenta contable para cobros por tarjetas y efectivo para cada una de las empresas.

Mapeo de formas de cobro (condiciones de venta)

Encontraremos el formulario maestro de formas de cobro/pago en el menú Aplicación >> Implantación >> Formas de Cobro/Pago >> Formas de Cobro/Pago.

Configuraremos aquí la condición de venta para cada una de las empresas.

Clientes

Se hará el alta del cliente en el entorno de TANGO si así está configurado en los parámetros de configuración del sistema de exportación (parámetro TNG_CREAR_CONTACTOS_SINO_EXISTE).

La forma de relacionar el cliente en Tango es a través de su código, donde existen dos niveles de configuración:

• Parámetros: se puede establecer el código de cliente y personalizarlo para cada empresa en los parámetros de cliente.
• En el caso que no establezcamos parámetros de cliente para el código, el valor que se envía a Tango es: código de empresa + código de cliente (por ejemplo en la ficha de cliente siguiente si no tuviese parámetros configurados se enviaría el código "CCDBM")

Proveedores

Los parámetros del proveedor que podemos configurar son:

1. CODIGO_DEPOSITO: código de deposito
2. CODIGO_VENDEDOR: código de vendedor/proveedor en TANGO

Estos valores si están configurados prevalecen sobre los parámetros generales del formulario de empresa.

Provincias

Encontraremos el formulario maestro de provincias en el menú: Aplicación >> Configuración >> Poblaciones >> Provincias

En la colección de parámetros podemos configurar el código e identificador de provincia que corresponde en Tango. 

Estos valores si están configurados prevalecen sobre los parámetros de empresa

Informes de control

Encontraremos en la sección de informes del panel de control el listado "Exportaciones >> Errores envios TANGO" donde podemos realizar una consulta de las facturas del sistema y comprobar si estas se han enviado o no o si existe algún problema.

Preguntas frecuentes

• ¿Cómo activar o desactivar la exportación para una empresa?

Buscaremos en los parámetros de empresa el parámetro "EXPORTACION_TANGO_ACTIVA"

donde podemos especificar dos valores: Activo/Desactivado

• ¿Cómo determinar la fecha de la primera factura a enviar a Tango?

Buscaremos en los parámetros de empresa el parámetro "FECHA_INICIO_EXPORTACION_FACTURAS"

Donde podemos determinar la primera fecha a partir de la que se realizará el envío de facturas a Tango