NCM Buscador
Buscar
CAMPO DO XML · CT-E Opcional

nTentativa

Número da tentativa de entrega que não teve insucesso

✓ Conferido · 12 de outubro de 2026 CT-e, CT-e OS e GTV-e: leiaute do XML e regras de validação — MOC CT-e — Anexo I: Leiaute e Regras de Validação, versão 4.00 · Portal Nacional do CT-e / SVRS

Onde fica no arquivo

Nos eventos

  • evIECTe/nTentativa

    Opcional, no máximo uma vez

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

  1. evIECTe — Schema XML de validação do evento insucesso na entrega eletrônico do CT-e 110190
  2. └ nTentativa — você está aqui

Dentro do grupo evIECTe , schema XML de validação do evento insucesso na entrega eletrônico do CT-e 110190

O que o arquivo aceita neste campo

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

Formato exigido: [0-9]{3} Exatamente 3 dígitos, sem espaço, ponto ou traço. 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.

Campos do mesmo grupo — 10

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

descEvento Descrição do Evento - “Apropriação Credito Presumido” dhHashTentativaEntrega Data e hora de geração do hash tentativa entrega dhTentativaEntrega Data e hora da tentativa da entrega da NF-e hashTentativaEntrega Hash (SHA1) no formato Base64 resultante da concatenação: Chave de acesso do CT-e +… infEntrega Grupo de informações das NF-e que foram entregues ao Destinatário latitude Latitude do ponto de entrega longitude Longitude do ponto de entrega nProt Número do Protocolo de Status do CT-e. tpMotivo Motivo do insucesso xJustMotivo Justificativa do Motivo de insucesso, informar apenas para tpMotivo = 4

Perguntas frequentes

O que é o campo nTentativa do CT-e?

Número da tentativa de entrega que não teve insucesso No XML ele fica em evIECTe/nTentativa. Opcional, no máximo uma vez.

Que formato o campo nTentativa exige no CT-e?

Exatamente 3 dígitos, sem espaço, ponto ou traço. A regra é a expressão do próprio esquema ([0-9]{3}), e ela é verificada antes de qualquer regra de negócio: valor fora do formato faz o arquivo ser recusado na validação, com rejeição genérica de schema — que é a mais difícil de diagnosticar justamente por não citar o campo.

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.

Voltar ao topo