Histórico da Página
Integração Backoffice Protheus x TOTVS Hospitalar
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.
...
- Acesse RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / De-Para.
- Inclua o registro de correspondência entre os códigos das empresas do Protheus com as coligadas do RM conforme imagem.
- 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 |
- 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.
- 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.
...
- Acesse RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / Fila de mensagens únicas.
- Nesta tela serão registradas as informações de envio e recebimento de mensagens XML trafegadas pela integração.
- 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.
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:
RM:
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.
Protheus:
RM:
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 |
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:
Protheus:
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:
RM:
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:
RM
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.
...