Corrigindo problemas de envio e leitura de documentos

A maioria dos problemas de envio e OCR de documentos se resume a qualidade de imagem, imagem do verso ausente, um subtipo não permitido, ou uma cópia em vez do original - veja como corrigir cada um deles.

Escrito pelo suporte da Didit · Atualizado em 15 de setembro de 2026

Quando um documento falha ao ser enviado ou os campos principais não são extraídos corretamente, quase sempre é uma de poucas causas conhecidas. Veja como investigar cada uma.

#Primeiro: o documento é permitido?

Antes de investigar a qualidade da imagem, confirme que o seu workflow aceita exatamente aquele subtipo de documento para aquele país. Um subtipo não permitido falha de um jeito que parece um problema de leitura, mas não é - e falha para todo usuário que tiver esse formato, não só para um. Veja os subtipos costumam ser o motivo pelo qual um documento é rejeitado.

#Imagens borradas, escuras ou estouradas

A Didit verifica a qualidade da imagem antes de processar um documento e pede que o usuário refaça a foto se ela estiver muito borrada, muito escura ou muito clara. Peça ao usuário para:

• Usar iluminação boa e uniforme, sem reflexos diretos
• Segurar a câmera parada e deixá-la focar antes de capturar
• Manter os quatro cantos do documento visíveis no enquadramento
• Retirar o documento de uma capa plástica - o reflexo atrapalha a captura automática

Os usuários têm um número limitado de tentativas de refazer a foto; na última tentativa permitida, a imagem é aceita, então eles nunca ficam permanentemente bloqueados, mas uma captura de baixa qualidade ainda pode deixar campos ilegíveis. Verifique os avisos da sessão para IMAGE_TOO_BLURRY, IMAGE_TOO_DARK ou IMAGE_TOO_BRIGHT para confirmar que essa foi a causa.

Se documentos borrados estão passando e até sendo aprovados, o limite está baixo demais para o seu apetite de risco. Duas configurações na etapa de verificação de ID do fluxo resolvem:

• Qualidade mínima da imagem (o controle deslizante de qualidade): cada foto do documento é pontuada pelo modelo de qualidade no momento da captura, e capturas abaixo do seu mínimo são rejeitadas na hora com pedido de nova foto. O padrão é deliberadamente permissivo; suba-o e o verso borrado que pontuou 33 nunca chega às verificações.
• Tela de revisão da imagem capturada (em Avançado): mostra à pessoa a foto que acabou de tirar e pede para confirmar ou escanear de novo antes do envio. Vale só para scans pela câmera, já que uploads mostram prévia do arquivo.

A própria pontuação de qualidade está no relatório da sessão, então você pode olhar as sessões que te preocuparam e escolher um limiar logo acima.

#Um campo não foi detectado, ou foi lido errado (nome, data de nascimento, número do documento)

Quando o OCR não consegue extrair um campo específico, isso sozinho geralmente não reprova a sessão - por padrão, ela é encaminhada para revisão manual para que uma pessoa possa verificar.

Se isso está acontecendo com frequência para um tipo de documento ou um idioma específico, revise a configuração Formato de caractere preferido do seu workflow: escolha se os nomes extraídos devem ser normalizados para caracteres latinos ou mantidos na escrita original do documento. Uma incompatibilidade aqui é uma causa comum de campos de nome embaralhados ou ausentes em documentos em escrita cirílica, árabe, grega ou han.

Quando um valor extraído está errado (um sobrenome com uma letra trocada, o endereço no campo do nome), veja corrigir um nome ou campo lido errado: o suporte não pode editar por você, mas a etapa de revisão de dados pelo usuário, a API update-data e um reenvio podem.

#Capturas de tela, impressões e fotos de telas são rejeitadas

A Didit exige uma foto original e em tempo real do documento físico - não uma captura de tela, uma digitalização, uma cópia impressa, ou uma foto do documento em outra tela. As verificações de vivacidade de documento são feitas exatamente para pegar esses casos e vão sinalizar ou reprovar a sessão. Peça ao usuário para fotografar o documento físico diretamente.

Isso é intencional: aceitar uma foto de uma foto elimina a maior parte do valor de verificar um documento.

O detector de captura de tela pode ocasionalmente disparar num documento genuíno fotografado sobre um fundo carregado: um teclado, uma mesa estampada, um monitor atrás do cartão. Se você olhou as imagens e o documento é claramente real, aprove a sessão você mesmo: a marcação vai para revisão justamente para uma pessoa tomar essa decisão. Cada sinal de prova de vida do documento (captura de tela, cópia impressa, substituição do retrato) tem seus próprios limiares de revisão e recusa nas configurações de falsificação da etapa, caso algum esteja sensível demais para o seu tráfego.

#Imagem do verso ausente

Carteiras de identidade e carteiras de motorista têm duas faces - a Didit precisa das imagens da frente e do verso para completar a extração. Se apenas uma imagem da frente foi enviada para um desses tipos de documento, a sessão não vai ter os dados necessários.

Se os usuários travam com frequência na etapa do verso, verifique se o documento em questão realmente carrega dados legíveis no verso naquele país. Exigir uma imagem do verso que não contém nada faz os usuários falharem uma etapa sem nenhum benefício.

#A câmera nunca abre

Isso parece um problema de documento, mas é um problema de ambiente:

• Navegadores dentro de aplicativos. Um link aberto dentro do navegador embutido de outro aplicativo (um app de chat, por exemplo) muitas vezes não consegue acessar a câmera. Abrir o mesmo link no navegador normal do celular resolve.
• Permissão negada anteriormente. Depois que uma pessoa nega o acesso à câmera para um site, o navegador lembra disso. Ela precisa reconceder a permissão nas configurações do site; o fluxo não pode pedir de novo.
• Câmera já em uso. Outra aba ou aplicativo usando a câmera a bloqueia. Em alguns dispositivos, conceder acesso ao microfone também pode travar a câmera.

#O texto do fluxo aparece embaralhado

Se a pessoa relata palavras embaralhadas ou sem sentido na interface (não no documento), a causa costuma ser uma extensão de tradução de página do navegador reescrevendo a tela. Peça para desativar a tradução para aquela página - o fluxo já oferece seus próprios idiomas. Veja definindo o idioma da verificação.

#Quantos idiomas o OCR suporta?

O OCR da Didit lê documentos em mais de 130 idiomas, como parte da sua cobertura de documentos e países. Isso é separado do idioma da própria tela de verificação, que o navegador do usuário define automaticamente, a menos que você o defina explicitamente.

#Ainda com problemas?

Fale com o suporte informando o ID da sessão da verificação afetada - é a forma mais rápida da equipe investigar um caso específico, porque permite que eles vejam exatamente as imagens e os avisos que você está descrevendo.