dhRetorno
AAAA-MM-DDTHH:MM:SSDeve ser preenchida com data e hora previstas para o retorno dos serviços prestados.
Onde fica no arquivo
Na resposta do web service
-
retConsStatServCTe/dhRetorno
Opcional, no máximo uma vez
O caminho até aqui, nível a nível
- retConsStatServCTe — Schema XML de validação do Resultado da Consulta do Status do Serviço de CT-e
- └ dhRetorno — você está aqui
Dentro do grupo retConsStatServCTe , schema XML de validação do Resultado da Consulta do Status do Serviço de CT-e
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 |
| DC-e | AAAA-MM-DDTHH:MM:SS TZD. Deve ser preenchida com data e hora previstas para o retorno dos serviços prestados. | retConsStatServDCe/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 |
Campos do mesmo grupo — 9
São os campos que ficam ao lado deste no arquivo, dentro de retConsStatServCTe. Quem
preenche um costuma precisar dos outros na mesma passada.
Perguntas frequentes
O que é o campo dhRetorno do CT-e?
AAAA-MM-DDTHH:MM:SSDeve ser preenchida com data e hora previstas para o retorno dos serviços prestados. No XML ele fica em retConsStatServCTe/dhRetorno. Opcional, no máximo uma vez.
dhRetorno no CT-e é o mesmo campo dos outros documentos fiscais?
O nome se repete no leiaute de 7 outros documentos (BP-e, DC-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 CT-e?
Do esquema XML oficial (PL_CTe_400_NT2026.004_RTC_1.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.