Cadastros
Cadastros Especiais
Será necessário primeiro fazer o cadastro É necessário cadastrar manualmente no Protheus e no RM e depois e posteriormente configurar o “dede/para” 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 | 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 suas 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.
ExExemplo:
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 |
Info |
---|
|
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 extensão criados nas integrações. |
Cadastros comuns
<Plano de Contas> 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 |
Info |
---|
|
Está disponível no RM um campo chamado “NATSPED” conforme print abaixo. Esse RM o campo NATSPED,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á não é transferido na mensagem, pois o mesmo deve estar somente no backoffice. Porém, porém esse campo é obrigatório para inclusão da conta contábil no RM. Sendo assim, iremos gravar o valor de valor “01 01 – Não informado” informado somente para permitir a geração. |
Info |
---|
|
A máscara parametrizada da conta contábil no TOTVS Contabilidade Gerencial será Gerencial é 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 no código de conta (ex, exemplo: 1011214), então o parâmetro “Não Não utiliza máscara nas contas” contas deve ser marcado. Caso contrário, ocorrerá um erro no processo de inclusão da conta. |
Caminho para acesso ao cadastro do Plano de contas, no sistema:
Acesse: BackOffice | Contabilidade Gerencial | Cadastros | 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 | BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros
01.01 – Plano de Contas | Contas / 01.01.01 – Plano de Contas contábil | contábil / Plano de Contas Contábil | Contábil / Não utilizar máscara nas contas
No cenário onde o Protheus possuir 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 | BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros
01.01 – Plano de Contas | Contas / 01.01.01 – Plano de Contas contábil | Plano Contas | contábil / Plano Contas / Acessa conta globais
01.01 – Plano de Contas | Contas / 01.01.01 – Plano de Contas contábil | Plano Contas | contábil / Plano Contas / Cadastrar como global por padrão
(Mais detalhes do cadastro de Plano de Conta acesse Principais Cadastros da Integração)
Note |
---|
Note |
---|
|
A configuração para utilização da conta Global será é realizada somente se somente caso o Protheus tiver um compartilhamento por Empresa. |
<Centro Centro de
custo> 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 |
| | | | | |
Informações importantes sobre a mensagem de Centro de Custo:
O código do centro de custo no TOTVS Gestão Financeira poderá pode ser criado de forma sequencial ou através de ou por meio de máscara. Essa definição poderá ser feita através do pode ser por meio do parâmetro EDUCTBCCUSTOAUTOINC criado nos parâmetros de integração.
Se o Caso o parâmetro estiver esteja com valor True (marcado) o código enviado será enviado é ignorado e um código de auto incremento será incremento é gerado. Se Se o parâmetro estiver com valor False (desmarcado) será é 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 Integração / Integração / Mensagem Única / Integrações / Anexo Parâmetros de Integração
A máscara de centro de custo deverá deve ser removida para que o sistema financeiro TOTVS Gestão Financeira aceite os código enviado pelo PROTHEUSProtheus, na integração.
No sistema, o parâmetro pode ser acessado através do caminho:
acessado pelo caminho:
Acesse: MóduloBackOffice / Gestão Financeira / Ambiente / Parâmetros / Acesse: MóduloBackOffice | Gestão Financeira | Ambiente | Parâmetros | TOTVS Gestão Financeira
02.02 – Contas a receber | receber / 02.02.01 – Manutenção de Lançamentos | Lançamentos / 02.02.01.01 – Lançamento | Lançamento / Centro de Custo | Custo / Máscara do Centro de Custo
Caminho para acesso ao cadastro do Centro de Custo, no sistema:
Acesse:
BackOffice | Gestão Financeira | Cadastros | BackOffice / Gestão Financeira / Cadastros / Centro de Custo
<Histórico Padrão>
(Mais detalhes do cadastro de Centro de Custo acesse Principais Cadastros da Integração)
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 |
|
Info |
---|
|
Apesar da mensagem de histórico padrão pertencer a integração, ainda , não será utilizada. |
<Período Contábil>
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 |
Info |
---|
|
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) |
No processo de integração, o RM atualizará atualiza as datas de 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, teremos espaço 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 | BackOffice / Contabilidade Gerencial / Ambiente / Parâmetros / TOTVS Contabilidade Gerencial
01.04 –
Fechamento | Fechamento / 01.04.01 – Fechamento Mensal
<Lançamentos Contábeis>
(Mais detalhes do cadastro de Período Contábil acesse Principais Cadastros da Integração)
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 Código do Lote” 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 / Contabilidade > Processo de Contabilidade), será é enviado uma mensagem com todos os lançamentos contábeis processados para o Protheus.
Caso seja executado o processo de estorno (Aba Financeiro / Contabilidade / Contabilidade > Processo de Contabilidade), deverá ser enviada uma mensagem com os lançamentos de estorno como se estissem incorporados ao lote “0”, nesse caso eles nunca 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 / Contabilidade
Educacional / Educacional / Financeiro / Contábil / Educacional | Educacional | Financeiro / Contábil | Contratos
Processos / Processos | Gerar contabilização
Importante:
As informações de Item Contábil e Classe de Valor
serão são obtidas
através por meio da Matriz Aplicada do Educacional.
Quando houver necessidade de enviá-las Caso seja necessário enviar na mensagem de lançamentos contábeis será necessário a configuração do Evento Contábil
para buscapara buscá-las.
Será É exibida a aba
“Integração Protheus” 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” Matriz Aplicada, na aba
“Integração Protheus” 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,
elas serão estas são enviadas para a integração.
A mesma configuração
poderá 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” será Integração Protheus é exibida para todos os eventos do tipo: Contrato Educacional, Parcela Educacional e Movimento.