Ficheiros Excel e CSV

A importação serve para clientes cuja contabilidade está num software sem ligação, ou para uma lista que alguém já tem numa folha. Um ficheiro por cliente; o ficheiro não diz de que cliente é — o separador onde está diz.

O ficheiro

Excel (.xlsx) ou CSV. É o conteúdo que decide, não a extensão: um .xlsx a que alguém chamou .txt é lido na mesma como Excel.

Primeira linha com os nomes das colunas.
Excel: a primeira folha do livro.
CSV: separador vírgula ou ponto e vírgula (detetado), codificação UTF-8.
Até 2000 linhas por importação.

Exemplo mínimo:

Descrição;Tipo;N.º do documento;Data;Valor
Infraestruturas de Portugal, S.A.;Fatura;FT 2026/117;2026-02-28;1234,56
EDP Comercial;FT;FT 2026/4471;05/03/2026;87,90
Movimento por justificar;MB;;12/03/2026;-45,00
Certidão permanente;Certidão;;;

As colunas

O ficheiro que carrega é o modelo que descarregou, com os mesmos cabeçalhos. Não há nada a mapear: a aplicação procura estas cinco colunas pelo nome, em português ou inglês, e aceita colunas suas a mais. Se faltar alguma, diz quais e não avança.

Coluna	Obrigatória	O que aceita
`Descrição`	Sim	Texto livre. Vai para Origem. Linhas vazias são ignoradas.
`Tipo de documento`	Não	No Excel é uma lista fechada. Uma sigla — `FT`, `FS`, `FR`, `ND`, `NC`, `RC`, `MB` — sozinha ou com o nome (`NC · Nota de crédito`, `MB · Movimento bancário`). A sigla fica na pendência, como nas que vêm do software. Vazio ou texto que não reconheça entra como fatura, e a linha é assinalada.
`N.º do documento`	Não	O número que o fornecedor imprimiu — `FT 2026/117`. É por ele que um documento que chega por email encontra a sua pendência. Deixe vazio no que não tem número próprio, como uma certidão ou um movimento bancário. Acima de 100 caracteres, a linha entra sem número.
`Data do documento`	Não	`AAAA-MM-DD`, `AAAA-MM` (fica o dia 1), ou `DD/MM/AAAA`. Outra coisa → sem data.
`Valor`	Não	`1234,56`, `1.234,56` ou `1234.56`, com ou sem `€`. Negativo para dinheiro que sai. Num movimento bancário é o que permite casar o comprovativo; noutros documentos é informação.

A pré-visualização

Assim que o ficheiro é lido, a pré-visualização mostra o que vai acontecer antes de escrever seja o que for: quantas linhas entram das que o ficheiro tem, as primeiras a entrar como ficarão, e a lista dos problemas, linha a linha, com o número que a folha de cálculo lhe dá.

Problema	Linha	Porquê
Sem descrição	não entra	A única coluna obrigatória está vazia — quase sempre uma linha em branco no fim do ficheiro.
Descrição demasiado longa	não entra	Acima de 500 caracteres.
Acima do limite	não entra	O que passa das 2000 linhas.
Data ilegível	entra sem data	O texto da célula não é nenhum dos formatos aceites.
Tipo não reconhecido	entra como fatura	O texto da célula não é nenhum dos tipos da lista.
Valor ilegível	entra sem valor	O texto da célula não é um número.
N.º do documento demasiado longo	entra sem número	Acima de 100 caracteres. Cortá-lo faria a pendência casar com o documento errado.
Repetida no ficheiro	não entra	Tipo, descrição e data iguais a uma linha anterior do mesmo ficheiro.

Só depois de ler isto é que Importar N escreve — e escreve exatamente as N linhas que a pré-visualização mostrou.

Duplicados

Entre importações, cada linha gera uma impressão digital a partir de tipo + descrição + data. Uma linha já importada antes, igual, é ignorada — o resultado diz N importadas, N ignoradas (duplicadas). Pode reimportar o mesmo ficheiro à vontade.

O que não faz

Não define número de documento, valor nem NIF de fornecedor. Isso vem só da sincronização.
Não fecha pendências. Uma linha do CSV entra sempre Pendente — a não ser que o documento já tenha chegado por email, caso em que fica logo Recebida.
Não elimina nada. Pendências que estavam na lista e não estão no ficheiro ficam onde estavam.