Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


...

ÍNDICE

  1. Visão GeralVisión general
  2. ImplantaçãoImplantación
  3. Wizard de Configuraçãoconfiguración
  4. Schedule
  5. Log da integraçãointegración
  6. Otras configuraciones
    1. Entes contables
    2. Monedas
    3. Campos personalizados
    Demais Configurações
    1. Entidades Contábeis
    2. Moedas
    3. Campos customizados - 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

...

Esse documento apresenta os passos necessários para ativação da integração Protheus x Gesplan, através da plataforma Carol.

Ao Al adquirir a la oferta internamente será iniciado o fluxo de provisionamento., internamente se iniciará el flujo de aprovisionamiento.

Se finalizó el flujo de aprovisionamiento, el cliente recibe Finalizado o fluxo de provisionamento, o cliente recebe por e-mail as credenciais do las credenciales del RAC (client_id e client_secret) necessárias necesarias para executar o ejecutar el Wizard de configuração no configuración en el Protheus.

Image Removed

Image Added

Será necesaria la actualización del entorno siguiendo el orden descrito en los siguientes tópicosSerá necessária a atualização do ambiente seguindo a ordem descrita nos tópicos abaixo.


02.

...

IMPLANTACIÓN

Para iniciar a implementação da integração será necessáriola implementación de la integración, será necesario:

1) Verificar os los requisitos mínimos:DbAccess a partir da versão 21.1.1.4

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

Release Protheus a partir da de la 12.1.33
Lib a partir da versão 2023022710


2) Aplicar
a la última expedição expedición continua do del Protheus, juntamente com o diferencial de dicionário através do UPDDISTR, de acordo com a sua versão da Release.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 3) Ativar parâmetros no configurador:

MV_FINTGES - Informar conteúdo el contenido true = .T. 

MV_PRJOVER - Informar conteúdo el contenido true = .T. 

Aviso

Somente ative o parâmetro Solamente active el parámetro MV_FINTGES na implantação da integração. O uso do parâmetro ativado sem a execução do Wizard de configuração, poderá causar falhar nos processos do sistema.

4) Executar o wizard de acordo com os passos listados no próximo tópico.

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

...

Deck of Cards
historyfalse
idteste
Card
labelPasso Paso 1

Para iniciar o el Wizard de configuração, o usuário deverá informar o configuración, el usuario debe informar el programa inicial: WIZARDTF1

Card
labelPasso Paso 2

Haga clic en avanzar

Image Added

Clicar em Avançar

Image Removed

Card
labelPasso Paso 3

Informar um usuário com Informe un usuario con poder de administrador e marcar as y marque las empresas que serão configuradas. Clicar em Avançarse configurarán. Haga clic en Avanzar.

Card
labelPasso Paso 4

Selecionar o produto Seleccione el producto Gesplan

Image RemovedImage Added

Card
labelPasso Paso 5

Confirmar usuário e senha para execução do Confirme el usuario y contraseña para ejecución del UPDDISTR. 

Serão criados os Se crearán los campos EV_MSUID e y EZ_MSUID do del tipo uniqueidentifier.

Image RemovedImage Added

Card
labelPasso Paso 6

Informar credenciais do RAC recebidos Informe las credenciales del RAC recibidas por e-mail

Card
labelPasso Paso 7

Nesse último passo serão criados os En este último paso se crearán los campos de controle control de alteração modificación (S_T_A_M_P_) em en todas as tabelas las tablas de integraçãointegración.


...

04. SCHEDULE

Após execução do Después de la ejecución del Wizard, o el job FWTECHFINJOB de integração com a Carol será cadastrado automaticamente no Protheus.

Se a integração possuir envio de dados por parte da Gesplan, o mesmo ocorrerá através do job FWTOTVSLINKJOB, que deverá ser incluído manualmente no schedule.

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 servicioSerá necessário finalizar as configurações do schedule de ambos os jobs e iniciar o serviço.

Informações
titleRecorrência Recurrencia de execuçãoejecución

Para que não haja delay no envio dos dados para a Carol  a Recorrência do job poderá ser cadastrada como 'Sempre ativo'; entretanto, não há uma regra quanto ao cadastro da recorrência da execução, a decisão quanto a isso depende da necessidade de disponibilidade desses dados, a partir do momento de geração deles. 
Quanto maior a recorrência e empresas/filiais listadas para execução, maior a necessidade de recursos para processamento dos jobs.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.

Aviso

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

Aviso

Inserir a configuração somente no ambiente que estiver em produção.

Bases de testes que estejam configuradas com o Smartlink interceptaram mensagens enviadas pela Gesplan da mesma forma que a base de produção, fazendo com que os dados sejam gravados na base de testes atualizando o status para a Gesplan como integrado. 

Integração Integración Gesplan - Movimento BancárioMovimiento 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

...

Com o schedule em execução, o job FWTECHFINJOB passa a enviar os registros para as staging tables da Carol. Toda alteração efetuada em qualquer registro no ERP automaticamente atualiza o timestamp, no campo S_T_A_M_P_, dessa forma o job reenvia o de esta manera, el job reenvía el registro completo para atualizar a actualizar la staging table.

É possível ativar os logs do Es posible activar los logs del job, para avaliação do que esta sendo executado e enviado, para isso basta seguir os procedimentos descritos no link abaixoevaluar 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

Aviso

É recomendado ativar o log somente quando for necessária alguma avaliação, pois manter o log ligado poderá onerar a performance, além de criar muitos arquivos no rootpath do ambiente.

06. DEMAIS CONFIGURAÇÕES

a) Entidades contábeis 

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 camposSerão utilizadas as entidades indicadas no cadastro da Natureza do título a Pagar/Receber, nos campos a seguir:

  • ED_DEBITO - Conta contábil Cuenta contable para careira cartera Pagar
  • ED_CREDITO - Conta contábil para careira ReceberCuenta contable para cartera Cobrar
  • ED_CCD - Centro de custo costo para carteira cartera Pagar
  • ED_CCC - Centro de custo costo para carteira Recebercartera Cobrar

Acceder al Acessar Configurador / Base de Dados e datos y marcar campos como Usado Utilizado:

Image RemovedImage Added

b)

...

A descrição da moeda do título, irá utilizar o Cadastro de Moedas (CTBA140) do módulo Contabilidade Gerencial, em Atualizações→Cadastros→Moedas Contabeis 

c) Campos customizados - Flex Fields

Documentação sobre campos customizados: Integração Gesplan - Dados enviados e Pipelines 

Referências

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'.

Image Added

Referencias