Integrações

Páginas filhas
  • DI_TOTVS_Gestão_Hospitalar_Back_Office_Protheus

Versões comparadas

Versão antiga 12

changes.mady.by.user Monica Matos Bock

Gravado em

comparado com

Nova versão 13

changes.mady.by.user Monica Matos Bock

Gravado em

Chave

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

...

Esta integração visa unir os dois sistemas para minimizar o trabalho de cadastrar as entidades comuns em ambos os sistemas e permitir que cada um trate exclusivamente do seu negócio.

  • Premissas.
  • Esta solução deve primar pela simplicidade e facilidade de uso, facilidade de manutenção e facilidade de atualização.
  • Deve respeitar os sistemas operacionais utilizados pelas soluções software das marcas: WINDOWNSWINDOWS.
  • Utilizar o Protheus versão 11.7 (e patchs específicos para esta integração) e o RM versão 11.82 (último patch disponível). Observação: Ambos utilizam o modelo de licenciamento TOTVS padrão (Licence Server).
  • Bancos de dados homologados: SQL Server 2005 ou 2008 e Oracle 10g ou 11g.
  • Se o cliente já possui base de dados implantada do RM ou do Protheus será responsabilidade da equipe de implantação efetuar a carga inicial e/ou sincronismo dos cadastros. A integração irá efetuar o sincronismo automático de novos registros ou alterações posteriores à ativação da integração.
  • Por padrão, todos os cadastros mantidos pelo Backoffice Protheus deverão ser desabilitados (manualmente) no controle de segurança do RM. Exceções serão destacadas ao longo do documento.
  • Arquitetura (Tecnologia).
  • Integração de processos síncronos através de WebServices (EAI).

...

Comunicação direta do EAI RM x EAI Protheus, via WebServices. Mensagens Assíncronas e Síncronas.

...

Definição de Mensagem Única TOTVSMESSAGE

 

Durante o processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudessem agora compor o seu ambiente de TI utilizando produtos de origens diferentes (Exemplo: BackOffice Protheus + TIN).

...

Com o objetivo de padronizar as integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: A de que todos os produtos TOTVS devam trabalhar com uma mensagem XML únicos evitando, desta forma, o processo de transformação de mensagens. Neste cenário, teríamos o seguinte quadro: 

 

Neste cenário, qualquer produto TOTVS trabalhará com o mesmo XML para uma mesma entidade, vamos supor que tenhamos um XML correspondente à mensagem de CLIENTES, ela poderá ser enviada para qualquer um dos produtos que suporte o recebimento desta entidade.
Uma vez que os vários produtos TOTVS terão um "idioma" comum (o XML Único), as integrações entre estes produtos não exigirão mais que as mensagens sejam transformadas de um formato para outro. Com isto, será possível conectar diretamente dois produtos, sem a necessidade do TOTVS ESB, como no diagrama abaixo:

Além de questões referentes ao formato das mensagens, a mensagem única também torna uniforme o tratamento destas mensagens XML pelos aplicativos, principalmente no que diz respeito à capacidade de rastreamento.

 

...

Escopo

A Gestão Hospitalar será feita exclusivamente no TOTVS Hospitalar (cadastro dos prestadores, convênios, tabelas de preço de MATMED, produto, grupo de estoque, etc.).

O controle de estoques, compras, faturamento, financeiro, contábil e fiscal serão feitos no Protheus (módulos integrados: SIGACOM, SIGAFAT e SIGAEST). Os cadastros básicos, bem como os cadastros de Cliente e Fornecedor, Centro de Custo, Condição de Pagamento, Unidade de Medida, Moeda serão realizados sempre no Protheus e sincronizados para o RM. 

 

...

Pré-requisitos instalação/implantação/utilização

 

A integração respeita todos os pré-requisitos definidos pelas linhas de produto TOTVS envolvidos. Para mais detalhes sobre configuração de hardware recomendada, sistema operacional, bancos de dados suportados e demais dados, consulte os seguintes documentos no TDN:

 

Os produtos envolvidos utilizam o modelo de licenciamento padrão (License Server). Para pleno funcionamento, as licenças (Hard Lock) devem ser providenciadas junto a TOTVS com antecedência. Vale ressaltar que esta integração está de acordo com as boas práticas recomendadas pelo Comitê de Integração TOTVS e utiliza a arquitetura Mensagem Única e comunicação via WebServices.

 

 

...

Protheus

Utilizar a versão 11.7 (ou superior).

Os WebServices exigem uma licença específica “TOTVS I”. 

...

RM

Utilizar a versão 11.82.36 (específica).

A TOTVS disponibiliza um backup da base de dados RM “vazia” que pode ser utilizada para novos clientes. Para clientes que já possuem versão anterior utilizar o Conversor RM para atualizar o banco de dados para a versão 11.82.

 

 

 

 

 

...

Instalação/Atualização

Esse documento não visa a descrição dos procedimentos de instalação do Protheus padrão e suas configurações. Neste documento serão apresentadas informações referentes ao EAI da Linha Protheus, que é o responsável pela comunicação com o TOTVS Hospitalar. 

...

Protheus

...

...

Cadastrar/Configurar Adapter para Integração no Protheus

Entre no configurador (SIGACFG), em Ambiente/Schedule/Adapter EAI, e preencha-o da seguinte forma:

Image Modified

O conteúdo da coluna Alias só deve ser preenchida se o cadastro for compartilhado no Protheus. No caso de cadastro compartilhado, é necessário que o adapter Family seja configurado para enviar do Protheus e não receber. Neste caso, a fórmula visual do grupo de estoque deve ser desabilitada.

 

Configurar o EAI para Integração no Protheus

No Protheus, acesse no configurador SIGACFG / Ambiente / Schedule / Schedule.

 

Cadastrar Agent

  1. Clique no sinal de +(Soma) ao lado esquerdo do Globo Verde com o título Agent, para abrir as opções Cadastro e Monitor.
  2. Clique na opção Cadastro.
  3. Após isso clique no Globo Verde com sinal de +(Soma) que está à direita da tela, as informações da tela de detalhes serão preenchidas automaticamente.

 

Cadastrar Agendamento

  1. Clique no sinal de +(Soma) ao lado esquerdo do Globo Verde com o título Agendamento, para abrir as opções Cadastro e Monitor.
  2. Clique na opção Cadastro, na tela de detalhes na parte inferior da tela principal.
  3. Clique no primeiro ícone de um caderno com sinal de +(soma). Algumas informações aparecerão automaticamente.
  4. Complete o preenchimento apenas em Rotina, com FWEAI e com Empresa/Filial clicando na Lupa ao lado direito do campo.
  5. Será exibida a tela apresentando as empresas cadastradas.
  6. Selecione a empresa que fará integração, clique duas vezes no Check-box ao lado esquerdo do Nome da empresa até ficar marcado com um (x).
  7. Após isso, clique no botão OK.
  8. Clique no botão Recorrência (Duas setas circulares).
  9. Na nova janela selecione Sempre Ativo nas opções de Padrão de Recorrência para que o job do EAI fique sempre escutando a fila de mensagens únicas.
  10. Para finalizar clique no (V) de cor verde Botão Confirmar.

...

EAI – Como visualizar os arquivos XML criados pelas rotinas

 

São apresentadas duas telas sendo a de Transações na parte superior e a tela de Eventos da Tarefa na parte inferior.

...

 Nota:Para identificar a Cor da Legenda com o tipo de mensagem, clique duas vezes na bolinha colorida que será exibida a tela de legenda com a identificação do tipo com a Cor.

...

Limpar Histórico de Mensagens

 Opção Limpeza de Tabelas: Caso queira realizar uma limpeza dos históricos das mensagens. 

Ao clicar nesta opção, será exibida uma tela denominada Tabelas,  uma frase com a descrição “Selecione a Tabela” e uma seta preta apontando para baixo do lado direito da frase. Clique nesta seta para abrir as opões: Tarefas ou EAI.

  1. Clique em EAI, e marque um tipo de mensagem que deseja limpar do histórico, são elas:
    • Aguardando Execução.
    • Executando.
    • Finalizada.
    • Falhou.
    • Bloqueado.
  2. Para identificar a Cor da Legenda com o tipo de mensagem, clicar duas vezes na bolinha colorida, será exibida a tela de legenda e a  identificação de cores correspondente ao status.
  3. Para executar todas as opções, não selecione nenhuma e clique no botão Executar. Será exibida a tela com todas as mensagens para serem excluídas.
  4. Para finalizar clique no Ícone de um Caderno com um (x) vermelho que está no lado direito superior da tela. Será exibida uma tela de confirmação com a mensagem Confirma deleção?.
  5. Clicar no botão Sim para excluir todos históricos ou no botão Não para manter os históricos.

 

Configurar Parâmetros da Integração

 

  1. Acesse o configurador (SIGACFG) , em Ambiente/Cadastros/Parâmetros:
    • MV_EAIURL2= Endereço WebService que Receberá os Dados Enviados (Exemplo: http://ip_do_servidor/TOTVSBusinessConnect/wsEAIService.asmx?wsdl).
    • MV_EAIWS= Informe o nome do Client WebService do EAI para envio a outro EAI. (WSEAISERVICE).
    • MV_EAIUSER= <Nome de usuário>.
    • MV_EAIPASS= <Senha de usuário>.
    • MV_EAIMETH= Informe o método de envio do EAI para envio a outro EAI. (RECEIVEMESSAGE). 








2. No Configurador, acesse Ambiente/Schedule/Emp fil. Msg Única e configure o de-para de Coligada e Filial.

RM

Serão destacadas as informações referentes ao TOTVS Business Connect (TBC) que é a ferramenta EAI da Linha RM, responsável pela comunicação com o BackOffice Protheus.

Para demais esclarecimentos sobre demais produtos da Linha RM, consulte o help online a documentação disponível no endereço: wikihelp.totvs.com.br ou o  tdn.totvs.com    

Pré-requisitos

Nesta versão os WebServices de Integração da linha RM devem ser hospedados no Microsoft IIS. Além disto a Biblioteca RM necessita da Microsoft .NET Framework. Assim, os pré-requisitos de instalação para o EAI RM são os seguintes:

  • Microsoft .NET Framework 4.0
  • Internet Information Services (IIS)

...

Instalar os WebServices de Integração (TBC)

...

  1. Execute o configurador conforme imagem abaixo para a criação de campos e conjunto de mensagens de integração.
  2. Selecione o sistema Integração, em Ferramentas, opção Configurar.
    1. Após execução, inative esta integração.
  3. Informe o usuário e senha do banco e clique em Testar Conexão para habilitar o botão Avançar.
    Image Modified
  4. Selecione a Integração TOTVS Manutenção de ativos X BackOffice RM, clique em Avançar e depois em Executar.
    Image Modified
  5. Acesse o Menu Integração / Mensagem Única / Integrações. Edite o registro de identificador = 1001 e desmarque o campo Ativo?

Image Modified

Importante: Execute os scripts somente após ter definido os cadastros de coligada e filial. Após isso, pare o serviço do RM.Host.Service para que as alterações no banco sejam refletidas na aplicação.

  1. Execute o script para configurar a integração com o TOTVS Hospitalar. Este script faz a configuração da integração, incluindo todas as mensagens utilizadas, tipos de movimento, máscaras, etc.
  2. Execute o script IntegracaoRMSaude_Protheus_01.sql. O script já define algumas máscaras defaults para os códigos de cliente/fornecedor, produto, família de materiais, local de estoque. Defina a máscara para que seja compatível com os códigos no Protheus.
  3. No script IntegracaoRMSaude_Protheus_02.sql.É necessário informar a coligada que será utilizada no cliente.
  4. Inicie o serviço RM.Host.Service


Oracle: Image Modified SQL Server: Image Modified

Requisitos Básicos da integração

...

  • TMVDEVOLUCAOCC: tipo de movimento do Nucleus utilizado nas movimentações de devolução para centro de custo
  • TMVDEVOLUCAO: tipo de movimento do Nucleus utilizado nas movimentações de devolução
  • TMVBAIXA: tipo de movimento do Nucleus utilizado nas movimentações de baixa de estoque. Requisições para paciente, prescrição
  • TIPOSAIDAPEDIDOVENDA: código do tipo de saída do Protheus para emissão de pedidos de venda
  • TIPODOCMOVFATURA: tipo de documento do Protheus utilizado para o envio de título a receber, relacionado ao movimento de fatura
  • TIPODOCFOLHAPAGTO: tipo de documento do Protheus utilizado para o envio de título a receber relacionado ao movimento de folha de pagamento
  • SERIEDOCMOVFATURA: série utilizada para enviar o título a receber para o Protheus
  • SERIEDOCFOLHAPAGTO: série utilizada para enviar o título a pagar para o Protheus

Configuração de-para de Coligada e Filial

...

  1. Acesse RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / De-Para.
  2. Inclua o registro de correspondência entre os códigos das empresas do Protheus com as coligadas do RM conforme imagem.
    Image Modified

 

  1. Faça o mesmo procedimento para as filiais. Deve-se atentar como o Protheus envia o valor da tag BranchId no cabeçalho da mensagem, pois o EAI RM irá concatenar as tags CompanyId com a BranchId separadas pelo caracter |
    Image Modified
  2. Assim no cadastro de filial ficaria 01|01 à CompanyId|BranchId, para o caso de não utilizar o conceito de gestão de grupo de empresas. Para o uso de gestão de grupo de empresas, o cadastro de de-para ficaria: 03|0101, onde 03 seria o grupo de empresa, o primeiro 01 seria o código da empresa e o segundo 01 seria o código da filial, sendo que 0101 é o código completo da filial.

...


  1. Image Modified

...

  2. Para o caso de utilizar o compartilhamento de cadastros do Protheus, é necessário configurar no cadastro das coligadas, o código do grupo da empresa a que pertencem as coligadas. Este código é utilizado para a réplica dos cadastros dentro do mesmo grupo.

 

 

Fórmulas Visuais

Realize a importação das fórmulas visuais necessárias para a integração de convênios, prestadores, produtos e grupos de estoque.

  1. Acesse o RM.exe / Segmento Saúde / Gestão Hospitalar / Gestão / Fórmula Visual.
  2. Em Categoria, crie a categoria 'Integração Protheus'.
  3. Na página Perfil da Categoria de Fórmula Visual inclua os perfis que terão acesso a está categoria.
  4. Inclua o perfil do usuário que fará a importação das fórmulas.
    Image Modified
    Image Modified
  5. Após isso acesse o RM.exe / Segmento Saúde / Gestão Hospitalar / Gestão / Fórmula Visual.
  6. Em Fórmula visual execute o processo Importação de Fórmula visual.
  7. Clique em Adicionar Objetos.
  8. Selecione o arquivo IntegracaoProtheus.TotvsWF.
  9. Na página Seleção de Coligadas, deixa a Coligada Atual.
  10. Para cada fórmula e necessário informar na página Parâmetros a categoria cadastrada anteriormente e marcar a opção Importar Gatilho.

...