Páginas filhas
  • Manual_Doc_Integracao_RMLabore_BackOfficeProtheus

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...


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

    • Cadastrar agendamento.


Clicar no símbolo destacado na parte inferior para adicionar um novo agendamento:
Image RemovedImage Added

Preencher o campo "Rotina" com a rotina FWEAI e informar as empresas para as quais o agendamento será válido:
Image RemovedImage Added

Definir a data e horário para a execução do agendamento e definir a recorrência (clicando no símbolo destacado na parte superior), conforme as necessidades existentes
Image RemovedImage Added
Image Removed
Image Added



Confirmar a inclusão do agendamento:
Image RemovedImage Added

    • Iniciar os serviços de agendamento:

Image RemovedImage Added

    • Iniciar os agentes:

Image RemovedImage Added

Âncora
_bookmark9
_bookmark9
Âncora
_Toc462828109
_Toc462828109
RM

...


Acesse RM.exe | Segmento Integrações | Aba Ferramentas | Configurar. Será apresentado um wizard de configuração do TBC. Este projeto utiliza mensageria padrão TOTVS, então selecione a opção "TOTVS Folha de pagamento RM x BackOffice Protheus" e execute o processo. 
Image RemovedImage Added

Âncora
_Toc462828112
_Toc462828112
Configuração da integração

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. 
Image RemovedImage Added

  • Identificação

 

...

    • SIGNIFICADO DE COLIGADA: Define qual o limite da identificação da coligada, se representa a companhia ou a unidade de negócio.
    • URL WEB SERVICE: Informe o endereço do WebService Protheus para envio de mensagens. Utilize o formato http://\[servidor\]:\[porta\]/EAIService.apw. Para verificar se o WS Protheus está disponível digite o endereço do mesmo no seu navegador (no formato http://\[servidor\]:\[porta\]), na página apresentada procure pelo texto EAISERVICE)
    • USUÁRIO AUTENTICAÇÃO: Informe o nome do usuário para autenticação pelo WebService.
    • SENHA AUTENTICAÇÃO: Informe a senha para autenticação pelo WebService. BackOffice Protheus X TOTVS Incorporação


Image RemovedImage Added

  • Mapeamento de Entidades


Aqui é possível fazer mapeamentos de cada entidade (cada mensagem única) que faz parte do pacote de integração. O Wizard de Configuração fará o mapeamento padrão automaticamente. Alterações só devem ser feitas com critério. Vale ressaltar que as alterações realizadas precisam ser muito bem documentadas, pois a atualização de versões e reconfiguração da integração pode substituí-las, para aplicar ajustes necessários ou até mesmo melhorias.
Caso seja necessário acrescentar uma entidade à integração que não esteja no pacote padrão, clique em Anexos e escolha "Mapeamento de Entidades". Na tela que é apresentada informe o código ou nome da mensagem. Clique no botão reticências (...) para localizar a mensagem na lista de mensagens pré-cadastradas. 
Image RemovedImage Added

  • EAI – Fila de Mensagens Únicas


Acesse RM.exe | Segmento Integrações | Aba Integração | Mensagem Única | Fila de mensagens únicas. Nesta tela serão registradas as informações de envio e recebimento de mensagens XML trafegadas pela integração. Para ver mais detalhes da mensagem trafegada de um duplo clique no registro, para detalhes de execução (erro ou sucesso) selecione o registro e clique em Anexos | Informações de execução de mensagem, neste anexo é possível visualizar a mensagem de resposta. 
Image RemovedImage Added

Âncora
_Toc462828113
_Toc462828113
Parametrização do Totvs folha de pagamento

Acesse RM.exe | segmento RH| aba Ambiente| Parâmetros | Folha de pagamento. Nesse parametrizador serão registradas informações dos parâmetros de integração da folha RM com qualquer BackOffice de terceiros.
Importante: O documento em questão detalha a integração da folha da RM com o BackOffice do Protheus.
Porém, a folha da RM está preparada para integrar com qualquer BackOffice. Para isso, basta desenvolver e mapear as mensagens no EAI da RM. 
Image RemovedImage Added
Image Removed
Image Added

  • Usa integração com outros BackOffice: Este parâmetro 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 contábeis enviadas por pacote contábil: Esse parâmetro armazena a quantidade de partidas contábeis que devem ser enviadas para os BackOffice. Esse parâmetro foi criado devido a uma limitação da arquitetura do Protheus em receber pacotes grandes de informações nas suas mensagens.


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.  
Image RemovedImage Added


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. 
Image RemovedImage Added

Nota:
Os parâmetros dos grupos "Lançamento Contábil (RM Saldus)" e "Contabilização" foram movidos da Etapa 17 (Geral) para a Etapa 11 (Contabilização).


Image RemovedImage AddedImage Removed


Image Added

Nota:
Para a integração de lançamentos financeiros não é contemplado as opções de envio dos campos Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor.

...

Lançamentos financeiros 
Acesse RM.exe | segmento Globais| aba Segurança| Perfis.
Image RemovedImage Added


Na edição de perfil, aba "Acesso a Menus" localize na árvore de tags o recurso em questão:
[Folha de Pagamento | Encargos | Financeiro | Lançamentos | Integração financeira com outros BackOffice]. Através dessa permissão, o usuário do perfil terá condições de executar o processo de envio de dados financeiros para o BackOffice de terceiros. 
Image RemovedImage Added


Lançamentos contábeis 
Acesse RM.exe | segmento Globais| aba Segurança| Perfis.
Image RemovedImage Added

Na edição de perfil, aba "Acesso a Menus" localize na árvore de tags o recurso em questão: 

[Folha de Pagamento | Encargos | Contabilização | Lançamentos| Lançamentos (RM Labore) | Integração contábil com outros BackOffice]. Através dessa permissão, o usuário do perfil terá condições de executar o processo de envio de dados contábeis para o BackOffice de terceiros. 
Image RemovedImage Added

Âncora
_bookmark10
_bookmark10
Âncora
_Toc462828116
_Toc462828116
Controle de Versão

...


+ 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. 
Image RemovedImage Added

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]. 
Image RemovedImage Added


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: 
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. 
Image RemovedImage Added

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. 
Image RemovedImage Added

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

...

  • Item contábil no módulo Educacional:

  Image RemovedImage Added
  Image RemovedImage Added
 

  • Item contábil no módulo Folha de Pagamento:

  Image RemovedImage Added
Image RemovedImage Added
Image RemovedImage Added


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:
Image RemovedImage Added
Na tela de cadastro de Funcionários acessar: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Item Contábil.
  Image RemovedImage Added
RM / Folha de Pagamento / Administração de Pessoal / Seções:
Image RemovedImage Added
Na tela de cadastro de Seção acessar: Dados Contábeis / Item Contábil:
Image RemovedImage Added

RM / Folha de Pagamento / Encargos / Contabilização – Cadastros / Cadastros Contábeis / Agrupamento de Contas:
Image RemovedImage Added
 
Na tela de cadastro do Agrupamento de Contas: Item Contábil (Área e Linha de Negócio).
Image RemovedImage Added


Nota:
1: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver desmarcado, o campo deverá ficar oculto

2: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver selecionado e os parâmetros "Agrupar partidas contábeis por Item Contábil" e "Gerar lanctos rateados por Item Contábil" estiverem desmarcados, o campo deverá ficar desabilitado.

...



Notas: 
Cadastros financeiros
Tipo de documento: as informações 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. 
Image RemovedImage Added

Parâmetros: Parametrização dos lançamentos financeiros
Image RemovedImage Added

Pasta [identificação]
Image RemovedImage Added

Tipo Documento: Informação recuperada da tabela de "FTDO - tipos de documentos".
Cód.Fornecedor: Informação recuperada da tabela de "FCFO – cliente/fornecedor". Dados dessa tabela devem ser enviados pelo Protheus. 


Pasta [parâmetros]:
Image RemovedImage Added

Tipo contábil: esse campo ficará desabilitado pois a geração contábil do lançamento financeiro ficará sob responsabilidade do backOffice Protheus.
Global: esse campo ficará desabilitado pois os dados da conta caixa são enviados por coligada;
Conta caixa: Informação recuperada da tabela de "FCXA – conta caixa". Dados dessa tabela devem ser enviados pelo Protheus.
Tabelas opcionais: ficarão desabilitadas nesse tipo de integração visto que o Protheus não as utiliza.
Rateio do fluxo de caixa: esse campo ficará desabilitado. Será criado um parâmetro de integração 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 informação fica no próprio lançamento. 


Geração dos lançamentos financeiros 
Image Removed
Image Added
Image Removed
Image Added

Usar Conta/caixa do cliente/Fornecedor: Essa opção ficará desabilitada, pois a conta caixa não é enviada para o cliente/fornecedor na mensageria padrão.
Conta caixa Global: Essa opção ficará desabilitada, pois a conta caixa é enviada por coligada.
Gerar lanctos bloqueados para alteração: Essa opção deve ser desabilitada, pois os lançamentos gerados para o Protheus não estarão bloqueados para alteração.
Gerar lanctos rateados por departamento: essa opção ficará desabilitada, pois não haverá rateio por departamento;
Gerar lanctos rateados por centro de custo: em caso de integração com backoffice de terceiro, essa opção sempre ficará habilitada 
Image Removed
Image Added

Tabelas opcionais: as tabelas opcionais ficarão desabilitadas. 

Integração dos lançamentos financeiros 
Acesse RM.exe | segmento RH| aba Encargos| Grupo Financeiro | Lançamentos | Lançamentos (RM Labore).
Image RemovedImage Added

Serão listados dados de financeiro gerados pela folha. Até esse momento as informações ainda não foram enviadas para o BackOffice de terceiro (diferentemente da integração da folha com o BackOffice da RM cujo dados são enviados automaticamente). Ao executar o processo de "Integração financeira com outros BackOffice", as informações de financeiro geradas pela folha serão enviadas automaticamente para o BackOffice conforme configuração da mensagem única.
Image RemovedImage Added

O status do processamento da mensagem poderá ser consultado no anexo "Informações de processamento" conforme figura abaixo. 
Image RemovedImage Added
Image Removed

Image Added


Lançamentos Contábeis 
Identificador da Mensagem: AccountingEntry
Versão: 2.002
Módulo RM: Contabilidade – Lançamentos Contábeis 
Módulo Protheus: SigaCTB – Contabilidade Gerencial 
Tipo de Envio: Síncrono

...



Cadastros contábeis 
Alteração de Máscara: ficará desabilitada pois a alteração na máscara de conta será feita somente no backOffice.
Image RemovedImage Added

Cadastros gerenciais: Todas as opções do menu "Cadastros gerenciais" serão desabilitadas, visto que, não faremos a integração gerencial com o BackOffice do Protheus.
Image RemovedImage Added

Período para manutenção de lançamentos: Essa opção ficará desabilitada as datas dos períodos contábeis serão enviadas pelo Protheus; 
Image RemovedImage Added


Solicitação de tarefa e tarefas: ficará desabilitado para o usuário pois a manutenção de lotes será feita pelo Protheus.
Image RemovedImage Added


Lançamentos (RM Saldus): ficará desabilitado pois os lançamentos contábeis gerados pela folha não serão integrados com o RM Saldus.
Image RemovedImage Added


Lançamentos (RM Labore): ficará habilitado para visualização dos lançamentos contábeis gerados pelo processo de contabilização. Será incluído nessa visão um menu para disparar o "processo para exportação dos dados contábeis para os backoffice de terceiro". 
Image RemovedImage Added

Integrar lote contábil com o Saldus: ficará desabilitada pois os lançamentos contábeis não serão exportados para o RM saldus.
Image RemovedImage Added


Integração dos lançamentos contábeis 

Acesse RM.exe | segmento RH| aba Encargos| Grupo Contabilização | Lançamentos | Lançamentos(RM Labore).
Image RemovedImage Added


Serão listados dados de lançamentos contábeis gerados pela folha. Até esse momento as informações ainda não foram enviadas para o BackOffice de terceiro (da mesma forma que acontece atualmente com a integração com o BackOffice da RM). Ao executar o processo de "Integração contábil com outros Backoffices", as informações de contabilidade geradas pela folha serão enviadas automaticamente para o BackOffice conforme configuração da mensagem única. 
Image RemovedImage Added

O status do processamento da mensagem poderá ser consultado no anexo "Informações de processamento" conforme figura abaixo.
Image RemovedImage Added
Image Removed
Image Added




Âncora
_Toc462828125
_Toc462828125

...

  • Acesse, no módulo configurador (SigaCFG), Ambiente > Schedule > Schedule > EAI.
  • Selecione a mensagem da qual deseja visualizar o XML e clique na lupa, conforme abaixo:



Image RemovedImage Added

Âncora
_Toc462828129
_Toc462828129
Situações comuns

...