Cadastros
Cadastros Especiais
É necessário cadastrar manualmente no Protheus e no RM e posteriormente configurar o de/para de integração correspondente (RM e Protheus possuem interfaces específicas para este fim).
RM: RM.exe / Segmento Integrações / Aba Integração / Mensagem Única / De-Para
Empresa e Filial
O primeiro cadastro que deve ser realizado para operação dos sistemas é o de Empresa (Coligada) e as 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 (Filial) |
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 |
Cadastros comuns
<Plano de Contas>
Identificador da Mensagem: AccountAntAccount
Versão: 2.000
Módulo Gestão Contábil: RM
Módulo Protheus: Protheus
Tipo de Envio:
Mensagem Padrão | RM | PROTHEUS |
Tabela | Campo | Tabela | Campo |
CompanyId | CCONTA | CODCOLIGADA | - | Variável do Sistema |
CompanyInternalId | CCONTA | CODCOLIGADA | - | Variável do Sistema |
Code | CCONTA | CODCONTA | CT1 | CT1_CONTA |
InternalId | CCONTA | CODCOLIGADA|CODCONTA | CT1 | CT1_FILIAL|CT1_CONTA |
ShortCode | CCONTA | REDUZIDO | CT1 | CT1_RES |
Description | CCONTA | DESCRIÇÃO | CT1 | CT1_DESC01 |
PostingNature | CCONTA | NATUREZA | CT1 | CT1_NORMAL |
AnalyticalOrSynthetic | CCONTA | ANALITICA | CT1 | CT1_CLASSE |
ActiveOrInactive | CCONTA | INATIVA | CT1 | CT1_BLOQ |
Caminho para acesso ao cadastro do Plano de contas, no sistema:
Acesse: BackOffice / Contabilidade Gerencial / Cadastros / Contábil
Caminho para acesso ao parâmetro para não utilizar máscara:
Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros
01.01 – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano de Contas Contábil / Não utilizar máscara nas contas
No cenário em que o Protheus possua um compartilhamento por Empresa e por Filial para o Plano de Contas, o TOTVS Contabilidade Gerencial deve ser parametrizado para utilizar contas globais por padrão:
Caminho para acesso ao parâmetro para utilizar conta global:
Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros
01.01 – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano Contas / Acessa conta globais
01.01 – Plano de Contas / 01.01.01 – Plano de Contas contábil / Plano Contas / Cadastrar como global por padrão
<Centro de custo>
Identificador da Mensagem: CostCenter
Versão: 2.000
Módulo Gestão Financeira: RM
Módulo Protheus: Protheus
Tipo de Envio:
Mensagem Padrão | RM | PROTHEUS |
Tabela | Campo | Tabela | Campo |
CompanyId | GCCUSTO | CODCOLIGADA | - | Variável do Sistema |
CompanyInternalId | | | - | Variável do Sistema |
BranchId | | | CTT | CTT_FILIAL |
InternalId | GCCUSTO | CODCOLIGADA|CODCCUSTO | CTT | CTT_FILIAL|CTT_CUSTO |
Code | GCCUSTO | CODCCUSTO | CTT | CTT_CUSTO |
Name | GCCUSTO | NOME | CTT | CTT_DESC01 |
RegisterSituation | GCCUSTO | ATIVO | CTT | CTT_BLOQ |
ShortCode | GCCUSTO | CODREDUZIDO | CTT | CTT_RES |
Sped | GCCUSTO | ENVIASPED | - | - |
Class | GCCUSTO | | CTT | CTT_CLASSE |
Informações importantes sobre a mensagem de Centro de Custo:
O código do centro de custo no TOTVS Gestão Financeira pode ser criado de forma sequencial ou por meio de máscara. Essa definição pode ser por meio do parâmetro EDUCTBCCUSTOAUTOINC criado nos parâmetros de integração.
Caso o parâmetro esteja com valor True (marcado) o código enviado é ignorado e um código de auto incremento é gerado. Se o parâmetro estiver com valor False (desmarcado) é utilizado o código enviado pelo sistema de origem de acordo com a máscara utilizada.
Acesse: Módulo Integração / Integração / Mensagem Única / Integrações / Anexo Parâmetros de Integração
A máscara de centro de custo deve ser removida para que o sistema financeiro TOTVS Gestão Financeira aceite os código enviado pelo Protheus, na integração.
No sistema, o parâmetro pode ser acessado pelo caminho:
Acesse: Módulo BackOffice / Gestão Financeira / Ambiente / Parâmetros / TOTVS Gestão Financeira
02.02 – Contas a receber / 02.02.01 – Manutenção de Lançamentos / 02.02.01.01 – Lançamento / Centro de Custo / Máscara do Centro de Custo
Caminho para acesso ao cadastro do Centro de Custo, no sistema:
Acesse: BackOffice / Gestão Financeira / Cadastros / Centro de Custo
<Histórico Padrão>
Identificador da Mensagem: AccountAntDefaultHistory
Versão: 1.000
Módulo Educacional: RM
Módulo Protheus: Protheus
Tipo de Envio:
Mensagem Padrão | RM | PROTHEUS |
Tabela | Campo | Tabela | Campo |
CompanyId | CHISTP | CODCOLIGADA | | |
DefaultHistoryCode | CHISTP | CODHISTP | | |
InternalId | CHISTP | CODCOLIGADA|CODHISTP | | |
Description | CHISTP | DESCRICAO | | |
DefaultHistoryCode | CHISTP | CODCOLIGADA | | |
<Período Contábil>
Identificador da Mensagem: AccountingCalendar
Versão: 1.000
Módulo Educacional: RM
Módulo Protheus: Protheus
Tipo de Envio:
Mensagem Padrão | RM | PROTHEUS |
Tabela | Campo | Tabela | Campo |
CompanyId | CPARAM | CODCOLIGADA | - | Variável do Sistema |
CompanyInternalId | CPARAM | CODCOLIGADA | - | Variável do Sistema |
CalendarCode | CPARAM | CODCOLIGADA |24|25 | CTG | CTG_CALEND |
InternalId | CPARAM | CODCOLIGADA|24|25 | CTG | CTG_FILIAL|CTG_CALEND|CTG_EXERC |
InitialDate | CPARAM | CODCOLIGADA|24 | CTG | CTG_DTINI |
FinalDate | CPARAM | CODCOLIGADA|25 | CTG | CTG_DTFIM |
No processo de integração, o RM atualiza as datas do 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, apenas há espaço para armazenar somente uma dataIncial e uma dataFinal.
Caminhos para a parametrização do período contábil:
Acesse: BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros / TOTVS Contabilidade Gerencial
01.04 – Fechamento / 01.04.01 – Fechamento Mensal
<Lançamentos Contábeis>
Identificador da Mensagem: AccountingEntry
Versão: 2.000
Módulo Gestão de Estoque, Compras e Faturamento: RM
Módulo Protheus: Protheus
Tipo de Envio:
Mensagem Padrão | RM | PROTHEUS |
Tabela | Campo | Tabela | Campo |
CompanyId | CLANCAMENTO | CODCOLIGADA | - | Variável do Sistema |
BranchId | CLANCAMENTO | CODFILIAL | - | Variável do Sistema |
CompanyInternalId | CLANCAMENTO | CODCOLIGADA | - | Variável do Sistema |
PeriodStartDate | CLANCAMENTO | DATAINICIAL | - | - |
PeriodoEndDate | CLANCAMENTO | DATAFINAL | - | - |
BatchNumber | CLANCAMENTO | CODLOTE | CT2 | CT2_LOTE |
Document | CLANCAMENTO | CODLOTE | CT2 | CT2_DOC |
InternalId | CLANCAMENTO | CODCOLIGADA|CODLOTE | CT2 | CT2_FILIAL | CT2_DATA | CT2_LOTE | CT2_SBLOTE | CT2_DOC |
Entries/Entry/item | | | CT2 | CT2_LINHA |
Entries/Entry/ItemType | | | CT2 | CT2_DC |
Entries/Entry/EntryNumber | CPARTIDA | CODCOLIGADA| IDPARTIDA | - | - |
Entries/Entry/MovementDate | CPARTIDA | DATA | CT2 | CT2_DATA |
Entries/Entry/DebitAccountCode | CPARTIDA | DEBITO | CT2 | CT2_DEBITO |
Entries/Entry/DebitAccountInternalId | CPARTIDA | CODCOLDEBITO|DEBITO | CT1 | CT1_FILIAL | CT1_CONTA |
Entries/Entry/CreditAccountCode | CPARTIDA | CREDITO | CT2 | CT2_CREDIT |
Entries/Entry/CreditAccountInternalId | CPARTIDA | CODCOLCREDITO|CREDITO | CT1 | CT1_FILIAL | CT1_CONTA |
Entries /EntryValue | CPARTIDA | VALOR | CT2 | Ct2_VALOR |
Entries/Entry/HistoryCode | | | CT2 | CT2_HP |
Entries/Entry/ComplementaryHistory | CPARTIDA | COMPLEMENTO | CT2 | Ct2_HIST |
Entries/Entry/CostCenterCode | CPARTIDA | CODCCUSTO | CT2 | CT2_CCD |
Entries/Entry/CostCenterDebitInternalId | CPARTIDA | CODCOLIGADA|CODCCUSTO | CTT | CTT_FILIAL | CTT_CUSTO |
CompanyId | CPARTIDA | CODCCUSTO | - | Variável do Sistema |
BranchId | CPARTIDA | CODCOLIGADA|CODCCUSTO | - | Variável do Sistema |
CompanyInternalId | CLANCAMENTO | CODCOLIGADA | - | Variável do Sistema |
PeriodStartDate | CLANCAMENTO | CODFILIAL | - | - |
PeriodoEndDate | CLANCAMENTO | CODCOLIGADA | - | - |
BatchNumber | CLANCAMENTO | DATAINICIAL | CT2 | CT2_LOTE |
Document | CLANCAMENTO | DATAFINAL | CT2 | CT2_DOC |
InternalId | CLANCAMENTO | CODLOTE | CT2 | CT2_FILIAL | CT2_DATA | CT2_LOTE | CT2_SBLOTE | CT2_DOC |
Entries/Entry/item | CLANCAMENTO | CODLOTE | CT2 | CT2_LINHA |
Entries/Entry/ItemType | CLANCAMENTO | CODCOLIGADA|CODLOTE | CT2 | CT2_DC |
Entries/Entry/EntryNumber | | | - | - |
Entries/Entry/MovementDate | | | CT2 | CT2_DATA |
Entries/Entry/DebitAccountCode | CPARTIDA | CODCOLIGADA| IDPARTIDA | CT2 | CT2_DEBITO |
Entries/Entry/DebitAccountInternalId | CPARTIDA | DATA | CT1 | CT1_FILIAL | CT1_CONTA |
Entries/Entry/CreditAccountCode | CPARTIDA | DEBITO | CT2 | CT2_CREDIT |
Entries/Entry/CreditAccountInternalId | CPARTIDA | CODCOLDEBITO|DEBITO | CT1 | CT1_FILIAL | CT1_CONTA |
Entries /EntryValue | CPARTIDA | CREDITO | CT2 | Ct2_VALOR |
Entries/Entry/HistoryCode | CPARTIDA | CODCOLCREDITO|CREDITO | CT2 | CT2_HP |
Entries/Entry/ComplementaryHistory | CPARTIDA | VALOR | CT2 | Ct2_HIST |
Entries/Entry/CostCenterCode | | | CT2 | CT2_CCD |
Entries/Entry/CostCenterDebitInternalId | CPARTIDA | COMPLEMENTO | CTT | CTT_FILIAL | CTT_CUSTO |
CompanyId | CPARTIDA | CODCCUSTO | - | Variável do Sistema |
BranchId | CPARTIDA | CODCOLIGADA|CODCCUSTO | - | Variável do Sistema |
CompanyInternalId | CPARTIDA | CODCCUSTO | - | Variável do Sistema |
PeriodStartDate | CPARTIDA | CODCOLIGADA|CODCCUSTO | - | - |
PeriodoEndDate | CLANCAMENTO | CODCOLIGADA | - | - |
BatchNumber | CLANCAMENTO | CODFILIAL | CT2 | CT2_LOTE |
Document | CLANCAMENTO | CODCOLIGADA | CT2 | CT2_DOC |
InternalId | CLANCAMENTO | DATAINICIAL | CT2 | CT2_FILIAL | CT2_DATA | CT2_LOTE | CT2_SBLOTE | CT2_DOC |
Entries/Entry/item | CLANCAMENTO | DATAFINAL | CT2 | CT2_LINHA |
Entries/Entry/ItemType | CLANCAMENTO | CODLOTE | CT2 | CT2_DC |
Entries/Entry/EntryNumber | CLANCAMENTO | CODLOTE | - | - |
Entries/Entry/MovementDate | CLANCAMENTO | CODCOLIGADA|CODLOTE | CT2 | CT2_DATA |
Entries/Entry/DebitAccountCode | | | CT2 | CT2_DEBITO |
Entries/Entry/DebitAccountInternalId | | | CT1 | CT1_FILIAL | CT1_CONTA |
Entries/Entry/CreditAccountCode | | CODCOLIGADA| IDPARTIDA | CT2 | CT2_CREDIT |
Entries/Entry/ AccountingItemDebitCode | SHABILITACAOFILIALINTPROTHEUS | IDCLASSEVALORPROTHEUS | CT2 | CT2_ITEMD |
Entries/Entry/ AccountingItemDebitInternalId | SHABILITACAOFILIALINTPROTHEUS | CODCOLIGADA| IDCLASSEVALORPROTHEUS | | |
Entries/Entry/ AccountingItemCreditCode | SHABILITACAOFILIALINTPROTHEUS | IDCLASSEVALORPROTHEUS | CT2 | CT2_ITEMC |
Entries/Entry/ AccountingItemCreditInternalId | SHABILITACAOFILIALINTPROTHEUS | CODCOLIGADA| IDCLASSEVALORPROTHEUS | | |
Entries/Entry/ ClassValueDebitCode | SHABILITACAOFILIALINTPROTHEUS | IDITEMCONTABILPROTHEUS | CT2 | CT2_CLVLDB |
Entries/Entry/ ClassValueDebitInternalId | SHABILITACAOFILIALINTPROTHEUS | CODCOLIGADA| IDITEMCONTABILPROTHEUS | | |
Entries/Entry/ ClassValueCreditCode | SHABILITACAOFILIALINTPROTHEUS | IDITEMCONTABILPROTHEUS | CT2 | CT2_CLVLCR |
Entries/Entry/ ClassValueCreditInternalId | SHABILITACAOFILIALINTPROTHEUS | CODCOLIGADA| IDITEMCONTABILPROTHEUS | | |
Informações importantes sobre a geração de lançamentos contábeis:
A informação do Código do Lote [BatchNumber] será utilizada como identificador do lote contábil enviado para o Protheus.
Durante a geração de contabilização por competência do Educacional (Aba Financeiro / Contabilidade / Processo de Contabilidade), é enviado uma mensagem com todos os lançamentos contábeis processados para o Protheus.
Caso seja executado o processo de estorno (Aba Financeiro / Contabilidade / Processo de Contabilidade), deverá ser enviada uma mensagem com os lançamentos de estorno como se estissem incorporados ao lote 0, que neste caso nunca serão excluídos.
Caminhos para acesso a geração da contabilização:
Educacional / Educacional / Financeiro / Contábil / Contabilidade
Educacional / Educacional / Financeiro / Contábil / Contratos
Processos / Gerar contabilização
Importante:
As informações de Item Contábil e Classe de Valor são obtidas por meio da Matriz Aplicada do Educacional. Caso seja necessário enviar na mensagem de lançamentos contábeis será necessário a configuração do Evento Contábil para buscá-las.
É exibida a aba Integração Protheus, no cadastro de Evento Contábil, quando a integração estiver ativa. Após a configuração de busca para Matriz Aplicada, na aba Integração Protheus, ao enviar a mensagem de lançamentos contábeis e as informações de Item Contábil e Classe de Valor vinculadas, estas são enviadas para a integração.
A mesma configuração pode ser realizada no Módulo de Gestão de Estoque, Compras e Faturamento para envio dessas informações na contabilização do movimento.
A aba Integração Protheus é exibida para todos os eventos do tipo: Contrato Educacional, Parcela Educacional e Movimento.