Linha Microsiga Protheus - Espanhol

Atalhos

Árvore de páginas


ÍNDICE

  1. Visión general
  2. Implantación
  3. Wizard de configuración
  4. Schedule
  5. Log da integración
  6. Otras configuraciones
    1. Entes contables
    2. Monedas
    3. Campos personalizados - FlexFields

01. VISIÓN GENERAL

Este documento presenta los pasos necesarios para activar la integración de datos del Protheus con el Gesplan, por medio de la plataforma Carol.

Al adquirir la oferta, internamente se iniciará el flujo de aprovisionamiento.

Se finalizó el flujo de aprovisionamiento, el cliente recibe por e-mail las credenciales del RAC (client_id e client_secret) necesarias para ejecutar el Wizard de configuración en el Protheus.

Será necesaria la actualización del entorno siguiendo el orden descrito en los siguientes tópicos.


02. IMPLANTACIÓN

Para iniciar la implementación de la integración, será necesario:

1) Verificar los requisitos mínimos:

Todos los artefactos (DbAccess, APPServer y Lib ) deben estar actualizados con la última versión disponible en el portal.

Release Protheus a partir de la 12.1.10


2) Aplicar la última expedición continua del Protheus, junto con el diferencial de diccionario por medio del UPDDISTR, de acuerdo con su versión de la Release.

 

3) Activar parámetros en el configurador:

MV_FINTGES - Informar el contenido true = .T. 

MV_PRJOVER - Informar el contenido true = .T. 

Solamente active el parámetro MV_FINTGES en la implantación de la integración. El uso del parámetro activado sin la ejecución del Wizard de configuración, podrá causar fallas en los procesos del sistema.


4) Verificar el contenido del parámetro MV_FINFIX. Para que la integración esté preparada y apta para su ejecución, el contenido debe tener como mínimo 25. 

IMPORTANTE: Si el contenido del parámetro mencionado anteriormente fuera inferior a 25, este NO debe modificarse manualmente. En este caso, se recomienda abrir un ticket en Atención, adjuntando los archivos error.log y console.log para análisis.

 

5) Para visualizar mejor los motivos por los cuales no se hicieron efectivos los asientos contables, utilice el parámetro MV_CT105MS con contenido igual a "S" .

 

6) Ejecutar el wizard de acuerdo con los pasos listados en el próximo tópico.

 

7) Tener liberación del servidor donde el schedule del Protheus se ejecuta para los siguientes end-points:

https://endpoint-registry.totvs.app/api/v1/services
https://admin.rac.totvs.app/totvs.rac/connect/token
https://provisioning.totvs.app/api/carol-definitions/v1/entities
https://ingestion-smartlink.totvs.app
https://app.carol.ai
https://provisioning.totvs.app/api/carol-definitions/v1/carolcredentials
https://link.totvs.app
https://api-smartlink.totvs.app


03. WIZARD DE CONFIGURACIÓN

    Para iniciar el Wizard de configuración, el usuario debe informar el programa inicial: WIZARDTF1

    Haga clic en avanzar

    Informe un usuario con poder de administrador y marque las empresas que se configurarán. Haga clic en Avanzar.

    Seleccione el producto Gesplan

    Confirme el usuario y contraseña para ejecución del UPDDISTR. 

    Se crearán los campos EV_MSUID y EZ_MSUID del tipo uniqueidentifier.

    Informe las credenciales del RAC recibidas por e-mail

    En este último paso se crearán los campos de control de modificación (S_T_A_M_P_) en todas las tablas de integración.


    04. SCHEDULE

    Después de la ejecución del Wizard, el job FWTECHFINJOB de integración con Carol se registrará automáticamente en el Protheus.

    Si la integración tuviera envío de datos de Gesplan al Protheus, esto ocurrirá por medio de la configuración del job FWTOTVSLINKJOB, que debe incluirse manualmente en el schedule. Crear con los mismos detalles del FwTechFinJob creado automáticamente.

    Será necesario finalizar las configuraciones del schedule de ambos jobs e iniciar el servicio.

    Recurrencia de ejecución

    Para que no haya delay en el envío de los datos a Carol, la Recurrencia del job podrá registrarse como 'Siempre activo'; sin embargo, no hay un regla cuanto al registro de recurrencia de la ejecución, la decisión cuando a esto depende de la necesidad de disponibilidad de estos datos, a partir del momento de la generación de estos. 
    Cuanto mayor la recurrencia y empresas/sucursales listadas para ejecución, mayor la necesidad de recursos para procesamiento de los jobs.

    Incluir la configuración únicamente en el entorno que esté en producción.

    Bases de pruebas que estén configuradas con el Smartlink interceptarán mensajes enviadas por la Gesplan de la misma forma que la base de producción, haciendo que los datos se graben en la base de pruebas actualizando el estatus de la Gesplan como integrado. 

    Integración Gesplan - Movimiento bancario enviado del Gesplan al Protheus

    Schedule - Como agendar a execução de rotinas

    05. LOG DE LA INTEGRACIÓN

    Con el schedule en ejecución, el job FWTECHFINJOB envía los registros a las staging tables de Carol. Cualquier modificación realizada en cualquier registro en el ERP automáticamente actualiza el timestamp, en el campo S_T_A_M_P_, de esta manera, el job reenvía el registro completo para actualizar la staging table.

    Es posible activar los logs del job, para evaluar lo que se está ejecutando y enviando, para ello, basta seguir los procedimientos descritos en el siguiente enlace.

    https://tdn.totvs.com/display/public/framework/TechFin+Debug

    Se recomienda activar el log únicamente cuando sea necesaria alguna evaluación, porque mantener el log conectado podrá afectar el desempeño, además de crear muchos archivos en el rootpath del entorno.


    06. OTRAS CONFIGURACIONES

    a) Entes contables 

    Se utilizarán los entes indicados en el registro de la Modalidad del título por Pagar/Cobrar, en los siguientes campos:

    • ED_DEBITO - Cuenta contable para cartera Pagar
    • ED_CREDITO - Cuenta contable para cartera Cobrar
    • ED_CCD - Centro de costo para cartera Pagar
    • ED_CCC - Centro de costo para cartera Cobrar

    Acceder al Configurador / Base de datos y marcar campos como Utilizado:

    b) Monedas

    La descripción de la moneda del título y de los movimientos tiene como origen el contenido del SX6, registro de Parámetros del configurador. 

    ¿Utilizará el contenido del parámetro MV_MOEDA?

    Donde "?" (interrogación) representa el código de la moneda.

    Ejemplo:

    Título de la moneda 1 = contenido informado en el parámetro MV_MOEDA1

    Título de la moneda 5 = contenido informado en el parámetro MV_MOEDA5


    c) Campos personalizados - Flex Fields

    Documentación sobre campos personalizados:  Integración Gesplan - Datos enviados y Pipelines 


    d) Parámetros opcionales

    Después de configurar como True, define que los títulos del Protheus que estén en situación de cartera descontada tendrán los valores previstos con el saldo en cero en el entorno Gesplan y se considerarán como realizados.

    Si se configura como False, el valor previsto de los títulos se mantendrá con el saldo restante de este en el Protheus, campo Saldo del título (E1_SALDO).

    Cuando el parámetro no esté configurado, el estándar será False.

     

    En el entorno Carol, el parámetro se accede por medio de la rutina 'Settings'

    El parámetro puede modificarse por medio de la opción en la columna Value, alternando el valor entre True y False, y para grabar, basta hacer clic en 'Save'.

    Referencias