Importar extratos bancários (camt.053)

Este guia abrange a importação de ficheiros de extratos bancários no formato ISO 20022 camt.053 através de um modelo de importação: o que transferir, como configurar o modelo e o que a importação cria. Os detalhes da API encontram-se em Importações de bancos e pagamentos. Para uma ligação direta ao banco em vez de ficheiros, consulte Ligações bancárias.

1. Transferir o extrato do seu banco

No seu homebanking, abra a exportação de extratos e escolha o formato ISO 20022 camt.053 (XML). Os bancos lituanos listam-no como "ISO 20022 XML" ou "camt.053"; a maioria dos bancos da UE disponibiliza-o na vertente de banca de empresas. Selecione o intervalo de datas e transfira o ficheiro. Um único ficheiro pode conter vários extratos (por exemplo, um por conta em moeda estrangeira); os extratos cujo IBAN não corresponda à conta bancária selecionada são ignorados.

Apenas são importados os movimentos contabilizados (Ntry/Sts = BOOK). Os movimentos pendentes são ignorados.

2. Criar a conta bancária

Cada importação é associada a uma conta bancária. Crie uma conta em Bancos indicando o IBAN e a moeda da conta. Quando o IBAN está definido, a importação verifica se o extrato se refere a essa conta e rejeita ficheiros com um IBAN diferente.

3. Criar o modelo de importação

Em Bancos → Modelos de importação, clique em Novo modelo de importação, escolha o tipo ISO 20022 camt.053 e atribua-lhe um nome.

Campos. Cada elemento do extrato lido pelo importador corresponde a uma linha. A caixa Obrigatório no ficheiro indica que o elemento tem de estar presente no ficheiro carregado; um ficheiro sem um elemento obrigatório é rejeitado sendo exibidos os nomes em falta. Os elementos comuns a todos os extratos (Stmt/Id, Stmt/Acct/Id/IBAN, saldos, Ntry/Amt, Ntry/CdtDbtInd, Ntry/Sts, Ntry/BookgDt) vêm selecionados por predefinição. Os elementos opcionais - o nome do banco, o código de transação, os nomes e IBANs do devedor e do credor, o texto do remitente e as referências - estão desmarcados, uma vez que nem todos os bancos os preenchem; selecione aqueles que o seu banco fornece.

Conta contábil (ledger account). As linhas que contêm valores monetários podem ser associadas a uma conta contábil, seja uma conta existente ou uma nova criada a partir da mesma linha. Cada movimento gerado a partir de uma linha associada é contabilizado no momento da importação: as entradas de dinheiro debitam a conta contábil da conta bancária e creditam a conta atribuída, as saídas fazem o oposto e a transação bancária é marcada como correspondida a esse lançamento no diário. Para além da linha de montante simples Ntry/Amt, existem linhas de regras que selecionam movimentos com base no código de transação bancária ou na direção do movimento:

Linha	Seleciona	Conta típica
Encargos bancários (BkTxCd CHRG)	movimentos cuja família de código de transação seja CHRG	gastos comissões bancárias (6800 no plano padrão)
Juros (BkTxCd INTR)	movimentos cuja família seja INTR	proveitos ou custos de juros
Impostos (BkTxCd TAXE)	movimentos cuja família seja TAXE	pagamentos de impostos
Outras saídas de dinheiro	qualquer outro movimento a débito	deixar "Não contabilizado" para que os pagamentos sejam associados a faturas de compra
Outras entradas de dinheiro	qualquer outro movimento a crédito	deixar "Não contabilizado" para que os recebimentos sejam associados a faturas de venda
Ntry/Amt	qualquer movimento não abrangido por regra	habitualmente "Não contabilizado"

Um movimento é contabilizado na conta correspondente à primeira linha com a qual seja compatível: primeiro a família do código de transação, depois a direção e, por fim, a linha de montante simples. As linhas de regras não são verificadas contra o ficheiro. O código de transação resulta de Ntry/BkTxCd/Domn/Fmly/Cd; um banco que não envie este dado deixará as linhas de código sem correspondência.

Criar clientes/fornecedores em falta. Selecione Criar clientes em falta na linha do nome do devedor (…/RltdPties/Dbtr/Nm) para criar um cliente para cada pagador desconhecido em recebimentos, e Criar fornecedores em falta na linha do nome do credor (…/RltdPties/Cdtr/Nm) para cada beneficiário desconhecido em pagamentos. Os parceiros são reconhecidos primeiro pelo IBAN (o IBAN fica guardado nas contas bancárias do parceiro) e, em seguida, pelo nome exato; a um parceiro encontrado por nome é adicionado o IBAN, permitindo que a importação seguinte o reconheça através deste. Um novo parceiro é considerado uma empresa caso o seu nome inclua uma forma jurídica (UAB, MB, AB, VšĮ, SIA, OÜ, GmbH, Ltd, …) e uma pessoa singular nos restantes casos.

Criar parceiro para o banco. Selecione esta opção na linha de regras de encargos bancários. A importação cria um fornecedor com o nome do banco (Stmt/Acct/Svcr/FinInstnId/Nm, ou o nome da conta bancária caso o extrato não indique o nome do banco) apenas uma vez, registando todos os encargos no diário associados a esse parceiro.

Ligar faturas por este campo. Selecione esta opção na linha de remitente (…/RmtInf/Ustrd), na linha de referência estruturada (…/RmtInf/Strd/CdtrRefInf/Ref) ou na linha de referência de ponta a ponta (…/Refs/EndToEndId). Apenas uma linha pode ter esta opção ativa; contudo, a importação lê todos os três textos independentemente da linha selecionada. Surgem duas opções adicionais:

• Criar faturas de adiantamento para pagamentos recebidos não correspondidos - um recebimento que não corresponda a nenhuma fatura e proveniente de um parceiro conhecido gera uma fatura de adiantamento emitida (série AV) pelo montante respetivo, com data do dia do pagamento, ficando o pagamento associado à mesma. O parceiro tem de ser conhecido, pelo que deve selecionar também Criar clientes em falta.
• Taxa de IVA e Artigo de catálogo para essas faturas de adiantamento. Quando é selecionado um artigo, utilizam-se a respetiva conta e, se o campo da taxa estiver vazio, a respetiva taxa de IVA.

Guarde o modelo.

4. Importar o ficheiro

Em Bancos, selecione a conta bancária, o modelo e o ficheiro, e clique em Importar. A linha de resultado indica quantas transações foram importadas, quantas já existiam, quantos movimentos foram contabilizados, quantos parceiros foram criados e quantas faturas foram associadas ou criadas. Os avisos listam os pagamentos que não puderam ser associados e o motivo.

Importar o mesmo ficheiro novamente é seguro: os movimentos são reconhecidos pela referência de movimento do banco (NtryRef, AcctSvcrRef ou o ID de transação TxId) ou, na ausência destes, por um hash calculado a partir da data contabilística, montante, moeda, IBAN da contraparte e texto, contabilizados de forma a distinguir entradas idênticas no mesmo ficheiro. Os parceiros são reconhecidos por IBAN e nome. Os movimentos contabilizados com montante zero são ignorados com emissão de aviso.

5. O que faz a opção "Ligar faturas por este campo"

Cada novo movimento bancário é verificado face aos documentos em aberto:

• as entradas de dinheiro são comparadas com faturas de venda emitidas que não estejam totalmente pagas, através do número da fatura (por exemplo, SF-123) encontrado no texto do remitente, na referência estruturada ou na referência de ponta a ponta;
• as saídas de dinheiro são comparadas com faturas de compra registadas que não estejam totalmente pagas, através do número de documento do fornecedor.

A correspondência regista o pagamento face à fatura e contabiliza o recebimento ou o pagamento; o movimento surge como associado em Bancos → Transações, com uma hiperligação para a fatura. Os movimentos sem um número reconhecível permanecem por associar e podem ser conciliados manualmente a partir da lista de transações ou, no caso de recebimentos de um cliente conhecido, convertidos numa fatura de adiantamento caso essa opção esteja ativa.

6. Onde consultar posteriormente

• Bancos → Transações - cada movimento importado; os associados contêm uma hiperligação para a fatura ou lançamento no diário.
• Faturas - faturas de adiantamento criadas para recebimentos não correspondidos.
• Parceiros - clientes e fornecedores criados, cada um com o respetivo IBAN associado nas contas bancárias.
• Contabilidade → Diário - os lançamentos referentes a encargos (tendo o banco como parceiro), juros, impostos e pagamentos.

Faturação

Ficheiros até 10 MB e 50 000 movimentos. Cada 10 movimentos importados contam como um pedido de API.