Páginas filhas
  • Manual_Doc_Integracao_RMLabore_BackOfficeProtheus

Versões comparadas

Chave

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

...

Sumário 

Âncora
_GoBack
_GoBack
1. Contexto de negócio (Introdução) 
2. Sistemas Envolvidos 
3. Integração 
4. Escopo 
5. Pré-requisitos instalação/implantação/utilização 
5.1 Protheus 
5.2 RM 
Importante! 
6. Instalação/Atualização 
6.1 Protheus 
6.2 RM 
Instalar o WebService de Integração (TBC) 
Execução do configurador da integração 
Configuração da integração 
Parametrização do Totvs folha de pagamento 
Mapeamento manual (cadastro de/para) 
Permissão de usuário 
7. Controle de Versão 
8. Suporte 
9. Transações/Entidades/Mensagens únicas 
10. Fluxo das Informações 
10.1 Cadastros 
10.2 Processos 
11. Como fazer 
12. Situações comuns 
1413. Anexos 
 14. Novidades da Integração


Â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
_Toc462828103
_Toc462828103
Protheus

    • Versão mínima do Protheus: 11.80.
    • Possuir um licenciamento (License Server) adequado do sistema Protheus.
    • Necessário o uso da ferramenta EAI.
    • Necessária configuração de um WebService.
    • Módulos necessários: Financeiro (SigaFIN) e Contabilidade Gerencial (SigaCTB).
    • Programa CTB cuja data mínima seja 24/07/2014.
    • Programa CTBA010 cuja data mínima seja 24/07/2014.
    • Programa CTBA020 cuja data mínima seja 24/07/2014
    • Programa CTBA030 cuja data mínima seja 03/07/2014.
    • Programa CTBA101 cuja data mínima seja 24/07/2014.
    • Programa CTBA102 cuja data mínima seja 24/07/2014.
    • Programa CTBA105 cuja data mínima seja 24/07/2014.
    • Programa CTBA140 cuja data mínima seja 24/07/2014.
    • Programa CTBI010 cuja data mínima seja 24/07/2014.
    • Programa CTBI020 cuja data mínima seja 24/07/2014.
    • Programa CTBI030 cuja data mínima seja 17/06/2014.
    • Programa CTBI102 cuja data mínima seja 24/07/2014.
    • Programa CTBXFUN cuja data mínima seja 24/07/2014.
    • Programa CTBXFUNA cuja data mínima seja 24/07/2014.
    • Programa CTBXFUNB cuja data mínima seja 24/07/2014.
    • Programa CTBXFUNC cuja data mínima seja 24/07/2014.
    • Programa CTBXVLD cuja data mínima seja 24/07/2014.
    • Programa FIN cuja data mínima seja 16/07/2014.
    • Programa FINA050 cuja data mínima seja 16/07/2014.
    • Programa FINI050 cuja data mínima seja 07/07/2014.
    • Programa FINXFUN cuja data mínima seja 22/07/2014.
    • Programa MATA020 cuja data mínima seja 29/04/2014.
    • Programa MATA070 cuja data mínima seja 14/07/2014.
    • Programa MATI020 cuja data mínima seja 26/05/2014.
    • Programa MATI070 cuja data mínima seja 01/04/2014.

Â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

Importante!

É responsabilidade da equipe de implantação executar a carga inicial e/ou sincronismo dos cadastros, para os clientes que já possuem bases de dados dos produtos TOTVS implantadas. A integração realiza o sincronismo automático dos novos registros ou das alterações posteriores após sua ativação.

...

Â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:

 


Mensagem Única

Rotina

Mensagem

Envia

Recebe

Método

Operação

Canal

Versão

Sim

CTBA020

ACCOUNTANTACCOUNT

Sim

Não

Síncrono

Todas

EAI

2.000

Sim

CTBA030

COSTCENTER

Sim

Não

Síncrono

Todas

EAI

2.000

Sim

CTBA010

ACCOUNTINGCALENDAR

Sim

Não

Síncrono

Todas

EAI

1.000

Sim

CTBA102

ACCOUNTINGENTRY

Não

Sim

Síncrono

Todas

EAI

2.000

Sim

MATA020

CUSTOMERVENDOR

Sim

Não

Síncrono

Todas

EAI

2.003

Sim

MATA070

BANK

Sim

Não

Síncrono

Todas

EAI

2.000

Sim

FINA050

ACCOUNTPAYABLEDOCUMENT

Não

Sim

Síncrono

Todas

EAI

2.000

 


  • 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. 

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).



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.

Â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:

De-para RM (Empresa)

 


Tabela RM

GFILIAL

 


Chave Primária RM

CODCOLIGADA

CODFILIAL

 


Valor Chave Primária RM

1

2

 


Sistema Integrado

PROTHEUS

 


Valor Chave Integração

10

113

 



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:

De-para RM (Empresa)

 


Tabela RM

GCOLIGADA

Chave Primária RM

CODCOLIGADA

Valor Chave Primária RM

1

Sistema Integrado

PROTHEUS

Valor Chave Integração

1

...


  • 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.

De-para RM (Empresa)

 


Tabela RM

FTDO

Chave Primária RM

CODCOLIGADA

CODTDO

Valor Chave Primária RM

1

0001

Sistema Integrado

PROTHEUS

Valor Chave Integração

10

1

...


Âncora
_Toc462828115
_Toc462828115
Permissão de usuário

...

Âncora
_Toc462828118
_Toc462828118
Transações/Entidades/Mensagens únicas

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)

Cadastros

01

Centro de Custo

Protheus

RM

CostCenter_2_000.xsd

 


02

Fornecedor

Protheus

RM

CustomerVendor_2_003.xsd

 


03

Banco

Protheus

RM

Bank_2_000.xsd

 


04

Plano de Contas

Protheus

RM

AccountantAccount_2_000.xsd

 


05

Histórico Padrão

Protheus

RM

AccountantDefaultHistory_1_000.xsd

 


06

Período Contábil

Protheus

RM

AccountingCalendar_1_000.xsd

 


07

Lançamento Financeiro

RM

Protheus

AccountPayableDocument_2_000.xsd

 


08

Lançamento Contábil

RM

Protheus

AccountingEntry_2_000.xsd

...


Â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

Mensagem Padrão


Descrição

RM

 

 



PROTHEUS

 

 

 

 





Tabela

Campo

Valor

Tabela

Campo

Valor

CompanyId

Código da empresa

FCFO

CODCOLIGA DA

 

 

CompanyIntern



cEmpAnt

 


CompanyIntern alId

InternalId da empresa


FCFO

CODCOLIGA DA

 

 



cEmpAnt

xFilial(" SA2")

 


Code

Código do fornecedor

FCFO

CODCFO

 


SA2

A2_COD

 


StoreId

Loja

 

 

 




SA2

A2_LOJA

 



InternalId


InternalId do fornecedor


FCFO


CODCOLIGA DA

CODCFO

 



XXF


XXF_INTVAL

cEmpAnt

xFilial("S A2")

A2_COD

A2_LOJA

ShortName

Nome reduzido

FCFO

NOMEFANTA SIA

 


SA2

A2_NREDUZ

 





Type




Tipo




FCFO




PAGREC

[Se Type = 'Customer'] PagRec=1 Senão se Type = 'Vendor' PagRec=2 Senão
PagRec = 3

 

 

 







EntityType




Tipo do registro




FCFO



PESSOAFISO UJUR

[Se EntityType = 'Person'] PessoaFisOuJur= F
Senão PessoalFisOuJus= J




SA2




A2_TIPO


'Person' = "F"
'Company' = "J"



RegisterSituatio n



Situação



FCFO



ATIVO

[Se RegisterSituation = 'Active']
Ativo=1 Senão Ativo=0



SA2



A2_MSBLQL



'Active' = "2"
'Inactive' = "1"


GovernmentalI nformation.Id Name[CNPJ]



CNPJ/CPF



FCFO



CGCCFO

[Se Id[Name]= CPF'] ou Id[Name]= CNPJ'] CGCCFO=1
Senão
Ativo=0



SA2



A2_CGC

 


Address.Addre ss

Nome da rua

FCFO

RUA

Address.Address

SA2

A2_END

 


Address.Numb er

Numero

FCFO

NUMERO

Address.Number

SA2

A2_NR_END

 


Address.Compl ement

Complemento

FCFO

COMPLEMEN TO

Address.Complem ent

SA2

A2_COMPLEM

 


Address.City.Ci tyInternalId

Código do município

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. StateDescriptin

Descrição do estado

FCFO

DESCETD

 


SX5

X5_DESCRI

 


Address.Countr y.CountryIntern alId


Codigo do país


FCFO


CODPAIS

 



SA2


A2_PAIS

 


Address.Countr y.CountryDescr iption


Nome do país


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

 


ListOfCommuni cationInformati on.Communicat ionInformation. PhoneNumber



Telefone



FCFO



TELEFONE

CommunicationInfor mation[1]/PhoneNu mber
[Primeira posição na lista de telefones da mensagem]



SA2



A2_TEL

 


ListOfCommuni cationInformati on.Communicat ionInformation. FaxNumber



Fax



FCFO



FAX

CommunicationInfor mation[1]/FaxNumb er
[Primeira posição na lista de fax da mensagem]



SA2



A2_FAX

 


ListOfCommuni cationInformati on.Communicat ionInformation. Email



E-mail



FCFO



EMAIL

CommunicationInfor mation[1]/E-mail [Primeira posição na lista de e-mail da mensagem]



SA2



A2_EMAIL

 



+ 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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 

 






Tabela

Campo

Valor

Tabela

Campo

Valor

CompanyId

Código da empresa

GCCUSTO

CODCOLIGADA

 

 



cEmpAnt

 


Code

Código do Centro de Custo

GCCUSTO

CODCCUSTO

 


CTT

CTT_CUSTO

 



InternalId


Internal Id de integração


GCCUSTO


CODCOLIGADA

CODCCUSTO

 



XXF


XXF_INTVAL

cEmpAnt

xFili al("CTT")

CTT_CUSTO




RegisterSituation



Situação: '2'- 'Active';
'1'- 'Inactive'




GCCUSTO

ATIVO
"2-Active"= GCCUSTO.ATI VO = "A"
"1-Inactive"
=GCCUSTO.AT IVO= "F"

 




CTT



CTT_BLOQ



'Active' = "2"
'Inactive' = "1"

Name

 


GCCUSTO

NOME

 


CTT

CTT_DESC01

 


ShortCode

Código do centro de custo reduzido

GCCUSTO

CODREDUZID O

 


CTT

CTT_RES

 




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">
<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

Mensagem Padrão

Descrição

RM

 

 

 

 



Protheus

 

 

 

 







Tabela

Campo

Valor

 


Tabela

Campo

Valor

 


Code

Número do banco

GBANCO

NUMBANCO

 

 



SA6

A6_COD

 

 

 

 

 

 





FCONTA

NUMBANCO

 

 

 

 

 

 









FCXA

NUMBANCO

 

 

 

 

 

 







Febraban

Número do banco oficial

GBANCO

NUMEROOFICIA L

 

 



SA6

A6_NUMBCO

 

 





InternalId



Internal Id de integração



GBANCO



CODCOLIGADA

NUMBANCO

 

 





XXF



XXF_INTVAL

cEmpAnt

xFilial( "SA6")

A6_COD

A6_AGENCIA

A6_NUMCON

 


Name

Nome banco

GBANCO

NOME

 

 



SA6

A6_NOME

 

 



ShortName

Nome reduzido

GBANCO

NOMEREDUZID O

 

 



SA6

A6_

NREDUZ

 

 

NREDUZ






Agency/Num ber




Código da agência

GAGENCIA

NUMAGENCIA

 

 






SA6




A6_AGENCIA

 

 

 

 





FCONTA

NUMAGENCIA

 

 

 

 

 

 

 

 









FCXA

NUMAGENCIA

 

 

 

 

 

 







Agency/Nam e


Nome da agência


GAGENCIA


NOME

Concatenção de : "Agencia: "+ Agency/Number

 



SA6


A6_NOMEAGE

 

 



Agency/Addr ess/Number

Número do endereço da agência


GAGENCIA


NUMERO

 

 




Não se aplica.

 

 

 




Agency/Addr ess/Complem ent


Complemento


GAGENCIA


COMPLEMENTO

 

 




Não se aplica.

 

 

 




Agency/Addr ess/City/Desc ription


Cidade


GAGENCIA


CIDADE

 

 




SA6


A6_MUN

 


Agency/Addr ess/State/Co de


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

 

 

 




cEmpAnt

 

/Account
/CompanyId

 

FCXA

CODCOLIGADA

 

 

 

 


/Account
/CompanyId


FCXA

CODCOLIGADA

 








Agency/ ListOfAccount
/Account/Nu mber




Número da conta caixa

FCONTA

NROCONTA

 

 






SA6




A6_NUMCON

 

 

 




FCXA

CODCXA

 

 

 

 

 

 

 








FCXA

NROCONTA

 

 

 

 

 












Agency/ ListOfAccount
/Account/Na me








Nome da conta caixa









FCXA









DESCRICAO

Concatenação de: "Conta Caixa – ", Number
Se o parâmetro "CONTACAIXAA
UTOINC" estiver marcado,então o valor de DESCRICAÇÃO
será o seguinte: Banco {0} -
Agência {1} -
Conta {2} = Número do banco, Numero da agencia, Numero da conta

 










Não se aplica.

 

 



Agency/ ListOfAccount
/Account
/CompanyId


Coligada global


FCXA


CODCOLPROP

 

 

 





cEmpAnt

 


Agency/ ListOfAccount
/Account
/CompanyId


Coligada global da conta


FCXA


CODCOLCONTA

 

 

 





cEmpAnt

 




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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 





Tabela

Campo

Valor

Tabela

Campo

valor

CompanyId

Empresa

CCONTA

CODCOLIGADA

 

 



cEmpAnt

 


CompanyIntern alId

Internal Id da empresa

CCONTA

CODCOLIGADA

 


Não se aplica.

 

 



Code

Código da conta

CCONTA

CODCONTA

 


CT1

CT1_CONTA

 



InternalId


Internal id da conta


CCONTA


CODCOLIGADA

CODCONTA

 



XXF


XXF_INTVAL

cEmpAnt

xFilial( "CT1")

CT1_CO NTA


ShortCode

Código reduzido da conta


CCONTA


REDUZIDO

 


CT1

CT1_RES

 


Description

Descrição da conta

CCONTA

DESCRIÇÃO

 


CT1

CT1_DESC01

 






PostingNature





Natureza da conta





CCONTA





NATUREZA

-Valor "1" no Protheus equivale valor "1" na RM
(devedora)
-valor "2" no Protheus equivale Valor "0" na RM
(credora)





CT1





CT1_NORMAL





Devedora = "1"
Credora = "2"





AnalyticalOrSyn thetic





Analitica ou sintética





CCONTA





ANALITICA

-Valor "1" no Protheus equivale valor "0" na RM
(analítica)
-valor "1" no Protheus equivale Valor "2" na RM
(sintética)





CT1





CT1_CLASSE





Sintétita = "1"
Analítica = "2"





ActiveOrInactiv e





Ativo ou inativo





CCONTA





INATIVA

-Valor "1" no Protheus equivale valor "1" na RM
(bloqueada)
-valor "2" no Protheus equivale Valor "0" na RM
(não bloqueada)





CT1





CT1_BLOQ





Inativa = "1"
Ativa = "2"


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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 

 






Tabela

Campo

Valor

 


Tabela

Campo

Valor

 


CompanyId

Empresa

CHISTP

CODCOLIGADA

 

 



Não se aplica.

 

 

 




DefaultHistor yCode

Código do histórico padrão

CHISTP

CODHISTP

 

 



Não se aplica.

 

 

 




InternalId

Id de integração

CHISTP

CODCOLIGADA

CODHISTP

 

 



Não se aplica.

 

 

 




Description

Descrição

CHISTP

DESCRICAO

 

 



Não se aplica.

 

 

 






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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 





Tabela

Campo

Valor

Tabela

Campo

Valor

CompanyId

Empresa

CPARAM

CODCOLIGADA

 

 



cEmpAnt

 


CompanyInt ernalId

Internal Id da empresa


CPARAM


CODCOLIGADA

 

 



cEmpAnt

cFilAn t

 






CalendarCo de





Código do calendário





CPARAM





CODCOLIGADA

24

25

ID = 24 (corresponde a linha da parametrização da dataInicio do período contábil)
ID = 25 (corresponde a linha da parametrização da dataFIm do período contábil)





CTG





CTG_CALEND

 






InternalId





Id de integração





CPARAM





CODCOLIGADA

24

25

ID = 24 (corresponde a linha da parametrização da dataInicio do período contábil)
ID = 25 (corresponde a linha da parametrização da dataFIm do período contábil)





XXF





XXF_INTVAL



cEmpAnt

xF ilial("CTG")

CTG_CALE ND

CTG_E XERC

InitialDate

Data inicial do período contábil

CPARAM

CODCOLIGADA

24

 


CTG

CTG_DTINI

 


FinalDate

Data final do período contábil

CPARAM

CODCOLIGADA

25

 


CTG

CTG_DTFIM

 



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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 





Tabela

Campo

Valor

Tabela

Campo

Valor

CompanyId

Empresa

SITEMCONTABILPROTHEUS

CODCOLIGADA

 

 

 

 





CompanyInt ernalId

Internal Id da empresa


SITEMCONTABILPROTHEUS


CODCOLIGADA

 

 

 

 









BranchId





Código Filial





SITEMCONTABILPROTHEUS





CODFILIAL

 

 

 

 









InternalId





Id de integração





SITEMCONTABILPROTHEUS





CODCOLIGADA

ITEMCONTABIL

 

 

 

 





Code

Código do Item Contábil

SITEMCONTABILPROTHEUS

ITEMCONTABIL

 

 

 

 





Description

Descrição do Item contábil

SITEMCONTABILPROTHEUS

DESCRICAO

 

 

 

 






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).


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.



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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 

 






Tabela

Campo

Valor

 


Tabela

Campo

Valor

 


CompanyId

Empresa

SCLASSEVALORPROTHEUS

CODCOLIGADA

 

 

 

 

 

 







CompanyInt ernalId

Internal Id da empresa

SCLASSEVALORPROTHEUS


CODCOLIGADA

 

 

 

 

 

 











BranchId





Código Filial

SCLASSEVALORPROTHEUS





CODFILIAL

 

 

 

 

 

 











InternalId





Id de integração

SCLASSEVALORPROTHEUS





CODCOLIGADA

IDCLASSEVALOR

 

 

 

 

 

 







Code

Código da Classe de Valor

SCLASSEVALORPROTHEUS

IDCLASSEVALOR

 

 

 

 

 

 







Name

Descrição da Classe de Valor

SCLASSEVALORPROTHEUS

DESCRICAO

 

 

 

 

 

 







RegisterSituation

Status

SCLASSEVALORPROTHEUS

STATUS

 

 

 

 

 

Status

SCLASSEVALORPROTHEUS

STATUS

 







Class

Tipo

SCLASSEVALORPROTHEUS

TIPO

 

 

 

 

 

 








Exemplo de mensagem de entrada: 
<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

Mensagem Padrão

Descrição

RM

 

 



Protheus

 

 

 

 





Tabela

Campo

Valor

Tabela

Campo

Valor





InternalId





Internal Id do titulo





PFINANCEIRO





CODCOLIGADA

I DFINANC

 






XXF





XXF_INTVAL

cEmpAnt

xFilial( 'SE2')

E2_PRE FIXO

E2_NUM

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')

 


Origin

Código do sistema

PFINANCEIRO

ORIGEM

 

 

 

 





DocumentNu mber

Número do título

PFINANCEIRO

NUMERODOCU MENTO

 


SE2

E2_NUM

 


DocumentParcel

Parcela do documento

PFINANCEIRO

PARCELA

 

 

 

 





DocumentTyp eCode

Tipo do título

PFINANCEIRO

CODCOLIGADA

CODTDO

 


SE2

E2_TIPO

 


VendorCode

Código do Cliente/Fornecedor

PFINANCEIRO

CODCFO

 

 

 

 





VendorInternalId

Internal Id de Cliente/Fornecedor

PFINANCEIRO

CODCOLCFO

CO DCFO

 




XXF



XXF_INTVAL

cEmpAnt

xFilial( 'SA2')

E2_FOR NECE

E2_LOJ A

IssueDate

Data da Emissão

PFINANCEIRO

DATAEMISSAO

 

 

 

 





DueDate

Data de vencimento

PFINANCEIRO

DATAVENCIMEN TO

 


SE2

E2_VENCTO

 



RealDueDate

Data de vencimento


PFINANCEIRO

DATAVENCIMEN TO

 


SE2

E2_VENCRE A

 


NetValue

Valor Orignal

PFINANCEIRO

VALORORIGINAL

 


SE2

E2_VALOR

 


GrossValue

Valor Original

PFINANCEIRO

VALORORIGINAL

 

 

 

 





CurrencyCode

Código da

Moeda

PFINANCEIRO

CODMOEVALORORIGINAL

 

 

 

Moeda

PFINANCEIRO

CODMOEVALORORIGINAL

 








CurrencyInter nalId




Internal Id da moeda

 

 



Não será enviado nenhum valor. O Protheus automaticame nte incluirá o valor "1".

 

 

 






FinancialNatu reInternalId



Natureza financeira



PARAMETRO DE INTEGRAÇAO

Natureza financeira gravada no parâmetro "RH_NATUREZA FINANCEIRADEF AULT"



FinancialNatur eInternalId




XXF



XXF_INTV AL



cEmpAnt

xFilial("SED")

E 2_NATUREZ

Apportionmen tDistribution/ Apportionmen t/ CostCenterInternalId



Internal Id de Centro de Custo


PRATFINANCE IRO



CODCOLIGADA

CODCCUSTO

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ CostCenterCode

Código do Centro de Custo


PRATFINANCE IRO


CODCCUSTO

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ ProjectInternalId


Internal Id do projeto



PRATFINANCE IRO



CODCOLIGADA

IDPRJ

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ TaskInternalId


Internal Id da tarefa



PRATFINANCE IRO



CODCOLIGADA

IDTRF

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ Value


Valor



PRATFINANCE IRO



VALOR

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ AccountingItemCode


Item Contábil



PRATFINANCE IRO



IDITEMCONTABIL

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ AccountingItemInternalId


Internal Id de Item Contábil



PRATFINANCE IRO



CODCOLIGADA

IDITEMCONTABIL

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ ClassValueCode


Classe de Valor



PRATFINANCE IRO



IDCLASSEVALOR

 

 

 

 





Apportionmen tDistribution/ Apportionmen t/ ClassValueInternalId


Internal Id de Classe de Valor



PRATFINANCE IRO



CODCOLIGADA

IDCLASSEVALOR

 

 

 

 






Exemplo de mensagem de saída: 
<TOTVSMessage>
<MessageInformation version="2.002">
<UUID>c0e2f361-2819-4e52-acaa-b602b0bb9e00</UUID>
<Type>BusinessMessage</Type>
<Transaction>ACCOUNTPAYABLEDOCUMENT</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>RM</SourceApplication>
<CompanyId>1</CompanyId>
<BranchId>1</BranchId>
<Product name="RM" version="12.1.11" />
<GeneratedOn>2016-06-23T19:28:10</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>ACCOUNTPAYABLEDOCUMENT</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<InternalId>1|258</InternalId>
<CompanyId>1</CompanyId>
<CompanyInternalId>1</CompanyInternalId>
<BranchId>1</BranchId>
<Origin>RM</Origin>
<DocumentNumber>258</DocumentNumber>
<DocumentParcel />
<DocumentTypeCode>10</DocumentTypeCode>
<VendorCode>000000000001461</VendorCode>
<VendorInternalId>1|000000000001461</VendorInternalId>
<IssueDate>2016-06-20T00:00:00</IssueDate>
<DueDate>2016-12-31T00:00:00</DueDate>
<RealDueDate>2016-12-31T00:00:00</RealDueDate>
<NetValue>460</NetValue>
<GrossValue>460</GrossValue>
<CurrencyCode />
<CurrencyInternalId />
<FinancialNatureInternalId>1|14</FinancialNatureInternalId>
<ApportionmentDistribution>
<Apportionment>
<CostCenterInternalId>1|0335</CostCenterInternalId>
<CostCenterCode>0335</CostCenterCode>
<ProjectInternalId />
<TaskInternalId />
<Value>460</Value>
<AccountingItemCode/ >
<AccountingItemInternalId/>
<ClassValueCode />
<ClassValueInternalId/>
</Apportionment>
</ApportionmentDistribution>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage>


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



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. 


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


Pasta [identificação]


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]:


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 





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 



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).


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.


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






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

Mensagem Padrão

Descrição

RM

 

 

 




Protheus

 

 

 

 





Tabela

Campo

Valor

Tabela

 


Campo

Valor

CompanyId

Empresa

PCONTABIIZACAO

CODCOLIGADA

 

 

 




cEmpAnt

 


BranchId

Filial

PCONTABILIZACAO

CODFILIAL

 

 

PCONTABILIZACAO

CODFILIAL

 




cFilAnt

 


CompanyInt ernalId

Internal Id da empresa

PCONTABILIZACAO

CODCOLIGADA

 


Não se aplica.

 

 

 




OriginCode

Código do Sistema de Origem

PCONTABILIZACAO

ORIGEM

 

 

 

 

 






PeriodStart Date

Data inicial do período contábil

PCONTABILIZACAO


DATAINICIAL

 



CT2

 



CT2_DATA

 


PeriodoEnd Date

Data final do período contábil

PCONTABILIZACAO


DATAFINAL

 


CT2

 


CT2_DATA

 


BatchNumb er

Código do lote contábil

PCONTABILIZACAO

CODLOTE

 


CT2

 


CT2_LOTE

 






Document




Número do documento contábil




PCONTABILIZACAO





CODLOTE

Rh da Rm não tem essa informação no cabeçalho dos lançamentos contábeis.
Inicialmente enviaremos o Código do Lote





CT2

 






CT2_DOC

 






InternalId




Internal Id do lançamento contábil




PCONTABILIZACAO




CODCOLIGAD A

CODLOTE

 





XXF

 





XXF_INTVAL

cEmpAnt

xFilial ("CT2")

CT2_D ATA

CT2_LOT
E

CT2_SBLOTE

CT2_DOC


Entries/Entr y/item


Número da linha.

Será enviado um auto-incromento contendo número da linha da partida.


Entries/Entry/ite m


Número da linha.


CT2

 



CT2_LINHA

 




Entries/Entr y/ItemType




Tipo da linha

ItemType = 3 [ partida dobrada] ItemType = 2 [ partida de crédito] ItemType = 1 [ partida de débito]



Entries/Entry/Ite mType




Tipo da linha




CT2

 





CT2_DC

1=Debito 2=Credito 3=Partida Dobrada 4=Cont.Hist 5=Rateio 6=Lcto Padrao




Entries/Entr y/EntryNum ber




Identificação da partida contábil





PPARTIDA




CODCOLIGAD A

IDPARTIDA

 

 

 




cEmpAnt

xFilial( "CT2")

CT2_DA TA

CT2_LOTE

CT2_SBLOTE

CT2_DOC

CT2
_LINHA

 


Entries/Entr y/Movemen tDate

Data da partida contábil


PPARTIDA


DATA

 


CT2

 


CT2_DATA

 


Entries/Entr y/DebitAcco untCode

Código da conta de débito


PPARTIDA


DEBITO

 


CT2

 


CT2_DEBITO

 


Entries/Entr y/DebitAcco untInternalI d

Internal Id da conta contábil de débito


PPARTIDA


CODCOLDEBIT O

DEBITO

 



XXF

 



XXF_INTVAL

cEmpAnt

xFilial ("CT1")

CT2_D EBITO

Entries/Entr y/CreditAcc ountCode

Código da conta de crédito


PPARTIDA


CREDITO

 


CT2

 


CT2_CREDIT

 


Entries/Entr y/CreditAcc ountInternal Id

Internal Id da conta contábil de crédito


PPARTIDA


CODCOLCRED ITO

CREDITO

 



XXF

 



XXF_INTVAL

cEmpAnt

xFilial ("CT1")

CT2_C REDIT

Entries
/EntryValue

Valor do lançamento

PPARTIDA

VALOR

 


CT2

 


CT2_VALOR

 



Entries/Entr y/HistoryCo de


Código do histórico padrão

 

 



Não será enviada nenhuma informação nesse campo



CT2

 

 

 

 

 




CT2_HP

 






visto que a sincronização do histórico contábil ainda não

foi implementada

 

 

 

 

foi implementada







Entries/Entr y/Complem entaryHistor y




Histórico complementar




PPARTIDA




COMPLEMENT O

As informações de complemento de histórico serão enviadas nesse campo.




CT2

 





CT2_HIST

 


Entries/Entr y/CostCent erCode

Centro de custo de débito


PPARTIDA


CODCCUSTO

 


CT2

 


CT2_CCD

 


Entries/Entr y/CostCent erDebitInter nalId

InternalId do centro de custo de débito


PPARTIDA

CODCOLDEBIT O

CODCCUST O

 



XXF

 



XXF_INTVAL

cEmpAnt

xFilial ("CTT")

CT2_C CD

Entries/Entr y/CostCent erCreditCod e

Centro de custo de crédito


PPARTIDA


CODCCUSTO

 



CT2

 



CT2_CCC

 


Entries/Entr y/CostCent erCreditInte rnalId

InternalId do centro de custo de crédito


PPARTIDA

CODCOLCRED ITO

CODCCUS TO

 



XXF

 



XXF_INTVAL

cEmpAnt

xFilial ("CTT")

CT2_C CC

Entries/Entr y/AccountingItemDebitCode

Item Contábil para Conta de Debito


PPARTIDA

IDITEMCONTABIL

 

 

 

 

 






Entries/Entr y/AccountingItemDebitInternalId

InternalId de Item Contábil para Conta de Debito


PPARTIDA

CODCOLIGADA

IDITEMCONTABIL

 

 

 

 

 






Entries/Entr y/AccountingItemCreditCode

Item Contábil para conta de Crédito


PPARTIDA

IDITEMCONTABIL

 

 

 

 

 






Entries/Entr y/AccountingItemCreditInternalId

Internal Id de Item Contábil para conta de Crédito


PPARTIDA

CODCOLIGADA

IDITEMCONTABIL

 

 

 

 

 






Entries/Entr y/ClassValueDebitCode

Classe de Valor para Conta de Debito


PPARTIDA

IDCLASSEVALOR

 

 

 

 

 






Entries/Entr y/ClassValueDebitInternalId

Internal Id de Classe de Valor para Conta de Debito


PPARTIDA

CODCOLIGADA

IDCLASSEVALOR

 

 

 

 

 






Entries/Entr y/ClassValueCreditCode

Classe de Valor para Conta de Crédito


PPARTIDA

IDCLASSEVALOR

 

 

 

 

 






Entries/Entr y/ClassValueCreditInternalId

Internal Id de Classe de Valor para Conta de Crédito


PPARTIDA

CODCOLIGADA

IDCLASSEVALOR

 

 

 

 

 






Entries/Entr y/AccountantDefaultHistoryInternalId

Internal Id de Histórico Padrão

PPARTIDA

CODCOLIGADA

CODHISTP

 

 

 

 


PPARTIDA

CODCOLIGADA

CODHISTP

 







Exemplo de mensagem de saída: 
<TOTVSMessage>
<MessageInformation version="2.002">
<UUID>0627d7a4-c11e-4cd5-9a79-975cdb447164</UUID>
<Type>BusinessMessage</Type>
<Transaction>ACCOUNTINGENTRY</Transaction>
<StandardVersion>1.000</StandardVersion>
<SourceApplication>RM</SourceApplication>
<CompanyId>1</CompanyId>
<BranchId>1</BranchId>
<Product name="RM" version="12.1.13.0" />
<GeneratedOn>2016-09-12T18:09:45</GeneratedOn>
<DeliveryType>Sync</DeliveryType>
</MessageInformation>
<BusinessMessage>
<BusinessEvent>
<Entity>ACCOUNTINGENTRY</Entity>
<Event>upsert</Event>
</BusinessEvent>
<BusinessContent>
<InternalId>1|9999999</InternalId>
<BranchId>1</BranchId>
<CompanyInternalId>1|1</CompanyInternalId>
<CompanyId>1</CompanyId>
<OriginCode>P</OriginCode>
<PeriodStartDate>2016-08-16T00:00:00</PeriodStartDate>
<PeriodoEndDate>2016-08-16T00:00:00</PeriodoEndDate>
<BatchNumber>9999999</BatchNumber>
<Document />
<Entries>
<Entry>
<Item>1</Item>
<ItemType>1</ItemType>
<EntryNumber>1|6831</EntryNumber>
<MovementDate>2016-08-16T00:00:00</MovementDate>
<DebitAccountCode>6.2.1.01.01</DebitAccountCode>
<DebitAccountInternalId>1|6.2.1.01.01</DebitAccountInternalId>
<CreditAccountCode />
<EntryValue>300</EntryValue>
<ComplementaryHistory>COMPLEMENTO HST EVENTO</ComplementaryHistory>
<CostCenterCode>5000</CostCenterCode>
<CostCenterDebitInternalId>1|5000</CostCenterDebitInternalId>
<CostCenterCreditCode />
<AccountingItemDebitCode>23</AccountingItemDebitCode>
<AccountingItemDebitInternalId>1|23</AccountingItemDebitInternalId>
<AccountingItemCreditCode>23</AccountingItemCreditCode>
<AccountingItemCreditInternalId>1|23</AccountingItemCreditInternalId>
<ClassValueDebitCode>15</ClassValueDebitCode>
<ClassValueDebitInternalId>1|15</ClassValueDebitInternalId>
<ClassValueCreditCode>15</ClassValueCreditCode>
<ClassValueCreditInternalId>1|15</ClassValueCreditInternalId>
<AccountantDefaultHistoryInternalId>1|00001</AccountantDefaultHistoryInternalId>
</Entry>
<Entry>
<Item>2</Item>
<ItemType>2</ItemType>
<EntryNumber>1|6832</EntryNumber>
<MovementDate>2016-08-16T00:00:00</MovementDate>
<DebitAccountCode />
<CreditAccountCode>6.2.1.01.02</CreditAccountCode>
<CreditAccountInternalId>1|6.2.1.01.02</CreditAccountInternalId>
<EntryValue>300</EntryValue>
<ComplementaryHistory>Teste Teste</ComplementaryHistory>
<CostCenterCode />
<CostCenterCreditCode>5000</CostCenterCreditCode>
<CostCenterCreditInternalId>1|5000</CostCenterCreditInternalId>
<AccountingItemDebitCode>23</AccountingItemDebitCode>
<AccountingItemDebitInternalId>1|23</AccountingItemDebitInternalId>
<AccountingItemCreditCode>23</AccountingItemCreditCode>
<AccountingItemCreditInternalId>1|23</AccountingItemCreditInternalId>
<ClassValueDebitCode>15</ClassValueDebitCode>
<ClassValueDebitInternalId>1|15</ClassValueDebitInternalId>
<ClassValueCreditCode>15</ClassValueCreditCode>
<ClassValueCreditInternalId>1|15</ClassValueCreditInternalId>
</Entry>
</Entries>
</BusinessContent>
</BusinessMessage>
</TOTVSMessage> 
Notas: 
A informação do "Código do Lote" [BatchNumber] será utilizada como identificador do lote contábil enviado para o Protheus e para o correto recebimento o RM deverá envia-lo com tamanho máximo de 8 caracteres.
Para garantir a integridade dos dados no Protheus já que o processo de contabilização no RM Labore poderá ser executado diversas vezes, será enviada uma mensagem do RM Labore para o Protheus excluir todos os registros contábeis do lote (somente em caso de já existir um mapeamento para o lote em questão no lado RM), e somente após isso, ocorrerá o envio das mensagens de inclusão de lançamentos. Caso ocorra algum erro no envio de algum pacote contábil, o Rm enviará uma mensagem de exclusão do lote em questão. 
IMPORTANTE: as mensagens contendo os dados da contabilização serão enviadas de forma síncrona, 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á também trabalhar com o conceito de mensagem síncrona. Ou seja, antes dele enviar à resposta (ResponseMessage) a mesma deve ser processada pelo receptor. Isso para evitar que a mensagem de exclusão seja processada depois de alguma inserção já realizada.
Obs: As mensagens contábeis enviadas serão divididas em pacotes devido a uma limitação no recebimento das mesmas. Será criado um parâmetro no RM Labore para o usuário informar a quantidade de partidas que deverão ser enviadas em cada pacote. 

O processo de envio de pacotes acontecerá no seguinte esquema:

...

  • Verificar se o Protheus está na versão 11.80 ou superior.
  • Verificar se as datas dos programas envolvidos estão de acordo com as especificadas nos pré-requisitos.
  • Verificar se os webservices estão ativos e acessíveis (é possível testar acessando-o através de um navegador).
  • Se a mensagem estiver no modo Assíncrono, verificar se os serviços de agendamento e se os agentes estão iniciados, conforme indicado no capítulo 6.1 (instalação).

 

...


Âncora
_bookmark19
_bookmark19
Âncora
_Toc462828130
_Toc462828130
Anexos

Não se aplica.

Âncora
_bookmark19
_bookmark19
Âncora
_Toc462828131
_Toc462828131
Novidades da Integração

Foi adaptado para que seja levado o Histórico Financeiro na Integração 1.0 

Versões que contempla a implementação (12.1.25.189 e superiores | 12.1.26.131 e superiores e 12.1.27 release)

  • RM: Preenchido o campo 'Complemento de Histórico' e utilizando uma Fórmula para complemento de histórico que retorna o valor 2000.

Image Added

  • Protheus: Note que as informações informadas no RM, foram corretamente para o lançamento financeiro para o Protheus.

Image Added

Quando Utilizado o Histórico Padrão é levado corretamente também.

Obs: Lembrando que o Protheus existe um limite de 40 caracteres.

Image Added

Não se aplica.