Corrigir problemas de envio e leitura de documentos

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

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

Se um documento falha ao ser enviado ou os campos principais não são extraídos corretamente, é quase sempre uma de algumas causas conhecidas. Aqui está como as analisar.

#Primeiro: o documento sequer é permitido?

Antes de investigar a qualidade de imagem, confirma que o teu fluxo de trabalho aceita esse subtipo exato de documento para esse país. Um subtipo não permitido falha de uma forma que parece um problema de leitura mas não é - e falha para todos os utilizadores com esse formato, não apenas um. Consulta os subtipos são o motivo habitual para um documento ser rejeitado.

#Imagens desfocadas, escuras ou sobreexpostas

A Didit verifica a qualidade da imagem antes de processar um documento e pede ao utilizador para repetir a foto se estiver demasiado desfocada, demasiado escura ou demasiado clara. Pede ao utilizador que:

• Use uma iluminação boa e uniforme, sem brilho direto
• Segure a câmara com firmeza e deixe-a focar antes de capturar
• Mantenha os quatro cantos do documento visíveis na moldura
• Retire o documento de uma bolsa de plástico - o reflexo impede a captura automática

Os utilizadores têm um número limitado de repetições; na última tentativa permitida a imagem é aceite para que nunca fiquem permanentemente bloqueados, mas uma captura de baixa qualidade ainda pode deixar campos ilegíveis. Verifica os avisos da sessão para IMAGE_TOO_BLURRY, IMAGE_TOO_DARK ou IMAGE_TOO_BRIGHT para confirmar que esta foi a causa.

Se documentos desfocados estão a passar e até a ser aprovados, o limiar está demasiado baixo para o seu apetite de risco. Duas definições no passo de verificação de ID do fluxo resolvem isso:

• Qualidade mínima da imagem (o controlo deslizante de qualidade): cada foto do documento é pontuada pelo modelo de qualidade no momento da captura, e as capturas abaixo do seu mínimo são rejeitadas de imediato com um pedido de nova foto. O valor por defeito é deliberadamente permissivo; suba-o e o verso desfocado que pontuou 33 nunca chega às verificações.
• Ecrã de revisão da imagem capturada (em Avançado): mostra à pessoa a foto que acabou de tirar e pede-lhe que a confirme ou digitalize de novo antes de a carregar. Aplica-se só a digitalizações pela câmara, já que os carregamentos mostram uma pré-visualização do ficheiro.

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

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

Quando o OCR não consegue extrair um campo específico, isso por si só normalmente não recusa a sessão - por predefinição é encaminhado para revisão manual para que uma pessoa possa verificar.

Se isto acontece com frequência para um tipo de documento ou um idioma, revê a definição Formato de caracteres preferido do teu fluxo de trabalho: escolhe 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 incompletos ou baralhados em documentos em cirílico, árabe, grego ou escrita han.

Quando extraiu um valor que está errado (um apelido com uma letra trocada, a morada no campo do nome), veja corrigir um nome ou campo mal lido: o suporte não o pode editar por si, mas o passo de revisão de dados pelo utilizador, a API update-data e um reenvio podem.

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

A Didit exige uma foto original, em tempo real, do documento físico - não uma captura de ecrã, uma digitalização, uma cópia impressa, ou uma foto do documento noutro ecrã. As verificações de prova de vida do documento são desenhadas precisamente para detetar estes casos e vão assinalar ou recusar a sessão. Pede ao utilizador que fotografe diretamente o documento físico.

Isto é deliberado: aceitar uma foto de uma foto elimina a maior parte do valor de sequer verificar um documento.

O detetor de captura de ecrã pode ocasionalmente disparar num documento genuíno fotografado sobre um fundo carregado: um teclado, uma secretária com padrão, um monitor atrás do cartão. Se olhou para as imagens e o documento é claramente real, aprove a sessão você mesmo: a etiqueta encaminha para revisão precisamente para uma pessoa tomar essa decisão. Cada sinal de prova de vida do documento (captura de ecrã, cópia impressa, substituição do retrato) tem os seus próprios limiares de revisão e recusa nas definições de falsificação do passo, caso algum seja demasiado sensível para o seu tráfego.

#Falta a imagem do verso

Os cartões de identidade e as cartas de condução têm duas faces - a Didit precisa tanto da imagem da frente como do verso para completar a extração. Se apenas foi submetida uma imagem da frente para um destes tipos de documento, a sessão não terá os dados de que precisa.

Se os utilizadores ficam consistentemente presos no passo do verso, verifica se o documento em questão realmente tem dados legíveis no verso nesse país. Exigir uma imagem do verso que não contém nada faz os utilizadores falhar um passo sem qualquer benefício.

#A câmara nunca abre

Isto parece um problema de documento mas é um problema de ambiente:

• Navegadores dentro de apps. Um link aberto dentro do navegador integrado de outra app (uma app de chat, por exemplo) muitas vezes não consegue aceder à câmara. Abrir o mesmo link no navegador normal do telemóvel resolve isto.
• Permissão previamente negada. Assim que uma pessoa nega o acesso à câmara para um site, o navegador lembra-se. Tem de voltar a conceder a permissão nas definições do site; o fluxo não pode voltar a pedir.
• Câmara já em uso. Outro separador ou app a usar a câmara bloqueia-a. Em alguns dispositivos, conceder acesso ao microfone também pode ocupar a câmara.

#O texto no fluxo parece incompreensível

Se a pessoa reportar palavras baralhadas ou sem sentido na interface (não no documento), a causa habitual é uma extensão de tradução do navegador a reescrever o ecrã. Pede-lhe que desligue a tradução para a página - o fluxo já oferece os seus próprios idiomas. Consulta definir o idioma da verificação.

#Quantos idiomas suporta o OCR?

O OCR da Didit lê documentos em mais de 130 idiomas, como parte da sua cobertura de documentos e países. Isto é independente do idioma do próprio ecrã de verificação, que o navegador do utilizador define automaticamente a menos que o definas explicitamente.

#Continuas preso?

Contacta o suporte com o ID de sessão da verificação afetada - é a forma mais rápida de a equipa investigar um caso específico, porque lhes permite ver exatamente as imagens e os avisos que estás a descrever.