Replicação do Plano de Contas DeRE

A integração do Gestão Empresarial | ERP com o módulo fiscal da Reforma Tributária envia para a SeniorX o plano de contas DeRE: o cabeçalho do plano e, para cada conta contábil e desdobramento, a natureza, o nível, a conta superior, a conta referencial e o código de tributação.

O plano de contas é a estrutura que a plataforma usa na apuração da Declaração de Regimes Específicos (DeRE). Ele é a base da replicação do balancete mensal: o plano define a estrutura de contas, e o balancete informa os saldos dessa estrutura mês a mês. Por isso, o plano precisa estar na SeniorX antes do envio do balancete.

Pré-requisitos

Gestão Empresarial | ERPXT
  • Versão 5.10.4.136 ou superior.

Componentes

A integração depende dos componentes abaixo configurados e em funcionamento.

RabbitMQ

Servidor de mensageria (código aberto) que gerencia os eventos trocados entre o ERP e a SeniorX. A comunicação usa duas instâncias:

Importante
  • Uma no ambiente do ERP, On-Premise ou no Cloud da Senior (neste caso, administrada pelo IT Services).
  • Outra no ambiente da SeniorX, administrada pela Arquitetura da Senior.
ERP Service

Faz a ponte de comunicação entre o Gestão Empresarial | ERP e a SeniorX e permite receber informações de fontes externas. Precisa obrigatoriamente estar conectado à instância do RabbitMQ.

Importante
  • No Cloud Senior, a configuração e a manutenção ficam com o IT Services da Senior.
  • Para instalar em ambiente On-Premise, consulte o Manual de instalação - ERP Service.
APP Manager

Gerencia as instâncias do ERP Service e deve ficar sempre habilitado.

Se estiver desativado ou indisponível, as instâncias do ERP Service não são carregadas em memória, e o processamento e o tráfego de informações entre o ERP e a SeniorX ficam comprometidos.

Importante
  • No Cloud Senior, a configuração e a manutenção ficam com o IT Services da Senior.
  • On-Premise, a configuração é feita na instalação do ERP Service.
Middleware Senior

Executa os processos automáticos por meio de uma instância do SapiensServer (sapiensserv.exe).

São esses processos que exportam as informações do ERP para a SeniorX; por isso o Middleware precisa estar em execução para a integração funcionar.

Plataforma SeniorX
  • Tenant configurado na plataforma SeniorX. Caso o cliente ainda não possua, é necessário providenciar a criação prévia.

  • Aplicação vinculada aos seguintes domínios/serviços:

    • erpx_cpl_itr/dere — replicação do plano de contas DeRE
    • erpx/foundation — integração com o Foundation
    • erpx_fnd/empresa — replicação de empresa e filial
    Observação

    Para mais informações sobre a configuração na plataforma SeniorX, consulte as documentações sobre Gestão dos Tenants, Gestão de Papéis e Gerenciamento de Aplicações.

Ativação da integração

Parametrizações

Central de Configurações Senior
Atenção!

Não execute este processo em ambientes que já tenham integrações ativas entre o ERP e a SeniorX: ele pode causar impactos operacionais.

  1. Execute o SeniorConfigCenter.exe;
  2. Acesse Plataforma XT > Configuração de integração;
  3. Informe o nome do tenant, a chave de acesso à plataforma e a chave secreta de acesso;
  4. Valide e aguarde a mensagem: “Autenticação na Plataforma SeniorX realizada com sucesso.”.

Onde ativar

  1. Acesse Recursos > XPlatform > Integração SeniorX (F000ISX);
  2. Selecione o Módulo FISCAL e a Integração REFORMA TRIBUTARIA;
  3. Clique em Ativar.

Detalhes sobre a tela estão na documentação F000ISX - Integração SeniorX.

Importante

A ativação só é concluída quando todas as validações retornam status OK. Se alguma falhar, a mensagem com o motivo aparece na coluna de status da grade Validações.

Como funciona?

Replicação dos dados

Depois de ativada a integração, os dados chegam ao SeniorX de duas formas. Em ambas, cada plano de contas é enviado em formato JSON para a SeniorX, contendo os dados do cabeçalho do plano e a lista de contas contábeis com seus respectivos desdobramentos.

1. Manual - Carga Inicial

Utilizada para enviar todos os planos de contas à SeniorX pela primeira vez, ou sempre que for necessário reenviar a base completa. Ao clicar no botão, o sistema marca internamente todos os planos existentes como pendente para envio. Em seguida, o ERP Service detecta esses registros e os envia à SeniorX, um plano por vez.

Atenção! — A carga precisa ser executada em duas etapas

Na versão atual, a carga inicial envia empresa/filial e os processos DeRE em uma única operação. Por isso, siga a ordem abaixo para evitar erros:

  1. 1ª execução — Empresa e Filial: clique em Iniciar Carga e aguarde a conclusão. Nesta etapa o ERP replica os cadastros de empresa e filial à SeniorX. Os processos DeRE (plano de contas e balancete) poderão retornar erro neste momento — isso é esperado, pois a especialização DeRE ainda não foi configurada na plataforma.
  2. Cadastrar a especialização DeRE na SeniorX: Essa especialização define os dados tributários necessários para o sistema do Fisco aceitar e validar os eventos da DeRE. Consulte: Cadastros necessários — Especialização DeRE (Documentação SeniorX).
  3. 2ª execução — Processos DeRE: com a especialização configurada, clique em Iniciar Carga novamente. Desta vez os processos DeRE poderão ser processados. O resultado dependerá da validação de regras e dados configurados na plataforma.
  1. Na F000ISX, com FISCAL | REFORMA TRIBUTARIA ativa, clique em Iniciar Carga.
  2. O sistema marca todos os planos de contas como prontos para envio.
  3. O ERP Service processa esses registros e os envia à SeniorX, um plano de contas por envio.
  4. O resultado de cada envio — sucesso ou erro — retorna de forma assíncrona e é gravado automaticamente no registro.

2. Automática - Replicação Automática

Após a carga inicial, qualquer inclusão, alteração ou inativação realizada no plano de contas, nas contas ou nos desdobramentos é enviada automaticamente à SeniorX, sem intervenção manual. O mecanismo é o mesmo da carga inicial: o sistema marca o plano como pronto para envio, e o ERP Service o processa na próxima execução automática da rotina sapiens 184 - Replicação XT - Senior X.

  1. A cada alteração em um registro monitorado pela integração, o sistema registra internamente que o plano de contas daquele registro precisa ser integrado.
  2. O ERP Service, executado continuamente pelo Middleware Senior (SapiensServer), verifica periodicamente se há planos para integrar. Quando encontra, monta o plano completo e o envia à SeniorX.
  3. O resultado retorna de forma assíncrona e é gravado automaticamente: o registro fica com situação Integrado em caso de sucesso, ou Erro com a mensagem devolvida pela plataforma.

Regras, exceções e comportamentos

Gatilhos
  • Mudanças no plano de contas (F043CPD): inclusão ou alteração do cabeçalho do plano.
  • Mudanças nas contas (F043CCD): inclusão ou alteração de uma conta contábil do plano.
  • Mudanças nos desdobramentos (F043CCD): inclusão ou alteração de um desdobramento de conta.

Em todos os casos, o plano de contas inteiro é reenviado na próxima execução da replicação. Várias alterações no mesmo plano antes dessa execução geram um único envio.

Inativação
  • Plano de contas inativado: é enviado à SeniorX como exclusão, com o motivo da inativação informado no plano. Nesse envio, as contas não são enviadas.
  • Desdobramento inativado: o plano é reenviado e o desdobramento segue com a situação DELETED; os demais continuam como ACTIVE.
Importante

A exclusão física de registros não é replicada. Para retirar um plano ou um desdobramento da SeniorX, inative o registro.

Elegibilidade
  • Integração ativa: a integração FISCAL | REFORMA TRIBUTARIA está ativa na F000ISX.
  • Sistema integrado: o sistema integrado Reforma Tributária - DeRE (RTDERE) está cadastrado na F000SIS.
Comunicação entre os sistemas

A comunicação entre o XT (Gestão Empresarial | ERP) e a plataforma SeniorX ocorre por meio de conexão HTTPS/TLS, garantindo segurança na transmissão dos dados. O ERP Service atua como intermediário, enviando os dados do plano de contas para a API REST da SeniorX de forma assíncrona: a plataforma devolve um protocolo no envio e informa o resultado final depois.

Endpoint enviado:

POST /erpx_cpl_itr/dere/actions/saveChartOfAccountsData

O mesmo endpoint é usado para inclusão, alteração e exclusão; o que muda é o conteúdo do payload.

Exemplo de payload (JSON) — inclusão ou alteração:

{
  "companyCode": 1,
  "code": "PCDERE01",
  "description": "Plano de contas DeRE",
  "reason": null,
  "chartOfAccountsType": "SPED",
  "accountingClosingFrequency": "MONTHLY",
  "effectiveStartDate": "2026-01-01",
  "accountDetails": [
    {
      "internalAccountCode": "1101001",
      "mixedAccountBreakdown": "001",
      "accountName": "Caixa geral",
      "accountTypeIndicator": "ANALYTICAL",
      "nature": "DEBIT",
      "natureCode": "ASSET",
      "referenceAccountCode": "101010101",
      "hierarchicalLevel": 5,
      "issqnIndicator": "NOT_SUBJECT",
      "status": "ACTIVE",
      "effectiveStartDate": "2026-01-01",
      "description": "Caixa geral da matriz",
      "parentAccountCode": "1101000",
      "taxCode": 10,
      "legalProvision": "Art. 183 da LC 214/2025"
    }
  ]
}

Exemplo de payload (JSON) — exclusão (plano inativado):

{
  "companyCode": 1,
  "code": "PCDERE01",
  "description": "Plano de contas DeRE",
  "reason": "INCORRECT_SUBMISSION",
  "chartOfAccountsType": "SPED",
  "accountingClosingFrequency": "MONTHLY"
}

Campos do payload — plano de contas:

Campo do JSONCampo XTDescrição
companyCodeE043CPD.CodEmpCódigo da empresa do plano de contas.
codeE043CPD.CodCpdCódigo do plano de contas DeRE.
descriptionE043CPD.DesCpdDescrição do plano de contas.
reasonE043CPD.MotInaMotivo da exclusão, enviado só quando o plano está inativo:
• 1 – JUDICIAL_DETERMINATION
• 2 – INCORRECT_SUBMISSION
• 3 – IDENTIFICATION_ERROR
• Demais – OTHER
chartOfAccountsTypeE043CPD.TipPlaModelo referencial do plano:
• 1 – COSIF
• 2 – ANS
• 3 – SUSEP
• 4 – SPED
• 5 – PREVIC
• 6 – COFI
accountingClosingFrequencyE043CPD.FreEncFrequência de encerramento contábil:
• 1 – ANNUAL
• 2 – SEMIANNUAL
• 3 – FOUR_MONTHLY
• 4 – QUARTERLY
• 5 – BIMONTHLY
• Demais – MONTHLY
effectiveStartDateE043CPD.ValIniInício da validade do plano (yyyy-mm-dd), quando informado.
effectiveEndDateE043CPD.ValFinFim da validade do plano (yyyy-mm-dd), quando informado.
accountDetails—Lista das contas do plano, com uma linha para cada conta e desdobramento. Não é enviada na exclusão.

Campos do payload — contas (accountDetails):

Campo do JSONCampo XTDescrição
internalAccountCode{código da conta variável}Código da conta. Varia conforme o tipo de conta do plano (E043CPD.TipCta):
• 1 – Reduzida: usa E043CCD.CtaRed (Conta reduzida).
• 2 – Expandida: usa E043PCM.ClaCta (Classificação da conta).
• 3 – Reduzida Paralela: usa E043PCM.CtaPar (Conta reduzida paralela).
• 4 – Expandida Paralela: usa E043PCM.ClaPar (Classificação paralela).
Quando o campo do tipo escolhido está em branco, é usada a conta reduzida.
mixedAccountBreakdownE043DMD.CodDesCódigo do desdobramento da conta.
accountNameE043CCD.NomCtaNome da conta (até 100 caracteres).
accountTypeIndicatorE043CCD.AnaSinTipo da conta: A – ANALYTICAL; demais – SYNTHETIC.
natureE043CCD.NatCtaNatureza da conta: 1 – CREDIT; 2 – DEBIT; demais – VARIABLE.
natureCodeE043CCD.GruCtaGrupo da conta: A – ASSET; P – LIABILITY; D – EXPENSE; R – REVENUE; L – EQUITY; O – OTHER.
referenceAccountCodeE043CCD.CtaRefConta referencial vinculada à conta.
hierarchicalLevelE043CCD.NivCtaNível da conta na estrutura do plano.
issqnIndicatorE043DMD.IndIssIndicador de ISS do desdobramento: S – SUBJECT; demais – NOT_SUBJECT.
statusE043DMD.SitDmdSituação do desdobramento: I – DELETED; demais – ACTIVE.
effectiveStartDateE043CCD.IniVigInício da vigência da conta, quando informado.
effectiveEndDateE043CCD.FinVigFim da vigência da conta, quando informado.
descriptionE043CCD.DesCtaDescrição da conta.
parentAccountCodeE043CCD.CtaRed (conta superior)Conta reduzida da conta superior, seguida de 000.
taxCodeE043CCT.CodCctCódigo de tributação DeRE do desdobramento, quando informado.
legalProvisionE051DIS.FunLegFundamento legal do dispositivo fiscal do desdobramento, quando informado.

Origem dos dados

TabelaDescrição
E043CPDPlano de Contas DeRE (F043CPD) — empresa, código, descrição, modelo referencial, frequência de encerramento, tipo de conta, validade, situação e motivo de inativação.
E043CCDContas Contábeis do Plano DeRE (F043CCD) — contas do plano, natureza, grupo, nível, conta superior e conta referencial.
E043DMDDesdobramentos das contas DeRE (F043CCD) — desdobramento, indicador de ISS, código de tributação, dispositivo fiscal e situação.
E043CCTCódigos de Tributação DeRE (F043CCT) — código de tributação de cada desdobramento.
E051DISDispositivos fiscais — fundamento legal de cada desdobramento.
E043PCMPlano de contas do modelo — classificação e contas paralelas, usadas para montar o código da conta enviada.

Este artigo ajudou você?