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:

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 — integração DeRE (plano de contas, balancete e documentos fiscais)
    • erpx/foundation — integração com o Foundation
    • erpx_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.

  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. 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.

Atenção!Nesta versão o envio é somente manual

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.

  1. 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.
  2. Clique em Pré-Visualizar para conferir o resumo das notas encontradas antes do envio.
  3. Clique em Processar e confirme. O sistema marca as notas encontradas como prontas para envio e exibe a mensagem Pendências geradas com sucesso.
  4. O ERP Service processa esses registros e os envia à SeniorX em lotes.
  5. 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/createFiscalDocumentDeductionAsync

Exemplo 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 JSONCampo XTDescrição
accountingPeriodE140NFV.DatEmi / E440NFC.DatEntPeríodo de apuração (mm/yyyy), obtido da data do primeiro documento do lote e repetido nos demais.
companyCodeE140NFV.CodEmp / E440NFC.CodEmpCódigo da empresa da nota.
fiscalDocumentTypeE020SNF.DisAutTipo do documento, conforme o dispositivo autorizado da série. Veja a tabela de tradução abaixo.
fiscalDocumentKeyE140IDE.ChvDoe / E440NFC.ChvNelChave eletrônica do documento.
issueDateE140NFV.DatEmi / E440NFC.DatEntData 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.
operationValueSoma de VlrBru dos itensValor 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.
statusE140NFV.SitNfv, E140IDE.SitDoe / E440NFC.SitNfcACTIVE 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 JSONCampo XTDescrição
activityTypeE075PRO.AtvDer / E080SER.AtvDerAtividade de dedução DeRE do produto ou serviço. Veja a tabela de tradução abaixo.
accountCode{codigo da conta variável} + E043DMD.CodDesCó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 JSONCampo XTDescrição
itemNumber—Número sequencial do item no documento. Conta só os itens enviados, primeiro os produtos e depois os serviços.
itemValueE140IPV/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.
Exemplo

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

TabelaDescrição
E140NFVNotas fiscais de saída — cabeçalho, data de emissão e situação da nota.
E140IDEDocumento eletrônico da nota de saída — chave e situação do documento eletrônico.
E140IPVItens de produto da nota de saída — valor bruto e conta reduzida do item.
E140ISVItens de serviço da nota de saída — valor bruto e conta reduzida do item.
E440NFCNotas fiscais de entrada — cabeçalho, data de entrada, situação e chave eletrônica.
E440IPCItens de produto da nota de entrada — valor bruto e conta reduzida do item.
E440ISCItens de serviço da nota de entrada — valor bruto e conta reduzida do item.
E020SNFSéries de notas fiscais — dispositivo autorizado da série (NF-e, NFS-e ou NFC-e).
E075PROProdutos — atividade de dedução DeRE dos itens de produto.
E080SERServiços — atividade de dedução DeRE dos itens de serviço.
E043CPDPlano de Contas DeRE — situação, tipo de conta e vigência do plano.
E043CCDContas Contábeis do Plano DeRE — conta DeRE relacionada à conta reduzida do item.
E043DMDDesdobramentos das contas DeRE — desdobramentos ativos e percentual de rateio de cada um.
E043PCMPlano de contas do modelo — classificação da conta e conta pai, usadas para montar o código da conta enviada.

Saiba mais

Este artigo ajudou você?