<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.payees">
<chapterinfo>
  <authorgroup>
    <author
>&Roger.Lum; &Roger.Lum.mail; </author>
    <author
>&Ace.Jones; &Ace.Jones.mail; </author>
    <author
>&Michael.Carpino; &Michael.Carpino.mail;</author>
    <author
>&Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
  </authorgroup>
  <date
>01/12/2024</date>
  <releaseinfo
>5.2.0</releaseinfo>
</chapterinfo>
<title
>Beneficiários</title>

<para
>Os beneficiários representam as pessoas ou organizações para quem você dá dinheiro. Os pagadores são aqueles de quem você recebe dinheiro. Eles são tratados de forma idêntica no &kmymoney; e só se diferenciam pela direção em que o dinheiro se move. É possível que uma única pessoa ou organização seja tanto um beneficiário quanto um pagador. Um exemplo é o seu empregador, que lhe paga um salário, mas a quem você pode pagar quando almoça no refeitório do trabalho. Você pode escolher usar o mesmo beneficiário para ambos os tipos de transação ou criar um beneficiário e um pagador separados, se quiser rastreá-los separadamente. </para>

<sect1 id="details.payees.view"
><title
>Vista de Beneficiários</title>

<para
>A vista de Beneficiários fornece informações detalhadas sobre todos os beneficiários e pagadores envolvidos nas transações. O &kmymoney; armazena informações sobre todos os beneficiários e pagadores de todas as transações existentes. Isso permite selecionar um beneficiário de uma lista em vez de ter que digitar o nome completo, o que também diminui a chance de erros de digitação ou de nome errado. </para>

<screenshot>
  <screeninfo
>vista de beneficiários</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="payeeview.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>vista de beneficiários</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<para
>Assim como a vista de Etiquetas, a vista de Beneficiários é dividida em duas áreas principais: uma lista de beneficiários e pagadores à esquerda e uma área de detalhes à direita. </para>

<para
>A vista de beneficiários está dividida em duas áreas principais: uma lista de beneficiários e pagadores à esquerda e uma área de detalhes à direita. A seção <guilabel
>Seus beneficiários</guilabel
> permite adicionar, excluir, renomear e mesclar beneficiários. A área de detalhes possui várias abas, mostrando as transações, o endereço, informações de correspondência, categoria padrão e números de conta do beneficiário selecionado na lista. Além disso, é possível criar e gerenciar links entre o conteúdo específico do beneficiário no campo de memorando de uma transação e caminhos de arquivos locais ou URLs remotos. </para>

<para
>A área de detalhes possui várias abas: Transações, Endereço, Correspondência, Padrão, Categoria, Números de Conta e Correspondência de Links. Cada uma delas é descrita nas seções a seguir. </para>

<sect2
><title
>Adicionar um Beneficiário ou Pagador</title>
<para
>Para adicionar um beneficiário ou pagador, clique no botão <guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="list-add-user.svg" format="SVG"/> </imageobject
> </inlinemediaobject
> </guiicon
>Novo beneficiário. Isso cria um novo beneficiário chamado <quote
>Novo beneficiário</quote
>. Você também pode clicar com o botão direito do mouse em qualquer beneficiário existente e selecionar <guimenuitem
>Adicionar beneficiário</guimenuitem
>. </para>
</sect2>

<sect2
><title
>Renomear um Beneficiário ou Pagador</title>
<para
>Para renomear um beneficiário ou pagador, selecione o beneficiário (clique com o botão esquerdo do mouse no nome) e clique em <guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="user-group-properties.svg" format="SVG"/> </imageobject
> </inlinemediaobject
> </guiicon
>Renomear beneficiário. Você também pode clicar duas vezes no nome ou clicar com o botão direito do mouse no nome e selecionar <guimenuitem
>Renomear beneficiário</guimenuitem
>. O nome então torna-se editável. Alterar o nome afetará o nome em todas as transações em que ele aparece. </para>
</sect2>

<sect2
><title
>Excluir um Beneficiário ou Pagador</title>
<para
>Para remover um beneficiário ou pagador, selecione-o e clique em <guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="list-remove-user.svg" format="SVG"/> </imageobject
> </inlinemediaobject
> </guiicon
> Excluir beneficiário, ou clique com o botão direito do mouse no nome e selecione <guimenuitem
>Excluir beneficiário</guimenuitem
>. Se o beneficiário tiver alguma transação, você verá uma caixa de diálogo que permite reatribuí-las a um beneficiário diferente, e também uma caixa de seleção para adicionar o nome excluído à lista de correspondência do novo beneficiário. </para>
</sect2>

<sect2 id="details.payees.merging"
><title
>Mesclar beneficiários</title>
<para
>Para mesclar dois beneficiários, selecione um deles (clique com o botão esquerdo do mouse no nome) e, em seguida, selecione o outro (<keycombo
>&Ctrl;<mousebutton
>clique-esquerdo</mousebutton
></keycombo
>). Você pode clicar em <guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="merge.svg" format="SVG"/> </imageobject
> </inlinemediaobject
> </guiicon
> Mesclar beneficiários ou clicar com o botão direito do mouse em qualquer um dos beneficiários selecionados e selecionar <guilabel
>Mesclar beneficiários</guilabel
>. Uma janela pop-up será exibida perguntando se você realmente deseja mesclar os beneficiários selecionados. Se você clicar em <guibutton
>Sim</guibutton
>, outra janela pop-up será exibida para que você especifique o nome do beneficiário para os dados combinados. Haverá um menu suspenso com os nomes dos beneficiários que você selecionou para mesclar (você pode selecionar mais de dois) e também permite que você digite um nome completamente novo. Há também uma caixa de seleção para adicionar os nomes dos beneficiários mesclados à lista de correspondência do novo beneficiário. </para>
</sect2>
</sect1>

<sect1 id="details.payees.transactionhistory"
><title
>Ver as transações para um beneficiário</title>
<para
>Para visualizar todas as transações associadas a um beneficiário específico, selecione o beneficiário na lista e selecione a aba <guilabel
>Transações</guilabel
> na área de detalhes. Clicar duas vezes em uma transação específica permitirá que você edite essa transação no contexto da conta apropriada. Clicar com o botão direito do mouse em uma transação abrirá um menu de contexto com as ações apropriadas, incluindo a possibilidade de ir diretamente para o livro de registro da conta apropriada, com a transação selecionada. </para>

<screenshot>
  <screeninfo
>aba para transações da vista de beneficiários</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="payee_history.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>aba para transações da vista de beneficiários</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect1>
  
<sect1 id="details.payees.details"
><title
>Detalhes Adicionais do Beneficiário</title>

<sect2
><title
>Informações pessoais do beneficiário</title>
<para
>Para visualizar e editar as informações pessoais associadas a um beneficiário específico, selecione-o na lista e clique na aba Endereço. Embora chamemos isso de informações pessoais, também se aplica se o beneficiário for uma empresa ou outra organização. Além das informações de endereço, você também pode armazenar um número de telefone, endereço de e-mail e observações referentes ao beneficiário selecionado. Para modificar essas informações, edite a área de detalhes diretamente e clique no botão <guibutton
>Atualizar</guibutton
> ao concluir. </para>

<screenshot>
  <screeninfo
>aba de informações pessoas da vista de beneficiários</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="payee_info.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>aba de informações pessoas da vista de beneficiários</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect2>

<sect2 id="details.payees.details.matching"
><title
>Configuração da Correspondência de Transações</title>

<sect3
><title
>Introdução</title>
<para
>O &kmymoney; tem a capacidade de atribuir automaticamente o beneficiário adequado às transações importadas. Isto poderá ser útil ao importar as transações do seu banco, quando o nome do beneficiário tiver caracteres extra desnecessários ou, pior ainda, se os nomes do beneficiário mudarem. A capacidade de associar transações a um beneficiário específico ajuda a fornecer uma nomenclatura consistente dos beneficiários no livro de registro e nos relatórios. </para>

<para
>Por exemplo, imagine que o pagamento da prestação da sua casa vem do seu banco como <quote
>CAIXA ECONÔMICA FEDERAL 10250</quote
> em um mês e <quote
>CAIXA ECONÔMICA FEDERAL 11250</quote
> no mês seguinte. Você pode querer que ambas as transações sejam associadas simplesmente ao seu beneficiário <quote
>Caixa Econômica</quote
>. A funcionalidade de correspondência de transações existe para isto! </para>
</sect3>

<sect3
><title
>Configurando a correspondência de beneficiário</title>
<screenshot>
  <screeninfo
>aba de correspondência da vista de beneficiários</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="payee_match.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>aba de correspondência da vista de beneficiários</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<para
>Na aba Correspondência, você pode definir as configurações de correspondência para transações importadas para este beneficiário. Você pode selecionar uma das quatro opções com o menu suspenso <guilabel
>Método de correspondência</guilabel
>. </para>

<itemizedlist>
  <listitem>
    <para
><emphasis
>Sem correspondência</emphasis
>: Isto desativa a funcionalidade de correspondência para este beneficiário. Esta é a configuração padrão para todos os beneficiários. </para>
  </listitem>

  <listitem>
    <para
><emphasis
>Correspondência parcial do nome do beneficiário</emphasis
>: Isso habilita o recurso com base em uma correspondência parcial do nome do beneficiário e usa o próprio nome do beneficiário como chave de correspondência. </para>
  </listitem>

  <listitem>
    <para
><emphasis
>Correspondência exata do nome do beneficiário</emphasis
>: Isso habilita o recurso com base em uma correspondência exata do beneficiário. Você pode usar esse método quando deseja acompanhar diferentes beneficiários que têm o mesmo nome comercial, mas têm locais diferentes. </para>
  </listitem>

  <listitem>
    <para
><emphasis
>Correspondência por um nome listado abaixo</emphasis
>: Isso permite a correspondência com base em vários nomes diferentes ou opcionais para um Beneficiário. Você usaria essa funcionalidade de correspondência quando tiver um Beneficiário específico com diferentes nomes comerciais, mas quiser que todas as transações importadas identificadas por qualquer um desses nomes sejam associadas a um único Beneficiário no &kmymoney;. </para>
    <para
>Outra utilização deste método é se você quiser um beneficiário para "Outros supermercados" para agrupar todos os supermercados, exceto um ou dois que você usa com frequência suficiente para querer rastrear separadamente. Você inseriria o nome de cada um dos diferentes supermercados na lista de correspondência e todos serão então associados ao mesmo beneficiário. </para>
  </listitem>
</itemizedlist>

<para
>Com qualquer uma dessas opções, você pode escolher se deseja ou não ignorar a distinção entre maiúsculas e minúsculas. A sensibilidade da grafia do nome do beneficiário depende de você selecionar ou não a opção <guilabel
>Ignorar maiúsculas e minúsculas</guilabel
>. </para>
</sect3>

<sect3
><title
>Importar Transações</title>
<para
>As chaves de correspondência que você definiu serão consideradas sempre que você importar transações usando QIF, CSV, OFX ou AqBanking de um arquivo ou fonte online. Se a chave de correspondência de um dos seus beneficiários for encontrada em qualquer lugar na lista de beneficiários da transação importada, o beneficiário correspondente da sua lista será atribuído a essa transação. Deste modo, uma chave de correspondência da <quote
>Caixa Econômica</quote
> irá corresponder a <quote
>CAIXA ECONÔMICA</quote
> ou mesmo a <quote
>CRÉDITO CAIXA ECONÔMICA&amp;EMPRÉSTIMO</quote
>. Sendo assim, escolha as suas chaves de correspondência com cuidado. </para>

<note>
  <para
>Se o beneficiário de uma transação corresponder a mais de uma chave, o comportamento é indefinido. O &kmymoney; irá escolher arbitrariamente um dos beneficiários correspondentes. </para>
</note>

</sect3>
</sect2>
</sect1>

<sect1 id="details.payees.linkmatching"
><title
>Gerenciar vínculo de correspondência</title>

<para
>Esta aba pode ser usada para vincular uma parte do campo de observações de uma transação a um URL remoto ou local, por exemplo, para tornar faturas ou outros documentos acessíveis. </para>

<para
>A aba contém campos de entrada para um padrão e um modelo de URL. O padrão especificado é tratado como uma expressão regular, que é aplicada ao campo de observações das transações associadas a este beneficiário, e o texto resultante é inserido no modelo de URL em locais designados. <screenshot>
  <screeninfo
>A aba de vínculo da correspondência</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="payee_link-matching.png" format="PNG"/>
      </imageobject>
    </mediaobject>
</screenshot>
</para>

<para
>O URL resultante é exibido como um link no livro de registro geral para as transações correspondentes (consulte a coluna “Detalhes”) e na visualização de detalhes no canto inferior esquerdo do campo de entrada de memorando. </para>

<screenshot>
  <screeninfo
>Mostrar vínculo no livro de registro geral</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="payee_link-matching-ledger.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>O link também pode ser acessado através do item de menu “Abrir URL” no menu de contexto de uma transação ou através de um atalho de teclado. </para>
<screenshot>
  <screeninfo
>Mostrar menu de contexto da transação</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="payee_link-matching-open-url.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>O atalho de teclado associado pode ser configurado no <link linkend="reference.menus.settings.help"
>Menu de Configurações e Ajuda</link
>. </para>
<screenshot>
  <screeninfo
>Mostrar atalho de teclado para abrir um URL</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="shortcut-payee-open-url.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<sect2 id="details.payees.linkmatching.pattern"
><title
>Dicas</title>
<para
>Os padrões encontrados, que devem corresponder a expressões regulares compatíveis com Perl, são inseridos no modelo de URL no lugar dos marcadores de posição suportados. Exemplos simples são: <itemizedlist>
    <listitem
><para
>\d+\b - um ou mais dígitos seguidos por um limite de palavra.</para
></listitem>
    <listitem
><para
>\d{2,4}\b - de 2 a 4 dígitos seguidos por um limite de palavra</para
></listitem>
    <listitem
><para
>\d{3}-d{6}\b - 3 dígitos seguidos de um hífen e 6 dígitos seguidos de um limite de palavra</para
></listitem>
  </itemizedlist>
</para>

<para
>Os marcadores de posição suportados são: <itemizedlist
> <listitem
><para
>%1 - primeira expressão encontrada</para
></listitem
> <listitem
><para
>%2 - segunda expressão encontrada (opcional)</para
></listitem
> </itemizedlist
> Ao usar dois padrões independentes, as expressões individuais no padrão são separadas por parênteses, por exemplo, <code
>(..)...(..)</code
>. </para>

<para
>Além disso, variáveis ​​predefinidas podem ser usadas no modelo de URL. Atualmente, as variáveis ​​suportadas são: <itemizedlist
> <listitem
> <para
>%year - o ano a partir da data da transação correspondente</para>
    </listitem>
  </itemizedlist>
</para>
</sect2>
</sect1>
</chapter>
