> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Mapas de campos do contexto

> Mapeie as colunas de cada fonte para os campos que o Matcher compara, na aba Mapas de campos de um contexto no módulo Matcher do Lerian Console.

Use a aba **Mapas de campos** de um contexto para dizer ao Matcher como ler cada fonte. Um mapa de campos traduz as colunas de uma fonte para os campos canônicos que o motor de correspondência compara.

## Acessando a aba Mapas de campos

***

<Steps>
  <Step>
    No módulo Matcher, selecione **Configurar → Contextos**.
  </Step>

  <Step>
    Clique em um contexto para abrir a página de detalhe dele.
  </Step>

  <Step>
    Selecione a aba **Mapas de campos**.
  </Step>
</Steps>

A etapa **Mapear campos** do [Assistente de configuração do contexto](/pt/products/matcher/ui/context-setup-wizard) mostra a mesma aba.

## Lista de mapas de campos

***

A aba mostra uma linha para cada fonte do contexto. Fontes arquivadas não aparecem. Cada linha mostra o nome da fonte, o tipo, o lado e um resumo do mapa:

* **Nenhum mapeamento de campos ainda**: a fonte não tem mapa. Clique em **Adicionar mapeamento** para criar um.
* Uma contagem de campos mapeados, seguida dos primeiros campos canônicos. Use o botão de lápis para editar o mapa e o botão de lixeira para excluí-lo.

Se o contexto não tiver fontes, a aba pede que você as adicione primeiro. Clique em **Ir para Sources** para abrir a aba **Fontes**.

<Note>
  O Matcher ativa um contexto apenas quando cada fonte desta aba tem um mapa de campos. Uma fonte com um valor de **Opções camt.053** diferente de **Automático** não precisa de mapa de campos. O parser camt.053 usa o mapeamento ISO 20022. Veja [Fontes do contexto](/pt/products/matcher/ui/context-sources).
</Note>

## Criando ou editando um mapa de campos

***

<Steps>
  <Step>
    Clique em **Adicionar mapeamento** na linha de uma fonte ou no botão de lápis de uma fonte mapeada. O painel lateral **Criar mapeamento de campos** ou **Editar mapeamento de campos** abre.
  </Step>

  <Step>
    Adicione uma linha de mapeamento para cada campo canônico. Em cada linha, digite o campo canônico à esquerda e a coluna da fonte à direita. Clique em **Adicionar campo** para adicionar uma linha. Clique no botão de lixeira de uma linha para removê-la.
  </Step>

  <Step>
    Se quiser, preencha os campos de **Coluna de débito e crédito**. Veja [Coluna de débito e crédito](#debit-and-credit-column).
  </Step>

  <Step>
    Clique em **Criar mapeamento** para um novo mapa ou em **Salvar mapeamento** para um mapa existente.
  </Step>
</Steps>

O Matcher recusa um mapa sem um campo obrigatório ou com um campo fora desta lista:

| Campo canônico | Obrigatório | Descrição |
| - | - | - |
| `external_id` | Sim | A referência da transação na fonte |
| `amount` | Sim | O valor da transação |
| `currency` | Sim | A moeda da transação |
| `date` | Sim | A data da transação |
| `description` | Não | Uma descrição da transação |
| `fee_amount` | Não | A tarifa cobrada na transação. A verificação de tarifas lê esse campo |
| `fee_currency` | Não | A moeda da tarifa |

O Matcher guarda como metadados da transação as colunas da fonte que o mapa não usa. As [regras de tarifa](/pt/products/matcher/ui/context-fee-rules) podem testar esses campos de metadados.

<h3 id="debit-and-credit-column">
  Coluna de débito e crédito
</h3>

Alguns arquivos não colocam um sinal de menos nos valores de débito. Eles marcam cada linha como débito ou crédito em uma coluna separada. Para esses arquivos, preencha os três campos:

| Campo | Descrição |
| - | - |
| **Coluna** | A coluna da fonte que contém o marcador de débito ou crédito |
| **Valor para débito** | O marcador de uma linha de débito, por exemplo `D` |
| **Valor para crédito** | O marcador de uma linha de crédito, por exemplo `C` |

Se você preencher um dos campos, preencha os três. Os valores de débito e de crédito devem ser diferentes. O Matcher os compara sem diferenciar maiúsculas de minúsculas.

O Matcher importa as linhas de débito como valores negativos e as linhas de crédito como valores positivos. A coluna de valor deve então conter valores sem sinal. Uma linha com um valor com sinal, ou com um marcador que não corresponde a nenhum dos dois valores, falha na importação.

## Sugerindo mapeamentos com IA

***

O editor tem um painel **Sugerir mapeamentos com IA**. Ele lê uma amostra do arquivo da fonte e propõe colunas da fonte para os campos canônicos. O Matcher envia um trecho limitado da amostra para o provedor de modelo de linguagem que a Lerian configura para o seu ambiente.

<Steps>
  <Step>
    Cole uma amostra do arquivo da fonte em **Amostra da fonte**. Uma linha de cabeçalho e algumas linhas bastam.
  </Step>

  <Step>
    Clique em **Sugerir mapeamentos**. O painel lista cada mapeamento proposto com um medidor de confiança.
  </Step>

  <Step>
    Clique em **Aceitar** em uma proposta para copiá-la para as linhas de mapeamento.
  </Step>

  <Step>
    Revise as linhas e depois salve o mapa.
  </Step>
</Steps>

Uma proposta não muda nada no Matcher. Apenas o mapa que você salva tem efeito.

Se o painel mostrar **Assistência de IA indisponível**, o assistente de mapeamento não está disponível. Mapeie os campos manualmente.

## Excluindo um mapa de campos

***

Clique no botão de lixeira de uma fonte mapeada. Uma caixa de diálogo **Excluir mapeamento de campos?** abre. Clique em **Excluir** para remover o mapa. O Matcher mantém a fonte.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.