Integração de Documentos Fiscais DeRE (D-1121)
A integração do Gestão Empresarial | ERP com o módulo fiscal da Reforma Tributária envia para a SeniorX as notas fiscais de entrada e de saída que têm itens com atividade de dedução DeRE. Para cada documento vão a chave eletrônica, a data, o valor da operação e a distribuição dos valores dos itens por atividade e por conta contábil/desdobramento do plano DeRE.
Na plataforma, essas informações compõem o evento D-1121 – Informações dos Documentos Fiscais (infoDFe) da Declaração de Regimes Específicos (DeRE). A integração depende da replicação do plano de contas: é o plano DeRE que define as contas e os desdobramentos informados em cada documento.
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— integração DeRE (plano de contas, balancete e documentos fiscais)erpx/foundation— integração com o Foundationerpx_fnd/empresa— replicação de empresa e filial
-
Especialização DeRE cadastrada na plataforma. Consulte: Cadastros necessários — Especialização DeRE (Documentação SeniorX).
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
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.
- 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.
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. A ativação também cadastra o sistema integrado RTDERE (Reforma Tributária - DeRE), usado o envio e retorno dos documentos.
Como funciona?
Replicação dos dados
Depois de ativada a integração, os documentos fiscais são enviados à SeniorX, contendo os dados de cada nota fiscal de entrada ou de saída e o rateio dos seus itens por atividade e conta do plano DeRE.
Manual - Relação de Deduções DERE
Utilizada para enviar as notas de um período à SeniorX, ou sempre que for necessário reenviá-las. Ao processar, o sistema marca internamente as notas encontradas como pendente para envio. Em seguida, o ERP Service detecta esses registros e os envia em lotes à SeniorX.
Diferente do plano de contas e do balancete, as notas fiscais não são replicadas automaticamente quando incluídas, alteradas ou canceladas, e não fazem parte do botão Iniciar Carga da F000ISX. Para enviar ou reenviar documentos, use sempre F043DED.
- Na F043DED – Relação de Deduções DERE, informe a empresa, o período e o tipo de documento. Se necessário, refine a seleção nas abas Entrada e Saída.
- Clique em Pré-Visualizar para conferir o resumo das notas encontradas antes do envio.
- Clique em Processar e confirme. O sistema marca as notas encontradas como prontas para envio e exibe a mensagem Pendências geradas com sucesso.
- O ERP Service processa esses registros e os envia à SeniorX em lotes.
- O resultado de cada envio — sucesso ou erro — retorna de forma assíncrona e é gravado automaticamente no registro, com a mensagem devolvida pela plataforma em caso de erro.
Regras, exceções e comportamentos
Gatilhos
- Processamento manual: as notas são enviadas somente ao clicar em Processar na F043DED. Incluir, alterar ou cancelar uma nota não gera envio automático.
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 e ativo na F000SIS.
- Notas elegíveis: a nota fiscal (entrada ou saída) é enviada quando atende a todas as condições abaixo:
- Tipo de documento: a série da nota tem o dispositivo autorizado NF-e, NFS-e ou NFC-e.
- Chave eletrônica: a nota tem a chave do documento eletrônico preenchida.
- Itens elegíveis: a nota tem pelo menos um item que atende às regras do item abaixo.
- Itens elegíveis: o item da nota (produto ou serviço) entra no envio quando atende a todas as condições abaixo:
- Atividade DeRE: o produto ou serviço tem uma atividade de dedução DeRE informada no seu cadastro.
- Conta no plano DeRE: a conta contábil do item está cadastrada no plano de contas DeRE da empresa.
- Plano ativo e vigente: o plano de contas DeRE está ativo e vigente na data da nota (emissão na saída, entrada na entrada).
- Desdobramento ativo: a conta tem pelo menos um desdobramento ativo.
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 documentos fiscais para a API REST da SeniorX de forma assíncrona e em lotes. A resposta imediata devolve o ticket do lote; o resultado do processamento chega depois, no evento createFiscalDocumentDeductionAsyncResponse.
Endpoint enviado:
POST /erpx_cpl_itr/dere/actions/createFiscalDocumentDeductionAsyncExemplo de payload (JSON):
{
“data”: [
{
“accountingPeriod”: “08/2026”,
“companyCode”: 1,
“fiscalDocumentType”: “NFE”,
“fiscalDocumentKey”: “35260800394460000141550010000000011000000017”,
“issueDate”: “2026-08-10”,
“fiscalDocumentKeyToAmend”: null,
“operationValue”: 1300.00,
“status”: “ACTIVE”,
“activityBreakdown”: [
{
“activityType”: “CREDIT_OPERATION”,
“accountCode”: “1101001001”,
“totalDeductibleValue”: 0,
“deductedValue”: 0,
“itemDetails”: [
{ “itemNumber”: 1, “itemValue”: 600.00, “itemTotalDeductibleValue”: 0, “itemDeductionValue”: 0 },
{ “itemNumber”: 3, “itemValue”: 100.00, “itemTotalDeductibleValue”: 0, “itemDeductionValue”: 0 }
]
},
{
“activityType”: “CREDIT_OPERATION”,
“accountCode”: “1101002001”,
“totalDeductibleValue”: 0,
“deductedValue”: 0,
“itemDetails”: [
{ “itemNumber”: 2, “itemValue”: 160.00, “itemTotalDeductibleValue”: 0, “itemDeductionValue”: 0 }
]
},
{
“activityType”: “CREDIT_OPERATION”,
“accountCode”: “1101002002”,
“totalDeductibleValue”: 0,
“deductedValue”: 0,
“itemDetails”: [
{ “itemNumber”: 2, “itemValue”: 240.00, “itemTotalDeductibleValue”: 0, “itemDeductionValue”: 0 }
]
},
{
“activityType”: “LEASING”,
“accountCode”: “1101003001”,
“totalDeductibleValue”: 0,
“deductedValue”: 0,
“itemDetails”: [
{ “itemNumber”: 4, “itemValue”: 100.00, “itemTotalDeductibleValue”: 0, “itemDeductionValue”: 0 }
]
}
]
},
{
“accountingPeriod”: “08/2026”,
“companyCode”: 1,
“fiscalDocumentType”: “NFSE”,
“fiscalDocumentKey”: “42260800394460000141560010000000051000000052”,
“issueDate”: “2026-08-12”,
“fiscalDocumentKeyToAmend”: null,
“operationValue”: 450.00,
“status”: “DELETED”
}
]
}Campos do documento:
| Campo do JSON | Campo XT | Descrição |
|---|---|---|
| accountingPeriod | E140NFV.DatEmi / E440NFC.DatEnt | Período de apuração (mm/yyyy), obtido da data do primeiro documento do lote e repetido nos demais. |
| companyCode | E140NFV.CodEmp / E440NFC.CodEmp | Código da empresa da nota. |
| fiscalDocumentType | E020SNF.DisAut | Tipo do documento, conforme o dispositivo autorizado da série. Veja a tabela de tradução abaixo. |
| fiscalDocumentKey | E140IDE.ChvDoe / E440NFC.ChvNel | Chave eletrônica do documento. |
| issueDate | E140NFV.DatEmi / E440NFC.DatEnt | Data do documento (yyyy-mm-dd): data deemissão em documentos de saída e data de entrada em documentos de entrada. |
| fiscalDocumentKeyToAmend | — | Chave do documento a retificar. Enviado sempre como null. |
| operationValue | Soma de VlrBru dos itens | Valor da operação: soma do valor bruto de todos os itens de produto e de serviço da nota (E140IPV/E140ISV ou E440IPC/E440ISC), inclusive os que não vão no envio. |
| status | E140NFV.SitNfv, E140IDE.SitDoe / E440NFC.SitNfc | ACTIVE para notas ativas e DELETED para notas canceladas (situação da nota 3 – Cancelada ou, na saída, documento eletrônico 9 – Cancelado). |
| activityBreakdown | — | Distribuição dos itens por atividade e conta. Não é enviada em notas canceladas. |
Campos da distribuição por atividade (activityBreakdown):
| Campo do JSON | Campo XT | Descrição |
|---|---|---|
| activityType | E075PRO.AtvDer / E080SER.AtvDer | Atividade de dedução DeRE do produto ou serviço. Veja a tabela de tradução abaixo. |
| accountCode | {codigo da conta variável} + E043DMD.CodDes | Código da conta concatenado com o código do desdobramento. A parte da conta varia conforme o tipo do plano: • 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). Se a conta não estiver no plano de contas contábil, é usada a conta reduzida. |
| totalDeductibleValue | — | Valor total dedutível. Enviado como 0. |
| deductedValue | — | Valor deduzido. Enviado como 0. |
| itemDetails | — | Itens da nota que compõem a combinação atividade + conta. |
Campos dos itens (itemDetails):
| Campo do JSON | Campo XT | Descrição |
|---|---|---|
| itemNumber | — | Número sequencial do item no documento. Conta só os itens enviados, primeiro os produtos e depois os serviços. |
| itemValue | E140IPV/E140ISV.VlrBru E440IPC/E440ISC.VlrBru | Valor bruto do item, rateado pelo percentual do desdobramento (E043DMD.PerDes) quando a conta tem mais de um desdobramento ativo. |
| itemTotalDeductibleValue | — | Valor total dedutível do item. Enviado como 0. |
| itemDeductionValue | — | Valor de dedução do item. Enviado como 0. |
Como os itens são distribuídos
- Itens com a mesma atividade e a mesma conta/desdobramento ficam no mesmo grupo de
activityBreakdown. - Na mesma conta, atividades diferentes geram grupos diferentes.
- Conta com um desdobramento ativo: o item vai com o valor cheio.
- Conta com vários desdobramentos ativos: o valor do item é dividido pelo percentual de cada desdobramento e o item aparece em um grupo por desdobramento, sempre com o mesmo
itemNumber. O último desdobramento recebe a diferença de centavos, para que a soma feche com o valor do item.
No payload acima, o item 2 (R$ 400,00) está em uma conta com os desdobramentos 001 (40%) e 002 (60%). Ele aparece duas vezes: R$ 160,00 em 1101002001 e R$ 240,00 em 1101002002.
Importante
O operationValue considera todos os itens da nota. Por isso a soma dos itemValue enviados pode ser menor que ele, quando algum item não tem atividade ou conta DeRE.
Origem dos dados
| Tabela | Descrição |
|---|---|
| E140NFV | Notas fiscais de saída — cabeçalho, data de emissão e situação da nota. |
| E140IDE | Documento eletrônico da nota de saída — chave e situação do documento eletrônico. |
| E140IPV | Itens de produto da nota de saída — valor bruto e conta reduzida do item. |
| E140ISV | Itens de serviço da nota de saída — valor bruto e conta reduzida do item. |
| E440NFC | Notas fiscais de entrada — cabeçalho, data de entrada, situação e chave eletrônica. |
| E440IPC | Itens de produto da nota de entrada — valor bruto e conta reduzida do item. |
| E440ISC | Itens de serviço da nota de entrada — valor bruto e conta reduzida do item. |
| E020SNF | Séries de notas fiscais — dispositivo autorizado da série (NF-e, NFS-e ou NFC-e). |
| E075PRO | Produtos — atividade de dedução DeRE dos itens de produto. |
| E080SER | Serviços — atividade de dedução DeRE dos itens de serviço. |
| E043CPD | Plano de Contas DeRE — situação, tipo de conta e vigência do plano. |
| E043CCD | Contas Contábeis do Plano DeRE — conta DeRE relacionada à conta reduzida do item. |
| E043DMD | Desdobramentos das contas DeRE — desdobramentos ativos e percentual de rateio de cada um. |
| E043PCM | Plano de contas do modelo — classificação da conta e conta pai, usadas para montar o código da conta enviada. |
English
Español
English
Español

