Importar Lotes de Faturas
📥 Importar Lotes de Faturas
Para que serve?
Esta funcionalidade permite criar várias faturas ou fatura-recibo em simultâneo através de um ficheiro CSV — ideal para poupar tempo quando tem um grande volume de documentos a emitir.
⚠️ Apenas é possível importar Faturas ou Faturas-Recibo.
📍 Onde posso importar lotes de faturas?
Aceda ao menu Faturas > Criar Outros > Lotes de faturas.

🔧 Antes de importar
- Faça download do ficheiro modelo e abra-o num editor de folhas de cálculo (ex.: Excel)
- Preencha os dados conforme a linha de exemplo incluída no ficheiro (consulte aqui os códigos de isenção de IVA)
- Respeite o máximo de 3 itens por fatura
- A data de emissão deve ser posterior à data da última fatura emitida no sistema, para garantir a sequencialidade
💡 Dica: Os dados a preencher no ficheiro são semelhantes ao que preencheria ao criar uma fatura manualmente.
📋 Guia de preenchimento do ficheiro CSV
Cada linha do ficheiro corresponde a uma fatura. Os campos obrigatórios estão assinalados com *.
🗓️ Detalhes da Fatura
| Campo | Descrição | Exemplo |
|---|---|---|
data * |
Data da fatura (AAAA-MM-DD) | 2024-01-15 |
vencimento * |
Data de vencimento (AAAA-MM-DD) | 2024-02-15 |
referencia |
Número de referência próprio | FAT-001 |
observacoes |
Notas visíveis na fatura | Fatura de janeiro |
codigo_de_isencao_de_iva |
Código de isenção de IVA (só necessário se o artigo estiver isento). consulte aqui os códigos de isenção de IVA | M00 |
retencao |
Taxa de retenção ao nível da fatura (deixar em branco se não aplicável) |
|
tipo_desconto |
Tipo de desconto: percentagem ou montante fixo |
percentagem |
desconto |
Valor do desconto | 0 |
👤 Dados do Cliente
| Campo | Descrição | Exemplo |
|---|---|---|
cliente_nif * |
NIF do cliente | 123456789 |
cliente_pais * |
País | Portugal |
cliente_nome * |
Nome do cliente | Acme Lda |
cliente_codigo |
Código interno do cliente — não obrigatório, mas recomendado para evitar duplicação de contactos e garantir que os documentos são criados para o contacto correto | CLI-001 |
cliente_email |
Email do cliente | contacto@acme.pt |
cliente_morada |
Morada | Rua Principal 123 |
cliente_codigo_postal |
Código postal | 1000-001 |
cliente_localidade |
Localidade | Lisboa |
cliente_telefone |
Telefone | +351 123 456 789 |
cliente_telemovel |
Telemóvel | +351 912 345 678 |
cliente_site |
Website | https://acme.pt |
🛒 Artigos (máximo 3 por fatura)
As colunas repetem-se com os sufixos _2 e _3 para o segundo e terceiro artigos.
| Campo | Descrição | Exemplo |
|---|---|---|
item_nome * |
Nome do artigo | Consultoria |
item_quantidade * |
Quantidade | 40 |
item_descricao |
Descrição do artigo | Horas de janeiro |
item_preco_unitario * |
Preço unitário | 75.0000 |
item_taxa_de_iva |
Taxa de IVA em % | 23 |
item_desconto |
Desconto ao nível do artigo | 0 |
item_retencao |
Retenção ao nível do artigo (deixar em branco se não aplicável) |
|
item_taxa |
Nome da taxa conforme configurada na conta | IVA23 |
item_unidade |
Unidade de medida | service |
💡 Exemplo prático: A linha de exemplo no template cria uma fatura para o cliente Acme Lda, com data de 15 de janeiro de 2024, vencimento a 15 de fevereiro de 2024, referente a 40 horas de consultoria a 75,00 €/hora com IVA a 23% — totalizando 3.690,00 € com IVA incluído.
📤 Como importar
Passo 1 — Carregar o ficheiro
Arraste o ficheiro CSV para a área de transferência, ou procure-o no seu computador:

Passo 2 — Validar os dados
Faça a correspondência entre os campos da fatura e as colunas do CSV, e escolha o que pretende incluir.
⚠️ Os campos assinalados com * são obrigatórios.
Se não selecionar um campo, a informação correspondente no CSV será ignorada na criação das faturas.

Passo 3 — Escolher as opções de importação
| Opção | Descrição |
|---|---|
| Nome do Lote * | Dê um nome ao lote para o encontrar facilmente na listagem |
| Tipo de Documento | Escolha o tipo de documento a criar: Fatura ou Fatura-Recibo |
| Estado do Documento | Escolha o estado: Criar como rascunho ou criar e finalizar |
| Série dos Documentos | Escolha uma série; caso não escolha, os documentos serão criados na série por defeito |
| Razão de Isenção de IVA | Indique o motivo de isenção caso haja itens com IVA a 0% |
| Tipo de Desconto Global | Poderá ainda aplicar o mesmo desconto a todos os documentos (caso seja o pretendido) |
| Enviar por email | Ative esta opção para enviar automaticamente cada documento por email após a criação. Se não ativar, os documentos serão apenas criados, mas não serão enviados por email. |

Passo 4 — Confirmação e validação
O InvoiceXpress irá validar os dados do CSV e criar as faturas de acordo com as opções escolhidas.
✅ Se tudo estiver correto: a validação será concluída com sucesso. Clique em Concluir e depois em Ver a listagem de Faturas para encontrar os documentos importados:


❌ Se forem encontrados erros: a validação falhará e será gerado um CSV com o detalhe dos erros. Corrija os dados e volte a importar um novo ficheiro através da opção Reiniciar.
