Integração PROTHEUS (SIGAJURI) X DATASUL (Simplificado)

Contexto de negócio

O intuito deste manual e validar a integração do Ambiente DATASUL X Protheus via envio de mensagem única EAI.

O objetivo da integração do PROTHEUS x BackOffice DATASUL é viabilizar que de forma automática os cadastros gerenciados pelo BackOffice sejam replicados. Desta forma as bases de dados se mantém espelhadas.

Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

Microsiga Protheus através dos seguintes módulos:
- Protheus Framework (SIGACFG): Módulo responsável pelos WebServices e Framework de Integração.
- Protheus Padrão Jurídico (SIGAJURI): Módulo Jurídico.
- TOTVS Business Connect: Módulo responsável pelos WebServices e Framework de Integração.

Integração

Atender a demanda de clientes que possuem o BackOffice DATASUL , sincronizando as informações entre os módulos a partir da integração por Mensagem Única TOTVS.

Hoje temos algumas mensagens conforme abaixo implementadas pelo Datasul. Precisamos validar o que existe e se está funcionando com o Protheus de fato para que possamos fazer a integração do financeiro.

Há um ambiente de testes Datasul disponibilizado pela equipe de Joinville.

Nós usamos as mensagens abaixo para a integração financeira:

Contas a pagar

- Moeda => Não temos Implementado (Datasul)

- Fornecedor => OK

- Centro de custo => OK

- Condição de pagamento => OK

- Natureza financeira => Não temos este Conceito no Datasul

- Títulos => Não temos Implementado (Datasul)

Contabilização

- Plano de contas => OK

- Lançamento contábil => OK

OBS: Dependente também a versão da Mensagem que vocês estão utilizando, precisamos saber se a que você irá mandar, é a mesma versão que eu implemento aqui.

Por exemplo, a da Plano de Contas é a 2.000.

Mensagens que o DATASUL implementa. A lista de EAI2 é o que o Protheus já entrega e EAI1 é o que o DATASUL tem mas não tem integração por padrão.

EAI2
Módulo	Transação	Descrição
ACR	AccountReceivableDocument	Título do Contas a Receber
ACR	TransportInvoice	Fatura de Transporte
ACR	TransportInvoiceStatus	Status da Fatura de Transporte
APB	TransportDocument	Documento de Transporte
APB	TransportDocumentStatus	Status do Documento de Transporte
FAS	AssetDepreciation	Movimentos de Depreciação de Bens
FGL	AccountingEntry	Lançamentos Contábeis
MGL	ExportOfAccountMovements	Exportação Arquivo Texto de Movto/Saldo Contábil
MGL	PeriodGlBalance	Saldos Contábeis - Despesas Gerais
FGL	AccountantAccount	Conta Contábil
FGL	CostCenter	Centro de Custo
UTB	CustomerVendor	Cliente/Fornecedor
UTB	CustomerVendorReserveID	Reserva do ID do Cliente/Fornecedor

EAI1
Módulo	Transação	Descrição
APB	AccountPayableDocument	Títulos do Contas a Pagar
APB	AccountPayableTransactions	Transações de Títulos a Pagar
ACR	AccountReceivableDocument	Títulos do Contas a Receber
ACR	AccountReceivableTransactions	Movimentos do Contas a Receber
ACR	ACRPosition	Posição Títulos Contas a Receber
APB	APBPosition	Posição dos Títulos do Contas a Pagar
FAS	AssetDepreciation	Depreciação por Bem
CMG	CheckingAccountTransactions	Movimentos do Caixa e Bancos
FGL	CostCenter	Centro de Custo
UTB	CurrencyRate	Cotações de Indicadores Econômicos
UTB	CustomerVendor	Emitente (Cliente/Fornecedor)
UTB	CustomerVendorInformation	Consulta Emitente (Cliente / Fornecedor)
CMG	DeleteCheckingAcctTrans	Eliminação de Movimentos do Caixa e Bancos
UTB	EconomyIndicator	Indicador Econômico
FGL	GLTransaction	Lançamento Contábil
FGL	GLTransactionEMS5	Geração Lançamento Contábil
MGL	PeriodGLBalance	Saldos Contábeis do Período
FGL	SenderGLTransaction	Manutenção Lote Contábil
APB	TaxesCalculate	Impostos Vinculados a Pagamentos

Roteiro de configuração EAI2 - DATASUL

- Se considerar que o ambiente já está configurado (que é a primeira parte da configuração descrita abaixo), você pode considerar diretamente o último Tópico (Totvs Monitor).

- Documentação completa no TDN no link: http://tdn.totvs.com/display/FRAMJOI/TOTVS+EAI2

Roteiro de configuração

Passos para configuração:

Passo 1

Appserver
- Utilizar o mesmo broker utilizado pelo Datasul.
  - Broker deve constar no arquivo <dir_jboss>/server/<instancia>/conf/datasul/datasul_framework.properties.
    - Propriedade progress.server.application.
- Verificar se o propath aponta para os programas corretos.
  - Pasta eai2 deve estar no propath.
  - Consultar propath usando a ferramenta OpenEdge Explorer, da Progress.
- Reiniciar o AppServer caso seja alterado o propath ou JBoss, caso se altere o arquivo datasul_framework.properties.

Passo 2

Configuração da ponte entre Jboss e Appserver:
- Verificar arquivo <dir_jboss>/server/<instancia>/conf/datasul/datasul_framework.properties.
  - Propriedades
    - eai.java.naming.security.principal=<usuário cadastrado no Datasul>
    - Eai.java.naming.security.credential=<senha do usuário>
  - O usuário informado nessa configuração deve estar relacionado com as empresas corretas.
  - Recomenda-se utilizar um usuário diferente do usuário padrão "super".

Passo 3

Usuário do webservice do EAI:
- Alterar arquivos da pasta <dir_jboss>/server/<instancia>/conf/props/.
  - Jbossws-roles.properties
    - Incluir papel eai2allowed.
    - Associar usuário eai ao papel eai2allowed.
  - Jbossws-users.properties
    - Incluir usuário eai, com a respectiva senha.
- Necessário reiniciar o Jboss.

Passo 4

Webservice do EAI:
- Verificar se está ativo.
- Exemplo de URL: http://srvr0000000166:8380/eai2-ws/EAIService?wsdl.

Passo 5

Arquivo de configuração do EAI (eai2-config.properties):
- O arquivo deve conter, pelo menos, a seguinte linha:
  - eai2.config.provider=com.totvs.datasul.eai.db.DBConfigurationProvider
- Deve estar visivel no propath do appserver e do client (DI).

Passo 6

Arquivos de publicação de adapters:
- Fornecidos com a instalação do datasul.
- Devem estar no propath.
- Podem ser encontrados nas seguintes pastas:
  - Crm/adapters:
    - Crm-adapters.xml
  - Ems2/adapters:
    - Agr-adapters.xml
    - Fis-adapters.xml
    - Log-adapters.xml
    - Man-adapters.xml
    - Uni-adapters.xml
  - Ems5/adapters:
    - Fin-adapters.xml
  - Fnd/adapters:
    - Tec-adapters.xml
  - Hcm/adapters:
    - Hcm-adapters.xml

Passo 7

Servidor RPW
- Configurar um servidor específico para tratar a fila de mensagens.
- Cadastrar o servidor RPW no Datasul.
  - Empresa 51, supervisor super.

Passo 8

Registrar fila do EAI2 no RPW (btb948aa):
- Informar o nome do servidor RPW que processará a fila do EAI.
- Informar data e hora de início.
- Se ainda não existir, criar uma agenda automática (botão Agenda Automática).

Passo 9

Agenda automática (cd8600):
- Aba Genéricos
  - Incluir agenda para o programa btb948za (Processar fila do EAI2).
  - Recomendações:
    - Agendamento ativo.
    - Não permitir execução paralela.
    - Calendário semanal.
- Botão Programar Horários.
  - Periodicidade: a cada 2 minutos.

Passo 10

Totvs Monitor:
- Verificar se está ativo.
- URL de acesso: http://srvr0000000166:8380/totvs-monitor.
- Usuário de acesso: super (ou qualquer outro, do tipo Super, cadastrado no Datasul).
- Aba EAI 2:
  - Se o ambiente não foi inicializado ainda, será apresentado o wizard de configuração.
  - No wizard, informar o tipo de host (aceitar a 1a opção exibida).
  - Em seguida, alterar o nome do aplicativo e clicar em Salvar.
  - Após configurar o aplicativo interno:
    - Habilitar o suporte à múltiplas versões (aba Opções, campo MultiVersionSupport = true).
    - Habilitar as transações.
  - Incluir os aplicativos externos.
  - Cadastrar a tabela de-para.
    - Valor externo: valor recebido do aplicativo externo.
    - Valor interno: valor correspondente no Datasul.
  - Configurar as rotas.

Roteiro de configuração EAI2 - Protheus

...

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

Identificar o funcionamento da integração;

Identificar a ocorrências de problemas;

Coletar evidências do mau funcionamento relatado pelo cliente;

Realizar possíveis ajustes na integração quanto à configuração ou negócio.