> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/portuguese/administration-and-setup/setup/document-types/fuzzy-data-configuration-with-master-data.md).
# Configurazione dei Dati Fuzzy con i Dati Principali
## **Visão Geral**
Cada tipo de documento possui suas próprias configurações padrão e deve ser configurado separadamente. Enquanto este exemplo explica a configuração para **Faturas**, o mesmo processo se aplica a todos os tipos de documentos.
## Para configurar Dados Fuzzy, navegue até:
Configurações → Configurações Globais → Tipos de Documento → Fatura → Campos → Configurações de Dados Mestres → Consultar Dados Mestres
## **Consultas Padrão**
Existem **quatro grupos de consulta padrão** para faturas:
1. **Dados da Empresa**
2. **Cabeçalho do Pedido de Compra**
3. **Fornecedor**
4. **Código de Imposto**
Cada grupo contém campos específicos. Clique em um grupo para **expandir** e visualizar os campos. Os grupos de consulta padrão são rotulados com uma **tag "Padrão"**.
## **Status da Configuração de Consulta**
* As **configurações ativas** são marcadas com uma **tag "Ativada"**.
* As **configurações desativadas** são marcadas com uma **tag "Desativada"**.
## **Pré-requisito: Importando Dados Mestres**
Para que os Dados Fuzzy funcionem corretamente, os **dados mestres** relevantes devem ser importados. Sem isso, o sistema não tem dados de referência para usar. Aqui está como importar dados mestres:
{% content-ref url="/pages/Chv0RPaVJt5KWPaHDDd6" %}
[Importazione Dati Master](/portuguese/infor-integration-and-configuration/importing-customer-master-data.md)
{% endcontent-ref %}
## **Gerenciando Grupos de Consulta**
Cada grupo de consulta é **ativado por padrão** mas pode ser modificado clicando nos três pontos:
* **Desativar** → Desativa um grupo. *(Disponível apenas para grupos ativados)*
* **Ativar** → Ativa um grupo. *(Disponível apenas para grupos desativados)*
* **Duplicar** → Cria uma cópia que pode ser modificada sem afetar o original.
* **Visualizar** → Exibe informações como o **tipo de documento** ao qual pertence e a **tabela de consulta** que utiliza. *(Disponível apenas para grupos padrão)*
* **Editar** → Disponível para grupos **não padrão**. Permite modificar detalhes do grupo.
* **Excluir** → Remove o grupo completamente. *(Apenas para grupos não padrão)*
## **Criando uma Nova Configuração de Consulta**
Existem **duas maneiras** de criar uma configuração de consulta:
1. **Duplicar uma consulta existente**
* Isso copia todas as informações e campos de um grupo existente.
* Você só precisa fornecer um **novo nome**.
2. **Criar uma consulta do zero**
* Clique em **"Criar Configuração de Consulta"**.
* Preencha os detalhes necessários:
* **Nome da Configuração**
* **Tabela de Consulta** (Tabela de Dados Mestres a ser usada)
* **Manipulador de Conflito** (Escolha um: Melhor Pontuação, Retornar Nenhum, Retornar Primeiro)
* **Tipo de Contexto** (Cabeçalho ou Linha) precisa de contexto
* **Corresponder Todos** (Opção de Checkbox) precisa de contexto
## **Gerenciando Campos Dentro de um Grupo de Consulta**
Cada grupo contém campos que podem ser **adicionados, removidos, editados ou visualizados**, dependendo se são campos padrão ou campos personalizados.
### **Campos Padrão**
* Marcados com uma **tag "Padrão"**.
* **Apenas pode ser visualizado**, não editado ou excluído.
### **Campos Não Padrão**
* **Podem ser editados ou excluídos** clicando nos três pontos e selecionando **Editar** ou **Remover**.
### **Adicionando um Novo Campo**
**Nota:** Você pode criar campos dentro de configurações de Consulta padrão.
Para adicionar um novo campo dentro de um grupo:
1. Clique em **"Criar"** dentro do grupo relevante.
2. Forneça os seguintes detalhes:
* **Campo de Consulta** → Nome da coluna da tabela de consulta de dados mestres.
* **Campo de Validação** → Campo correspondente do DocBits.
* **Campo Pai** → *(Mais detalhes necessários)*
* **Operador de Busca** → Escolha um:
* Inteligente
* Contém
* Exato
* Começa com
* Termina com
* **Caixas de Seleção:**
* **Acionador Automático** → Quando ativado, se outro campo em uma configuração de consulta diferente compartilhar a mesma coluna, este campo será atualizado **automaticamente** sempre que o outro campo for atualizado
* **Pesquisável** → Ativa o campo como um campo **Fuzzy Data**, permitindo pesquisas na consulta de dados mestres (ícone azul na tela de validação).
## **Última Etapa: Adicionando Campos ao Layout**
Após configurar os campos de Dados Fuzzy, **certifique-se de adicioná-los ao layout usando o Construtor de Layout**. Se os campos não forem adicionados ao layout, eles não estarão disponíveis para uso.
{% content-ref url="/pages/kqY68n6veT0mSw5H7hdu" %}
[Gestore Layout](/portuguese/administration-and-setup/settings/global-settings/document-types/layout-manager.md)
{% endcontent-ref %}
## **Como o DocBits escolhe um fornecedor**
Quando um documento chega, o DocBits procura o fornecedor nos seus dados mestres. Três definições determinam o resultado. Esta secção explica-as passo a passo, com exemplos.
### **Passo 1 — Que campos são usados na pesquisa**
O DocBits só usa um campo na pesquisa quando ambos os pontos são verdadeiros:
* o campo está marcado como **Pesquisável (Searchable)** ou **Auto Trigger** na configuração de consulta, e
* o campo tem um valor no documento.
A origem do valor não importa. Um campo treinado, um campo preenchido pela IA e um valor escrito por um utilizador são tratados da mesma forma.
{% hint style="warning" %}
**Pesquisável faz duas coisas.** Mostra o ícone azul de pesquisa no ecrã de validação **e** acrescenta o campo à pesquisa automática de fornecedor. Um campo que só deve ser pesquisado manualmente fica desmarcado.
{% endhint %}
### **Passo 2 — Uma pesquisa, não uma pesquisa por campo**
O DocBits **não** pesquisa cada campo separadamente. Constrói **uma** pesquisa sobre todos os campos usados. **Corresponder a tudo (Match All)** determina como são combinados:
* **Corresponder a tudo desligado** (predefinição) → "encontrar todos os fornecedores que correspondem ao NIF **OU** ao nome do fornecedor". Isto dá uma lista **mais longa**.
* **Corresponder a tudo ligado** → "encontrar todos os fornecedores que correspondem ao NIF **E** ao nome do fornecedor". Isto dá uma lista **mais curta**.
Tenha em conta que os operadores **Smart** e **Contains** procuram uma parte do texto. O nome "Meier" também encontra "Meier Bau GmbH" e "Meier & Sons Ltd". Por isso um nome de fornecedor encontra muitas vezes vários fornecedores.
### **Passo 3 — O que acontece quando a lista tem mais de um fornecedor**
O **Gestor de conflitos (Conflict Handler)** decide:
* **Best Score** → escolhe o fornecedor que corresponde ao maior número de campos. Nunca deixa o fornecedor vazio.
* **Return None** → deixa o fornecedor vazio, para que um utilizador o escolha.
* **Return First** → escolhe o primeiro fornecedor da lista.
### **Exemplos**
Em todos os exemplos o documento tem um NIF e um nome de fornecedor, e ambos os campos são **Pesquisáveis**.
| O NIF encontra | O nome encontra | Corresponder a tudo desligado + Return None | Corresponder a tudo ligado + Return None | Corresponder a tudo desligado + Best Score |
|---|
| só A | A e B | vazio | A | A |
| A e B | só B | vazio | B | B |
| A, B e C | C, D e E | vazio | C | C |
| A, B e C | B, C e D | vazio | vazio | B ou C, não fiável |
| só A | nada | A | vazio | A |
Como ler a tabela:
* **As linhas 1 a 3** são o caso normal. Um campo é único, o outro não. Com **Corresponder a tudo desligado** a lista contém vários fornecedores e **Return None** deixa o campo vazio. **Corresponder a tudo ligado** mantém apenas o fornecedor que corresponde aos dois campos e encontra-o.
* **A linha 4** não tem nenhum fornecedor único. Deixar o campo vazio está correto. **Best Score** escolhe um à mesma, e pode ser o errado.
* **A linha 5** é o risco de **Corresponder a tudo ligado**. Ver o aviso abaixo.
{% hint style="warning" %}
**Corresponder a tudo pode perder um fornecedor.** Com **Corresponder a tudo ligado** todos os campos usados têm de corresponder. Se um campo tiver um valor que não existe nos seus dados mestres — um erro de escrita, um nome de empresa antigo, um valor lido da página — a pesquisa inteira não devolve nada e nenhum fornecedor é encontrado, apesar de o NIF sozinho ter encontrado o correto.
{% endhint %}
### **Um fornecedor era reconhecido antes e agora já não é**
Quase sempre há mais um campo que passou a ter valor. Verifique por esta ordem:
1. Abra o documento. Que campo do grupo de consulta tem agora um valor que antes estava vazio?
2. Abra a configuração de consulta. Esse campo está marcado como **Pesquisável** ou **Auto Trigger**? Se sim, passou a participar na pesquisa e torna a lista de resultados mais longa.
3. Escolha uma das três saídas:
* **O campo não deve participar na pesquisa** → desmarque **Pesquisável** e **Auto Trigger** nesse campo. O campo mantém o seu valor no documento e continua a ser mostrado ao utilizador. É a alteração mais pequena.
* **O campo deve participar** → ligue **Corresponder a tudo**, mas leia primeiro o aviso acima.
* **Quer um fornecedor em todos os casos** → coloque o **Gestor de conflitos** em **Best Score**. Aceite que pode escolher o fornecedor errado em vez de deixar o campo vazio.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.docbits.com/portuguese/administration-and-setup/setup/document-types/fuzzy-data-configuration-with-master-data.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
