> 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/settings/global-settings/document-types/fields/master-data-settings.md).

# Configurações de dados mestre

## Vídeo tutorial: Dados mestres e listas de valores

{% embed url="<https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/master-data-lists-admin/v1/pt.mp4>" %}
Fontes de dados mestres, listas de valores e configurações de dados mestre no DocBits
{% endembed %}

O vídeo mostra as fontes de dados mestres, as listas de valores e as configurações de dados mestre de um tipo de documento.

As **Configurações de dados mestre** ligam os campos de validação de um documento aos dados guardados em [Pesquisa de dados mestre](/portuguese/administration-and-setup/settings/document-processing/master-data-lookup.md). Use **Pesquisar Dados Mestres** para encontrar e preencher registos correspondentes. Use **Dados Mestres LOV** para oferecer uma lista de valores de um conjunto de dados.

As imagens dos formulários mostram os valores iniciais antes de introduzir dados. Os valores dos mapeamentos existentes estão ocultados na imagem da tabela.

## Abrir as configurações

1. Em **Configurações**, abra **Processamento de documentos → Tipos de documentos**.
2. Abra o tipo de documento que quer configurar, por exemplo **Fatura**, e selecione **Campos**.
3. Selecione **Configurações de dados mestre**. A página tem as secções separadas **Pesquisar Dados Mestres** e **Dados Mestres LOV**. Selecione o título de uma secção para a expandir.

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-e5eb45c9ab2e2bb599c4c67cbe04322cc73cfc19%2Fdbdc-35-overview-pt-20261101.png?alt=media" alt="Secções Pesquisar Dados Mestres e Dados Mestres LOV recolhidas nas Configurações de dados mestre de Fatura"><figcaption><p>Selecione o título de uma secção para expandir as configurações de pesquisa ou de listas de valores.</p></figcaption></figure>

## Corresponder um registo com Pesquisar Dados Mestres

As configurações em **Pesquisar Dados Mestres** procuram num conjunto de dados e associam um registo correspondente aos campos do documento. A lista mostra o nome de cada configuração e se está ativa. Uma etiqueta **Padrão** identifica uma configuração do DocBits; pode desativá-la, mas não a pode editar nem eliminar.

### Criar uma configuração de pesquisa

1. Selecione **Criar configuração de pesquisa**.
2. Introduza um **Nome da pesquisa** e escolha o **Nome do conjunto de dados de pesquisa** que contém os registos a procurar.
3. Escolha um **Manipulador de conflitos** para os casos em que vários registos correspondem:
   * **Best Score** escolhe a correspondência mais forte.
   * **Return None** deixa o resultado vazio, para um utilizador decidir.
   * **Return First** usa o primeiro resultado.
4. Escolha **HEADER** para campos do documento ou **LINE** para campos de uma tabela do documento. Em **LINE**, escolha também **Detalhe do contexto**, a tabela onde a pesquisa é aplicada.
5. Ative **Combinar tudo** se todos os campos de pesquisa configurados tiverem de corresponder a um registo. Deixe desativado se um campo correspondente for suficiente. Selecione **Criar**.

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-9b1d6fd3c04fee10e4a285d8be51db15b72e45a7%2Fdbdc-35-lookup-config-pt-20261101.png?alt=media" alt="Formulário vazio Criar configuração de dados mestre com tipo de documento, nome da pesquisa, conjunto de dados, manipulador de conflitos, tipo de contexto, Combinar tudo, Cancelar e Criar"><figcaption><p>O formulário mostra inicialmente INVOICE, Best Score e HEADER; preencha os campos para a configuração pretendida.</p></figcaption></figure>

**Combinar tudo** e o **Manipulador de conflitos** afetam o reconhecimento automático de fornecedores. Veja [Configuração de Dados Fuzzy com Dados Mestres](/portuguese/administration-and-setup/setup/document-types/fuzzy-data-configuration-with-master-data.md) para exemplos práticos.

### Mapear campos numa configuração

Expanda uma configuração para ver os campos associados. As colunas mostram o campo do conjunto de dados, o campo de validação do documento, um campo pai opcional e se o mapeamento é pesquisável ou aciona a pesquisa automaticamente. Os mapeamentos da sua organização podem ser diferentes.

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-3d4621919ab0cc4cbda47c806b3c6820f56b9472%2Fdbdc-35-mapped-fields-pt-20261101.png?alt=media" alt="Tabela de mapeamentos expandida com Campo De Pesquisa, Campo De Validação, Campo Pai, Pesquisável, Gatilho Automático e Ações; os valores existentes estão ocultados"><figcaption><p>Verifique as colunas antes de adicionar um campo. Os valores existentes estão ocultados nesta imagem.</p></figcaption></figure>

Selecione **Criar** dentro da configuração expandida para adicionar um mapeamento:

* **Campo de pesquisa** é a coluna do conjunto de dados a procurar.
* **Campo de validação** é o campo do documento que recebe o resultado.
* **Campo pai** verifica opcionalmente o resultado contra um campo relacionado.
* **Operador de pesquisa** controla a forma como o texto é comparado. **Inteligente** ignora espaços e pontuação, por isso os valores que só diferem na formatação continuam a corresponder. **Inteligente Exato** aplica a mesma normalização, mas só devolve um registo quando o valor completo é igual; numa correspondência parcial não é devolvido nenhum registo. As outras opções são **Contém**, **Começa com**, **Termina com** e **Exato**.
* **Gatilho automático** inicia uma pesquisa quando este campo é preenchido. **Pesquisável** permite que o campo participe nas pesquisas e suporta a pesquisa manual durante a validação.

Selecione **Criar** para adicionar o mapeamento. Use o menu de três pontos **Ações** numa linha para editar ou eliminar um mapeamento editável. Os mapeamentos padrão só podem ser vistos.

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-d4e21c0afa76966beeb2465199dced82a9da53dc%2Fcore-6312-search-operator-pt.png?alt=media" alt="Janela Criar campos de dados mestre com a lista Operador de pesquisa aberta: Inteligente, Inteligente Exato, Contém, Termina com, Exato, Começa com"><figcaption><p>Escolha <strong>Inteligente Exato</strong> quando o valor completo tem de corresponder depois de ignorar espaços e pontuação.</p></figcaption></figure>

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-33cdc84af64510a07257200f5b080eff078491c2%2Fdbdc-35-create-field-pt-20261101.png?alt=media" alt="Formulário vazio Criar campos de dados mestre com Campo de pesquisa, Campo de Validação, Campo Pai, Operador de pesquisa, Gatilho automático, Pesquisável, Cancelar e Criar"><figcaption><p>Escolha como uma coluna do conjunto de dados é associada a um campo do documento.</p></figcaption></figure>

Use o menu de três pontos de uma configuração para a ativar ou desativar, duplicar ou editar. Uma configuração padrão só pode ser vista e não pode ser eliminada. Eliminar uma configuração ou campo personalizado remove o respetivo mapeamento; verifique primeiro de que campos do documento depende.

## Oferecer uma lista com Dados Mestres LOV

**Dados Mestres LOV** cria listas de opções a partir de um conjunto de dados de dados mestre. Também pode adicionar campos de filtro para que uma seleção anterior limite as opções mostradas a seguir.

Expanda **Dados Mestres LOV** e selecione **Criar configuração de pesquisa Lov**. Se não existir nenhuma configuração, a secção mostra apenas este botão.

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-6c1a0febbf136c693d3b4e8fc68ed424690c29f4%2Fdbdc-35-lov-overview-pt-20261101.png?alt=media" alt="Secção Dados Mestres LOV expandida com o botão Criar configuração de pesquisa Lov"><figcaption><p>Abra o formulário de listas de valores com Criar configuração de pesquisa Lov.</p></figcaption></figure>

No formulário, introduza **Pesquisar nome de amor**, escolha **Nome do conjunto de dados de pesquisa Lov** e defina o **Tipo de contexto** como **HEADER** ou **LINE**. Em **LINE**, selecione **Detalhe do contexto** para identificar a tabela do documento. Depois escolha:

* **Campo de rótulo de pesquisa**: o valor que os utilizadores veem na lista de opções.
* **Campo de valor de pesquisa**: o valor guardado para a seleção e usado para filtrar.
* **Fora do campo**: o campo do documento preenchido com o rótulo selecionado.

Selecione **Criar** para guardar a configuração. Expanda-a para ver os respetivos campos, ou use o menu de três pontos para a ativar, duplicar, editar ou eliminar.

<figure><img src="https://4193417932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuAz1Yhpnxw8Gd9kza0ch%2Fuploads%2Fgit-blob-fe684b195601dbda25ff61f1b5923749ff76ec6a%2Fdbdc-35-lov-config-pt-20261101.png?alt=media" alt="Formulário LOV vazio Criar configuração de dados mestre com conjunto de dados, tipo de contexto, campo de rótulo de pesquisa, campo de valor de pesquisa, Fora do campo, Cancelar e Criar"><figcaption><p>Ligue o valor de um conjunto de dados e o respetivo rótulo visível a um campo do documento.</p></figcaption></figure>

Para criar listas dependentes, selecione **Criar** dentro de uma configuração LOV expandida e escolha um **Campo de pesquisa** e um **Campo de filtro**. O valor do campo de filtro limita as opções devolvidas pela pesquisa. Também pode definir um **Valor do filtro** fixo e marcar um campo como **Obrigatório**. Use o menu de três pontos da linha para editar ou eliminar um campo de filtro personalizado.


---

# 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/settings/global-settings/document-types/fields/master-data-settings.md?ask=<question>&goal=<user_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.
