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 cliente é determinado pela ficha a partir da qual é feita a importação.

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, Windows-1252 (a do Excel em português) ou UTF-16 (detetada).
Até 2000 linhas por importação. Um ficheiro maior é recusado inteiro, sem importar nenhuma linha: divida-o e importe as partes uma a uma.

Exemplo mínimo:

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

Um ficheiro que não se consegue ler de todo não chega à pré-visualização:

Mensagem	Porquê
Não foi possível ler este ficheiro. Confirme que é um .xlsx ou .csv válido.	O conteúdo não é Excel nem CSV.
O ficheiro não tem cabeçalho nem linhas.	O ficheiro está vazio.
Este ficheiro não tem as colunas do modelo. Falta: …	Falta o cabeçalho de uma ou mais colunas - ver Os cabeçalhos.

Relatórios do Primavera CEGID

Além do modelo, a importação reconhece dois relatórios exportados diretamente do Primavera CEGID, pelos cabeçalhos que eles próprios trazem. Não há nada a preparar: carregue o ficheiro como está, e a pré-visualização diz Primavera CEGID quando o reconheceu.

Relatório	Colunas que lê	O que entra
Faturas em falta	`Nome Entidade`, `N.º Doc. Ext.`, `Tipo Documento Desc`, `Data Doc.`, `Total`	Uma pendência por linha, descrita por fornecedor — número do documento.
Movimentos bancários	`Descrição`, `Data Mov.`, `C/D`, `Valor`	Uma pendência `MB` por movimento, sem número: o movimento é o documento. A coluna `C/D` dá o sinal - um débito entra negativo.

As restantes colunas do relatório - NIF, incidência, IVA, se o documento já tem digitalização - são lidas por alto e ignoradas. Se faltar alguma das colunas acima, o ficheiro não é reconhecido como relatório e a importação pede as colunas do modelo.

Os cabeçalhos

O ficheiro que carrega é o modelo que descarregou, com os mesmos cabeçalhos. Não há nada a mapear: a aplicação procura as colunas pelo nome da primeira linha.

Os cinco cabeçalhos têm de existir no ficheiro - Descrição, Tipo de documento, N.º do documento, Data do documento e Valor -, mesmo os das colunas cujas células podem ficar vazias. Basta faltar um para a importação parar com Este ficheiro não tem as colunas do modelo. Falta: Valor. Descarregue o modelo e preencha-o., com os nomes que faltam.

Os nomes podem estar em português ou em inglês (Description, Document type, Document number, Document date, Amount).
Maiúsculas e acentos não contam; a pontuação conta: N.º do documento é lido, Nº do documento não.
Colunas suas a mais são ignoradas.

As células

Com os cabeçalhos certos, cada linha é lida por si. O que uma célula vazia faz depende da coluna:

Coluna	Célula vazia	O que aceita
`Descrição`	A linha não entra.	Texto livre, até 500 caracteres. Vai para Origem.
`Tipo de documento`	Entra como fatura (`FT`), sem aviso.	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`), ou `Outro`. A sigla fica na pendência, como nas que vêm do software. Texto que não reconheça entra como fatura, e a linha é assinalada.
`N.º do documento`	A linha não entra - exceto num `MB`.	O número que o fornecedor imprimiu - `FT 2026/117`, até 100 caracteres. É por ele que um documento que chega por email encontra a sua pendência, e é o que distingue duas linhas escritas da mesma maneira. Só um movimento bancário entra sem ele: o movimento não tem número próprio.
`Data do documento`	A linha não entra.	`AAAA-MM-DD`, `AAAA/MM/DD`, `AAAA-MM` (fica o dia 1), `DD/MM/AAAA`, `DD-MM-AAAA` ou `DD.MM.AAAA`; uma hora a seguir (`2026-10-14T10:00:00`) é ignorada. Noutro formato ou num dia que não existe (`31/02/2026`), a linha não entra: sem dia, a pendência não pertence a nenhum período, não conta antiguidade e nunca é cobrada.
`Valor`	Entra sem valor, sem aviso.	`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 (N a importar de N linhas), as primeiras a entrar como ficarão, e a lista dos problemas, linha a linha (Linha N), com o número que a folha de cálculo lhe dá. Os problemas vêm separados em N não entram e N entram com alterações.

Mensagem	Linha	Porquê
Sem descrição - a coluna obrigatória está vazia.	não entra	A célula `Descrição` está vazia - quase sempre uma linha só com separadores (`;;;;`) no fim do ficheiro.
Descrição com N caracteres; o máximo é 500.	não entra	Descrição demasiado longa.
Sem data - a coluna obrigatória está vazia.	não entra	A célula `Data do documento` está vazia.
Data “…” não reconhecida ou inexistente - a linha não entra.	não entra	O texto da célula não é nenhum dos formatos aceites, ou é um dia que não existe.
Sem n.º do documento - só um movimento bancário pode entrar sem ele.	não entra	A célula `N.º do documento` está vazia, ou o número foi ignorado por ser longo demais, e o tipo não é `MB`.
Repetida no próprio ficheiro - só a primeira entra.	não entra	Tipo, descrição, data e n.º do documento iguais a uma linha anterior do mesmo ficheiro. Num movimento bancário, que não tem número, é o valor que distingue duas linhas do mesmo dia.
Tipo “…” não reconhecido - entra como fatura.	entra como fatura	O texto da célula não é nenhum dos tipos da lista.
Valor “…” não reconhecido - a pendência entra sem valor.	entra sem valor	O texto da célula não é um número.
N.º do documento com N caracteres; o máximo é 100 - o número é ignorado.	entra sem número num `MB`; noutro tipo, não entra	Cortá-lo faria a pendência casar com o documento errado. Sem número, só um movimento bancário entra - noutro tipo aparece também Sem n.º do documento.

Uma linha com um aviso e um erro conta como linha que não entra.

Só depois de ler isto é que Importar N escreve - e escreve exatamente as N linhas que a pré-visualização mostrou. Se nenhuma linha puder entrar, aparece Nenhuma linha pode ser importada. e o botão fica desligado.

Duplicados

Entre importações, cada linha gera uma impressão digital a partir de tipo + descrição + data + n.º do documento (ou o valor, num movimento bancário). 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 o NIF do 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 Associada.
Não elimina nada. Pendências que estavam na lista e não estão no ficheiro ficam onde estavam.