Document AI: Extraia Campos Personalizados de Qualquer Documento (PT-PT)

Os documentos de identidade são fáceis. Existem aproximadamente 14.000 deles no mundo, têm layouts fixos e um bom motor OCR lê-os sem que lhe seja dito nada. Os documentos que realmente atrasam um onboarding são os outros: uma constancia de situación fiscal mexicana, um RIF venezuelano, uma escritura de constitución espanhola, um extrato bancário indiano, um recibo de vencimento do Reino Unido, uma carta de origem de riqueza escrita pelo contabilista de alguém. Não há dois iguais, e nenhum modelo os abrange.

A resposta usual é um humano. Alguém abre o PDF, lê o número, digita-o num formulário e prossegue — algumas centenas de vezes por semana. O Document AI é a resposta que não é um humano.

Principais conclusões

• Configura até três documentos por fluxo de trabalho e, para cada um, define os campos exatos que pretende extrair — nome, tipo (texto, número, data), uma instrução de extração e se é obrigatório.
• Um modelo de visão-linguagem lê cada documento em relação a um esquema construído a partir das suas definições de campo e devolve valores tipificados — números como números, datas como AAAA-MM-DD.
• Análise forense de PDF e EXIF é executada em cada upload para detetar manipulação.
• Os campos extraídos podem ser referenciados cruzadamente com outras etapas — o nome do titular da conta num extrato bancário com o nome no ID verificado, por exemplo — e com regras personalizadas que escreve.
• $0.20 por documento. Existe também uma API autónoma se já tiver o ficheiro e não quiser nenhuma IU alojada.

O que o Document AI faz

Descreve um documento uma vez. Atribui-lhe um título e uma descrição no ecrã, que são automaticamente traduzidos para todos os idiomas de verificação, e lista os pontos de dados a ler. Cada campo recebe uma chave, um nome humano, uma instrução que diz ao modelo o que procurar, um tipo e uma sinalização de obrigatoriedade.

O utilizador carrega um PDF ou uma imagem. O Didit renderiza-o, executa a extração em relação ao seu esquema, aplica a análise forense e, em seguida, aplica as suas regras. O resultado é um estado por documento que se acumula no estado da funcionalidade, com Recusado a superar Em Revisão a superar Aprovado.

Porque é que isto é importante

Três coisas falham no onboarding que um OCR de modelo fixo não consegue corrigir.

O documento não tem modelo. Um comprovativo de fundos é o que o banco do cliente decidiu imprimir. Uma carta de origem de riqueza é prosa. A única coisa que generaliza é um modelo que lê o significado em vez da posição.

Os dados têm de concordar com o resto da sessão. Extrair "J. Smith" de um recibo de vencimento vale muito pouco por si só. Extraí-lo e compará-lo com o nome completo no documento de identidade verificado é um controlo. O Document AI faz a comparação e permite-lhe decidir o que acontece quando falha.

O documento pode ter sido editado. Um recibo de vencimento com um número diferente colado sobre o original é o truque mais antigo no crédito. As verificações forenses na estrutura do PDF e no EXIF da imagem são executadas em cada upload e podem recusar, rever ou passar, dependendo da ação que configurar.

Detalhes técnicos

Se o ficheiro já estiver no seu servidor, um pedido faz tudo:

curl -X POST https://verification.didit.me/v3/document-ai/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -F "document=@payslip.pdf" \
  -F 'fields=[{"key":"account_holder","name":"Account holder","instruction":"Full name of the employee","type":"text","required":true,"is_full_name":true},{"key":"net_pay","name":"Net pay","instruction":"Net amount paid this period","type":"number","required":true},{"key":"pay_date","name":"Pay date","instruction":"Date of payment","type":"date","required":true}]'

Recebe os campos extraídos, o resultado da correspondência de nome e um estado de forma síncrona. Sem fluxo alojado, sem sessão.

Dentro de um fluxo de trabalho, a mesma configuração reside na funcionalidade DOCUMENT_AI, e o utilizador carrega através do fluxo alojado ou do SDK. DOCUMENT_AI aparece então na matriz features[] da decisão, e obtém o resultado de GET /v3/session/{sessionId}/decision/ ou subscreve session.status.updated.

As regras que pode definir

Regra	Dispara quando	Ação
document_ai_unreadable_document_action	O ficheiro não pode ser lido	DECLINE · REVIEW · NO_ACTION
document_ai_missing_required_fields_action	Um campo obrigatório está ausente	DECLINE · REVIEW · NO_ACTION
document_ai_document_tampering_action	A análise forense deteta manipulação	DECLINE · REVIEW · NO_ACTION
document_ai_name_mismatch_action	O campo de nome pontua abaixo do limiar	DECLINE · REVIEW · NO_ACTION
document_ai_unsupported_file_action	O tipo de ficheiro não é aceite	DECLINE · REVIEW · NO_ACTION
document_ai_max_attempts_exceeded_action	O utilizador esgota as tentativas	DECLINE · REVIEW · NO_ACTION

Além de document_ai_name_match_score_threshold de 0 a 100 e document_ai_max_retry_attempts de 2 a 5.

Referência cruzada de outras etapas

As status_rules[] personalizadas referenciam um campo extraído como document_ai. e podem compará-lo com a saída de outra etapa usando value_type: "field". Assim, document_ai.account_holder equals kyc.full_name é uma regra que escreve, não uma funcionalidade pela qual espera.

Num fluxo de trabalho de pessoa, um campo marcado como is_full_name é comparado automaticamente com a identidade verificada. Num fluxo de trabalho de negócio, é comparado com o nome da empresa correspondente no registo.

Casos de uso

Empréstimos e BNPL. Recibos de vencimento e extratos bancários, com o salário líquido extraído como um número sobre o qual as suas regras de subscrição podem atuar, e deteção de adulteração em cada upload.

Onboarding de criptomoedas e de alto valor. Comprovativos de fundos e cartas de origem de riqueza, verificados cruzadamente com a identidade verificada.

Onboarding de negócios na América Latina. Constancia de situación fiscal, RIF, contrato social, certificado de existencia. Documentos cujo formato é definido por uma autoridade fiscal e muda sem aviso prévio, lidos por instrução e não por modelo.

Serviços profissionais regulados. Cartas de compromisso e atos fiduciários, onde o nome no documento tem de corresponder à pessoa que assinou a sessão.

Como integrar com o Didit

1. Abra o construtor de fluxos de trabalho e adicione a funcionalidade Document AI.
2. Defina os seus documentos e os seus campos. Comece a partir de um modelo ou construa do zero.
3. Defina as regras básicas e o limiar de correspondência de nomes.
4. Adicione quaisquer regras de estado personalizadas que façam referência cruzada a outras etapas.
5. Crie sessões com POST /v3/session/ e leia a decisão, ou chame POST /v3/document-ai/ diretamente se já tiver o ficheiro.

Perguntas frequentes

Quantos documentos posso configurar?

Até três por fluxo de trabalho, cada um com a sua própria lista de campos, título e descrição.

Que tipos de ficheiro funcionam?

PDF e imagens. Qualquer outra coisa aciona document_ai_unsupported_file_action.

Lida com documentos noutros idiomas?

Sim. Os títulos e descrições que escreve são traduzidos automaticamente para todos os idiomas de verificação, e a extração é orientada por instruções e não bloqueada por idioma.

Quanto custa?

$0.20 por documento, seja através do fluxo de trabalho ou da API autónoma. Os primeiros 500 por mês são gratuitos, como em todas as funcionalidades do Didit.

Posso usá-lo sem qualquer verificação de identidade?

Sim. POST /v3/document-ai/ é uma chamada autónoma de servidor para servidor. Sem sessão, sem IU alojada, sem etapa de identidade necessária.

Pronto para começar?

Leia a documentação do Document AI, a referência da API autónoma, verifique os preços e comece gratuitamente.