Histórico da Página
...
Utilizar a versão 11.82.36 (específica).
A TOTVS disponibiliza um backup da base de dados RM "vazia" que pode ser utilizada para novos clientes. Para clientes que já possuem versão anterior utilizar o Conversor RM para atualizar o banco de dados para a versão 11.82.
Instalação/Atualização
Esse documento não visa a descrição dos procedimentos de instalação do Protheus padrão e suas configurações. Neste documento serão apresentadas informações referentes ao EAI da Linha Protheus, que é o responsável pela comunicação com o TOTVS Hospitalar.
...
Dados da mensagem trocada entre o RM e o Protheus
Detalhes da execução da mensagem. O campo Mensagem transformada corresponde ao xml que foi enviado para o outro EAI e o campo Mensagem de resposta corresponde ao xml que o outro EAI retornou mediante ao xml recebido.
Âncora | ||||
---|---|---|---|---|
|
...
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.
...
Cliente/Fornecedor
Os Fornecedores devem ser cadastrados somente no BackOffice Protheus através do SIGAFIN (Atualizações / Cadastros / Fornecedor).
O sincronismo de Cliente e Fornecedor será de forma automática para o RM utilizando a mesma estrutura de mensagem. O que os difere é a Tag <EntityType>.
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
Versão: 2.002
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento /Cadastros / Financeiro / Clientes/Fornecedores
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 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 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.
...
...
Família de Materiais
Este cadastro no RM é tratado como uma tabela de classificação, TTB1 e sincronizado do RM para o Protheus.
Identificador da Mensagem: FAMILY
Versão: 2.000
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento/Cadastros/Tabelas de classificação
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.
...
Produto/Serviço
Os Produtos e Serviços devem ser cadastrados somente no RM e serão sincronizados automaticamente para o Protheus.
Identificador da Mensagem: ITEM
Versão: 2.001
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento /Cadastros / Produtos
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 |
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.
As configurações inicias da integração irá alterar a máscara do Código do Produto para "QQQQQQQQQQQQQQQ" que permite 15 caracteres de qualquer tipo.
A primeira unidade de medida do Protheus será gravada em todas unidades de medida (Controle, Compra e Venda) do Produto no RM.
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.
...
...
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.
Identificador da Mensagem: PAYMENTCONDITION
Versão: 2.000
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento/Cadastros/Tabelas auxiliares / Condições de pagamento
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 |
...
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
Versão: 2.000
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento /Cadastros / Tabelas auxiliares / Unidade
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 |
...
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:
...
A seguir serão descritos os processos do TOTVS Hospitalar integrados diretamente com o BackOffice Protheus.
...
...
Título a pagar
Tipo de Fluxo: RM Protheus
Mensagem: ACCOUNTPAYABLEDOCUMENT
Versão: 2.000
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
Mensagem: ACCOUNTRECEIVABLEDOCUMENT
Versão: 3.000
O título a receber é gerado para as faturas de convênios. Além do título a receber é gerando em conjunto o pedido de venda. Este processo é executando no menu Faturamento -> Geração de Movimento de fatura.
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 Fatur que o título será excluído do Protheus.
...
Baixa de títulos
Tipo de Fluxo: RM Protheus
Mensagem: ACCOUNTRECEIVABLEDOCUMENTDISCHARGE
Versão: 2.000
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.
...
Tipo de Fluxo: RM Protheus
Mensagem: REVERSALOFACCOUNTRECEIVABLEDOCUMENTDISCHARGE
Versão: 2.000
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
Mensagem: INVENTORY
Versão: 1.000
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
Mensagem: INVOICE
Versão: 3.001
A nota fiscal de entrada de produtos é realizada no Protheus e sincronizada com o 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
Mensagem: ORDER
Versão: 3.002
O pedido de venda se refere à fatura gerada para os convênios e ao pedido de emissão de nota fiscal para o paciente.
Após encerrada a conta do paciente e esta possuir gastos particulares, o usuário acessará o TOTVS 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.
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
Mensagem: STOCKLEVEL
Versão: 1.000
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.
Âncora
...
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
Âncora | ||||
---|---|---|---|---|
|
Devolução
...
Transferência
Tipo de Fluxo: RM Protheus e Protheus RM
Mensagem: TRANSFERWAREHOUSE
Versão: 1.001
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
Instalação/Configuração
Protheus:
Verificar no AppServer.INI está configurado ambiente correto, Filial, ou se a chamada do Scheduler foi configurado.
Verificar no Adapter se a Rotina está cadastrada e se constam todas as informações corretas como: Nome correto do XSD, se Envia está como SIM, se o Serviço está como EAI.
Verificar se no Scheduler foi cadastrado o Agent e se o Ambiente está o mesmo do AppServer.INI e o Agendamento se na Rotina está FWEAI, e a Filial a que você está Logado .
Verifique os Parâmetros, MV_EAIMETH, MV_EAIWS , MV_EAIURL2, MV_EAIUSER, MV_EAIPASS
Verifique o Firewall (desabilite-o).
RM:
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:
Relacione itens de verificações para que o atendente possa:
- Identificar o funcionamento da integração.
Protheus:
- Para verificar se a integração está funcionando, entre no Scheduler e em EAI, clique na última linha de histórico de Transações, clique nele e clique na Lupa da mesma tela, abrirá no Browser um arquivo XML com todas as informações que você cadastrou na Tela, verifique se aparece a Data a Hora e Inicio de Processamento e Fim de Processamento, sem nenhuma mensagem de Erro no meio destas informações.
...
- Verificar se na fila de mensagem única existem registros.
- Verificar no menu de Integrações se a integração ID=1011 está com status = 'Ativo'.
- Verificar se foram importadas as Fórmulas Visuais para esta integração.
...
- Identificar a ocorrências de problemas
Protheus:
- Procure no histórico se tem alguma linha com mensagem de Erro.
...
- Verificar se na fila de mensagem única existem registros com Status de Execução = "Error".
...
- Coletar evidências do mau funcionamento relatado pelo cliente.
Protheus:
- Tivemos o problema do Firewall estar bloqueando a entrega da mensagem, tivemos que desligar para funcionar.
- O Servidor de Entrega da Mensagem tem Usuário e Senha que devem ser logados para receber a Mensagem: para isto cadastre nos parâmetros já informados na Instalação, MV_EAIUSER e MV_EAIPASS e preencher com os dados do Login e Senha.
- Host do Destinatário ter caído.
- Confirmar Endereço IP e Porta do Destinatário e verificar se está correto no parâmetro MV_EAIURL2.
...
- O web.config (tags DBAlias e Port) do WebSerivce deve possuir o mesmo nome do Alias e a mesma Porta usadas na aplicação RM.exe.
...
- Realizar possíveis ajustes na integração quanto à configuração ou negócio.
Protheus:
- 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.
...