Documento
Visão geral
O componente Documento guarda e apresenta um único documento estruturado — tipicamente uma fatura ou documento comercial semelhante — associado a um registo. Mostra o PDF guardado lado a lado com os dados extraídos do mesmo, e permite corrigir esses dados manualmente.
Este componente não carrega ficheiros, não executa OCR nem chama um modelo de AI por si próprio — a extração é feita por um workflow de AI (uma ação "AI — processar documento", configurada em Workflows ou através da definição Workflow AI da vista Documento). O componente Documento apenas apresenta e edita o resultado estruturado depois de este existir no valor da coluna, e guarda de volta as correções manuais feitas.
Utilize-o quando um registo precisa de um único documento canónico (uma fatura, uma guia de remessa, um contrato) cujos campos de cabeçalho e linhas devam poder ser revistos e corrigidos dentro do próprio registo — não para armazenamento genérico de ficheiros ou uma biblioteca de documentos (para isso, consulte a vista Documento).
Tipos de documento
A definição Tipo de visualização escolhe qual o editor que apresenta os dados da coluna:
| Tipo | Comportamento |
|---|---|
| Fatura — por defeito | Campos de cabeçalho editáveis, uma tabela de linhas editável (com totais, IVA e descontos), mapeamento de cabeçalho/linhas, e auto-matching |
| Genérico | Um visualizador de dados estruturados só de leitura. Ainda não existe escrita de volta para este tipo, pelo que nunca mostra campos editáveis, e os separadores Mapeamento / Auto-Matching ficam desativados com uma mensagem explicativa |
Configuração
O painel de configuração tem três separadores: Configuração, Mapeamento, e Auto-Matching. Os últimos dois só se aplicam ao tipo Fatura.
Configuração
| Definição | Descrição |
|---|---|
| Texto do botão | Etiqueta do botão que abre o editor na vista de formulário |
| Texto de ajuda | Texto de ajuda apresentado junto ao botão |
| Tipo de visualização | Fatura ou Genérico — ver Tipos de documento acima |
| Tamanho máximo do arquivo (MB) | Tamanho máximo de ficheiro aceite |
| Processar todas as páginas | Quando desativado, revela Máximo de páginas a processar, para limitar quantas páginas são consideradas |
| Combinar texto de todas as páginas | Junta o texto extraído de todas as páginas num único bloco |
| Tipos de arquivo aceitos | PDF, JPG, JPEG, PNG, BMP, GIF, WebP — o PDF não pode ser desmarcado; as imagens são convertidas automaticamente para PDF antes do processamento |
Mapeamento (apenas Fatura)
- Mapeamento do Cabeçalho — mapeia uma lista fixa de campos de cabeçalho da extração (nome/morada/NIF do fornecedor, número/data do documento, totais, forma/condições de pagamento, etc.) para colunas desta feature. Isto determina quais os campos que aparecem — e que são editáveis — no separador Cabeçalho do editor, pela ordem das colunas da feature.
Os controlos Salvar documento, Preenchimento automático e Configuração das Linhas (feature de destino, coluna do número de linha, ligação cabeçalho ↔ linhas e mapeamento de campos de linha) foram removidos deste painel: não tinham efeito no runtime. Só o Mapeamento do Cabeçalho continua a ser configurável.
Auto-Matching (apenas Fatura)
Permite que campos individuais de cabeçalho ou de linha procurem, à medida que escreve, um registo correspondente noutra feature, em vez de armazenar texto livre.
| Definição | Descrição |
|---|---|
| Ativar Auto-Matching | Ativa o auto-matching no campo Descrição das linhas — o único campo de linha com pesquisa em tempo real. Configura-se diretamente, sem depender de mapeamento de linhas |
| Ativar Auto-Matching no Cabeçalho | Ativa o auto-matching para os campos de cabeçalho já mapeados em Mapeamento do Cabeçalho |
| Por campo: Feature onde procurar | A feature onde se procura uma correspondência |
| Por campo: Coluna onde procurar | Coluna comparada com o texto extraído |
| Por campo: Coluna do ID/valor | Coluna cujo valor é guardado assim que uma correspondência é confirmada |
| Campos de cabeçalho também têm: Coluna para mostrar | Coluna apresentada como etiqueta legível da correspondência |
As correspondências com 70% de semelhança ou mais são ligadas automaticamente (visto verde + registo); abaixo disso, o campo mostra em alternativa uma indicação para "adicionar". Pode alternar um campo correspondido de volta para o texto originalmente extraído.
Em formulários
O botão abre um editor em ecrã inteiro. No desktop, os separadores Cabeçalho e Linhas ficam lado a lado com o PDF; em ecrãs estreitos, um terceiro separador Documento mostra o PDF em alternativa.
- Cabeçalho — os campos definidos pelo mapeamento de Cabeçalho, editáveis diretamente (com auto-matching quando configurado).
- Linhas — uma tabela editável (Descrição, Preço Unit., Qtd, Un, Total, IVA %) com adição/remoção por linha, três campos de desconto (S/IVA, IVA, Total), e totais que são recalculados em tempo real à medida que edita.
Não existe um botão de guardar separado que "confirma definitivamente" versus um cancelar que descarta: Guardar rascunho guarda o rascunho atual sem fechar, e o botão de fechar (✕) também guarda o rascunho antes de fechar — se o guardar falhar, o editor mantém-se aberto, em vez de se perderem as edições.
Para o tipo Genérico, abre-se o mesmo editor em ecrã inteiro, mas totalmente só de leitura.
Em tabelas e outras vistas
As vistas de tabela, lista, kanban, calendário e execução mostram um botão de ícone Ver documento que abre o mesmo editor em modo só de leitura. Se o documento tiver sido processado pela integração AI Struct do workspace, aparece um badge de estado compacto junto ao botão:
Por processar (ainda sem staging) · Pendente · A processar · Em staging · Rascunho · Validado · Duplicado · Importado · Ignorado · Erro
Dicas
- Nada preenche este campo automaticamente por si só — preencha os separadores Cabeçalho/Linhas manualmente, ou associe um workflow de AI ao documento de origem da coluna (ver a vista Documento e Integrações).
- O PDF é sempre um tipo de ficheiro aceite e não pode ser excluído; abrir o painel de configuração também volta a adicionar quaisquer extensões de imagem que tenha desmarcado anteriormente.
- O auto-matching aqui funciona sempre com um limiar de confiança fixo de 70% — ao contrário do componente Auto Match autónomo, este limiar não é configurável.