...

Sumário 

Âncora
_bookmark0 _bookmark0

Âncora
_Toc462828093 _Toc462828093

Contexto de negócio (Introdução)

...

• Envio ou recebimento de Clientes através da mensagem CUSTOMERVENDOR.
• Integração do cadastro de Natureza Financeira (FinancialNature).
• Integração do cadastro de Moeda (Currency),
• Integração de Histórico Padrão (AccountantDefaultHistory).
• Envio de Fornecedor do RM Labore para o Protheus.
• Envio de Centro de Custo do RM Labore para o Protheus.
• Envio de Banco do RM Labore para o Protheus.
• Envio de Plano de Contas do RM Labore para o Protheus.
• Envio de Período Contábil do RM Labore para o Protheus.
• Envio de Lançamento Contábil do Protheus para o RM Labore.
• Envio de Lançamento Financeiro (Contas a Pagar) do Protheus para o RM Labore.

...

Âncora
_Toc462828097 _Toc462828097

Pré-requisitos instalação/implantação/utilização

...

Âncora
_bookmark6 _bookmark6

Âncora
_Toc462828104 _Toc462828104

RM

• • Versão mínima RM: 12.1.3.
  • Utilizar nova máquina de cálculo do RM Labore.
  • Utilizar o EAI.

  • Utilizar o Internet Information Services (IIS).

Obs.: As entidades contábeis "Item contábil" e "Classe de Valor"

...

da Integração Contábil,  foram homologadas e disponibilizadas ao mercado no release 12.1.13 das duas marcas (Protheus e RM)

...

.

Âncora
_Toc462828105 _Toc462828105

...

Âncora
_Toc462828108 _Toc462828108

Protheus

• Acessar SigaCFG > Ambiente > Cadastros > Parâmetros e configurar o parâmetro MV_EAIURL2 com o endereço do serviço de EAI do ambiente ao qual o Protheus será integrado.

...

• Acessar SigaCFG > Ambiente > Schedule > Adapter E.A.I. e realizar o cadastro das rotinas de integração, conforme segue:

...

• Caso alguma mensagem esteja configurada com o método Assíncrono, acessar SigaCFG > Ambiente > Schedule > Schedule e configurar um agente e um agendamento, conforme segue abaixo:

...

• • Cadastrar agente.

Clicar no símbolo destacado no canto superior direito da tela, para o cadastro automático dos agentes:

...

Acesse RM.exe | Segmento Integrações | Aba Integração | Mensagem Única | Integrações. Esta interface permite incluir ou alterar um pacote de integração.
Selecione TOTVS Folha de pagamento Rm x BackOffice Protheus (Identificador = 1013) e clique em editar para alterar as configurações iniciais criadas pelo configurador. 

• Identificação

...

• • NOME INTEGRAÇÃO: Este é o nome completo da integração. Trata-se de um campo meramente informativo.
  • NOME REDUZIDO: Este é o nome reduzido da integração. Trata-se de um campo apenas informativo.
  • SISTEMA INTEGRADO: Este é um mnemônico que identifica a aplicação de origem e será enviado no atributo "name" da tag <Product> no XML trafegado.

...

Ao ativar a opção de integração com outros BackOffices, automaticamente o parâmetro "Gera lotes contábeis no Folha de Pagamento antes de enviar para o Saldus" localizado em 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal é selecionado e bloqueado para alteração.  



Para a configuração agrupamento de partidas contábeis, acessar a Etapa 11 (Contabilização) do parametrizador e selecionar as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

Âncora
_Toc462828114 _Toc462828114

Mapeamento manual (cadastro de/para)

...

O primeiro cadastro que deve ser realizado para operação dos sistemas é o de Empresa (Coligada) e suas Filiais. No RM estas entidades são cadastros comuns, mas no Protheus a Empresa e as Filias são definidas em arquivos de configuração de ambientes sendo parte da implantação do Protheus padrão.
A maioria das mensagens de integração fará referências ao cadastro de Empresa/Coligada. Ex:

Obs: Nas integrações com o Protheus, será necessário cadastrar manualmente na tabela de De/Para um mapeamento da coligada para ela mesma (conforme exemplo abaixo). Esse cadastro é necessário para o correto funcionamento dos códigos de extensions criados nas integrações.
Ex:

...

• Tipo de documento

Esse projeto não contempla o sincronismo automático de tipos de documentos. Portanto, o cadastro dessas informações 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 lançamentos financeiros fará referência aos tipos de documentos cadastrados.

...

Âncora
_Toc462828115 _Toc462828115

Permissão de usuário

...

Âncora
_Toc462828118 _Toc462828118

Transações/Entidades/Mensagens únicas

...

Âncora
_bookmark13 _bookmark13

Âncora
_Toc462828119 _Toc462828119

Fluxo das Informações

...

Fornecedor 
Identificador da Mensagem: CustomerVendor 
Versão: 2.003
Módulo RM: Financeiro – Cadastro de Cliente/Fornecedor 
Módulo Protheus: SigaFIN - Financeiro
Tipo de Envio: Síncrono

+ Notas:
Somente fornecedores devem ser enviados nessa integração. 

As configurações iniciais desta integração criará um parâmetro chamado "RH_CLIFORAUTOINC" que irá definir se utiliza Auto incremento ou não para o campo "FCFO.CODCFO". Caso o parâmetro não seja "De auto incremento", a máscara do código do Cliente/Fornecedor deve ser configurada de acordo com a máscara do cliente/fornecedor enviada pelo Protheus:
Ex: "QQQQQQQQ". [Permite qualquer caractere limitado a 8 posições].
Caso o parâmetro seja de "auto incremento", a máscara deve ser definida como "" (vazio) e o parâmetro do financeiro "Usar código sequencial (se máscara for numérica)" deve ser marcado. 


Exemplo de mensagem de entrada:
<TOTVSMessage>
<MessageInformation version="2.003">
<UUID>76111122-5165-2241-2012-021116129700</UUID>
<Type>BusinessMessage</Type>
<Transaction>CUSTOMERVENDOR</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>Protheus</SourceApplication>
<CompanyId>10</CompanyId>
<BranchId>113</BranchId>
<Product name="Protheus" version="12.1.1" />
<GeneratedOn>2014-04-11T19:30:05</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>CUSTOMERVENDOR</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<InternalId>10|F00983</InternalId>
<CompanyId>10</CompanyId>
<CompanyInternalId>10|113</CompanyInternalId>
<Code>F00983</Code>
<ShortName>Fornecedor xpto</ShortName>
<Name>fornecedor erlon</Name>
<Type>Customer</Type>
<EntityType>Person</EntityType>
<RegisterSituation>Active</RegisterSituation>
<GovernmentalInformation>
<Id name="CPF">908094166-20</Id>
</GovernmentalInformation>
<Address>
<Address>Rua Santos</Address>
<Number>907</Number>
<Complement>ap 201</Complement>
<City>
<CityInternalId>1</CityInternalId>
<CityDescription>Belo Horizonte</CityDescription>
</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 
Versão: 2.000
Módulo RM: Contabilidade – Cadastro de Centro de Custo 
Módulo Protheus: SigaCTB – Contabilidade Gerencial 
Tipo de Envio: Síncrono

Notas:
As configurações iniciais desta integração criará um parâmetro chamado "RH_ CENTROCUSTOAUTOINC" que irá definir se utiliza Auto incremento ou não para o campo "GCCUSTO.CODCCUSTO". Caso o parâmetro não seja "De auto incremento", a máscara do código do Centro de custo deve ser configurada de acordo com a máscara do centro/custo enviada pelo Protheus: Ex: "QQQQQQQQ". [Permite qualquer caractere limitado a 8 posições].
Caso o parâmetro seja "De auto incremento", o Código do Centro de Custo no RM será gerado a partir da tabela GAUTOINC, sempre ignorando o código informado na mensagem única. Nesse caso, o parâmetro "Máscara do Centro de Custo" deve ser preenchido como "QQQQQQQ" [qualquer caractere]. 

O parâmetro de Integração “CENTROCUSTOAUTOINC” define:

Se desmarcado: O Código do Centro de Custo no RM será sempre o código informado na mensagem única; porém, o implantador deve limpar a máscara do centro de custo, para que a integração use o código exato do
Protheus. (Fica no parametrizados do módulo Financeiro ou via script, limpando o campo MASCARACC da tabela GCCUPAR). Feito isto, é necessário apagar o _Broker e reiniciar o host.

Se marcado: O Código do Centro de Custo no RM será com um valor a partir da tabela GAUTOINC, sempreignorando o código informado na mensagem única.

Exemplo de mensagem de entrada: 
<TOTVSMessage>
<MessageInformation version="2.000">
Exemplo de mensagem de entrada: 
<TOTVSMessage>
<MessageInformation version="2.000">
<UUID>59e9fed1-45ac-41a2-bd8b-12c990eb2d58</UUID>
<Type>BusinessMessage</Type>
<Transaction>COSTCENTER</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>Protheus</SourceApplication>
<CompanyId>10</CompanyId>
<BranchId>113</BranchId>
<Product name="Protheus" version="12.1.1" />
<GeneratedOn>2014-04-11T19:30:05</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>COSTCENTER</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<InternalId>10|04.4.9</InternalId>
<CompanyId>10</CompanyId>
<CompanyInternalId>10|113</CompanyInternalId>
<Code>04.4.9</Code>
<RegisterSituation>Active</RegisterSituation>
<Name>PDE</Name>
<ShortCode>04.4.9</ShortCode>
<SPED>true</SPED>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> 

Banco 
Identificador da Mensagem: Bank 
Versão: 2.000
Módulo RM: Financeiro – Cadastro de Banco
Módulo RM: Financeiro – Cadastro de Agência 
Módulo RM: Financeiro – Conta Corrente 
Módulo RM: Financeiro – Conta Caixa
Módulo Protheus: SigaFIN - Financeiro 
Tipo de Envio: Síncrono

Notas: 
O Banco, Agência, Conta Corrente e Conta Caixa devem ser cadastrados no BackOffice Protheus e sincronizados para o RM. O BackOffice Protheus possui apenas uma tabela que contém todas as informações Código do Banco, Nome, Agência, Conta, entre outros.
Agência é um anexo da visão de Banco, assim como Conta Corrente é um anexo da visão de Agência. Na Linha RM são tabelas independentes: Banco (GBANCO), Agência (GAGENCIA), Conta Corrente (FCONTA) e Conta Caixa (FCXA). Com isso, a exclusão da entidade banco no Protheus, reflete na exclusão de uma Conta caixa, conta, agencias e banco no Lado RM.
As configurações iniciais desta integração criará um parâmetro chamado "RH_ CONTACAIXAAUTOINC" que irá definir: Se desmarcado: O Código da "Conta / Caixa" no RM será sempre o número da conta bancária enviada na mensagem;
Se marcado: O Código da conta caixa no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o número da conta bancária enviada na mensagem única. 

Exemplo de mensagem de entrada: 
<TOTVSMessage>
<MessageInformation version="2.000">
<UUID>11108840-8121-9118-9052-220423190777</UUID>
<Type>BusinessMessage</Type>
<Transaction>BANK</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>Protheus</SourceApplication>
<CompanyId>10</CompanyId>
<BranchId>113</BranchId>
<Product name="Protheus" version="12.1.1" />
<GeneratedOn>2014-04-11T19:30:05</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>BANK</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<Code>877</Code>
<InternalId>877</InternalId>
<Name>Banco teste 1 </Name>
<ShortName>teste</ShortName>
<Febraban>877</Febraban>
<ListOfAgency>
<Agency>
<Number>0488</Number>
<Address>
<Number>877</Number>
<Complement>ap 201</Complement>
<City>
<Description>Itaguara</Description>
</City>
<State>
<Code>MG</Code>
</State>
<District>jardim america</District>
<ZIPCode>30421546</ZIPCode>
</Address>
<ContactInformation>
<CommunicationInformation>
<PhoneNumber>33845425</PhoneNumber>
</CommunicationInformation>
</ContactInformation>
<ListOfAccount>
<Account>
<Number>70</Number>
<CompanyId>10</CompanyId>
</Account>
</ListOfAccount>
</Agency>
</ListOfAgency>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> 

Natureza Financeira 
Notas: 
A mensagem única "FinancialNature _2_000" não será utilizada nessa integração. No RM a natureza financeira existe no rateio de centro de custo do lançamento financeiro (FlanRatCCu.CODNATFINANCEIRA) e na mensagem padrão a natureza financeira existe no lançamento financeiro (AccountPayableDocument.FinancialNatureInternalId). Sendo assim, não temos esse valor para enviar para o Protheus.
Será criado um parâmetro de integração 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 padrão "Currency" não será utilizada nessa integração. O RH da RM trabalha sempre com a moeda real "R$". Portanto, não será enviado nenhum valor na mensagem "AccountPayableDocument.CurrencyInternalId". O Protheus automaticamente incluirá o valor "1" (moeda corrente do país) em caso de não envido da moeda. 

Plano de Contas 
Identificador da Mensagem: AccountantAccount 
Versão: 2.000
Módulo RM: Contabilidade – Cadastro de Plano de Contas Contábil 
Módulo Protheus: SigaCTB – Contabilidade Gerencial
Tipo de Envio: Síncrono

Notas: 
Está disponível 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, patrimônio líquido, contas de resultado, contas de compensação). Esse campo não será transferido na mensagem pois o mesmo deve estar somente no BackOffice.
Porém, esse campo é obrigatório para inclusão da conta contábil no RM. Sendo assim, iremos gravar o valor de valor "01 – Não informado" somente para permitir a gravação. O mesmo não será utilizado pelo RM Labore. 


A máscara parametrizada da conta contábil no RM será validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado de acordo com o formato do código da conta a ser enviado pelo Protheus. Caso o Protheus não envie máscara no seu código de conta (ex: 1011214), então o parâmetro "Não utiliza máscara nas contas" deve ser marcado. Caso contrário, ocorrerá um erro no processo de inclusão da conta. 


Exemplo de mensagem de entrada: 
<TOTVSMessage>
<MessageInformation version="2.000">
<UUID>11009901-2801-8089-0090-949098000290</UUID>
<Type>BusinessMessage</Type>
<Transaction>ACCOUNTANTACCOUNT</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>Protheus</SourceApplication>
<CompanyId>10</CompanyId>
<BranchId>113</BranchId>
<Product name="Protheus" version="12.1.1" />
<GeneratedOn>2014-04-11T19:30:05</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>ACCOUNTANTACCOUNT</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<InternalId>10|1.1.1.1.369</InternalId>
<CompanyId>10</CompanyId>
<CompanyInternalId>10|113</CompanyInternalId>
<Code>1.1.1.1.369</Code>
<ShortCode>1.1.1.1.369</ShortCode>
<Description>Conta contábil teste</Description>
<PostingNature>0</PostingNature>
<AnalyticalOrSynthetic>2</AnalyticalOrSynthetic>
<ActiveOrInactive>2</ActiveOrInactive>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> 


Histórico Padrão 
Identificador da Mensagem: AccountantDefaultHistory 
Versão: 1.000
Módulo RM: Contabilidade – Cadastro de Histórico Padrão 
Módulo Protheus: Não se aplica.
Tipo de Envio: Síncrono

Notas:
No primeiro momento não será implementada no lado do Protheus a sincronização via mensagem única das informações de histórico padrão.
No lado RM, a rotina já está preparada para recebê-la quando a mesma for implementada pela equipe Protheus. 

Período Contábil 
Identificador da Mensagem: AccountingCalender
Versão: 1.000
Módulo RM: Contabilidade – Parâmetros
Módulo Protheus: SigaCTB – Contabilidade Gerencial 
Tipo de Envio: Síncrono

Notas:
No processo de integração, o lado RM atualizará as datas de período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Protheus. No Protheus, essas informações são armazenadas em um cadastro, e no Rm essas informações são armazenadas nos parâmetros, sendo assim, teremos espaço para armazenar somente uma dataIncial e uma dataFinal. 


Item Contábil 
Identificador da Mensagem: AccountingItem
Versão: 1.000
Módulo RM: Contabilidade – Item Contábil
Módulo Protheus: SigaCTB – Contabilidade Gerencial 
Tipo de Envio: Síncrono

Notas:
Notas:
Existem três pontos para visualizar os registros integrados de item contábil (Área e Linha de Negócio):

...

  




Após recebimento, o Item Contábil (Área e Linha de Negócio) poderá ser vinculado ao Funcionário, na Seção, e no Agrupamento de Contas por meio do lookup disponibilizado nas respectivas telas.
RM / Folha de Pagamento / Administração de Pessoal / Funcionários:

Na tela de cadastro de Funcionários acessar: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Item Contábil.
  
RM / Folha de Pagamento / Administração de Pessoal / Seções:

Na tela de cadastro de Seção acessar: Dados Contábeis / Item Contábil:


RM / Folha de Pagamento / Encargos / Contabilização – Cadastros / Cadastros Contábeis / Agrupamento de Contas:

 
Na tela de cadastro do Agrupamento de Contas: Item Contábil (Área e Linha de Negócio).

Exemplo de mensagem de entrada: 
<TOTVSMessage>
<MessageInformation version="1.000">
<UUID>08648e54-c7b0-e0ca-dbb7-fa1953f6a91d</UUID>
<Type>BusinessMessage</Type>
<Transaction>ACCOUNTINGITEM</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>P12_INTXX</SourceApplication>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<Product name="PROTHEUS" version="12" />
<GeneratedOn>2016-08-24T11:34:10</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>Departament</Entity>
<Event>upsert</Event>
<Identification>
<key name="InternalID">T1|D MG 01 |600000003</key>
</Identification>
</BusinessEvent>
<BusinessContent>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<CompanyInternalId>T1|D MG 01</CompanyInternalId>
<Code>600000003</Code>
<InternalID>T1|D MG 01 |600000003</InternalID>
<Description>ITCTB ANLT 600000003</Description>
<Classe>2</Classe>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> 

Classe de Valor 
Identificador da Mensagem: ClassValue
Versão: 1.000
Módulo RM: Contabilidade – Classe de Valor
Módulo Protheus: SigaCTB – Contabilidade Gerencial 
Tipo de Envio: Síncrono

Exemplo de mensagem de entrada: 

...

...

...

...

...

Exemplo de mensagem de entrada: 
<TOTVSMessage>
<TOTVSMessage>
<MessageInformation version="1.000">
<UUID>ef20b823-0c55-c21b-925d-62fd37fd6a38</UUID>
<Type>BusinessMessage</Type>
<Transaction>CLASSVALUE</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>P12_INTXX</SourceApplication>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<Product name="PROTHEUS" version="12" />
<GeneratedOn>2016-08-23T09:26:43</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>ClassValue</Entity>
<Event>upsert</Event>
<Identification>
<key name="InternalId">T1|D MG 01 |700000001</key>
</Identification>
</BusinessEvent>
<BusinessContent>
<CompanyId>T1</CompanyId>
<BranchId>D MG 01</BranchId>
<CompanyInternalId>T1|D MG 01</CompanyInternalId>
<Code>700000001</Code>
<Name>CLVL ANLT 700000001</Name>
<Class>2</Class>
<RegisterSituation>Active</RegisterSituation>
<InternalId>T1|D MG 01 |700000001</InternalId>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> 

Lançamentos Financeiros 
Identificador da Mensagem: AccountPayableDocument 
Versão: 2.002
Módulo RM: Financeiro – Lançamentos Financeiros 
Módulo Protheus: SigaFIN - Financeiro
Tipo de Envio: Síncrono