Escolar Documentos
Profissional Documentos
Cultura Documentos
Outubro/2014
Ttulo do documento
Sumrio
1.
2.
3.
Integrao .................................................................................................................................................. 3
4.
Escopo ....................................................................................................................................................... 4
5.
5.1.
Protheus ..................................................................................................................................................... 5
5.2.
RM .............................................................................................................................................................. 5
6.
Instalao/Atualizao ............................................................................................................................... 6
6.1.
Protheus ..................................................................................................................................................... 6
6.2.
RM .............................................................................................................................................................. 9
7.
8.
Suporte ....................................................................................................................................................... 17
9.
10.
12.
13.
14.
Anexos ....................................................................................................................................................... 49
Verso 4.0
2. Sistemas Envolvidos
RM Labore
3. Integrao
Envio de Lanamentos Financeiros (Contas a Pagar) do RM Labore para o Protheus, mdulo Financeiro.
Verso 22.0
Ttulo do documento
4. Escopo
Essa integrao visa a utilizao do BackOffice Protheus para fazer a contabilizao e o RM Labore para o clculo da folha de
pagamento. Para tais fins, os seguintes itens fazem parte do escopo:
Envio de incluso, alterao e excluso de Fornecedor do Protheus, mdulo Financeiro, para o RM Labore.
Envio de incluso, alterao e excluso de Centro de Custo do Protheus, mdulo Contabilidade Gerencial, para o RM
Labore.
Envio de incluso, alterao e excluso de Banco do Protheus, mdulo Financeiro, para o RM Labore.
Envio de incluso, alterao e excluso de Plano de Contas do Protheus, mdulo Contabilidade Gerencial, para o RM
Labore.
Envio de incluso, alterao e excluso de Perodo Contbil do Protheus, mdulo Contabilidade Gerencial, para o RM
Labore.
Envio de incluso, alterao e excluso de Lanamento Contbil do RM Labore para o Protheus, mdulo
Contabilidade Gerencial.
Envio de incluso, alterao e excluso de Lanamento Financeiro (Contas a Pagar) do RM Labore para o Protheus,
mdulo Financeiro.
Verso 4.0
5. Pr-requisitos instalao/implantao/utilizao
5.1.
5.2.
Protheus
RM
Verso 22.0
Ttulo do documento
Importante!
responsabilidade da equipe de implantao executar a carga inicial e/ou sincronismo dos cadastros, para os clientes que j
possuem bases de dados dos produtos TOTVS implantadas. A integrao realiza o sincronismo automtico dos novos
registros ou das alteraes posteriores aps sua ativao.
6. Instalao/Atualizao
6.1.
Protheus
Acessar SigaCFG > Ambiente > Cadastros > Parmetros e configurar o parmetro MV_EAIURL2 com o endereo do
servio de EAI do ambiente ao qual o Protheus ser integrado.
Exemplo: http://12.50.90.211:81/MensagemUnicaWS.
Acessar SigaCFG > Ambiente > Cadastros > Parmetros e configurar o parmetro MV_EAIWS com o nome do
cliente WebService do EAI para envio a outro EAI. (WSEAISERVICE).
Caso o servidor necessite de autenticao, acessar SigaCFG > Ambiente > Cadastros > Parmetros e configurar o
parmetro MV_ EAIUSER com o nome de usurio.
Caso o servidor necessite de autenticao, acessar SigaCFG > Ambiente > Cadastros > Parmetros e configurar o
parmetro MV_ EAIPASS com a senha de usurio.
Acessar SigaCFG > Ambiente > Schedule > Adapter E.A.I. e realizar o cadastro das rotinas de integrao, conforme
segue:
Mensagem
nica
Rotina
Mensagem
Envia
Recebe
Mtodo
Operao
Canal
Verso
Sim
CTBA020
ACCOUNTANTACCOUNT
Sim
No
Sncrono
Todas
EAI
2.000
Sim
CTBA030
COSTCENTER
Sim
No
Sncrono
Todas
EAI
2.000
Sim
CTBA010
ACCOUNTINGCALENDAR
Sim
No
Sncrono
Todas
EAI
1.000
Sim
CTBA102
ACCOUNTINGENTRY
No
Sim
Sncrono
Todas
EAI
2.000
Sim
MATA020
CUSTOMERVENDOR
Sim
No
Sncrono
Todas
EAI
2.003
Sim
MATA070
BANK
Sim
No
Sncrono
Todas
EAI
2.000
Sim
FINA050
ACCOUNTPAYABLEDOCU
MENT
No
Sim
Sncrono
Todas
EAI
2.000
Caso alguma mensagem esteja configurada com o mtodo Assncrono, acessar SigaCFG > Ambiente > Schedule >
Schedule e configurar um agente e um agendamento, conforme segue abaixo:
Cadastrar agente.
Verso 4.0
Clicar no smbolo destacado no canto superior direito da tela, para o cadastro automtico dos agentes:
Cadastrar agendamento.
Clicar no smbolo destacado na parte inferior para adicionar um novo agendamento:
Preencher o campo Rotina com a rotina FWEAI e informar as empresas para as quais o agendamento ser vlido:
Definir a data e horrio para a execuo do agendamento e definir a recorrncia (clicando no smbolo destacado na
parte superior), conforme as necessidades existentes:
Verso 22.0
Ttulo do documento
Verso 4.0
6.2.
Iniciar os agentes:
RM
Verso 22.0
Ttulo do documento
Configurao da integrao
Acesse RM.exe | Segmento Integraes | Aba Integrao | Mensagem nica | Integraes. Esta interface permite incluir ou alterar
um pacote de integrao.
Selecione TOTVS Folha de pagamento Rm x BackOffice Protheus (Identificador = 1013) e clique em editar para alterar as
configuraes iniciais criadas pelo configurador.
Identificao
o NOME INTEGRAO: Este o nome completo da integrao. Trata-se de um campo meramente informativo.
o NOME REDUZIDO: Este o nome reduzido da integrao. Trata-se de um campo apenas informativo.
o SISTEMA INTEGRADO: Este um mnemnico que identifica a aplicao de origem e ser enviado no atributo
name da tag <Product> no XML trafegado.
Ex: PROTHEUS.
10
Verso 4.0
o
o
o
o
Mapeamento de Entidades
Aqui possvel fazer uma mapeamentos de cada entidade (cada mensagem nica) que faz parte do pacote de
integrao. O Wizard de Configurao far o mapeamento padro automaticamente. Alteraes s devem ser feitas com
critrio. Vale ressaltar que as alteraes realizadas precisam ser muito bem documentadas, pois a atualizao de verses
e reconfigurao da integrao pode substitu-las, para aplicar ajustes necessrios ou at mesmo melhorias.
Caso seja necessrio acrescentar uma entidade integrao que no esteja no pacote padro, clique em Anexos e
escolha Mapeamento de Entidades. Na tela que apresentada informe o cdigo ou nome da mensagem. Clique no
boto reticncias (...) para localizar a mensagem na lista de mensagens pr-cadastradas.
Verso 22.0
11
Ttulo do documento
12
Verso 4.0
Acesse RM.exe | segmento RH| aba Ambiente| Parmetros | Folha de pagamento. Nesse parametrizador sero registradas
informaes dos parmetros de integrao da folha RM com qualquer BackOffice de terceiros.
Importante: O documento em questo detalha a integrao da folha da RM com o BackOffice do Protheus.
Porm, a folha da RM est preparada para integrar com qualquer BackOffice. Para isso, basta desenvolver e mapear as
mensagens no EAI da RM.
Verso 22.0
13
Ttulo do documento
Usa integrao com outros BackOffice: Este parmetro deve ser marcado caso queira integrar a folha da RM com
outros BackOffice. Se o mesmo for desmarcado, a folha ser integrada com o BackOffice da RM.
Qtde. partidas contbeis enviadas por pacote contbil: Esse parmetro armazena a quantidade de partidas contbeis
que devem ser enviadas para os BackOffice. Esse parmetro foi criado devido a uma limitao da arquitetura do
Protheus em receber pacotes grandes de informaes nas suas mensagens.
Empresa e Filial
O primeiro cadastro que deve ser realizado para operao dos sistemas o de Empresa (Coligada) e suas Filiais. No RM
estas entidades so cadastros comuns, mas no Protheus a Empresa e as Filias so definidas em arquivos de
configurao de ambientes sendo parte da implantao do Protheus padro.
A maioria das mensagens de integrao far referncias ao cadastro de Empresa/Coligada.
Ex:
De-para RM (Empresa)
Tabela RM
Chave Primria RM
Valor Chave Primria
RM
Sistema Integrado
Valor Chave Integrao
GFILIAL
CODCOLIGADA|CODFILI
AL
1|2
PROTHEUS
10|113
Obs: Nas integraes com o Protheus, ser necessrio cadastrar manualmente na tabela de De/Para um mapeamento da
coligada para ela mesma (conforme exemplo abaixo). Esse cadastro necessrio para o correto funcionamento dos
cdigos de extensions criados nas integraes.
Ex:
De-para RM (Empresa)
Tabela RM
Chave Primria RM
Valor Chave Primria
RM
Sistema Integrado
Valor Chave Integrao
GCOLIGADA
CODCOLIGADA
1
PROTHEUS
1
Tipo de documento
Esse projeto no contempla o sincronismo automtico de tipos de documentos. Portanto, o cadastro dessas informaes
deve ser feito manualmente no RM e no Protheus e o cadastro dos de/para devem ser feitos manualmente em ambos
os lados.
A mensagem contendo dados de lanamentos financeiros far referncia aos tipos de documentos cadastrados.
De-para RM (Empresa)
Tabela RM
FTDO
14
Verso 4.0
Chave Primria RM
Valor Chave Primria
RM
Sistema Integrado
Valor Chave Integrao
CODCOLIGADA|CODTD
O
1|0001
PROTHEUS
10|1
Permisso de usurio
Lanamentos financeiros
Acesse RM.exe | segmento Globais| aba Segurana| Perfis.
Na edio de perfil, aba Acesso a Menus localize na rvore de tags o recurso em questo:
[Folha de Pagamento | Encargos | Financeiro | Lanamentos | Integrao financeira com outros BackOffice]. Atravs dessa
permisso, o usurio do perfil ter condies de executar o processo de envio de dados financeiros para o BackOffice de
terceiros.
Verso 22.0
15
Ttulo do documento
Lanamentos contbeis
Acesse RM.exe | segmento Globais| aba Segurana| Perfis.
Na edio de perfil, aba Acesso a Menus localize na rvore de tags o recurso em questo:
16
Verso 4.0
[Folha de Pagamento | Encargos | Contabilizao | Lanamentos| Lanamentos (RM Labore) | Integrao contbil com outros
BackOffice]. Atravs dessa permisso, o usurio do perfil ter condies de executar o processo de envio de dados contbeis
para o BackOffice de terceiros.
7. Controle de Verso
O grupo TOTVS representado por suas marcas ir administrar as demandas de evoluo dos layouts e demais ajustes, acordando
junto aos solicitantes o prazo de liberao de release.
Todas as evolues programadas devero ser discutidas e aprovadas pelas marcas antes do incio do desenvolvimento e
somente sero desenvolvidas em caso de concordncia das marcas e alinhamento com as diretivas definidas pelo Comit de
Integrao TOTVS.
8. Suporte
O suporte aos recursos da Integrao ser de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos
produtos RM Conector e Backoffice Protheus estaro aptas a fazer a primeira anlise e, quando necessrio, repassar para a
equipe mais adequada em cada caso.
Observao: Este modelo de suporte est sendo revisado pela TOTVS.
Verso 22.0
17
Ttulo do documento
9. Transaes/Entidades/Mensagens nicas
Mtodo
ID
Cadastros 01
02
03
04
05
06
07
08
Descrio
Centro de Custo
Fornecedor
Banco
Plano de Contas
Histrico Padro
Perodo Contbil
Lanamento Financeiro
Lanamento Contbil
Origem
Protheus
Protheus
Protheus
Protheus
Protheus
Protheus
RM
RM
Destino
RM
RM
RM
RM
RM
RM
Protheus
Protheus
10.1. Cadastros
Fornecedor
Identificador da Mensagem: CustomerVendor
Verso: 2.003
Mdulo RM: Financeiro Cadastro de Cliente/Fornecedor
Mdulo Protheus: SigaFIN - Financeiro
Tipo de Envio: Sncrono
Mensagem
Padro
Descrio
RM
Tabela
Campo
CompanyId
Cdigo da
empresa
FCFO
CODCOLIGA
DA
CompanyIntern
alId
InternalId da
empresa
FCFO
CODCOLIGA
DA
Code
Cdigo do
fornecedor
FCFO
CODCFO
PROTHEUS
Valor
Tabela
Campo
Valor
cEmpAnt
cEmpAnt|xFilial("
SA2")
SA2
18
A2_COD
Verso 4.0
StoreId
SA2
Loja
A2_LOJA
cEmpAnt|xFilial("S
InternalId
ShortName
Type
InternalId do
fornecedor
FCFO
Nome reduzido
FCFO
Tipo
CODCOLIGA
DA|CODCFO
XXF
NOMEFANTA
SIA
SA2
FCFO
PAGREC
EntityType
Tipo do registro
FCFO
PESSOAFISO
UJUR
RegisterSituatio
n
Situao
FCFO
ATIVO
GovernmentalI
nformation.Id
Name[CNPJ]
CNPJ/CPF
FCFO
CGCCFO
Address.Addre
ss
Nome da rua
FCFO
RUA
Address.Numb
er
Numero
FCFO
Address.Compl
ement
Complemento
Address.City.Ci
tyInternalId
XXF_INTVAL
A2_LOJA
[Se Type =
'Customer]
PagRec=1
Seno se Type =
'Vendor'
PagRec=2
Seno
PagRec = 3
[Se EntityType =
'Person]
PessoaFisOuJur=
F
Seno
PessoalFisOuJus=
J
[Se
RegisterSituation =
'Active]
Ativo=1
Seno
Ativo=0
[Se Id[Name]=
CPF] ou Id[Name]=
CNPJ]
CGCCFO=1
Seno
Ativo=0
A2_NREDUZ
SA2
A2_TIPO
SA2
A2_MSBLQL
SA2
A2_CGC
Address.Address
SA2
A2_END
NUMERO
Address.Number
SA2
A2_NR_END
FCFO
COMPLEMEN
TO
Address.Complem
ent
SA2
A2_COMPLEM
Cdigo do
municpio
FCFO
CODMUNICIP
IO
Address.City.CityI
nternalId
SA2
cCodEst +
A2_COD_MUN
Address.City.Ci
tyDescription
Nome cidade
FCFO
CIDADE
SA2
A2_MUN
Address.District
Bairro
FCFO
BAIRRO
SA2
A2_BAIRRO
Address.State.
StateInternalId
Codigo do
estado
FCFO
CODETD
SA2
A2_EST
Address.State.
StateDescriptio
Descrio do
estado
FCFO
DESCETD
SX5
X5_DESCRI
Verso 22.0
A2")| A2_COD|
19
'Person = F
Company = J
'Active = 2
Inactive = 1
Ttulo do documento
n
Address.Countr
y.CountryIntern
alId
Address.Countr
y.CountryDescr
iption
Codigo do pas
FCFO
CODPAIS
SA2
A2_PAIS
Nome do pas
FCFO
PAIS
SA2
A2_PAISDES
Address.ZIPCo
de
Cep
FCFO
CEP
SA2
A2_CEP
Address.POBo
x
Caixa postal
FCFO
CAIXAPOSTA
L
SA2
A2_CX_POST
SA2
A2_TEL
SA2
A2_FAX
SA2
A2_EMAIL
ListOfCommuni
cationInformati
on.Communicat
ionInformation.
PhoneNumber
Telefone
FCFO
TELEFONE
ListOfCommuni
cationInformati
on.Communicat
ionInformation.
FaxNumber
Fax
FCFO
FAX
ListOfCommuni
cationInformati
on.Communicat
ionInformation.
Email
FCFO
CommunicationInfor
mation[1]/PhoneNu
mber
[Primeira posio
na lista de telefones
da mensagem]
CommunicationInfor
mation[1]/FaxNumb
er
[Primeira posio
na lista de fax da
mensagem]
CommunicationInfor
mation[1]/E-mail
[Primeira posio
na lista de e-mail da
mensagem]
Notas:
Somente fornecedores devem ser enviados nessa integrao.
As configuraes iniciais desta integrao criar um parmetro chamado RH_CLIFORAUTOINC que ir definir se utiliza Auto
incremento ou no para o campo FCFO.CODCFO. Caso o parmetro no seja De auto incremento, a mscara do cdigo do
Cliente/Fornecedor deve ser configurada de acordo com a mscara do cliente/fornecedor enviada pelo Protheus:
Ex: QQQQQQQQ. [permite qualquer caractere limitado a 8 posies].
Caso o parmetro seja de auto incremento, a mscara deve ser definida como (vazio) e o parmetro do financeiro Usar cdigo
sequencial (se mscara for numrica) deve ser marcado.
20
Verso 4.0
Verso 22.0
21
Ttulo do documento
</City>
<District>Jardim America</District>
<State>
<StateInternalId>MG</StateInternalId>
<StateDescription>Minas Gerais</StateDescription>
</State>
<Country>
<CountryInternalId>Br</CountryInternalId>
<CountryDescription>Brasil</CountryDescription>
</Country>
<ZIPCode>30421386</ZIPCode>
<POBox>24533</POBox>
</Address>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage>
Centro de Custo
Identificador da Mensagem: CostCenter
Verso: 2.000
Mdulo RM: Contabilidade Cadastro de Centro de Custo
Mdulo Protheus: SigaCTB Contabilidade Gerencial
Tipo de Envio: Sncrono
Mensagem Padro
Descrio
RM
Tabela
Campo
Protheus
Valor
Tabela
Campo
Valor
cEmpAnt
CompanyId
Cdigo da empresa
GCCUSTO
CODCOLIGADA
Code
Cdigo do Centro
de Custo
GCCUSTO
CODCCUSTO
InternalId
Internal Id de
integrao
GCCUSTO
CODCOLIGADA
|CODCCUSTO
XXF
GCCUSTO
ATIVO
2-Active=
GCCUSTO.ATI
VO = A
1-Inactive
=GCCUSTO.AT
IVO= F
CTT
CTT_BLOQ
GCCUSTO
NOME
CTT
CTT_DESC01
GCCUSTO
CODREDUZID
O
CTT
CTT_RES
CTT
CTT_CUSTO
cEmpAnt|xFili
RegisterSituation
Situao:
'2'- 'Active';
'1'- 'Inactive'
Name
ShortCode
Cdigo do centro
de custo reduzido
22
XXF_INTVAL
al("CTT")|
CTT_CUSTO
'Active = 2
Inactive = 1
Verso 4.0
Notas:
As configuraes iniciais desta integrao criar um parmetro chamado RH_ CENTROCUSTOAUTOINC que ir definir se
utiliza Auto incremento ou no para o campo GCCUSTO.CODCCUSTO. Caso o parmetro no seja De auto incremento, a
mscara do cdigo do Centro de custo deve ser configurada de acordo com a mscara do centro/custo enviada pelo Protheus:
Ex: QQQQQQQQ. [permite qualquer caractere limitado a 8 posies].
Caso o parmetro seja De auto incremento, o Cdigo do Centro de Custo no RM ser gerado a partir da tabela GAUTOINC,
sempre ignorando o cdigo informado na mensagem nica. Nesse caso, o parmetro Mscara do Centro de Custo deve ser
preenchido como QQQQQQQ [qualquer caractere].
Verso 22.0
23
Ttulo do documento
Banco
Identificador da Mensagem: Bank
Verso: 2.000
Mdulo RM: Financeiro Cadastro de Banco
Mdulo RM: Financeiro Cadastro de Agncia
Mdulo RM: Financeiro Conta Corrente
Mdulo RM: Financeiro Conta Caixa
Mdulo Protheus: SigaFIN - Financeiro
Tipo de Envio: Sncrono
Mensagem
Padro
Code
Descrio
Nmero do banco
RM
Tabela
Campo
GBANCO
NUMBANCO
Protheus
Valor
Tabela
SA6
24
Campo
Valor
A6_COD
Verso 4.0
Febraban
Nmero do banco
oficial
FCONTA
NUMBANCO
FCXA
NUMBANCO
GBANCO
NUMEROOFICIA
L
SA6
A6_NUMBCO
cEmpAnt|xFilial(
InternalId
Internal Id de
integrao
GBANCO
CODCOLIGADA|
NUMBANCO
XXF
XXF_INTVAL
SA6)|A6_COD
|A6_AGENCIA|
A6_NUMCON
Name
Nome banco
GBANCO
NOME
SA6
A6_NOME
ShortName
Nome reduzido
GBANCO
NOMEREDUZID
O
SA6
A6_NREDUZ
GAGENCIA
NUMAGENCIA
FCONTA
NUMAGENCIA
SA6
A6_AGENCIA
FCXA
NUMAGENCIA
SA6
A6_NOMEAGE
Agency/Num
ber
Cdigo da
agncia
Concateno de :
Agencia: +
Agency/Number
Agency/Nam
e
Nome da agncia
GAGENCIA
NOME
Agency/Addr
ess/Number
Nmero do
endereo da
agncia
GAGENCIA
NUMERO
No se aplica.
Complemento
GAGENCIA
COMPLEMENTO
No se aplica.
Cidade
GAGENCIA
CIDADE
SA6
A6_MUN
Estado
GAGENCIA
ESTADO
SA6
A6_EST
Agency/Addr
ess/District
Bairro
GAGENCIA
BAIRRO
SA6
A6_BAIRRO
Agency/Addr
ess/ZIPCode
Cep
GAGENCIA
CEP
SA6
A6_CEP
Agency/Cont
actInformatio
n/
Comunication
Information/P
honeNumber
Telefone
GAGENCIA
TELEFONE
SA6
A6_TEL
Agency/
ListOfAccount
Empresa
FCONTA
CODCOLIGADA
Agency/Addr
ess/Complem
ent
Agency/Addr
ess/City/Desc
ription
Agency/Addr
ess/State/Co
de
Verso 22.0
25
cEmpAnt
Ttulo do documento
/Account
/CompanyId
Agency/
ListOfAccount
/Account/Nu
mber
Agency/
ListOfAccount
/Account/Na
me
Agency/
ListOfAccount
/Account
/CompanyId
Agency/
ListOfAccount
/Account
/CompanyId
Nmero da conta
caixa
FCXA
CODCOLIGADA
FCONTA
NROCONTA
FCXA
CODCXA
FCXA
NROCONTA
SA6
Concatenao de:
Conta Caixa ,
Number
Se o parmetro
CONTACAIXAA
UTOINC estiver
marcado,ento o
valor de
DESCRICAO
ser o seguinte:
Banco {0} Agncia {1} Conta {2} =
Nmero do
banco, Numero
da agencia,
Numero da conta
A6_NUMCON
Nome da conta
caixa
FCXA
DESCRICAO
Coligada global
FCXA
CODCOLPROP
cEmpAnt
Coligada global
da conta
FCXA
CODCOLCONTA
cEmpAnt
No se aplica.
Notas:
O Banco, Agncia, Conta Corrente e Conta Caixa devem ser cadastrados no BackOffice Protheus e sincronizados para o RM.
O BackOffice Protheus possui apenas uma tabela que contm todas as informaes Cdigo do Banco, Nome, Agncia, Conta,
entre outros.
Agncia um anexo da viso de Banco, assim como Conta Corrente um anexo da viso de Agncia. Na Linha RM so tabelas
independentes: Banco (GBANCO), Agncia (GAGENCIA), Conta Corrente (FCONTA) e Conta Caixa (FCXA). Com isso, a
excluso da entidade banco no Protheus, reflete na excluso de uma Conta caixa, conta, agencias e banco no Lado RM.
As configuraes iniciais desta integrao criar um parmetro chamado RH_ CONTACAIXAAUTOINC que ir definir:
Se desmarcado: O Cdigo da Conta / Caixa no RM ser sempre o nmero da conta bancria enviada na mensagem;
Se marcado: O Cdigo da conta caixa no RM ser um valor a partir da tabela GAUTOINC, sempre ignorando o nmero da conta
bancria enviada na mensagem nica.
26
Verso 4.0
Verso 22.0
27
Ttulo do documento
Natureza Financeira
Notas:
A mensagem nica FinancialNature _2_000 no ser utilizada nessa integrao. No RM a natureza financeira existe no rateio de
centro de custo do lanamento financeiro (FlanRatCCu.CODNATFINANCEIRA) e na mensagem padro a natureza financeira
existe no lanamento financeiro (AccountPayableDocument.FinancialNatureInternalId). Sendo assim, no temos esse valor para
enviar para o Protheus.
Ser criado um parmetro de integrao chamado RH_NATUREZAFINANCEIRADEFAULT que deve ser preenchido
manualmente com um valor de natureza financeira default a ser enviado para o Protheus na mensagem
AccountPayableDocument.FinancialNatureInternalId).
Moeda
Notas:
A mensagem padro Currency no ser utilizada nessa integrao. O RH da RM trabalha sempre com a moeda real R$.
Portanto, no ser enviado nenhum valor na mensagem AccountPayableDocument.CurrencyInternalId. O Protheus
automaticamente incluir o valor 1 (moeda corrente do pas) em caso de no envido da moeda.
Plano de Contas
Identificador da Mensagem: AccountantAccount
Verso: 2.000
Mdulo RM: Contabilidade Cadastro de Plano de Contas Contbil
Mdulo Protheus: SigaCTB Contabilidade Gerencial
Tipo de Envio: Sncrono
Mensagem
Padro
Descrio
RM
Tabela
Campo
Protheus
Valor
Tabela
Campo
valor
cEmpAnt
CompanyId
Empresa
CCONTA
CODCOLIGADA
CompanyIntern
alId
Internal Id da
empresa
CCONTA
CODCOLIGADA
No se aplica.
Code
Cdigo da
conta
CCONTA
CODCONTA
CT1
InternalId
Internal id da
conta
CCONTA
CODCOLIGADA|
CODCONTA
XXF
ShortCode
Cdigo
reduzido da
conta
CCONTA
REDUZIDO
CT1
CT1_RES
Description
Descrio da
conta
CCONTA
DESCRIO
CT1
CT1_DESC01
CT1_CONTA
cEmpAnt|xFilial(
XXF_INTVAL
"CT1")|CT1_CO
NTA
28
Verso 4.0
PostingNature
Natureza da
conta
CCONTA
NATUREZA
AnalyticalOrSyn
thetic
Analitica ou
sinttica
CCONTA
ANALITICA
ActiveOrInactiv
e
Ativo ou
inativo
CCONTA
INATIVA
-Valor 1 no
Protheus
equivale valor
1 na RM
(devedora)
-valor 2 no
Protheus
equivale Valor
0 na RM
(credora)
-Valor 1 no
Protheus
equivale valor
0 na RM
(analtica)
-valor 1 no
Protheus
equivale Valor
2 na RM
(sinttica)
-Valor 1 no
Protheus
equivale valor
1 na RM
(bloqueada)
-valor 2 no
Protheus
equivale Valor
0 na RM
(no bloqueada)
CT1
CT1_NORMAL
Devedora = 1
Credora = 2
CT1
CT1_CLASSE
Sinttita = 1
Analtica = 2
CT1
CT1_BLOQ
Inativa = 1
Ativa = 2
Notas:
Est disponvel no Rm um campo chamado NATSPED conforme print abaixo. Esse campo informa para o sped a natureza da
conta (se uma conta de ativo, passivo, patrimnio lquido, contas de resultado, contas de compensao). Esse campo no ser
transferido na mensagem pois o mesmo deve estar somente no BackOffice.
Porm, esse campo obrigatrio para incluso da conta contbil no RM. Sendo assim,iremos gravar o valor de valor 01 No
informado somente para permitir a gravao. O mesmo no ser utilizado pelo RM Labore.
Verso 22.0
29
Ttulo do documento
A mscara parametrizada da conta contbil no RM ser validada no processo de incluso da conta contbil. Portanto, o parmetro
de mscara contbil deve ser cadastrado de acordo com o formato do cdigo da conta a ser enviado pelo Protheus. Caso o
Protheus no envie mscara no seu cdigo de conta (ex: 1011214), ento o parmetro No utiliza mscara nas contas deve ser
marcado. Caso contrrio, ocorrer um erro no processo de incluso da conta.
30
Verso 4.0
Histrico Padro
Identificador da Mensagem: AccountantDefaultHistory
Verso: 1.000
Mdulo RM: Contabilidade Cadastro de Histrico Padro
Mdulo Protheus: No se aplica.
Tipo de Envio: Sncrono
Mensagem
Padro
Descrio
RM
Tabela
Campo
Protheus
Valor
Tabela
CompanyId
Empresa
CHISTP
CODCOLIGADA
No se aplica.
DefaultHistor
yCode
Cdigo do histrico
padro
CHISTP
CODHISTP
No se aplica.
InternalId
Id de integrao
CHISTP
CODCOLIGADA|
CODHISTP
No se aplica.
Description
Descrio
CHISTP
DESCRICAO
No se aplica.
Verso 22.0
31
Campo
Valor
Ttulo do documento
Notas:
No primeiro momento no ser implementada no lado do Protheus a sincronizao via mensagem nica das informaes de
histrico padro.
No lado RM, a rotina j est preparada para receb-la quando a mesma for implementada pela equipe Protheus.
Perodo Contbil
Identificador da Mensagem: AccountingCalender
Verso: 1.000
Mdulo RM: Contabilidade Parmetros
Mdulo Protheus: SigaCTB Contabilidade Gerencial
Tipo de Envio: Sncrono
Mensagem
Padro
Descrio
RM
Tabela
Campo
CompanyId
Empresa
CPARAM
CODCOLIGADA
CompanyInt
ernalId
Internal Id da
empresa
CPARAM
CODCOLIGADA
CalendarCo
de
Cdigo do
calendrio
Protheus
Valor
Tabela
Campo
Valor
cEmpAnt
cEmpAnt|cFilAn
CPARAM
CODCOLIGADA |24|25
InternalId
Id de integrao
CPARAM
CODCOLIGADA|24|25
InitialDate
Data inicial do
perodo contbil
CPARAM
FinalDate
Data final do
perodo contbil
CPARAM
ID = 24 (corresponde
a linha da
parametrizao da
dataInicio do perodo
contbil)
ID = 25 (corresponde
a linha da
parametrizao da
dataFIm do perodo
contbil)
ID = 24 (corresponde
a linha da
parametrizao da
dataInicio do perodo
contbil)
ID = 25 (corresponde
a linha da
parametrizao da
dataFIm do perodo
contbil)
CTG
CTG_CALEND
XXF
XXF_INTVAL
CODCOLIGADA|24
CTG
CTG_DTINI
CODCOLIGADA|25
CTG
CTG_DTFIM
cEmpAnt|xF
ilial("CTG")|
CTG_CALE
ND|CTG_E
XERC
Notas:
32
Verso 4.0
No processo de integrao, o lado RM atualizar as datas de perodo contbil sempre de acordo com a menor data inicial e a
maior data final enviada pelo Protheus. No Protheus, essas informaes so armazenadas em um cadastro, e no Rm essas
informaes so armazenadas nos parmetros, sendo assim, teremos espao para armazenar somente uma dataIncial e uma
dataFinal.
Lanamentos Financeiros
Identificador da Mensagem: AccountPayableDocument
Verso: 2.000
Mdulo RM: Financeiro Lanamentos Financeiros
Mdulo Protheus: SigaFIN - Financeiro
Tipo de Envio: Sncrono
Mensagem
Padro
Descrio
RM
Tabela
Protheus
Campo
Valor
Tabela
Campo
Valor
cEmpAnt|xFilial(
'SE2')|E2_PRE
FIXO|E2_NUM|
InternalId
Internal Id do
titulo
PFINANCEIRO
CODCOLIGADA|I
DFINANC
XXF
XXF_INTVAL
E2_PARCELA|
E2_TIPO|E2_F
ORNECE|E2_L
OJA
CompanyId
Empresa
PFINANCEIRO
CODCOLIGADA
cEmpAnt
CompanyInte
rnalId
Enteral Id da
coligada
PFINANCEIRO
CODCOLIGADA
cEmpAnt|xFili
al('SE2')
BranchId
Filial
PFINANCEIRO
CODFILIAL
xFilial('SE2')
DocumentNu
mber
Nmero do
ttulo
PFINANCEIRO
NUMERODOCU
MENTO
SE2
E2_NUM
DocumentTyp
eCode
Tipo do ttulo
PFINANCEIRO
CODCOLIGADA|
CODTDO
SE2
E2_TIPO
XXF
XXF_INTV
AL
E2_VENCTO
FinancialNatu
reInternalId
Natureza
financeira
PARAMETRO
DE
INTEGRAAO
Natureza
financeira
gravada no
parmetro
RH_NATUREZA
FINANCEIRADEF
AULT
DueDate
Data de
vencimento
PFINANCEIRO
DATAVENCIMEN
TO
SE2
RealDueDate
Data de
vencimento
PFINANCEIRO
DATAVENCIMEN
TO
SE2
Verso 22.0
33
FinancialNatur
eInternalId
E2_VENCRE
A
cEmpAnt|
xFilial("SED")|E
2_NATUREZ
Ttulo do documento
cEmpAnt|xFilial(
VendorIntern
alId
Internal Id do
fornecedor
PFINANCEIRO
CODCOLCFO|CO
DCFO
XXF
XXF_INTVAL
'SA2')|E2_FOR
NECE|E2_LOJ
A
NetValue
CurrencyInter
nalId
Apportionmen
tDistribution/
Apportionmen
t/ Value
Apportionmen
tDistribution/
Apportionmen
t/ Percentual
Apportionmen
tDistribution/
Apportionmen
t/
CostCenterInt
ernalId
Valor Orignal
PFINANCEIRO
VALORORIGINAL
SE2
E2_VALOR
CV4
CV4_VALOR
No ser
enviado
nenhum valor.
O Protheus
automaticame
nte incluir o
valor 1.
Internal Id da
moeda
Valor do rateio
PRATFINANCE
IRO
VALOR
Percentual do
valor de
distribuio
PRATFINANCE
IRO
PERCENTUAL
Id de integrao
de centro de
custo
PRATFINANCE
IRO
CODCOLIGADA|
CODCCUSTO
cEmpAnt|xFilial(
XXF
XXF_INTVAL
'CTT')|CV4_CC
D
34
Verso 4.0
<DocumentNumber>317</DocumentNumber>
<DocumentParcel />
<DocumentTypeCode>1|01</DocumentTypeCode>
<VendorCode>F01234</VendorCode>
<VendorInternalId>1|F01234</VendorInternalId>
<IssueDate>2011-04-12T17:26:46.23</IssueDate>
<DueDate>2011-04-12T17:26:46.23</DueDate>
<RealDueDate>2011-04-12T17:26:46.23</RealDueDate>
<NetValue>6839.7900</NetValue>
<GrossValue>6839.7900</GrossValue>
<FinancialNatureInternalId>1|01</FinancialNatureInternalId>
<ApportionmentDistribution>
<Apportionment>
<CostCenterInternalId>1|01.2</CostCenterInternalId>
<CostCenterCode>01.2</CostCenterCode>
<ProjectInternalId />
<TaskInternalId />
<Value>3419.9000</Value>
</Apportionment>
<Apportionment>
<CostCenterInternalId>1|01.3</CostCenterInternalId>
<CostCenterCode>01.3</CostCenterCode>
<ProjectInternalId />
<TaskInternalId />
<Value>3419.8900</Value>
</Apportionment>
</ApportionmentDistribution>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage>
Notas:
Cadastros financeiros
Tipo de documento: as informaes de tipo de documento devem ser cadastradas na tela abaixo e mapeadas manualmente no
cadastro de De/para de acordo com os tipos de documentos correspondentes do Protheus.
Verso 22.0
35
Ttulo do documento
Pasta [identificao]
36
Verso 4.0
Pasta [parmetros]:
Tipo contbil: esse campo ficar desabilitado pois a gerao contbil do lanamento financeiro ficar sob responsabilidade do
backOffice Protheus.
Global: esse campo ficar desabilitado pois os dados da conta caixa so enviados por coligada;
Conta caixa: Informao recuperada da tabela de FCXA conta caixa. Dados dessa tabela devem ser enviados pelo Protheus.
Tabelas opcionais: ficaro desabilitadas nesse tipo de integrao visto que o Protheus no as utiliza.
Rateio do fluxo de caixa: esse campo ficar desabilitado. Ser criado um parmetro de integrao para preenchimento de um
default de natureza financeira.
Obs: Esse default ser enviado para o Protheus. No RM a natureza financeira gravada no rateio de centro de custo, e no Protheus
essa informao fica no prprio lanamento.
Verso 22.0
37
Ttulo do documento
Gerao dos lanamentos financeiros
Usar Conta/caixa do cliente/Fornecedor: Essa opo ficar desabilitada, pois a conta caixa no enviada para o cliente/fornecedor
na mensageria padro.
Conta caixa Global: Essa opo ficar desabilitada, pois a conta caixa enviada por coligada.
Gerar lanctos bloqueados para alterao: Essa opo deve ser desabilitada, pois os lanamentos gerados para o Protheus no
estaro bloqueados para alterao.
Gerar lanctos rateados por departamento: essa opo ficar desabilitada, pois no haver rateio por departamento;
Gerar lanctos rateados por centro de custo: em caso de integrao com backoffice de terceiro, essa opo sempre ficar
habilitada
38
Verso 4.0
Sero listados dados de financeiro gerados pela folha. At esse momento as informaes ainda no foram enviadas para o
BackOffice de terceiro (diferentemente da integrao da folha com o BackOffice da RM cujo dados so enviados
automaticamente). Ao executar o processo de Integrao financeira com outros BackOffice, as informaes de financeiro
geradas pela folha sero enviadas automaticamente para o BackOffice conforme configurao da mensagem nica.
Verso 22.0
39
Ttulo do documento
O status do processamento da mensagem poder ser consultado no anexo Informaes de processamento conforme figura
abaixo.
40
Verso 4.0
Lanamentos Contbeis
Identificador da Mensagem: AccountingEntry
Verso: 2.000
Mdulo RM: Contabilidade Lanamentos Contbeis
Mdulo Protheus: SigaCTB Contabilidade Gerencial
Tipo de Envio: Sncrono
Mensagem
Padro
Descrio
RM
Tabela
Campo
Protheus
Valor
Tabela
Campo
CompanyId
Empresa
PCONTABIIZACAO
CODCOLIGAD
A
cEmpAnt
BranchId
Filial
PCONTABILIZACA
O
CODFILIAL
cFilAnt
CompanyInt
ernalId
Internal Id da
empresa
PCONTABILIZACA
O
CODCOLIGAD
A
No se aplica.
PCONTABILIZACA
O
DATAINICIAL
CT2
CT2_DATA
PCONTABILIZACA
O
DATAFINAL
CT2
CT2_DATA
PCONTABILIZACA
O
CODLOTE
CT2
CT2_LOTE
CT2
CT2_DOC
PeriodStart
Date
PeriodoEnd
Date
BatchNumb
er
Document
Verso 22.0
Data inicial do
perodo
contbil
Data final do
perodo
contbil
Cdigo do lote
contbil
Nmero do
documento
contbil
PCONTABILIZACA
O
Rh da Rm no
tem essa
informao no
cabealho dos
lanamentos
contbeis.
Inicialmente
enviaremos o
Cdigo do
CODLOTE
41
Valor
Ttulo do documento
Lote.
cEmpAnt|xFilial
("CT2")|CT2_D
InternalId
Internal Id do
lanamento
contbil
PCONTABILIZACA
O
CODCOLIGAD
A|CODLOTE
XXF
XXF_INTVAL
ATA|CT2_LOT
E|
CT2_SBLOTE|
CT2_DOC
Entries/Entr
y/item
Entries/Entr
y/ItemType
Nmero da
linha.
Ser enviado um
auto-incromento
contendo nmero
da linha da partida.
Tipo da linha
ItemType = 3 [
partida dobrada]
ItemType = 2 [
partida de crdito]
ItemType = 1 [
partida de dbito]
Entries/Entry/ite
m
Entries/Entry/Ite
mType
Nmero da
linha.
Tipo da linha
CT2
CT2
CT2_LINHA
CT2_DC
1=Debito
2=Credito
3=Partida
Dobrada
4=Cont.Hist
5=Rateio
6=Lcto Padrao
cEmpAnt|xFilial(
"CT2")|CT2_DA
Entries/Entr
y/EntryNum
ber
Identificao
da partida
contbil
PPARTIDA
TA|CT2_LOTE|
CODCOLIGAD
A| IDPARTIDA
CT2_SBLOTE|
CT2_DOC|CT2
_LINHA
Entries/Entr
y/Movemen
tDate
Entries/Entr
y/DebitAcco
untCode
Entries/Entr
y/DebitAcco
untInternalI
d
Entries/Entr
y/CreditAcc
ountCode
Entries/Entr
y/CreditAcc
ountInternal
Id
Data da
partida
contbil
Cdigo da
conta de
dbito
PPARTIDA
DATA
CT2
CT2_DATA
PPARTIDA
DEBITO
CT2
CT2_DEBITO
Internal Id da
conta contbil
de dbito
PPARTIDA
CODCOLDEBIT
O|DEBITO
XXF
Cdigo da
conta de
crdito
PPARTIDA
CREDITO
CT2
Internal Id da
conta contbil
de crdito
PPARTIDA
CODCOLCRED
ITO|CREDITO
XXF
Entries
/EntryValue
Valor do
lanamento
PPARTIDA
VALOR
CT2
CT2_VALOR
Entries/Entr
y/HistoryCo
de
Cdigo do
histrico
padro
CT2
CT2_HP
cEmpAnt|xFilial
XXF_INTVAL
("CT1")|CT2_D
EBITO
CT2_CREDIT
cEmpAnt|xFilial
("CT1")|CT2_C
REDIT
No ser
enviada
nenhuma
informao
nesse campo
42
XXF_INTVAL
Verso 4.0
visto que a
sincronizao
do histrico
contbil ainda
no foi
implementada
Entries/Entr
y/Complem
entaryHistor
y
Entries/Entr
y/CostCent
erCode
Entries/Entr
y/CostCent
erDebitInter
nalId
Entries/Entr
y/CostCent
erCreditCod
e
Entries/Entr
y/CostCent
erCreditInte
rnalId
Histrico
complementar
Centro de
custo de
dbito
InternalId do
centro de
custo de
dbito
Centro de
custo de
crdito
InternalId do
centro de
custo de
crdito
As
informaes
de
complemento
de histrico
sero
enviadas
nesse campo.
PPARTIDA
COMPLEMENT
O
PPARTIDA
CODCCUSTO
PPARTIDA
CODCOLDEBIT
O|CODCCUST
O
XXF
PPARTIDA
CODCCUSTO
CT2
PPARTIDA
CODCOLCRED
ITO|CODCCUS
TO
CT2
CT2_HIST
CT2
CT2_CCD
cEmpAnt|xFilial
XXF_INTVAL
("CTT")|CT2_C
CD
CT2_CCC
cEmpAnt|xFilial
XXF
XXF_INTVAL
("CTT")|CT2_C
CC
Notas:
A informao do Cdigo do Lote [BatchNumber] ser utilizada como identificador do lote contbil enviado para o Protheus.
Para garantir a integridade dos dados no Protheus j que o processo de contabilizao no RM Labore poder ser executado
diversas vezes, ser enviada uma mensagem do RM Labore para o Protheus excluir todos os registros contbeis do lote (somente
em caso de j existir um mapeamento para o lote em questo no lado RM), e somente aps isso, ocorrer o envio das mensagens
de incluso de lanamentos. Caso ocorra algum erro no envio de algum pacote contbil, o Rm enviar uma mensagem de
excluso do lote em questo.
IMPORTANTE: as mensagens contendo os dados da contabilizao sero enviadas de forma sncrona, ou seja, ser enviada
uma mensagem por vez. A mensagem seguinte somente ser enviada se a mensagem anterior estiver com status de sucesso no
seu processamento. Sendo assim, o receptor da mensagem dever tambm trabalhar com o conceito de mensagem sncrona. Ou
seja, antes dele enviar resposta (ResponseMessage) a mesma deve ser processada pelo receptor. Isso para evitar que a
mensagem de excluso seja processada depois de alguma insero j realizada.
Obs: As mensagens contbeis enviadas sero divididas em pacotes devido a uma limitao no recebimento das mesmas. Ser
criado um parmetro no RM Labore para o usurio informar a quantidade de partidas que devero ser enviadas em cada pacote.
O processo de envio de pacotes acontecer no seguinte esquema:
Verso 22.0
43
Ttulo do documento
1) Ser enviada uma mensagem de excluso de lote (somente em caso de j existir uma sincronizao do RM com o
Protheus do lote em questo, ou seja, se existir um mapeamento para o lote na tabela de De/para). Essa mensagem
possuir somente informaes do lote (cabealho). Nenhuma partida ser enviada nessa mensagem. No campo
TotvsMessage/BusinessMessage/BusinessEvent/Event ser enviada a informao de delete.
O Protheus dever receber essa mensagem e excluir o lote e as partidas contbeis gravadas.
2) Sero enviadas mensagens contendo os dados dos pacotes contbeis. Essas mensagens possuiro informaes do lote
(cabealho) e das partidas contbeis. No campo TotvsMessage/BusinessMessage/BusinessEvent/Event ser enviada a
informao de upsert. Caso ocorra algum erro no envio de algum pacote, os pacotes restantes no sero mais enviados, e uma
mensagem de excluso de lote ser enviada logo a seguir.
Cadastros contbeis
Alterao de Mscara: ficar desabilitada pois a alterao na mscara de conta ser feita somente no backOffice.
Cadastros gerenciais: Todas as opes do menu Cadastros gerenciais sero desabilitadas, visto que, no faremos a
integrao gerencial com o BackOffice do Protheus.
Perodo para manuteno de lanamentos: Essa opo ficar desabilitada as datas dos perodos contbeis sero enviadas
pelo Protheus;
44
Verso 4.0
Solicitao de tarefa e tarefas: ficar desabilitado para o usurio pois a manuteno de lotes ser feita pelo Protheus.
Lanamentos (RM Saldus): ficar desabilitado pois os lanamentos contbeis gerados pela folha no sero integrados com o
RM Saldus.
Lanamentos (RM Labore): ficar habilitado para visualizao dos lanamentos contbeis gerados pelo processo de
contabilizao. Ser includo nessa viso um menu para disparar o processo para exportao dos dados contbeis para os
backoffice de terceiro.
Verso 22.0
45
Ttulo do documento
Integrar lote contbil com o Saldus: ficar desabilitada pois os lanamentos contbeis no sero exportados para o RM saldus.
Sero listados dados de lanamentos contbeis gerados pela folha. At esse momento as informaes ainda no foram enviadas
para o BackOffice de terceiro (da mesma forma que acontece atualmente com a integrao com o BackOffice da RM). Ao
executar o processo de Integrao contbil com outros Backoffices, as informaes de contabilidade geradas pela folha sero
enviadas automaticamente para o BackOffice conforme configurao da mensagem nica.
46
Verso 4.0
O status do processamento da mensagem poder ser consultado no anexo Informaes de processamento conforme figura
abaixo.
Verso 22.0
47
Ttulo do documento
10.2. Processos
No se aplica.
No Protheus, mdulo Financeiro (SigaFIN), cadastrar os Fornecedores (SigaFIN > Atualizaes > Cadastros >
Fornecedores).
No Protheus, mdulo Financeiro (SigaFIN), cadastrar os Bancos (SigaFIN > Atualizaes > Cadastros > Bancos).
No Protheus, mdulo Contabilidade Gerencial (SigaCTB), cadastrar um calendrio contbil, as moedas contbeis e a
amarrao de Moeda x Calendrio para o perodo contbil em questo.
No Protheus, mdulo Contabilidade Gerencial (SigaCTB), cadastrar o plano de contas (SigaCTB > Atualizaes >
Entidades > Plano de Contas).
No Protheus, mdulo Contabilidade Gerencial (SigaCTB), cadastrar os centros de custos (SigaCTB > Atualizaes >
Entidades > Custos > C Custo).
Para visualizar os arquivos XML gerados nos processos integrados, atravs do sistema Protheus, siga os passos abaixo:
Acesse, no mdulo configurador (SigaCFG), Ambiente > Schedule > Schedule > EAI.
Selecione a mensagem da qual deseja visualizar o XML e clique na lupa, conforme abaixo:
48
Verso 4.0
14. Anexos
No se aplica.
Verso 22.0
49