Visão Geral
Templates de extração (chamados de Configurações de Estrutura no painel) definem quais dados a Textualiza deve extrair dos seus documentos. Em vez de receber o texto bruto, você configura os campos que precisa — como nome, CPF, valor do contrato, data de vencimento — e o sistema extrai essas informações automaticamente usando IA.
Quando Usar
- Você processa documentos recorrentes com estrutura semelhante (contratos, laudos, fichas cadastrais)
- Precisa extrair campos específicos em vez de texto livre
- Quer padronizar a saída para integrar com outros sistemas
Usando o Painel
Passo 1: Acessar as Configurações
No menu lateral, vá em Configurações de Estrutura. Você verá a lista de todas as suas configurações, com nome, descrição, quantidade de campos e status (Ativo/Inativo).
Passo 2: Criar Nova Configuração
Clique em “Nova Configuração”. Você terá duas opções:
Opção A: Usar um Template Pronto
Selecione “Usar Template” para começar a partir de um modelo pré-configurado. Você pode:
- Buscar templates por nome
- Filtrar por setor: Cartório, Jurídico, RH, Saúde, Finanças, Educação, Governo, Transportes ou Geral
- Visualizar os campos que cada template extrai antes de escolher
- Clicar em “Usar este template” para carregar os campos automaticamente
Após carregar o template, você pode personalizar os campos antes de salvar.
Opção B: Criar do Zero
Selecione “Criar do Zero” para montar sua própria configuração.
Passo 3: Preencher as Informações Básicas
| Campo | Descrição |
|---|---|
| Nome da Configuração | Um nome descritivo (ex: “Contrato de Locação”, “Ficha de Paciente”). |
| Descrição | Opcional. Explique o propósito do template para facilitar a identificação. |
Passo 4: Definir os Campos de Extração
Clique em “Adicionar Campo” para incluir cada dado que deseja extrair. Para cada campo, preencha:
| Propriedade | Descrição | Exemplo |
|---|---|---|
| Nome do Campo | Identificador único, sem espaços (usado internamente e na exportação) | nome_locatario |
| Rótulo | Nome legível que aparece nos relatórios | Nome do Locatário |
| Tipo | O tipo de dado esperado (veja a tabela abaixo) | CPF |
Tipos de Campo Disponíveis
| Tipo | O que Extrai | Exemplo de Resultado |
|---|---|---|
| Texto | Texto livre | ”João da Silva Pereira” |
| Número | Valores numéricos | 42500 |
| Data | Datas | ”2025-03-15” |
| Data e Hora | Datas com horário | ”2025-03-15 14:30:00” |
| Percentual | Valores percentuais | 12.5 |
| Valor Monetário | Valores em reais | 1500.00 |
| Sim/Não | Valores booleanos | true |
| Endereços de e-mail | ”joao@empresa.com” | |
| Telefone | Números de telefone | ”(11) 99999-0000” |
| URL | Links | ”https://exemplo.com” |
| CPF | CPF do documento | ”123.456.789-00” |
| CNPJ | CNPJ da empresa | ”12.345.678/0001-00” |
| RG | Registro Geral | ”12.345.678-9” |
| CEP | Código postal | ”01310-100” |
| Número de Protocolo | Protocolos e registros | ”2025/001234” |
| Número de Processo | Processos judiciais | ”0001234-56.2025.8.26.0100” |
| Conta Bancária | Dados bancários completos | Banco, agência, conta e tipo |
| Endereço Completo | Endereço com todos os componentes | Rua, número, complemento, bairro, cidade, estado e CEP |
| Lista de Valores | Múltiplos itens do mesmo tipo | [“Item 1”, “Item 2”, “Item 3”] |
| Lista de Objetos | Múltiplos registros com sub-campos | Lista de partes envolvidas, cada uma com nome, CPF e papel |
Campos Especiais
Lista de Valores
Ao selecionar este tipo, você define o tipo dos itens da lista. Por exemplo: uma lista de e-mails, uma lista de datas, etc.
Lista de Objetos
Ao selecionar este tipo, um sub-formulário aparece para você definir os campos de cada item. Ideal para dados repetidos como:
- Partes envolvidas: cada uma com nome, CPF, papel
- Itens de um contrato: cada um com descrição, quantidade, valor
- Imóveis em uma matrícula: cada um com endereço, área, registro
Para cada sub-campo, defina nome, rótulo, tipo e se é obrigatório.
Passo 5: Salvar
Clique em “Salvar Configuração”. O template ficará disponível para uso nos módulos de OCR e Processamento de Textos.
Usando o Template
Após criar, seu template pode ser usado em dois lugares:
-
Processamento de Textos — ao criar uma nova análise, selecione o tipo “Estrutura Personalizada” e escolha seu template no campo “Configuração de Estrutura”.
-
Processamento de Imagens (OCR) — ao enviar um documento, marque “Iniciar Processamento de Texto Automaticamente” e selecione seu template no campo “Configuração de Estrutura NLP”.
Gerenciando Templates
Na lista de Configurações de Estrutura, você pode:
- Visualizar os detalhes e campos de cada template
- Editar para adicionar, remover ou modificar campos
- Desativar templates que não está mais usando (ficam com status “Inativo”)
- Excluir templates que não precisa mais
Exemplo Prático
Template: “Contrato de Locação”
Campos configurados:
| Nome do Campo | Rótulo | Tipo |
|---|---|---|
locador_nome | Nome do Locador | Texto |
locador_cpf | CPF do Locador | CPF |
locatario_nome | Nome do Locatário | Texto |
locatario_cpf | CPF do Locatário | CPF |
endereco_imovel | Endereço do Imóvel | Endereço Completo |
valor_aluguel | Valor do Aluguel | Valor Monetário |
data_inicio | Data de Início | Data |
data_fim | Data de Término | Data |
garantia | Tipo de Garantia | Texto |
testemunhas | Testemunhas | Lista de Objetos |
Com este template, ao processar qualquer contrato de locação, a Textualiza extrai automaticamente todos esses campos e entrega os dados organizados em Excel ou JSON.
Dicas
- Comece pelos templates prontos: explore os modelos pré-configurados antes de criar do zero. É mais rápido e você pode personalizar depois.
- Nomes de campo consistentes: use nomes padronizados (ex:
cpf_comprador,nome_vendedor) para facilitar integrações via API. - Teste com documentos reais: após criar o template, processe um documento de teste para verificar se os campos estão sendo extraídos corretamente.
- Reutilize: um bom template serve para dezenas ou centenas de documentos do mesmo tipo.