Histórico da Página
...
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
Versão: 2.000
Módulo RM: BackOffice – Gestão Contábil
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 |
Centro de Custo
Os Centros de Custos devem ser cadastrados somente no BackOffice Protheus através do SIGACTB (Atualizações / Entidades / Custos) e serão sincronizados automaticamente para o RM.
Identificador da Mensagem: COSTCENTER
Versão: 2.000
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento /Cadastros / 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.
A tag <SPED> da mensagem única é do tipo boolean (true/false) que será gravado no campo “SPED” do RM os valores “T” para true e “F” para false.
A tag <RegisterSituation> da mensagem única é um Enumerado (Active/Inactive) que será gravado no campo “ATIVO” os valores “T” para Active e “F” para Inactive.
A tag <Class> será gravada no campo “PERMITELANCAMENTO”. Quando o valor da tag for 1 (Sintético) será gravado 0, se o valor da tag for 2 (Analítico) será gravado 1.
Importante:
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.
Não é permitido alterar o símbolo de uma moeda já cadastrada.
Identificador da Mensagem: CURRENCY
Versão: 2.000
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento /Cadastros / Financeiro / Moedas e Índices
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.
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.
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
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 |
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
No RM deve ser informada uma Unidade Base, porém não temos esta informação no Protheus, desta forma, este campo será preenchido com o valor do campo <Code>.
O campo “FATORCONVERSAO” receberá sempre o valor 1, pois a Unidade Base será sempre o mesmo código da Unidade Principal.
Local de Estoque
Os Locais de Estoque devem ser cadastrados somente no BackOffice Protheus no SIGACOM (Atualizações / Cadastros / Locais de Estoque) e sincronizados automaticamente para o RM através de mensagem única.
Identificador da Mensagem: WAREHOUSE
Versão: 1.000
Módulo RM: BackOffice – Gestão de Estoque, Compras e Faturamento /Cadastros / Local de Estoque
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:
- RM / Protheus: O RM irá consumir um WebService do EAI Protheus para envio da(s) mensagem(s) e o Protheus irá retornar uma mensagem com o status do processamento, após a resposta do Protheus, o RM atualizará o registro no Monitor da Fila de Integração.
- Protheus / RM: O Protheus irá consumir um WebService do EAI RM para envio da(s) mensagem(s) e o RM irá retornar uma mensagem com o status do processamento.
A seguir serão descritos os processos do TOTVS Hospitalar integrados diretamente com o BackOffice Protheus.
Título a pagar
Tipo de Fluxo: RM e 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.