NCM Buscador

dhRetorno

AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados.

✓ Conferido · 28 de agosto de 2026DC-e (modelo 99): leiaute do XML e regras de validação — Manual DC-e — Anexo I: Leiaute e Regras de Validação. Inclui a NT 2024.001 v1.30 (agosto/2026), que altera leiaute e corrige o Manual · Portal Nacional dos DF-e / SVRS

Onde fica no arquivo

Na resposta do web service

  • retConsStatServDCe/dhRetorno

    Opcional, no máximo uma vez

O caminho até aqui, nível a nível

  1. retConsStatServDCe — Schema XML de validação do Resultado da Consulta do Status do Serviço de DCe
  2. dhRetorno — você está aqui

Dentro do grupo retConsStatServDCe , schema XML de validação do Resultado da Consulta do Status do Serviço de DCe

O que o arquivo aceita neste campo

Ocorrência
0-1
Tamanho
Tipo no esquema
TDateTimeUTC
Formato base
string

Formato exigido: (((20(([02468][048])|([13579][26]))-02-29))|(20[0-9][0-9])-((((0[1-9])|(1[0-2]))-((0[1-9])|(1\d)|(2[0-8])))|((((0[13578])|(1[02]))-31)|(((0[1,3-9])|(1[0-2]))-(29|30)))))T(20|21|22|23|[0-1]\d):[0-5]\d:[0-5]\d([\-,\+](0[0- Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

O mesmo nome em outros documentos fiscais — 7

dhRetorno aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento O que o leiaute dele diz Caminho lá
BP-e AAAA-MM-DDTHH:MM:SSDeve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServBPe/dhRetorno
CT-e AAAA-MM-DDTHH:MM:SSDeve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServCTe/dhRetorno
MDF-e AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServMDFe/dhRetorno
NF3e AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServNF3e/dhRetorno
NFAg AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServNFAg/dhRetorno
NFCom AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServNFCom/dhRetorno
NFGas AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. retConsStatServNFGas/dhRetorno

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 9

São os campos que ficam ao lado deste no arquivo, dentro de retConsStatServDCe. Quem preenche um costuma precisar dos outros na mesma passada.

Perguntas frequentes

O que é o campo dhRetorno do DC-e?

AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. No XML ele fica em retConsStatServDCe/dhRetorno. Opcional, no máximo uma vez.

dhRetorno no DC-e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 7 outros documentos (BP-e, CT-e, MDF-e, NF3e, NFAg, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição do DC-e?

Do esquema XML oficial (PL_DCe_v1.00a_NT2024.001v1.00). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo