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:
- 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.
- 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.
- 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 DeREerpx/foundation— integração com o Foundationerpx_fnd/empresa— replicação de empresa e filial
ObservaçãoPara 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
Não execute este processo em ambientes que já tenham integrações ativas entre o ERP e a SeniorX: ele pode causar impactos operacionais.
- Execute o
SeniorConfigCenter.exe; - Acesse Plataforma XT > Configuração de integração;
- Informe o nome do tenant, a chave de acesso à plataforma e a chave secreta de acesso;
- Valide e aguarde a mensagem: “Autenticação na Plataforma SeniorX realizada com sucesso.”.
Onde ativar
- Acesse Recursos > XPlatform > Integração SeniorX (F000ISX);
- Selecione o Módulo FISCAL e a Integração REFORMA TRIBUTARIA;
- Clique em Ativar.
Detalhes sobre a tela estão na documentação F000ISX - Integração SeniorX.
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.
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ª 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.
- 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).
- 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.
- Na F000ISX, com FISCAL | REFORMA TRIBUTARIA ativa, clique em Iniciar Carga.
- O sistema marca todos os planos de contas como prontos para envio.
- O ERP Service processa esses registros e os envia à SeniorX, um plano de contas por envio.
- 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.
- 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.
- 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.
- 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.
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/saveChartOfAccountsDataO 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 JSON | Campo XT | Descrição |
|---|---|---|
| companyCode | E043CPD.CodEmp | Código da empresa do plano de contas. |
| code | E043CPD.CodCpd | Código do plano de contas DeRE. |
| description | E043CPD.DesCpd | Descrição do plano de contas. |
| reason | E043CPD.MotIna | Motivo da exclusão, enviado só quando o plano está inativo: • 1 – JUDICIAL_DETERMINATION • 2 – INCORRECT_SUBMISSION • 3 – IDENTIFICATION_ERROR • Demais – OTHER |
| chartOfAccountsType | E043CPD.TipPla | Modelo referencial do plano: • 1 – COSIF • 2 – ANS • 3 – SUSEP • 4 – SPED • 5 – PREVIC • 6 – COFI |
| accountingClosingFrequency | E043CPD.FreEnc | Frequência de encerramento contábil: • 1 – ANNUAL • 2 – SEMIANNUAL • 3 – FOUR_MONTHLY • 4 – QUARTERLY • 5 – BIMONTHLY • Demais – MONTHLY |
| effectiveStartDate | E043CPD.ValIni | Início da validade do plano (yyyy-mm-dd), quando informado. |
| effectiveEndDate | E043CPD.ValFin | Fim 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 JSON | Campo XT | Descriçã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. |
| mixedAccountBreakdown | E043DMD.CodDes | Código do desdobramento da conta. |
| accountName | E043CCD.NomCta | Nome da conta (até 100 caracteres). |
| accountTypeIndicator | E043CCD.AnaSin | Tipo da conta: A – ANALYTICAL; demais – SYNTHETIC. |
| nature | E043CCD.NatCta | Natureza da conta: 1 – CREDIT; 2 – DEBIT; demais – VARIABLE. |
| natureCode | E043CCD.GruCta | Grupo da conta: A – ASSET; P – LIABILITY; D – EXPENSE; R – REVENUE; L – EQUITY; O – OTHER. |
| referenceAccountCode | E043CCD.CtaRef | Conta referencial vinculada à conta. |
| hierarchicalLevel | E043CCD.NivCta | Nível da conta na estrutura do plano. |
| issqnIndicator | E043DMD.IndIss | Indicador de ISS do desdobramento: S – SUBJECT; demais – NOT_SUBJECT. |
| status | E043DMD.SitDmd | Situação do desdobramento: I – DELETED; demais – ACTIVE. |
| effectiveStartDate | E043CCD.IniVig | Início da vigência da conta, quando informado. |
| effectiveEndDate | E043CCD.FinVig | Fim da vigência da conta, quando informado. |
| description | E043CCD.DesCta | Descrição da conta. |
| parentAccountCode | E043CCD.CtaRed (conta superior) | Conta reduzida da conta superior, seguida de 000. |
| taxCode | E043CCT.CodCct | Código de tributação DeRE do desdobramento, quando informado. |
| legalProvision | E051DIS.FunLeg | Fundamento legal do dispositivo fiscal do desdobramento, quando informado. |
Origem dos dados
| Tabela | Descrição |
|---|---|
| E043CPD | Plano 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. |
| E043CCD | Contas Contábeis do Plano DeRE (F043CCD) — contas do plano, natureza, grupo, nível, conta superior e conta referencial. |
| E043DMD | Desdobramentos das contas DeRE (F043CCD) — desdobramento, indicador de ISS, código de tributação, dispositivo fiscal e situação. |
| E043CCT | Códigos de Tributação DeRE (F043CCT) — código de tributação de cada desdobramento. |
| E051DIS | Dispositivos fiscais — fundamento legal de cada desdobramento. |
| E043PCM | Plano de contas do modelo — classificação e contas paralelas, usadas para montar o código da conta enviada. |
English
Español
English
Español

