Histórico da Página

...

1. Visão Geral
2. Exemplo de utilização
3. Tela XXX
   1. Outras Ações / Ações relacionadas
      
4. Tela XXX
   1. Principais Campos e Parâmetros
      
5. Tabelas utilizadas

01. VISÃO GERAL

Este documento tem por objetivo reunir todas as informações relevantes sobre a Integração do TOTVS Gestão Hospitalar (RM Saúde) x BackOffice Protheus disponível a partir da 12.1.6.

02. 

...

SISTEMAS ENVOLVIDOS

...

03. TELA XXXXX

Outras Ações / Ações relacionadas

...

04. TELA XXXXX

Principais Campos e Parâmetros

...

05. TABELAS UTILIZADAS

TEXTO RETIRADO DO DT, VAMOS OFICIALIZAR E ATUALIZAR COMO DR

Sistema Envolvidos

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

• CorporeRM através dos seguintes módulos:
• RM Saúde (TOTVS Gestão Hospitalar): realiza a gestão hospitalar da empresa, desde o registro do paciente, passando pela assistência, gerando o faturamento, baseado nos diversos padrões do mercado como TISS, SUS, ABRAMGE, IPASGO, IPERGS, IPSEMG e etc.
• Estoque (RM Nucleus): utilizado para o cadastro de produtos, locais de estoque, unidades de medida, condições de pagamento. Trata-se do intermediador da integração, uma vez que a integração entre o Hospitalar e ele já é nativa.

...

• Microsiga Protheus através dos seguintes módulos:
• Compras (SIGACOM): Oferece à equipe de compras de uma empresa, condições de acompanhar e controlar as carteiras de compras, cotações, pedidos de compras e o recebimento de materiais, permitindo a reposição dos estoques em tempo hábil e apresentando informações indispensáveis a uma boa negociação com seus fornecedores.
• Faturamento (SIGAFAT): Pode ser definido como a receita bruta decorrente da venda de mercadorias, de mercadorias e serviços e de serviços de qualquer natureza.
• Estoque e Custos (SIGAEST): Controle de materiais movimentados e armazenados da empresa, além do custo incorrido sobre este material.

...

03. INTEGRAÇÃO

A integração entre os sistemas foi motivada pelo uso prévio do Protheus pela instituição ou pela escolha do uso de BackOffice da linha Microsiga e do Hospitalar da linha RM. O TOTVS Gestão Hospitalar já é integrado nativamente com o BackOffice RM e com este cenário surgiu a necessidade de integração com o BackOffice Protheus.

O TOTVS Gestão Hospitalar é responsável pela gestão de saúde e o Protheus pela gestão de estoque, financeira e contábil.

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: WINDOWS.
  • 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.

Utilização do Monitor da Fila de Integração para gravar todas as mensagens enviadas/recebidas para efeito de registro e, no caso de mensagem assíncrona, permitindo reprocessar.

Modelo de Mensagem Única TOTVS.

...

04. MODELO DE MENSAGEM ÚNICA TOTVS (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:

Image Modified

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:
Image Modified

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.

...

05. ESCOPO

A Gestão Hospitalar será feita exclusivamente no TOTVS Gestão 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

06. PRÉ-REQUISITOS 

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:

• Documento de Portabilidade TOTVS Application Server - 29289 da Linha RMProtheus: http://tdn.totvs.com.br/display/rmtec/PortabilidadeApplication+Server
• Documento TOTVS Application Server - 29289 de Portabilidade da Linha ProtheusRM: http://tdn.totvs.com.br/display/tecrm/Application+ServerPortabilidade

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.

Versão mínima Protheus

Utilizar a versão 11.7 (ou superior).

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

Versão mínima 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

07. INTEGRAÇÃO PROTHEUS

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 Gestão 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:

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

Image Modified

Image Modified

Image Modified

Image Modified

Image Modified

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

Image Modified

08. INTEGRACAO 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 a documentação disponível no endereç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)

Execute o instalador “TOTVS Business Connect – [versão].msi” e patchs disponíveis, se existirem. Este pacote cria uma aplicação no IIS e copia os arquivos necessários para a utilização dos WS. Os WS serão instalados na porta 80 (como é a porta padrão pode ser omitida na url). E o alias de banco de dados padrão será CORPORERM.

O administrador do sistema poderá alterar esta e demais configurações, se necessário, editando o arquivo Web.config que se encontra no diretório de instalação RM na pasta WS_TBC.

Instalar a Biblioteca RM

Execute o instalador “BibliotecaRM – [versão].msi” e patchs disponíveis, se houver. Este pacote contém o client “RM.exe” e demais arquivos necessários para funcionamento de todos os módulos da linha RM. A instalação pode ser feita em 3 camadas ou local.

...

1. Execute o script para configurar a integração com o TOTVS Gestão 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

...

1. Acesse RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / Integrações. Esta interface permite incluir ou alterar um pacote de integração.
2. Selecione TOTVS Gestão Hospitalar x BackOffice Protheus (Identificador = 1011) e clique em editar para alterar as configurações iniciais.

...

1. Nome Integração: Este é um campo meramente informativo, recomendamos uma descrição curta, mas clara, para este pacote de integração. Por padrão este nome já vem preenchido como: TOTVS Gestão Hospitalar x BackOffice Protheus.
2. Nome Reduzido: Também é um campo apenas informativo, insira um bem curto. Por padrão vem preenchido como: THPROT.
3. Sistema Integrado: Informe PROTHEUS. Este é um mnemônico que identifica a aplicação de origem e será enviado no atributo "name" da tag <Product> no XML trafegado.
4. URL WebService: Informe o endereço do WebService Protheus para envio de mensagens. Utilize o formato http://\[servidor\]:\[porta\]/EAIService.apw . Para verificar se o WS Protheus está disponível digite o endereço do mesmo no seu navegador (no formato http://\[servidor\]:\[porta\]), na página apresentada procure pelo texto EAISERVICE).
5. Usuário Autenticação: Informe o nome do usuário para autenticação pelo WebService Protheus.
6. Senha Autenticação: Informe a senha para autenticação pelo WebService Protheus.

...

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos TOTVS Gestão Hospitalar (RM Saúde) e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

...

Transações/Entidades/Mensagens únicas

Fluxo das Informações

O fluxo básico desta integração está em definir a origem da informação, enviar para o EAI da linha do produto e este se comunica com o EAI da outra linha. Ambos os produtos possuirão as mesmas informações, porém podem possuir códigos diferentes. Cada sistema possui uma tabela de de-para onde são armazenados os códigos de origem e os códigos de destino e a entidade correspondente. Com isso, cada sistema envia o seu código e o outro sistema faz a troca assim que receber a mensagem. Abaixo serão detalhados cada entidade envolvida nesta integração.

...

O cadastro de filial também deve ser feito manualmente na tabela de “de-para” de integração.

Banco 

O cadastro de bancos, agências e conta caixa devem ser cadastrados somente no BackOffice Protheus através do módulo SIGAFIN. Esta informação é utilizada somente na integração financeira quando se deve informar a conta caixa no processo de baixa.

...

Módulo Protheus: SIGAFIN

Tipo de Envio: Síncrono.

Protheus:

RM:

Centro de Custo

...

Módulo Protheus: SIGACTB

Tipo de Envio: Síncrono.

Notas:

RM: Deve-se definir a máscara do código do centro de custo. O código no Protheus é um campo livre, podendo assim enviar um valor que o RM não possa aceitar, o RM faz a validação do código do Protheus de acordo com a máscara e retorna um erro quando existir.

...

Módulo Protheus: SIGACTB

Tipo de Envio: Síncrono.

Notas:

RM: O símbolo da moeda é a chave primária. Desta forma, ao cadastrar no Protheus uma moeda com um símbolo que já exista no RM ele será vinculado ao registro cadastrado anteriormente caso seja de empresas diferentes, ou seja, teremos dois registros no de/para do RM apontando para um único registro de moeda. Exemplo:

O de/para no RM ficará:

Caso o usuário tente cadastrar uma nova moeda com o mesmo símbolo para a empresa que já tenha este símbolo integrado o RM retornará uma mensagem de erro. Exemplo:

Neste caso será retornado uma mensagem de erro pois a empresa 01 já possui a moeda 01 com o símbolo € cadastrado. Este tratamento será feito no RM via eventos.

Se alterado no PROTHEUS dados de uma moeda, cuja exista mais de um de-para no RM, as demais moedas do RM sofrerão a alteração, porém no PROTHEUS as demais moedas nada sofrerão. Exemplo:

Para a alteração acima serão alterados o cadastro da moeda 01 da empresa 02 do Protheus e na moeda € do RM porém, as moedas 01 da empresa 01 e 03 do Protheus não serão alteradas.

...

Esta mesma mensagem é utilizada para o cadastro de convênios, prestadores e responsáveis financeiros. Porém estes cadastros são realizados no TOTVS Gestão Hospitalar.

Identificador da Mensagem: CUSTOMERVENDOR

...

Módulo Protheus: SIGAFAT e SIGAFIN

Tipo de Envio: Síncrono

Notas:

• A máscara em ambos os sistemas deve ser igual.
• Ao cadastrar um prestador é gerado um fornecedor no RM e sincronizado com o Protheus . O mesmo é gerado um fornecedor no Protheus.
• Ao cadastrar um convênio é gerado um cliente no RM e sincronizado com o Protheus .  O mesmo é gerado um cliente no Protheus.
• Ao cadastrar um responsável financeiro, é criado um cliente no RM e depois gerado um cliente no Protheus. Neste caso, o sincronismo só ocorre no pedido de nota fiscal.

...

Módulo Protheus: SIGAEST

Tipo de Envio: Síncrono

Notas:

Para utilizar esta mensagem é necessário parametrizar o Gestão de Estoques do RM para utilizar a tabela de classificação 1 TTB1. Isso já é feito pelo script de implantação. É necessário utilizar a fórmula visual Integração Grupo de produto para fazer o sincronismo deste cadastro com o Protheus.

...

Módulo Protheus: SIGAEST

Tipo de Envio: Síncrono.

Notas:

São aceitos dois tipos de produtos <ProductType>, Produto acabado (10) e Mão de Obra (07) que serão gravados o valor “P” para Mercadoria e “S” para Mão de Obra.

...

Módulo Protheus: SIGACOM

Tipo de Envio: Síncrono

Protheus:

RM

Unidade de medida

...

Módulo Protheus: SIGAQIE

Tipo de Envio: Síncrono

Notas:

No Protheus a unidade de medida é um cadastro por empresa e no RM o cadastro de unidade de medida é um cadastro compartilhado, para solucionar esse caso as unidades de medida com mesmo símbolo no Protheus irão apontar para uma mesma unidade de medida do RM

...

Módulo Protheus: SIGACOM

Tipo de Envio: Síncrono

Processos

Os processos poderão ser gerados através de dois Tipos de Fluxo:

...

A seguir serão descritos os processos do TOTVS Gestão Hospitalar integrados diretamente com o BackOffice Protheus.

...

No RM é gerado um movimento com o código do fornecedor da nota, data de emissão e seus itens com a quantidade, preço unitário, validade e lote. Ao receber a nota fiscal de entrada, a integração criará os novos lotes recebidos com suas respectivas validades e incluirá nas tabelas do Nucleus. Estes dados são importantes para que o TOTVS Gestão Hospitalar consiga atualizar os preços dos itens e gerar os códigos de barras dos itens.

...

Após encerrada a conta do paciente e esta possuir gastos particulares, o usuário acessará o TOTVS Gestão Hospitalar, menu Tesouraria /Controle de Solicitação p/ Emissão de Nota Fiscal / Recibos. Clicar no botão Gerar Solicitação de emissão de documento, informar o paciente, selecionar o tipo de gasto, selecionar o responsável financeiro e clica no botão Processar. Após isso, clicar no botão Gera Pedido de emissão de documento para o Protheus. Neste momento é exibido o movimento associado a este processo e deve-se informar a condição de pagamento deste pedido de venda.

...