&Ace.Jones; &Ace.Jones.mail;
&Jack.H.Ostroff; &Jack.H.Ostroff.mail;
01/12/2024
5.2.0

# Importação e Exportação

&Tony.Bloomfield; &Tony.Bloomfield.mail;
&Jack.H.Ostroff; &Jack.H.Ostroff.mail;

## Importação do &gnucash;

### Arquivos do &gnucash;

O importador do &kmymoney; para o &gnucash; é conhecido por lidar com a leitura direta de arquivos padrão (&XML;) produzidos pelas versões 1.8 e 2.0 do &gnucash;. Arquivos de versões mais recentes também devem ser importados sem problemas. Não há testes formais recentes para confirmar isso, mas a lista de discussão dos desenvolvedores &devlist; contém um relato de sucesso na importação de um arquivo do &gnucash; 5.3. Especificamente, no entanto, os seguintes arquivos não são suportados:

- importação dos dados do banco de dados (Postgres)

- importação dos arquivos 'multi-livro'

- importação para um arquivo do &kmymoney; existente

- importação das funcionalidades específicas para pequenas empresas (Empregados, Faturas, &etc;)

- exportar para arquivos do &gnucash;.

A importação provavelmente só funcionará corretamente se for apresentado um arquivo válido. Recomenda-se que o item de menu Ações Verificar e reparar tudo do &gnucash; seja executado antes de salvar o arquivo e tentar importá-lo para o &kmymoney;.

Os arquivos podem ser abertos especificando o nome do arquivo na linha de comando (`kmymoney <caminho para o arquivo>`), ou por meio dos &kmymoney; &Ctrl;O Arquivo Abrir ou Arquivo Importar itens de menu.

A semelhança entre os dois produtos significa que muitos dados do dia a dia podem ser importados de forma simples. No entanto, existem algumas áreas onde há diferenças, e várias opções são fornecidas para lidar com elas. As seções a seguir descreverão algumas dessas diferenças; compreendê-las deve levar a uma importação mais tranquila, caso alguma delas seja relevante para seus dados.

### Semelhanças, diferenças e terminologia

#### Uso em pequenos negócios

Deverá ser observado que o &kmymoney; é um gerenciador de finanças pessoais e, como tal, não suporta diretamente nenhuma das funcionalidades para negócios do &gnucash;, como as tabelas de impostos, processamento de salários e o rastreamento de lotes. Todas as contas de Pagamento ou Recebimento serão importadas como contas de Passivos e Ativos, respectivamente.

#### Contas

##### Tipos de conta

Para ambos os produtos, o nível mais alto na estrutura do arquivo é a conta O &kmymoney;suporta 5 tipos principais de contas: Ativos, Passivos, Receitas, Despesas e Fundos, tendo cada uma delas vários sub-tipos, ⪚, Cheque, Cartão de Crédito, &etc; O &kmymoney; inclui uma conta 'padrão' para cada um destes cinco tipos, sendo todas as outras subordinadas a uma destas. O &kmymoney; aplica mais consistência (ou menos flexibilidade, dependendo do seu ponto de vista) entre os tipos de contas em relação ao &gnucash;, sendo que o módulo de importação irá corrigir as inconsistências que detectar. Isto poderá conduzir a uma estrutura de contas relativamente diferente, ainda que esta possa, sem qualquer razão, ser alterada após o fim da importação.

##### Categorias

O &kmymoney; usa o termo Categoria para denotar uma conta do tipo Receita ou Despesa. Ao contrário do &gnucash;, essas não são consideradas contas do livro de registro e a entrada de transações diretamente em categorias não é suportada. As alocações para categorias são feitas quando as transações são inseridas ou editadas em outros tipos de conta.

##### Estrutura e Substituições

O &gnucash; suporta o uso de contas de Substituição. De fato, são contas apenas para leitura, nas quais não poderão ser inseridas operações, mas cuja função é semelhante às pastas numa estrutura de diretórios, como portadora das outras contas. Ainda que o &kmymoney; não suporte esta funcionalidade, oferece uma relação mãe/filha entre contas, simulando as substituições através da criação de contas vazias durante a importação.

##### Mapa do tipo de contas

Tipo do &gnucash; | Tipo do &kmymoney;
--- | ---
`BANCO` | `Corrente`
`CORRENTE` | `Corrente`
`SAVINGS` | `Poupança`
`ATIVO` | `Ativo`
`DINHEIRO` | `Dinheiro`
`CURRENCY` | `Dinheiro`
`MONEYMRKT` | `Mercado Monetário`
`STOCK` | `Ação`
`MUTUAL` | `Ação`
`EQUITY` | `Ação Ordinária`
`LIABILITY` | `Passivo`
`CREDIT` | `Cartão de Crédito`
`INCOME` | `Receita`
`EXPENSE` | `Despesa`
`RECEIVABLE` | `Ativo`
`PAYABLE` | `Passivo`

#### Transações e Parcelas

##### Transações balanceadas

Em ambos os programas, os dados são inseridos sob a forma de operações, cada uma delas consistindo geralmente em 2 ou mais parcelas. De fato, as operações válidas do GnuCash sempre conterão pelo menos 2 parcelas e, para estar em conformidade com a norma de contabilidade por partidas dobradas, estas deverão estar balanceadas no saldo (&ie;, o resultado final deverá ser zero). O &kmymoney; encoraja, mas não obriga o uso desta norma; contudo, todas as operações importadas que não estejam balanceadas serão marcadas no livro de registros como tendo problemas.

##### Beneficiários

O &kmymoney; prefere que todas as transações tenham um Beneficiário (um termo genérico que se refere tanto aos credores como aos devedores) e, ao contrário do &gnucash;, é mantida uma lista com estes credores. Os nomes dos credores são gerados pelo módulo de importação, a partir do campo de Descrição da transação do &gnucash;.

##### Transferências

O &kmymoney; usa o termo Transferência para descrever uma transação que não envolva uma Categoria, mas que só transfere dinheiro entre as contas de Ativos e/ou Passivos.

##### Reconciliação

O &kmymoney; oferece uma função de reconciliação ou consolidação semelhante à do &gnucash;, e o estado correspondente da transação será importado.

#### Mercadorias

O &gnucash; usa o termo Mercadorias para cobrir os ativos monetários e não-monetários. Estes são tratados de forma separada no &kmymoney;.

##### Moedas

O &kmymoney; possui o suporte incorporado para todos os tipos de moedas estrangeiras. O &kmymoney; também necessita que o usuário defina uma moeda base, sendo esta a moeda padrão para as contas novas. O módulo de importação tentará determinar a moeda base mais provável, ainda que esta escolha possa ser rejeitada em detrimento de uma alternativa.

O &kmymoney; ainda não tem suporte a contas expressas em moedas 'mortas' (exceto as que foram substituídas pelo Euro). No momento, será necessário remover todas essas contas do seu arquivo do &gnucash;, antes de iniciar a importação. Esperamos melhorar essa situação em uma versão futura.

##### Títulos e Investimentos

Os ativos não-monetários (tipicamente os fundos e ações) são chamados de Títulos pelo &kmymoney; e representa a principal diferença entre os dois produtos, na medida em que o &kmymoney; exige que qualquer conta associada a um título seja subordinada a uma Conta de Investimento. Isto está descrito com mais detalhes no capítulo sobre Investimentos. Ainda que os usuários possam ter criado uma relação assim, o &gnucash; não impõe qualquer estrutura definida sobre ele; como tal, o módulo de importação é incapaz de detectá-la e de efetuar uma conversão automática. Assim, estão disponíveis três opções:

- Criar uma conta de Investimento separada para cada título, com o mesmo nome do título

- Criar uma única conta de Investimento que irá atuar como pai de todas as contas de título

- Criar várias contas de Investimento, atribuindo títulos a elas de acordo com o indicado pelo usuário.

Depende completamente dos requisitos e preferências do usuário, definir quais destas opções é relevante para cada uma das situações e, em alguns casos, poderá ser necessária a reestruturação manual das contas após a importação.

##### Preços e taxas de câmbio

As taxas dos preços dos títulos e de câmbio das moedas, tal como aparecem no Editor de Preços do &gnucash;, serão importadas. Além disso, os itens de preços e das taxas serão gerados a partir de todas as transações que envolvam títulos e várias moedas.

##### Cotações online

Para obter as cotações dos preços e taxas de câmbio online, o &gnucash; usa um pacote chamado `Finance::Quote`. As versões mais recentes do &kmymoney; possuem suporte para este pacote, de modo a obter a cotação das ações, e este será usado como padrão para importação dos dados do &gnucash;. Contudo, você poderá optar por converter para o método nativo usado pelo &kmymoney;, o qual está descrito com mais detalhes em cotações online.

Se optar por fazer isso, a próxima janela permitirá a seleção de uma fonte de preços nativa do &kmymoney;, ou uma fonte definida pelo usuário, para todas as contas onde sejam necessárias cotações online. Contudo, o símbolo financeiro será importado sem qualquer alteração. Uma vez que este símbolo será quase com certeza diferente nos dois pacotes, será necessário editá-lo manualmente, após finalizar o processo de importação. As atualizações futuras das taxas de câmbio não usarão o `Finance::Quote`, mas o método de obtenção nativo.

seleção da fonte de preço de importação do GnuCash
seleção da fonte de preço de importação do GnuCash

#### Transações Agendadas

O &kmymoney; não retém a separação feita no &gnucash; entre as transações-modelo e a sua frequência das ocorrências. Os dados das transações serão duplicados se o mesmo modelo for usado em diferentes agendamentos, mas isso não parece ser muito significativo.

##### Tipos de eventos recorrentes

O &kmymoney; classifica todos os agendamentos como um de três tipos: Contas, Depósitos e Transferências. Uma vez que o &gnucash; não faz essa distinção, o módulo de importação tenta determinar a classificação a partir das contas e da direção do movimento do dinheiro. Poderão existir alguns casos em que são feitas escolhas incorretas, sendo necessário corrigi-las manualmente.

##### Agendamentos suspeitos

Algumas funcionalidades das transações agendadas do &gnucash; não estão disponíveis no &kmymoney;, pelo que o módulo de importação tenta, em cada um dos casos, atingir um meio termo razoável na conversão dos dados. Estas transações serão marcadas como suspeitas, e o usuário terá a opção de editá-las diretamente, durante o processo de importação. Alguns exemplos de situações que possam provocar isto são:

- alguns intervalos de frequência suportados no &gnucash; não estão disponíveis atualmente no &kmymoney;

- O &kmymoney; não suporta a utilização de fórmulas e variáveis nos campos do montante

- os casos complexos que ainda não foram identificados para a importação

Apesar do enorme esforço, é possível que, devido às muitas opções envolvidas, uma operação agendada possa provocar um erro fatal dentro do &kmymoney;. Se esse tipo de problema ocorrer, o módulo de importação oferece a opção para ignorar todos os agendamentos suspeitos.

#### Relatórios

O &kmymoney; oferece uma seleção abrangente de relatórios configuráveis, descritos com mais detalhes em Relatórios. Estes não irão corresponder, necessariamente, aos que estão disponíveis no &gnucash;.

### Selecionar as opções de importação

opções de importação do GnuCash
opções de importação do GnuCash

#### Manipulação do Investimento

Veja acima em "Títulos e Investimentos".

#### Cotações online

Desative esta opção se desejar usar o método nativo para futuras cotações de preços online. Veja "Cotações Online" acima para mais detalhes.

#### Transações Agendadas

Veja acima em "Transações Agendadas".

#### Opções de decodificação

Se o seu idioma nativo é escrito em letras ou símbolos que sejam diferentes dos usados em idiomas 'Latinos' (&ie;, como acontece na Europa Ocidental), estes serão representados num formato especial (codificados) no seu arquivo do &gnucash;. Se esses caracteres não forem apresentas corretamente na sua tela, então terão que ser decodificadas. Atualmente, não é possível detectar com precisão qual o formato de decodificação a usar, por isso você poderá ter que definir esta opção manualmente selecionando um item na lista. De modo geral, o primeiro item na lista será considerado o apropriado para sua região (&ie;, o país e idioma selecionados como nativos na instalação do seu sistema operacional), e deve ser o escolhido como primeira tentativa. Uma vez que o processo de importação não sobrepõe o seu arquivo do &gnucash;, fique à vontade para experimentar qualquer uma destas seleções.

#### Opção de Notas de Transação

Em algumas condições de uso, as operações não-divididas do &gnucash; poderão conter dados de memorandos residuais, e muitas vezes incorretos, que normalmente não estão visíveis ao usuário. Contudo, quando são importadas para o &kmymoney;, essas operações terão um campo de Notas que descreve o objetivo real da operação. Se esta opção estiver selecionada, essas notas, se estiverem presentes, serão usadas para substituir os dados estranhos do memorando.

#### Opções de depuração

Estas opções só precisam ser usadas em caso de problemas na importação, os quais deverão ser comunicados à lista de programadores &devlist;;. Lembre-se de que os registros produzidos por essas opções poderão conter dados de natureza confidencial, devendo assim ser usada a opção Anonimizar dados, caso esses registros precisem ficar disponíveis publicamente.

### Relatório de importação

No fim do processamento, o módulo de importação produz um relatório que mostra o número de entidades diferentes processadas, assim como todos os erros ou anomalias encontrados. Este relatório será apresentado na tela, podendo ser gravado num arquivo para revisão posterior. Um relatório completo poderá conter as seguintes seções:

- Quantidade de registros

- Inconsistências nos tipos de contas e ações tomadas

- Detalhes dos agendamentos suspeitos

relatório do importador do GnuCash
relatório do importador do GnuCash
&Thomas.Baumgart; &Thomas.Baumgart.mail;
&Jack.H.Ostroff; &Jack.H.Ostroff.mail;

## Importação de QIF

### O formato QIF é considerado perigoso

De um modo geral, o formato QIF deverá ser evitado sempre que possível. Por várias razões, é uma má escolha para transferir dados financeiros. Entre outras coisas, o QIF sofre dos seguintes problemas:

- Falta de um formato-padrão: As diferentes versões do mesmo programa irão importar diferentes significados para o mesmo elemento.

- Falta de um identificador de transação: Uma vez que não existe nenhum número ID associado a cada transação, a correspondência de duplicados será muito mais dificultada.

- Falta de expressividade: A gramática é realmente simples, e não consegue refletir a profundidade de informação financeira que existe num ambiente de finanças da atualidade.

Esses são os motivos, de modo geral, que a Intuit deixou de dar suporte a importação em QIF no Quicken 2005. Se tiver a opção de obter os dados de outra forma, como no formato OFX, escolha sempre esta opção.

### Como importar um arquivo QIF

Para importar um arquivo QIF, primeiro certifique-se de ter um arquivo válido do &kmymoney; aberto, em seguida, selecione o item de menu Arquivo Importar QIF... .

importador do qif
importador do qif

A caixa de diálogo resultante solicita o nome do arquivo QIF, permitindo que você digite o caminho completo para o arquivo ou localize o arquivo clicando em Navegar.

Observe que o &kmymoney; diferencia entre a importação de um arquivo de extrato bancário e um arquivo com dados históricos exportados de outro aplicativo. Um arquivo de extrato bancário não inclui necessariamente todos os dados relacionados a um único extrato; ele pode conter apenas uma ou algumas transações. A opção padrão é importar um arquivo de extrato bancário. Caso você esteja importando dados do seu aplicativo anterior de gerenciamento de finanças pessoais, selecione a opção apropriada.

Em seguida, você precisa selecionar um perfil do QIF para a importação. Como não existe um formato padrão universal para um arquivo QIF, diferentes fornecedores tomaram liberdades com o formato e introduziram suas próprias nuances. O perfil do QIF permite que o &kmymoney; conheça as peculiaridades do seu arquivo. Em geral, o perfil padrão do QIF deve funcionar com a maioria dos arquivos QIF. Em alguns casos, pode ser necessário usar um perfil QIF modificado. Consulte a próxima seção para obter mais detalhes sobre esse assunto.

Clique em Importar para importar o arquivo QIF.

O &kmymoney; irá começar a analisar o arquivo, de modo a determinar os formatos usados para representar as datas e os números. Se não conseguir determinar um formato de data de forma unívoca, o &kmymoney; pedirá que o usuário selecione um dos formatos de data possíveis.

Em seguida, o &kmymoney; irá importar os dados e criar todos os objetos necessários, como informações do beneficiário, os registros das contas e das categorias e a informação dos preços das ações. Sempre que possível, as transações existentes serão correspondidas com a informação importada, para evitar transações duplicadas. É apresentada uma barra de progresso que vai sendo atualizada durante o processo de importação.

Caso o &kmymoney; não consiga detectar o nome da conta a importar, será solicitado ao usuário para selecionar a conta para onde os dados serão importados. Se a conta não existir no seu arquivo, você poderá criar uma nova conta clicando no botão Criar.

No fim da importação, o &kmymoney; mostra uma janela com as estatísticas de importação do extrato.

estatísticas da importação de extrato do qif
estatísticas da importação de extrato do qif

Após a importação, todas as operações importadas serão apresentadas com um fundo amarelo no livro de registros. Caso o &kmymoney; consiga corresponder uma operação importada com uma existente, o fundo aparece em verde claro.

As cores usadas para marcar as transações importadas e correspondidas são personalizadas e poderão ser diferentes no seu ambiente.

O próximo passo é verificar os dados importados e aceitar todas as transações importadas. Este é um processo geral e também se aplica a importações de outras fontes. É semelhante ao processo para transações correspondentes. Todas as transações importadas são marcadas no livro de registro com um ícone de importação. Depois de Aceitar a transação, ela deixa de ser marcada como importada.

### Correspondência de transações

Como foi apontado anteriormente, uma das maiores desvantagens do formato QIF é a falta de um identificador único para cada transação. Por isso, se estiver importando um arquivo QIF e algumas das transações já estiverem no seu livro de registro, você poderá obter algumas duplicações. O &kmymoney; tenta contornar isto, procurando por transações que se assemelhem às que já tem. Se encontrar algo que se pareça com a mesma transação, irá eliminar a aparente duplicação.

Isto poderá ser um problema se você tiver transações que sejam muito parecidas, mas que sejam diferentes, de fato. Nesse caso, você poderá optar por dissociar essas transações mais tarde na área do livro de registros.

### Escrever um filtro de importação

Algumas vezes você poderá ter dados num formato personalizado, como os valores separados por vírgulas (CSV), ou algo único para a sua situação em particular. A partir da versão 4.6, o &kmymoney; inclui um plugin para importação de CSV, mas você ainda poderá importar outros tipos de arquivo no &kmymoney; usando um Filtro de Importação de QIF. Um filtro é um programa personalizado, feito por você, que recebe o seu arquivo especial como entrada, produzindo um arquivo QIF como resultado. Este poderá ser um programa da 'shell', em Perl, um programa compilado e feito em C/C++ ou qualquer coisa que imaginar, desde que o sistema o consiga executar. O filtro será executado com o arquivo de entrada como stdin e stdout, que é assumido como um arquivo qif válido para passar para o importador QIF propriamente dito.

Para usar um filtro, edite seu Perfil QIF favorito ou crie um novo (consulte a próxima seção para obter detalhes sobre Perfis QIF) e selecione a aba Filtro. Insira o caminho completo para o seu programa de filtro no campo Local do filtro de entrada ou clique no ícone de navegação ao lado do campo e navegue até o filtro na caixa de diálogo Abrir arquivo.... Então, sempre que você fizer uma importação QIF usando este perfil, o arquivo selecionado para importação será processado pelo seu filtro primeiro. Observe que o campo de localização do filtro contém o caminho completo para o programa ou script do filtro, mas também pode incluir parâmetros de linha de comando para o programa.

Em seguida, se você quiser que a caixa de diálogo Abrir arquivo..., onde você escolhe o arquivo para importar, tenha um filtro para o seu tipo de arquivo específico, insira uma lista de filtros de arquivo separados por vírgula (como *.abc,*.xyz) no campo Tipo de arquivo de filtro de entrada. Com o exemplo acima, ao abrir um arquivo para importação usando este perfil, você verá apenas arquivos com as extensões abc ou xyz. Se você deixar o campo vazio, nenhum filtro de nome será aplicado e você verá todos os arquivos.

Um problema comum é converter uma lista de valores separados por vírgula em um arquivo QIF. Antes da adição do plugin de importação do CSV do &kmymoney;, este seria um caso clássico para a ferramenta `awk`. Ainda usamos este exemplo aqui, apenas para apresentar uma amostra de como o processo de filtro de importação funciona. Crie um script chamado `csv2qif.awk`, com as duas linhas a seguir como conteúdo:

    BEGIN { FS=","; print "!Type:Bank" }

        { print "D"$1; print "T"$2; print "N"$3; print "P"$4; print "M"$5; print "^" }

Depois, mude as chaves do QIF (D,T,N,P,M) para corresponder à ordem das colunas em seus dados CSV. Configure o filtro de entrada como sendo `awk -f csv2qif.awk`.

Outro problema também ocorre normalmente na codificação dos arquivos QIF. O &kmymoney; espera que os arquivos estejam codificados em UTF-8. Se o seu arquivo estiver codificado em outro formato qualquer, pode ser útil convertê-lo para UTF-8. Por exemplo, para converter de ISO-8859-1, poderá indicar o filtro de entrada como sendo `recode iso-8859-1..utf-8`.

### Extensões especiais do QIF no &kmymoney;

Como foi apontado anteriormente, uma das grandes desvantagens do formato QIF é a falta de um identificador único para cada operação. Se estiver escrevendo seu próprio criador de arquivos QIF (ou filtro, como foi descrito acima), poderá contornar esse problema. O &kmymoney; tem suporte ao campo '#'. O módulo de importação irá interpretá-lo como um ID de operação único e irá ignorar a operação se ela já estiver no sistema.

## Perfis QIF

Para editar um perfil QIF existente ou criar um novo, abra a caixa de diálogo do importador QIF selecionando &Ctrl;&Shift;, Configurações Configurar &kmymoney;... no menu principal, clicando em Plugins na parte inferior do painel esquerdo e clicando em &configicon; Configurar na entrada para o Importador QIF.

Observe que, como o Importador QIF e o Exportador QIF são implementados como plugins separados, há entradas separadas para cada um na caixa de diálogo de configuração de Plugins. A configuração de qualquer um deles abre a mesma caixa de diálogo do Editor de Perfil.

aba geral do editor de perfil qif
aba geral do editor de perfil qif

À esquerda, o seletor de Perfil exibe uma lista de todos os perfis QIF existentes; selecione um para editar sua configuração. Para criar um novo perfil, pressione o botão Novo. Você pode renomear um perfil existente selecionando-o no seletor de Perfil e clicando em Renomear, e excluí-lo com o botão Excluir. Clicar em Redefinir redefine todos os campos do perfil exibido para seus valores padrão.

A área direita da caixa de diálogo possui quatro abas.

A aba Geral contém um campo para uma descrição do filtro, vários campos para especificar como o &kmymoney; deve esperar que certos campos apareçam no arquivo qif gerado pelo filtro e uma caixa de seleção que indica ao &kmymoney; se deve ou não tentar encontrar transações semelhantes para evitar duplicatas.

aba de filtro do editor de perfil qif
aba de filtro do editor de perfil qif

A aba Filtro permite especificar a localização de um filtro de importação, conforme descrito na seção anterior, bem como um filtro de saída, que funciona de forma semelhante, mas é aplicado ao gravar um arquivo de dados. O tipo de arquivo de filtro de entrada não se aplica a um filtro de saída, pois a caixa de diálogo de arquivo para o arquivo a ser gravado não requer filtragem.

aba de data do editor de perfil qif
aba de data do editor de perfil qif

A aba Data aplica-se principalmente à Exportação QIF, pois o &kmymoney; geralmente consegue determinar o formato da data examinando os dados reais. O objetivo principal é especificar a ordem das partes da data, e o delimitador que as separa.

Como o formato QIF não é padronizado, é impossível saber a qual século se refere quando se utilizam anos com dois dígitos. Em arquivos QIF com anos de dois dígitos, assume-se um século padrão, e um apóstrofo é usado como separador de ano para especificar que a entrada pertence a OUTRO século. No entanto, como o século assumido como padrão não é padronizado, o campo Tratamento de apóstrofo é usado para essa finalidade, indicando o século pretendido quando um apóstrofo é usado como separador de ano. Por exemplo, você definiria o formato de apóstrofo para "2000-2099", de modo que as datas com um apóstrofo serão interpretadas como sendo > ano 2000. Nesse caso, as datas sem apóstrofo serão tratadas como sendo da década de 1900.

aba de montantes do editor de perfil qif
aba de montantes do editor de perfil qif

A aba Montantes é usada na Exportação QIF para especificar o Símbolo Decimal e o Separador de Milhares a serem usados. No entanto, você precisa especificar esses valores para cada linha do arquivo QIF que pode conter um valor. Para alterar essas configurações, clique em uma das linhas na parte superior da tela e, em seguida, use os menus suspensos abaixo para definir os caracteres a serem usados.

## Exportação para QIF

Para exportar uma de suas contas para um arquivo QIF, escolha o item de menu Arquivo Exportar QIF... . Você será solicitado a informar qual conta específica exportar, em qual arquivo exportá-la e qual perfil QIF usar.

O Exportador QIF não processa a exportação de contas de investimento. Ele pode parecer funcionar e gerar um arquivo de saída, mas esse arquivo não incluirá nenhum dado real.

exportador qif
exportador qif

O Exportador QIF usa Perfis QIF de maneira semelhante ao Importador QIF, mas ele usa as informações do Perfil para formatar o arquivo QIF que está sendo gravado, em vez de interpretar o arquivo que está sendo lido. Paralelamente ao importador, você pode usar um programa de filtro personalizado. Há um campo separado na aba Filtro do editor de Perfil QIF para um filtro de saída, então você pode usar o mesmo Perfil QIF para importar e exportar, mas usar um filtro diferente para os dois processos.

&Ace.Jones; &Ace.Jones.mail;
&Thomas.Baumgart; &Thomas.Baumgart.mail;
&Jack.H.Ostroff; &Jack.H.Ostroff.mail;

## Importação de OFX

O importador OFX foi um dos primeiros componentes do &kmymoney; a ser escrito como um Plugin. Naquela época, havia apenas alguns plugins incluídos no código-fonte, e eles nem sempre estavam incluídos nas versões compiladas para distribuições &Linux; então, às vezes, era necessário que os usuários pudessem compilar os plugins por conta própria. Isso raramente acontece hoje em dia, mas veja a seção sobre Plugins para mais informações. Atualmente, muitos dos recursos considerados partes essenciais do &kmymoney; são implementados como plugins, então esse fato nem sempre é mencionado neste manual onde esses recursos são discutidos. Veja também a seção Plugins no capítulo Configurações.

### O que é OFX

OFX significa Open Financial Exchange. De acordo com o site do Grupo de Trabalho OFX Open Financial Exchange é um padrão aberto para sistemas cliente-servidor e APIs baseadas em nuvem para troca de dados financeiros e realização de transações financeiras entre instituições financeiras e aplicativos financeiros. A especificação define formatos para transferência de dados financeiros tanto por arquivo quanto por intercâmbio direto. Informações históricas adicionais podem ser encontradas na página da Wikipédia

Ainda que o padrão OFX seja muito mais completo e robusto que o QIF, ainda existem variações, dependendo da implementação específica usada por uma determinada instituição. Os arquivos OFX podem ter uma extensão OFX ou QFX (em maiúsculas ou minúsculas); isso não implica nenhuma diferença em particular para o conteúdo. A especificação foi originalmente baseada em SGML, e versões mais recentes são baseadas em &XML;, permitindo que os arquivos possam ser lidos em qualquer editor de texto. Contudo, uma vez que os espaços em branco não são relevantes para o conteúdo em si, algumas implementações não usam espaços, tornando difícil a leitura dos dados por uma pessoa.

Além disso, embora o padrão inclua disposições para tipos adicionais de dados, o &kmymoney; só consegue importar dados de transações, com alguns dados adicionais, como o saldo atual das contas.

Embora pareça ter desaparecido, existia outro site com boas informações em OFX Home, que mantinha um diretório de instituições financeiras que suportavam OFX. Isso era frequentemente útil se você tivesse problemas para configurar a conexão direta com OFX. Eles também tinham um fórum para discussões sobre questões relacionadas ao OFX. Como o domínio ainda está registrado, manteremos esta referência caso o site reapareça no futuro.

### Importar dados OFX

O padrão OFX define a organização e a formatação de dados financeiros, mas esses dados podem existir como um arquivo comum ou como um fluxo de dados entre dois computadores. A maneira mais simples de obter dados OFX é baixá-los do seu banco ou outra instituição financeira como um arquivo OFX. Na maioria dos casos, quando você está conectado ao site do banco, na página que exibe suas transações, há um botão ou link para baixar esses dados. Pode estar escrito OFX ou QFX, ou você pode solicitar os dados para Quicken ou Web Connect (veja abaixo mais informações sobre este termo). Você também tem a opção de especificar o intervalo de datas das transações para baixar (embora isso seja às vezes restrito a períodos que correspondam aos extratos disponíveis), bem como filtrar por tipo de transação.

Se você baixou um arquivo OFX, a maneira mais básica de importá-lo é: escolher o importador na barra de menus, selecionando o item de menu Arquivo Importar OFX... . Se OFX não aparecer em Importar, você não instalou o Plugin de Importação de OFX corretamente ou ele não está habilitado. Consulte a seção anterior.

A primeira coisa que o importador fará é perguntar em qual conta importar as transações. Se o arquivo incluir transações de várias contas, você ouvirá essa pergunta várias vezes.

Depois da importação, algumas das suas transações poderão estar em vermelho intermitente no livro de registros. Isto acontece porque necessitam ter uma categoria atribuída. O módulo de importação não foi capaz de detectar automaticamente uma categoria com base no seu histórico de transações. Você poderá editar cada uma das transações intermitentes para atribuir uma categoria, para que então deixe de piscar em vermelho.

Esta seção descreve o importador OFX nativo. Arquivos OFX também podem ser importados usando o plugin do importador AqBanking. Os dois importadores se comportam de maneira ligeiramente diferente e são escritos e mantidos por dois desenvolvedores diferentes.

### Importar os Investimentos

Lembre-se de que se estiver importando um arquivo com transações de investimentos, estes deverão existir em primeiro lugar no seu arquivo do &kmymoney;. O símbolo comercial é usado para fazer a correspondência, por isso certifique-se de que o símbolo no &kmymoney; é exatamente igual ao mesmo existente no arquivo que está importando.

### Conexão à Web

Em vez de baixar explicitamente um arquivo OFX, como descrito acima, uma maneira mais fácil de importar um arquivo OFX é configurar o Web Connect. Visite o site do seu banco e clique no botão ou link para baixar seus dados como um arquivo OFX. (Algumas instituições listam apenas o formato QFX, que é equivalente.) Seu navegador deve perguntar se você deseja salvar o arquivo ou qual programa você gostaria de usar para abri-lo. Aponte seu navegador para o &kmymoney;. Ele importará o arquivo OFX baixado diretamente para o arquivo do &kmymoney; que você tem aberto no momento ou para o arquivo que você abriu mais recentemente. Você também pode alterar as associações de arquivos do seu ambiente de trabalho e fazer com que o sistema abra o &kmymoney; automaticamente se você clicar em um arquivo OFX no seu navegador de arquivos.

Se precisar importar o arquivo OFX para outro arquivo de dados do &kmymoney;, primeiro abra esse arquivo no &kmymoney; e depois vá para o site do seu banco.

### Conexão Direta

A &kmymoney; também oferece suporte a conexão direta OFX. Isso permite que o &kmymoney; entre em contato diretamente com seu banco para baixar as transações, desde que o banco ofereça suporte a esse serviço.

Atenção: nem todos os bancos são compatíveis com a conexão direta OFX, e aqueles que são geralmente utilizam softwares fornecidos e suportados por terceiros, e esses terceiros geralmente oferecem suporte ao cliente apenas para usuários de softwares comerciais específicos de gestão financeira. Nenhum banco oferece suporte direto ao &kmymoney; portanto, você pode ter que informar que deseja realizar operações bancárias diretamente pelo MS Money ou Quicken. Além disso, o site do Grupo de Trabalho OFX mencionado acima também afirma: A API permite que a troca seja facilitada diretamente ou por meio de um intermediário, como provedores de serviços de agregação de dados. Usuários relataram que bancos que migraram para o uso desses provedores de serviços de agregação são ainda menos propensos a fornecer qualquer suporte, a menos que você esteja usando um dos aplicativos comerciais.

Além disso, seu banco pode exigir um cadastro separado do que o do site normal, pode fornecer uma senha ou PIN diferente e pode até cobrar uma taxa separada por esse serviço.

Se conexão direta funcionar para você, ele permitirá que você atualize seus registros baixando as transações recentes com um único clique. Se não funcionar na primeira tentativa, você pode encontrar uma solução fácil para o seu problema, ou pode ser necessário pesquisar bastante, e não há garantia de que funcionará em qualquer situação específica. No entanto, por favor, não interprete isso como um motivo para não tentar.

O primeiro passo é configurar cada conta para a qual você deseja baixar as transações. Vá para a vista de Contas, clique com o botão direito do mouse na conta que deseja configurar e escolha Mapear para conta online.... Essa opção também está disponível no menu Contas se a conta estiver aberta na vista de Extratos. Caso mais de um plugin de banco online esteja instalado em seu sistema, você será questionado sobre qual usar. Para o método OFX interno, selecione OFX do &kmymoney;. Uma lista de bancos será baixada da internet e um assistente o guiará na escolha de um banco, na inserção de seu nome de usuário e senha e na seleção de uma conta. Caso seu banco não esteja listado, ainda poderá ser possível usar a opção manual. Seu banco poderá fornecer os parâmetros necessários ou você poderá ter que pesquisá-los.

Como mencionado acima, configurar a conexão direta OFX às vezes pode ser um desafio, especialmente porque as implementações na maioria das instituições não fornecem detalhes suficientes nas mensagens de erro. Um problema específico a observar é que muitas instituições exigem que você altere sua senha na primeira vez que acessar o sistema online usando este método. Infelizmente, no momento, a biblioteca que o &kmymoney; usa (libofx) não possui uma maneira interativa de alterar a senha. Em alguns casos, é possível solicitar que um técnico de suporte da instituição altere a senha para você. Até que possamos expandir esta seção com informações de solução de problemas mais detalhadas, se você tiver problemas para fazer isso funcionar, pode pedir ajuda na lista de discussão dos desenvolvedores (&devlist;) ou em um dos outros canais de suporte.

Depois de configurar uma conta no banco online, acesse o extrato dessa conta e selecione Conta Atualizar conta.... Isso conectará você ao seu banco e baixará suas transações recentes. Consulte a próxima seção para saber como configurar o intervalo de datas das transações a serem buscadas.

Em versões anteriores do &kmymoney;, o nome do beneficiário era sempre obtido do campo `PAYEEID` nos dados OFX. A partir da versão 4.6, o nome do beneficiário pode ser baseado no campo `PAYEEID`, `NAME` ou `MEMO` na transação OFX. A próxima seção mostra como você pode configurar esse recurso e algumas outras configurações de conexão direta do OFX.

### Configurando os detalhes de importação do OFX

Isso foi descrito anteriormente, na seção sobre editar detalhes da conta.

### Exportar um arquivo OFX

Atualmente ainda não é possível exportar os seus dados como um arquivo OFX. Se estiver interessado em contribuir nessa área, entre em contato com a equipe de desenvolvimento da biblioteca libofx para obter mais detalhes.

&details-impexp-csv; &details-impexp-woob;