Páginas filhas
  • DI_TOTVS_Gestão_Hospitalar_Back_Office_Protheus

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Integração Backoffice Protheus x TOTVS Hospitalar

Table Filter
id1538508239843_-1767089867

Produto:

TOTVS Gestão Hospitalar

Versões:

A partir da 12.1.6

Assunto:

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

 


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

...

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.

...

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:

...

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. 

...

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

Image Removed

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.

  1. Na tela de transações são exibidas as mensagens que foram geradas.
  2. Para visualizar o arquivo XML criado pela mensagem, clique na linha da mensagem e em seguida clique na Lupa azul que se encontra na parte superior da tela, será aberto o arquivo XML no browser do Internet Explorer.
  3. Ao clicar na linha da Mensagem, na tela de Eventos da Tarefa podem ser exibidas as seguintes informações de acordo com o status da mensagem:
    1. Início de Processamento.
    2. Falhas.
    3. Processo Interrompido.
    4. Fim de Processamento.

 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.

Image Removed

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.

Configurar a Integração

  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 Removed
  4. Selecione a Integração TOTVS Manutenção de ativos X BackOffice RM, clique em Avançar e depois em Executar.
    Image Removed
  5. Acesse o Menu Integração / Mensagem Única / Integrações. Edite o registro de identificador = 1001 e desmarque o campo Ativo?

...

Msg ÚnicaRotinaMensagemEnviaRecebeMétodoOperaçãoCanalVersãoAlias
SimAGRA045WAREHOUSESimNãoSíncronoTodasEAI1.000NNR
SimMATA020CUSTOMERVENDORSimSimSíncronoTodasEAI2.002
SimMATA030CUSTOMERVENDORSimSimSíncronoTodasEAI2.002
SimCRMA980CUSTOMERVENDORSimSimSíncronoTodasEAI2.005
SimCTBA140CURRENCYSimNãoSíncronoTodasEAI2.000CTO
SimMATA360PAYMENTCONDITIONSimNãoSíncronoTodasEAI2.000SE4
SimMATA070BANKSimNãoSíncronoTodasEAI2.000SA6
SimCTBA030COSTCENTERSimNãoSíncronoTodasEAI2.000CTT
SimMATA010ITEMSim/NãoNão/SimSíncronoTodasEAI2.001SB1
SimQIEA030UNITOFMEASURESimNãoSíncronoTodosEAI2.000SAH
SimMATA035FAMILYSim/NãoNão/SimSíncronoTodasEAI2.000SBM
SimMATA035STOCKGROUPSimNãoSíncronoTodasEAI1.000SBM
SimFINA040ACCOUNTRECEIVABLEDOCUMENTNãoSimSíncronoTodasEAI3.000
SimFINA050ACCOUNTPAYABLEDOCUMENTNãoSimSíncronoTodasEAI2.000
SimFINA070ACCOUNTRECEIVABLEDOCUMENTDISCHARGENãoSimSíncronoAtualizaçãoEAI2.000
SimFINA070REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGENãoSimSíncronoExclusãoEAI2.000
SimMATA103BINVOICE (Doc de entrada)SimNãoSíncronoTodasEAI3.001
SimMATA521INVOICE (Exclusão de doc de saída)SimNãoSíncronoTodasEAI3.009
SimMATA461INVOICE (Doc de Saída)SimNãoSíncronoTodasEAI3.009
SimMATA225STOCKLEVELNãoSimSíncronoTodasEAI1.000
SimMATA241STOCKTURNOVERSimSimSíncronoTodasEAI1.003
SimMATA261TRANSFERWAREHOUSESimSimSíncronoTodasEAI1.001
SimMATA340INVENTORYSimNãoSíncronoTodasEAI1.000
SimMATA410ORDERNãoSimSíncronoTodasEAI3.002
SimFINA010FINANCIALNATURESimNãoSíncronoTodasEAI2.000SED


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.

  1. Na tela de transações são exibidas as mensagens que foram geradas.
  2. Para visualizar o arquivo XML criado pela mensagem, clique na linha da mensagem e em seguida clique na Lupa azul que se encontra na parte superior da tela, será aberto o arquivo XML no browser do Internet Explorer.
  3. Ao clicar na linha da Mensagem, na tela de Eventos da Tarefa podem ser exibidas as seguintes informações de acordo com o status da mensagem:
    1. Início de Processamento.
    2. Falhas.
    3. Processo Interrompido.
    4. Fim de Processamento.

 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 Added

Image Added
Image Added

Image Added

Image Added

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

Image Added

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.

Configurar a Integração

  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 Added
  4. Selecione a Integração TOTVS Manutenção de ativos X BackOffice RM, clique em Avançar e depois em Executar.
    Image Added
  5. Acesse o Menu Integração / Mensagem Única / Integrações. Edite o registro de identificador = 1001 e desmarque o campo Ativo?

Image Added

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 Added SQL Server: Image Added

Requisitos Básicos da integração

  • Máscara do código do cliente/fornecedor deve ser compatível com a máscara no Protheus
  • Utilizar CPF Único
  • Utilizar CNPJ Único
  • Máscara do código do produto deve ser igual ao do Protheus
  • Habilitar a TB1 para manutenção de Família de Materiais.
  • Máscara do local de estoque deve ser compatível
  • Máscara do centro de custo deve ser compatível
  • Para a utilização de cadastros compartilhados, deve-se ter a mesma configuração em todas as coligadas dos seguintes itens:
    • Produto global
    • Cliente/fornecedor global

Parametrizar a integração

  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 Hospitalar x BackOffice Protheus (Identificador = 1011) e clique em editar para alterar as configurações iniciais.

Primeira parte – Identificação

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

Image Added

Segunda parte – (Anexo) Mapeamento de Entidades

É possível realizar um mapeamento de cada entidade (cada mensagem única) que faz parte do pacote de integração.
O script de Configuração irá fazer o mapeamento padrão automaticamente. Alterações só devem ser feitas com critério. Caso seja necessário acrescentar uma entidade à integração que não esteja no pacote padrão, clique em Anexos e escolha "Mapeamento de Entidades". Na tela que é apresentada informe o código ou nome da mensagem. Clique no botão reticências (...) para localizar a mensagem na lista de mensagens pré-cadastradas.
Image Added

Terceira parte – (Anexo) Parâmetros

Aqui estão disponíveis os parâmetros utilizados na integração. Este parâmetro já vem preenchidos pelo script de inicialização. Os parâmetros de tipo de movimento não devem ser alterados. Já os parâmetros TIPOSAIDAPEDIDOVENDA, TIPODOCMOVFATURA, TIPODOCFOLHAPAGTO, SERIEDOCMOVFATURA e SERIEDOCFOLHAPAGTO devem ser alterados para os valores de cada cliente.

  • TMVTRANSF: tipo de movimento do Nucleus utilizado nas movimentações de transferência
  • TMVENTRADANF: tipo de movimento do Nucleus utilizado nas movimentações de entrada de nota fiscal que afeta estoque
  • TMVENTRADANFNAOBAIXAtipo de movimento de ENTRADA de nota que NÃO afeta estoque
  • TMVENTRADANFCONSIGNADO: tipo de movimento de ENTRADA de CONSIGNADO de nota que afeta estoque
  • TMVENTRADANFCONSIGNADONAOBAIXA: tipo de movimento de ENTRADA de CONSIGNADO de nota que NÃO afeta estoque
  • TMVDEVOLUCAONF: tipo de movimento de  DEVOLUÇÃO  de nota que afeta estoque
  • TMVDEVOLUCAONFNAOBAIXA: tipo de movimento de  DEVOLUÇÃO  de nota que NÃO afeta estoque
  • TMVDEVOLUCAONFCONSIGNADO: tipo de movimento de DEVOLUÇÃO de CONSIGNADO de nota que afeta estoque
  • TMVDEVOLUCAONFCONSIGNADONBAIXA: tipo de movimento de  DEVOLUÇÃO  de CONSIGNADO de nota que NÃO afeta estoque
  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

...

Requisitos Básicos da integração

  • Máscara do código do cliente/fornecedor deve ser compatível com a máscara no Protheus
  • Utilizar CPF Único
  • Utilizar CNPJ Único
  • Máscara do código do produto deve ser igual ao do Protheus
  • Habilitar a TB1 para manutenção de Família de Materiais.
  • Máscara do local de estoque deve ser compatível
  • Máscara do centro de custo deve ser compatível
  • Para a utilização de cadastros compartilhados, deve-se ter a mesma configuração em todas as coligadas dos seguintes itens:
    • Produto global
    • Cliente/fornecedor global

Parametrizar a integração

  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 Hospitalar x BackOffice Protheus (Identificador = 1011) e clique em editar para alterar as configurações iniciais.

Primeira parte – Identificação

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

Image Removed

Segunda parte – (Anexo) Mapeamento de Entidades

É possível realizar um mapeamento de cada entidade (cada mensagem única) que faz parte do pacote de integração.
O script de Configuração irá fazer o mapeamento padrão automaticamente. Alterações só devem ser feitas com critério. Caso seja necessário acrescentar uma entidade à integração que não esteja no pacote padrão, clique em Anexos e escolha "Mapeamento de Entidades". Na tela que é apresentada informe o código ou nome da mensagem. Clique no botão reticências (...) para localizar a mensagem na lista de mensagens pré-cadastradas.
Image Removed

Terceira parte – (Anexo) Parâmetros

Aqui estão disponíveis os parâmetros utilizados na integração. Este parâmetro já vem preenchidos pelo script de inicialização. Os parâmetros de tipo de movimento não devem ser alterados. Já os parâmetros TIPOSAIDAPEDIDOVENDA, TIPODOCMOVFATURA, TIPODOCFOLHAPAGTO, SERIEDOCMOVFATURA e SERIEDOCFOLHAPAGTO devem ser alterados para os valores de cada cliente.

  • TMVTRANSF: tipo de movimento do Nucleus utilizado nas movimentações de transferência
  • TMVENTRADANF: tipo de movimento do Nucleus utilizado nas movimentações de entrada de nota fiscal
  • 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
  • TMVENTRADAAJUSTE: utilizado para incrementar o saldo no inventário 
  • 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
  • CODCLASSIFICPAIS: utilizado como código do país

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.
  3. 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 |
  4. 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.

  5. 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 RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / Fila de mensagens únicas.
  2. Nesta tela serão registradas as informações de envio e recebimento de mensagens XML trafegadas pela integração.
  3. Para ver mais detalhes da mensagem trafegada de um duplo clique no registro, para detalhes de execução (erro ou sucesso) selecione o registro e clique em Anexos / Informações de execução de mensagem, neste anexo é possível visualizar a mensagem de resposta.

 


Dados da mensagem trocada entre o RM e o Protheus:

...

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos TOTVS 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.

Image Removed

  

Image Added



Nota: a versão atualizada deste fluxo pode ser consultada no TDN (TOTVS Developer Network), acesse o caminho http://tdn.totvs.com, faça o login e acesse Qualidade de Software Corporativa / Metodologia de Desenvolvimento de Produtos TOTVS / Processo de Sustentação / Subprocesso de Suporte Técnico / Fluxo de Integração de Produtos.

Transações/Entidades/Mensagens únicas

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)

 


 

 

 

 

 

 

 

 

 

 

 

 

 

 

Cadastros

01

Local de estoque

Protheus

RM

Warehouse_1_000.xsd

02

Cliente-Fornecedor

Protheus

RM

CustomerVendor_2_002.xsd

03

Grupo de Estoque

RM

Protheus

Family_2_000.xsd

04

Moeda

Protheus

RM

Currency_2_000.xsd

05

Condição de pagamento

Protheus

RM

PaymentCondition_2_000.xsd

06

Banco

Protheus

RM

Bank_2_000.xsd

07

Centro de Custo

Protheus

RM

CostCenter_2_000.xsd

08

Produto

RM

Protheus

Item_2_001.xsd

09

Unidade de Medida

Protheus

RM

UnitOfMeasure_2_000.xsd

10

Coligada*

* Integrado manualmente, incluindo na tabela de de/para em ambos os sistemas

 

 

 




11

Filial*

* Integrado manualmente, incluindo na tabela de de/para em ambos os sistemas

 

 

 




12

Prestadores

RM

Protheus

CustomerVendor_2_002.xsd

13

Convênios

RM

Protheus

CustomerVendor_2_002.xsd

 

 

 

 

 

 

 

 

Processos

14

Título a receber

RM

Protheus

AccountReceivableDocument_3_000.xsd

15

Título a pagar

RM

Protheus

AccountPayableDocument_2_000.xsd

16

Baixa de títulos

RM

Protheus

AccountReceivableDocumentDischarge_2_000.xsd

17

Cancelamento de baixa

RM

Protheus

ReversalOfAccountReceivableDocumentDischarge_2_000.xsd

18

Nota fiscal de entrada

Protheus

RM

Invoice_3_001.xsd

19

Saldo

RM

Protheus

STOCKLEVEL_1_000.xsd

20

Movimentação de estoque

RM/ Protheus

Protheus/ RM

STOCKTURNOVER_1_003.xsd

21

Transferências

RM/ Protheus

Protheus/ RM

TRANSFERWAREHOUSE_1_001.xsd

22

Inventário

Protheus

RM

INVENTORY_1_000.xsd

23

Pedido de venda

RM

Protheus

ORDER_3_002.xsd

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.

...


De-para RM (Empresa)

De-Para Protheus (Empresa)/(FILIAL)

Tabela RM

GCOLIGADA

Referência

RM

Chave Primária RM

CODCOLIGADA

Company

<Valor da Empresa RM>

Valor Chave Primária RM

<Valor CODCOLIGADA>

Branch

<Valor da Coligada RM>

Sistema Integrado

PROTHEUS

Emp. Protheus

<Empresa do Protheus>

Valor Chave Integração

< Valor recebido pelo InternalId >

Fil.Protheus

<Filial do Protheus>

 


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.

 


Identificador da Mensagem: BANK

...

Módulo Protheus: SIGAFIN

Tipo de Envio: Síncrono.

Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

Code

SA6010

A6_CODE

GBANCO

NUMBANCO

Name

SA6010

A6_NOME

GBANCO

NOME

ShortName

SA6010

A6_NREDUZ

GBANCO

NOMEREDUZIDO

Febraban

SA6010

A6_NUMBCO

GBANCO

NUMEROOFICIAL

Code

SA6010

A6_CODE

GAGENCIA

NUMBANCO

Agency/Number

SA6010

A6_AGENCIA

GAGENCIA

NUMAGENCIA

Address/Number

 

 



GAGENCIA

NUMERO

Address/Complement

SA6010

A6_END

GAGENCIA

COMPLEMENTO

Address/City/Description

SA6010

A6_MUN

GAGENCIA

CIDADE

Address/State/Code

SA6010

A6_EST

GAGENCIA

ESTADO

Address/District

SA6010

A6_BAIRRO

GAGENCIA

BAIRRO

Address/ZIPCode

SA6010

A6_CEP

GAGENCIA

CEP

ContactInformation/ CommunicationInformation/PhoneNumber

SA6010

A6_TEL

GAGENCIA

TELEFONE

Account/Number

 

 



FCONTA

NROCONTA

CompanyId

 

 



FCONTA

CODCOLIGADA

CompanyId

 

 



FCXA

CODCOLIGADA

Account/Number

 

 



FCXA

CODCXA

-

 


concat('Conta Caixa - ',Number)

FCXA

DESCRICAO

CompanyId

 

 



FCXA

CODCOLPROP

CompanyId

 

 

FCXA

CODCOLCONTA



FCXA

CODCOLCONTA

Protheus:

Image Added

RM:

Image Added Image Added

Image Added 


Centro de Custo

...

Módulo Protheus: SIGACTB

Tipo de Envio: Síncrono.

Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

CompanyId

CTT

 


GCCUSTO

CODCOLIGADA

CompanyInternalId

CTT

Empresa

-

-

BranchId

CTT

CTT_FILIAL

-

-

Code

CTT

CTT_CUSTO

GCCUSTO

CODCCUSTO

InternalId

CTT

Empresa/CTT_FILIAL/CTT_CUSTO

 


IDINTEGRACAO

RegisterSituation

CTT

CTT_BLOQ

GCCUSTO

ATIVO

Name

CTT

CTT_DESC01

GCCUSTO

NOME

ShortCode

CTT

CTT_RES

GCCUSTO

CODREDUZIDO

SPED

 


-

GCCUSTO

ENVIASPED

Class

CTT

CTT_CLASSE

GCCUSTO

PERMITELANCAMENTO

 


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.

...

Após cadastrar os centros de custos, acessar o RMSaude.exe / Opções / Parâmetros / Funções Automáticas, cadastrar a função Importação de Centro de Custo, definir um período, salvar e em seguida clicar no botão Executa.

 


Moeda

As Moedas devem ser cadastrados somente no BackOffice Protheus através do SIGACTB (Atualizações / Cadastros / Moedas Contábeis) e serão sincronizados automaticamente para o RM.

...

Módulo Protheus: SIGACTB

Tipo de Envio: Síncrono.

...


Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

Code

CTO

CTO_MOEDA

-

-

InternalId

CTO

Empresa/ CTO_FILIAL/ CTO_MOEDA

HCINTEGRACAOID

IDINTEGRACAO

Description

CTO

CTO_DESC

GMOEDA

DESCRICAO

Symbol

CTO

CTO_SIMB

GMOEDA

SIMBOLO

DecimalPlaces

CTO

CTO_DECIM

GMOEDA

NUMCASASDECIMAIS

 


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:


 

Empresa

Moeda

Descrição

Símbolo

 Casas Decimais

01

01

Moeda 01

 2

02

01

Moeda 02

 2

03

01

Moeda 03

 2

 


O de/para no RM ficará:


 

Tabela RM

Chave RM

Valor Chave RM

Sistema Integrado

 Chave Integração

GMOEDA

SIMBOLO

Protheus

 01/ /01

GMOEDA

SIMBOLO

Protheus

 02/ /01

GMOEDA

SIMBOLO

Protheus

 03/ /01

 


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:


 

Empresa

Moeda

Descrição

Símbolo

 Casas Decimais

01

02

Moeda 02

 2

 


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:

...


Empresa

Moeda

Descrição

Símbolo

 Casas Decimais

02

01

Moeda 01 alterada

 4

 


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.serão alteradas.

Protheus:

Image Added


RM:

Image Added

Cliente/Fornecedor

...

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

...


Identificador da Mensagem: CUSTOMERVENDOR

...

Módulo Protheus: SIGAFAT e SIGAFIN

Tipo de Envio: Síncrono

Mensagem Padrão

 

PROTHEUS - Cliente

PROTHEUS - Fornecedor

RM

Tabela

Campo

Tabela

Campo

Tabela

Campo

CompanyId

SA1

Empresa

SA2

Empresa

FCFO

CODCOLIGADA

BranchId

SA1

A1_FILIAL

SA2

A2_FILIAL

-

-

CompanyInternalId

SA1

Empresa/A1_FILIAL

SA2

Empresa/ A2_FILIAL

-

-

Code

SA1

A1_COD

SA2

A2_COD

FCFO

CODCFO

InternalId

SA1

Empresa/A1_FILIAL /A1_COD

SA2

Empresa/ A2_FILIAL/A2_COD

HCINTEGRACAOID

 


ShortName

SA1

A1_NREDUZ

SA2

A2_NREDUZ

FCFO

NOMEFANTASIA

Name

SA1

A1_NOME

SA2

A2_NOME

FCFO

NOME

Type

SA1

Customer

SA2

Vendor

FCFO

PAGREC

EntityType

SA1

A1_TIPO

SA2

A2_TIPO

FCFO

PESSOAFISOUJUR

RegisterDate

SA1

RegisterDate

 

 

 

 





RegisterSituation

SA1

A1_MSBLQL

SA2

A2_MSBLQL

FCFO

ATIVO

GovernmentalInformation.Id Name=CNPJ

SA1

A1_CGC

SA2

A2_CGC

FCFO

CGCCFO

Address.Address

SA1

A2_END

SA2

A2_END

FCFO

RUA

Address.Number

SA1

A2_END

SA2

A2_END

FCFO

NUMERO

Address.Complement

SA1

A1_COMPLEM

SA2

A2_COMPLEM

FCFO

COMPLEMENTO

Address.City.CityCode

SA1

A1_EST+A1_COD_MUN

SA2

A2_COD_MUN

FCFO

CODMUNICIPIO

Address.City.CityDescription

SA1

A1_MUN

SA2

A2_MUN

FCFO

CIDADE

Address.District

SA1

A1_BAIRRO

SA2

A2_BAIRRO

FCFO

BAIRRO

Address.State.StateCode

SA1

A1_EST

SA2

A2_EST

FCFO

CODETD

Address.State.StateDescription

SA1

X5DESCRI

SA2

X5DESCRI

FCFO

DESCETD

Address.Country.CountryCode

SA1

A1_PAIS

SA2

A2_PAIS

FCFO

CODPAIS

Address.Country.CountryDescription

SA1

 


SA2

 


FCFO

PAIS

Address.ZIPCode

SA1

A1_CEP

SA2

A2_CEP

FCFO

CEP

Address.POBox

SA1

A1_CX_POST

SA2

A2_CX_POST

FCFO

CAIXAPOSTAL

ListOfCommunicationInformation.CommunicationInformation.PhoneNumber

SA1

A1_TEL

SA2

A2_TEL

FCFO

TELEFONE

ListOfCommunicationInformation.CommunicationInformation.FaxNumber

SA1

A1_FAX

SA2

A2_FAX

FCFO

FAX

ListOfCommunicationInformation.CommunicationInformation.Email

SA1

A1_EMAIL

SA2

A2_EMAIL

FCFO

EMAIL

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 através da fórmula visual Integração de cliente/fornecedor, o . O mesmo é gerado um fornecedor no Protheus.
  • Ao cadastrar um convênio é gerado um cliente no RM e sincronizado com o Protheus através da fórmula visual Integração de cliente/fornecedor, o .  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.

Protheus:


Grupo de Estoque

Este cadastro no RM é tratado como uma tabela de classificação, TTB1 e sincronizado do RM para o Protheus. 


Identificador da Mensagem: FAMILY

...

Módulo Protheus: SIGAEST

Tipo de Envio: Síncrono

...


Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

CompanyId

SBM010

Empresa

-

CODCOLIGADA

Code

SBM010

BM_GRUPO

TTB1

CODTB1FAT

InternalId

SBM010

Empresa/ BM_GRUPO

HCINTEGRACAOID

CODCOLIGADA/ CODTB1FAT

Description

SBM010

BM_DESC

TTB1

DESCRICAO

WarehouseCode

 


-

TTB1

-

UnitOfMeasureCode

 


-

TTB1

-

FamilyClassificationCode

 


-

TTB1

-

 

 



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.

Deve-se definir a máscara deste cadastro para ser compatível com o cadastro no Protheus.

RM:

Image Added

Protheus:

Image Added

Produto/Serviço

Os Produtos e Serviços devem ser cadastrados somente no RM e serão sincronizados automaticamente para o Protheus; ou configurados para ter origem no Protheus e sincronizados com o RM. Isso depende da configuração do Adapter no Protheus.

 


Identificador da Mensagem: ITEM

...

Módulo Protheus: SIGAEST

Tipo de Envio: Síncrono.

...


Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

CompanyId

SB1

Empresa

TPRODUTO

CODCOLPRD

TPRODUTODEF

CODCOLIGADA

BranchId

SB1

B1_FILIAL

-

-

CompanyInternalId

SB1

Empresa/B1_FILIAL

-

-

Code

SB1

B1_COD

TPRODUTO

CODIGOPRD

InternalId

SB1

Empresa/B1_FILIAL/ B1_COD

HCINTEGRACAOID

IDINTEGRACAO

Name

SB1

B1_DESC

TPRODUTO

DESCRICAO

ShortName

SB1

B1_DESC

TPRODUTO

NOMEFANTASIA

Active

SB1

B1_ATIVO

TPRODUTO

INATIVO

UnitOfMeasureInternalId

SB1

Empresa/SAH_FILIAL/B1_UM

TPRODUTODEF

CODUNDCONTROLE

CODUNDCOMPRA

CODUNDVENDA

DeployDate

-

-

TPRODUTO

DTCADASTRAMENTO

NetWeight

SB1

B1_PESO

TPRODUTO

PESOLIQUIDO

GrossWeight

SB1

B1_PESBRU

TPRODUTO

PESOBRUTO

Origin

SB1

B1_ORIGEM

TPRODUTO

REFERENCIACP

Values.CostPrice

SB1

BZ_UPRC ou B1_UPRC

TPRODUTODEF

PRECO1

Values.SalesPrice

SB1

B1_PRV1

TPRODUTODEF

PRECO2

Values.AverageCostPrice

SB2

B2_CM1

TPRODUTODEF

CUSTOMEDIO

Values.StandardCostPrice

SB1

BZ_CUSTD ou B1_CUSTD

TPRODUTODEF

CUSTOUNITARIO

Values.BaseDate

SB1

BZ_UCALSTD ou B1_UCALSTD

TPRODUTODEF

DATABASEPRECO1

ProductType

SB1

B1_TIPO

TPRODUTO

TIPO

SecondUnitOfMeasureInternalId

SB1

Empresa/AH_FILIAL/B1_SEGUM

HCUNDCONV

CODUNDSEG

MultiplicationFactorValue

SB1

B1_CONV

HCUNDCONV

FATOR

 

...

FATOR



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.

...

Produto Global: Ao receber a mensagem única como produto global, o RM irá verificar via Eventos se nos parâmetros de produto está configurado para utilizar Produto Global, se estiver, será ignorado o código da coligada (CompanyId) enviado pelo Protheus e será gravado com o código 0 (zero). As configurações de Produto Global no Protheus e no RM ficarão a cargo do implantador.

Protheus:

Image Added

RM:

Image Added Image Added

Image Added

Condição de pagamento

As Condições de Pagamentos devem ser cadastradas somente no BackOffice Protheus através do SIGACOM (Atualizações / Cadastros / Cond. de Pagamento) e serão sincronizados automaticamente para o RM.

...

Módulo Protheus: SIGACOM

Tipo de Envio: Síncrono

 



 

Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

CompanyId

SE4

Empresa

TCPG

CODCOLIGADA

BranchId

SE4

E4_FILIAL

-

-

CompanyInternalId

SE4

Empresa/E4_FILIAL

-

-

Code

SE4

E4_CODIGO

TCPG

CODCPG

InternalId

SE4

Empresa/E4_FILIAL /E4_CODIGO

HCINTEGRACAOID

IDINTEGRACAO

Description

SE4

E4_DESCRI

TCPG

NOME

DayFirstDue

SE4

Ver Tópico 6.1.7.2

TCPG

PRAZO1

QuantityPlots

SE4

 


TCPG

QUANTASVEZES1

RangePlots

SE4

 


TCPG

PERIODOEMDIAS1

WeekDayFixed

SE4

 


TCPG

DIASVENCSEMANA

DaysCondition

-

-

TCPG

TIPO1

 

...

Protheus:

Image Added

RM

Image Added Image Added


Unidade de medida

As Unidades de Medidas devem ser cadastradas somente no BackOffice Protheus através do SIGAQIE (Atualizações / Cadastros / Unidades Medida) e serão sincronizados automaticamente para o RM. 


Identificador da Mensagem: UNITOFMEASURE

...

Módulo Protheus: SIGAQIE

Tipo de Envio: Síncrono

...


Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

Code

SAH

AH_UNIMED

TUND

CODUND

InternalId

SAH

Empresa/AH_FILIAL/ AH_UNIMED

HCINTEGRACAOID

IDINTEGRACAO

Description

SAH

AH_DESCPO

TUND

DESCRICAO

 

 

 




TUND

CODUNDBASE

 

 

 




TUND

FATORCONVERSAO

 


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 



 

Mensagem Padrão

PROTHEUS

RM

Tabela

Campo

Tabela

Campo

CompanyId

NNR

Empresa

TLOC

CODCOLIGADA

BranchId

NNR

NNR_FILIAL

-

-

CompanyInternalId

NNR

Empresa/NNR_FILIAL

TLOC

CODFILIAL

Code

NNR

NNR_CODIGO

TLOC

CODLOC

InternalId

NNR

Empresa/NNR_FILIAL/NNR_CODIGO

TLOC

CODCOLIGADA/CODFILIAL/CODLOC

Description

NNR

NNR_DESCRI

TLOC

NOME

Active

 

 



TLOC

INATIVO (0 – ATIVO, 1 – INATIVO)

 

 



Processos

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

...

O título a pagar se refere aos repasses que o hospital deve pagar ao médico. Após serem liberados para pagamento, o usuário deverá clicar no botão Gerar título a pagar no Protheus para que o processo seja disparado. O processo de geração do movimento no Nucleus foi mantido. Após a inclusão do movimento é enviado para o Protheus a mensagem ACCOUNTPAYABLEDOCUMENT com os dados do prestador, valor a ser pago, data de emissão, vencimento. A série do documento gerado será o parâmetro SERIEDOCFOLHAPAGTO e o tipo de documento será o conteúdo do parâmetro TIPODOCFOLHAPAGTO. Caso seja necessário cancelar a folha, basta clicar no botão Retornar para correção que o título será excluído do Protheus.

 


Título a receber

Tipo de Fluxo: RM è Protheus

...

A série do documento gerado será o parâmetro SERIEDOCMOVFATURA e o tipo de documento será o conteúdo do parâmetro TIPODOCMOVFATURA. Caso seja necessário cancelar o movimento de fatura, basta clicar no botão Exclui Movimento de Fatura que o título será excluído do Protheus.

 


Baixa de títulos

Tipo de Fluxo: RM è Protheus

...

A baixa de títulos é realizada nas faturas dos convênios. Após gerado o movimento de fatura e consequentemente gerado no Protheus o título a receber, basta acessar o menu Tesouraria/Controle de Recebimentos, página inferior Fatura, subpágina Fatura. Informe a competência, o convênio e a unidade de faturamento e clique no botão Pesquisar. Selecione a fatura desejada, clique na subpágina Recebimentos e inclua o valor recebido. Neste momento é solicitada a conta-caixa deste recebimento e a baixa será efetuada no Protheus.

 


Cancelamento de Baixa de títulos

...

O cancelamento de baixa de títulos deve ser realizado quando o valor informado está incorreto ou algum outro motivo que leve a exclusão do recebimento. Feito isso, a baixa associada será excluída no Protheus.

 


 


Inventário

Tipo de Fluxo: Protheus è RM

...

O inventário é realizado no Protheus e sincronizado com o RM apenas para manter o histórico de movimentações dos produtos, assim como a geração dos códigos de barras para os diversos lotes. 


Nota fical de entrada

Tipo de Fluxo: Protheus è RM

...

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 Hospitalar consiga atualizar os preços dos itens e gerar os códigos de barras dos itens.

 


Pedido de venda

Tipo de Fluxo: RM è Protheus

...

Para a fatura, acesse o menu Faturamento /Geração de Movimento de fatura. Clicar no botão Gera Movimento de fatura e informar a condição de pagamento para este pedido. No caso da fatura são utilizadas duas mensagens, a Order para o pedido de venda e a ACCOUNTRECEIVABLEDOCUMENT para o título a receber.

 


Saldo em estoque

Tipo de Fluxo: RM è Protheus

...

Esta mensagem é utilizada para se consultar o saldo no BackOffice Protheus. São enviados o produto e o local de estoque e retornam o saldo por lote e validade que serão exibidos na tela de movimentação de estoque e impressão de etiquetas de códigos de barras. 


 


1.1.8.    Movimentação de estoque

 


Tipo de Fluxo: RM è Protheus e Protheus è RM

Mensagem: STOCKTURNOVER

Versão: 1.003 


Esta mensagem é utilizada em toda movimentação que envolve mudança de saldo no estoque. Tanto as movimentações do lado do RM quanto do lado do Protheus refletirão em ambos os sistemas. No lado do RM seria apenas como histórico, já no Protheus ocorre a alteração no saldo e suas respectivas alterações financeiras e fiscais. Esta mensagem envolve requisição para paciente, devolução de paciente, requisição para centro de custo, devolução de centro de custo, folha de sala, requisição para o CME

...


 

 



Devolução

 

 


Transferência

Tipo de Fluxo: RM è Protheus e Protheus è RM

...

Esta mensagem é utilizada para refletir as transferências de produtos entre locais de estoque.

 


Restrições:

No RM, um movimento de transferência, os itens só podem ser transferidos entre dois locais de estoque, ou seja, os locais são definidos no movimento. Já no Protheus, é possível definir para cada item o local de origem e o de destino. Com isso, com a integração ativa, no Protheus deve-se realizar as transferências apenas com os mesmos locais de estoque para todos os itens.

 


Checklist de suporte da aplicação

...

  • Verificar em RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / Integrações se a integração ID = 1011 está com Status = ‘Ativo’.
  • Verificar se existe as fórmulas visuais ativas.

...


Checklist de Verificações:

...

  • Verifique se os Parâmetros estão configurados corretamente com o endereço de IP e Porta do Server Destino que receberá a Mensagem ou a Configuração do Adapter ou seu Appserver.INI
  • Outras Informações.

...