D-9209 retorno e recibo de processamento de eventos transacionais. Retorno gerado para eventos que não exijam um totalizador específico de cálculo
Evento de retorno e recibo de processamento de eventos transacionais. Retorno gerado para eventos que não exijam um totalizador específico d. No XML é a tag evtRetornoTransac, dentro do
envelope DeRE.
- Campos no leiaute
- 26
- Grupos
- 8
- Com regra citada
- 3
- Esquema XML
- v0.0.1
O que mudou neste evento na versão 1.2.0 — 1
Do histórico oficial de versões, com a justificativa técnica que a fonte dá para cada alteração.
Inclusão do leiaute do evento de retorno D-9209.
Por quê: Confirmar a recepção dos lotes transacionais e retornar a memória de cálculo do rateio de prêmios de planos de saúde ({detRateioPremio}).
O leiaute, campo a campo
Na ordem em que o documento oficial os numera. O recuo mostra a hierarquia: um campo indentado mora dentro do grupo acima dele.
| Campo | O que é | Ocor. | Tam. |
|---|---|---|---|
| DeRE grupo | Envelope raiz dos eventos da DeRE. | 1-1 | — |
| evtRetornoTransac grupo | Evento de retorno e recibo de processamento de eventos transacionais. Retorno gerado para eventos que não exijam um totalizador específico de cálculo. Chave do grupo: id | 1-1 | — |
| id atributo | Identificação única do evento (campo id do evento transmitido pelo contribuinte, a que se refere este retorno). | 1-1 | 42 |
| ideContrib grupo | Informações de identificação do contribuinte. Chave do grupo: nrInsc | 1-1 | — |
| nrInsc | Número de inscrição do contribuinte (CNPJ raiz). | 1-1 | 8 |
| ideStatus grupo | Situação do processamento do evento. | 1-1 | — |
| cdRetorno | Código indicativo do status do retorno. Valores: 0 Erro · 1 Sucesso | 1-1 | 1 |
| descRetorno | Descrição literal do status do retorno. – Erro; – Sucesso. | 1-1 | 4,7 |
| ocorrencias grupo | Informações de ocorrências registradas. | 0-10 | — |
| codigo | Código numérico da ocorrência. | 1-1 | 1-6 |
| descricao | Descrição detalhada da ocorrência (mensagem de erro ou aviso). | 1-1 | 1-2048 |
| tipo | Classificação do tipo da ocorrência. Valores: 1 Erro · 2 Aviso | 1-1 | 1 |
| localizacao | Identificação do campo ou grupo onde a ocorrência foi detectada. | 0-1 | 1-2048 |
| infoRecEv grupo | Informações de processamento dos eventos. | 1-1 | — |
| nrRecibo | Número do recibo do evento processado com sucesso. Preenchimento: Preenchido somente quando {cdRetorno} = [1] (Sucesso). RN - Formação do Número do Recibo do Evento | 0-1 | 31 |
| protocoloLote | Número do protocolo de entrega do lote. RN - Numero do Protocolo do Lote | 0-1 | 28 |
| dhRecepcao | Data e hora da recepção do evento (UTC). | 1-1 | 25-33 |
| dhProcess | Data e hora do processamento do evento (UTC). | 1-1 | 25-33 |
| tpEv | Sigla de identificação do tipo de evento. Exemplo: D-2201. | 1-1 | 6 |
| hash | Hashcode do arquivo processado. | 1-1 | 44 |
| infoPlanoSaude grupo | Grupo de retorno do processamento de Planos de Assistência à Saúde. Preenchimento: Exclusivo quando {tpEv} = [D-3201] e existir campo {tpContrato} igual a [4] (Plano ou seguro sem valor definido por usuário). | 0-1 | — |
| chDeREOper | Chave de acesso individualizada da operação da DeRE (chave-filha). Preenchimento: Chave de 53 caracteres que identifica unicamente a operação de rateio do beneficiário titular. Corresponde à chave-mãe do agrupamento ({chDeRE} do evento D-3201 de origem) com a substituição de seus 3 (três) últimos dígitos (sufixo aglutinador) pelo número sequencial ({seq}) individualizado. | 1-1 | 53 |
| detRateioPremio grupo | Grupo de detalhamento do rateio dos prêmios, individualizado por beneficiário titular. Gerado pelo sistema após a aplicação dos coeficientes de rateio da [[Tabela 33 – Coeficiente de Rateio do Prêmio não Individualizado]]. Preenchimento: Listagem das ocorrências válidas extraídas da tag {CPFTitular} do evento D-3201 de origem, consolidando-as exclusivamente para os contratos de plano ou seguro sem valor definido por usuário ({tpContrato} = [4]). | 1-30000 | — |
| chDeREOper | Chave de acesso individualizada da operação da DeRE (chave-filha). Preenchimento: Chave de 53 caracteres que identifica unicamente a operação de rateio do beneficiário titular. Corresponde à chave-mãe do agrupamento ({chDeRE} do evento D-3201 de origem) com a substituição de seus 3 (três) últimos dígitos (sufixo aglutinador) pelo número sequencial ({seq}) individualizado. | 1-1 | 53 |
| CPFBenefTit | Número de inscrição no CPF do beneficiário titular. Cálculo: Listagem de todas as ocorrências de {CPFTitular} quando {tpContrato} = [4] (Plano ou seguro sem valor definido por usuário). DV_CPF | 1-1 | 11 |
| vPremIndivid | Valor consolidado do rateio do prêmio ou contraprestação, individualizado por titular. | 1-1 | 4-18 |
As tabelas de domínio que este evento usa
Os campos acima puxam valores destas tabelas do Anexo I. Quem preenche o evento precisa delas abertas do lado.
As regras de validação que este evento cita — 3
Cada regra tem nome, e é por ele que o leiaute a cita. Quando ela falha, o ambiente devolve um código MS####: se ele interrompe, o processamento para naquele ponto; se não, o erro se acumula e o retorno traz a lista inteira.
DV_CPF
Verificar se dígito verificador é válido. O dígito verificador do CPF é baseado no cálculo do módulo 11 e corresponde aos 2 últimos dígitos do CPF, o restante dos dígitos são a base para cálculo dos dígitos verificadores. No caso do CPF, o DV módulo 11 corresponde ao resto da divisão por 11 do somatório da multiplicação de cada algarismo da base respectivamente por 9, 8, 7, 6, 5, 4, 3, 2, 1 e 0, a partir da unidade. O resto 10 é considerado 0. Veja, abaixo, exemplo de cálculo de DV módulo 11 para o CPF nº 280012389: 2 8 0 0 1 2 3 8 9=3 x x x x x x x x x 1 2 3 4 5 6 7 8 9 ------------------------- 2+16+ 0+ 0+ 5+12+21+64+81 = 201÷11=18, com resto 3 2 8 0 0 1 2 3 8 9 3=8 x x x x x x x x x x 0 1 2 3 4 5 6 7 8 9 ---------------------------- 0+ 8+ 0+ 0+ 4+10+18+56+72+27 = 195÷11=17, com resto 8 Portanto, CPF + DV = 280012389-38
RN - Formação do Número do Recibo do Evento
Campo de 31 caracteres conforme abaixo: 0000-000000-0000000000000000000, onde: 0000 (Código do Tipo do Evento. Ex.: 1001, 1011 etc. / 4 caracteres); - (Preencher com "-" / 1 caractere); 000000 (Período de apuração do evento "AAAAMM" ou o ano/mês do campo da recepção do evento, no formato "AAAAMM", caso seja um evento não periódico / 6 caracteres); - (Preencher com "-" / 1 caractere); 0000000000000000000 (idInternoEvento/Valor do campo id da tabela do respectivo evento/ Campo autoincremental gerado ao incluir o evento na respectiva tabela do evento/1 a 19 caracteres).
RN - Numero do Protocolo do Lote
O número do protocolo será composto por no máximo 28 caracteres conforme abaixo: T.AAAAMM.NNNNNNNNNNNNNNNNNNN, onde: T (Tipo de ambiente de recepção): 1-Produção; 2-Pré-Produção; AAAAMM (Ano/Mês): Ano e Mês da recepção do lote; NNNNNNNNNNNNNNNNNNN (Número de Identificação do Lote): Máximo de 19 posições. Número sequencial gerado internamente pelo sistema DeRE.
Os outros eventos do mesmo prazo
Todos com data em 01/01/2027: quem precisa deste evento quase sempre precisa destes também.
Perguntas frequentes
O que é o evento D-9209 da DeRE?
D-9209 é o retorno e recibo de processamento de eventos transacionais. retorno gerado para eventos que não exijam um totalizador específico de cálculo da Declaração de Regimes Específicos. No XML ele é a tag evtRetornoTransac, dentro do envelope DeRE, e o leiaute dele tem 26 campos, sendo 8 grupos e 18 campos de valor. O esquema oficial o descreve como "Evento de retorno e recibo de processamento de eventos transacionais. Retorno gerado para eventos que não exijam um totalizador específico d".
Quando o D-9209 passa a ser obrigatório?
Em 01/01/2027. Ele pertence ao grupo "Eventos de Retorno e Totalização", que é a alínea "c" do inciso XVII do Ato Conjunto RFB/CGIBS nº 4, de 30 de julho de 2026 — a alínea residual, que o ato descreve como "eventos não enquadrados nas alíneas anteriores". O Buscador NCM tira essa data do próprio ato, não de texto escrito à mão, para que duas páginas do site não publiquem prazos diferentes para o mesmo documento.
Quais campos do D-9209 são obrigatórios?
15 dos 18 campos de valor têm ocorrência mínima 1: id, nrInsc, cdRetorno, descRetorno, codigo, descricao, tipo, dhRecepcao, dhProcess, tpEv, hash, chDeREOper, chDeREOper, CPFBenefTit…. ⚠ Ocorrência mínima 1 dentro de um grupo opcional não é obrigatoriedade global: o campo só é exigido se o grupo em que ele mora for informado. Neste evento, 5 campos trazem condição de preenchimento declarada no leiaute, e ela aparece em cada linha da tabela.
Que erros o D-9209 pode gerar?
O leiaute deste evento cita 3 regras de validação do Anexo II, que disparam as mensagens . A DeRE não usa a numeração de rejeição das notas fiscais: os erros dela são códigos MS####, com texto próprio, e cada um diz se interrompe o processamento ou se apenas se acumula no retorno.
O leiaute do D-9209 já está fechado?
O esquema XML deste evento está na versão 0.0.1, e o documento de leiaute não o marca como preliminar. Ainda assim, a documentação técnica da DeRE evolui de forma incremental: o Buscador NCM publica a versão do esquema em cada evento para que dê para conferir se o que está em uso é a safra corrente.