Comparativo de software de faturação self-hosted
Compare Invoice Ninja, InvoiceShelf, InvoicePlane, Kimai e ERPNext num VPS: faturação recorrente, impostos, portal do cliente, gateways e licenças.
Qual software de faturação self-hosted deve escolher?
O software de faturação self-hosted resume-se a cinco opções realistas num único VPS, e elas não são substitutos equivalentes. O Invoice Ninja é o produto mais completo: faturas recorrentes, um portal do cliente, gateways de pagamento e formatos de fatura eletrónica funcionam desde o momento da instalação. O InvoiceShelf é a opção totalmente open source mais leve. O InvoicePlane é uma aplicação PHP simples, sem nada para orquestrar. O Kimai fatura as horas registadas, em vez de itens de linha. O ERPNext é um sistema de contabilidade completo que também gera faturas.
Dois problemas comprometem uma instalação de faturação self-hosted com muito mais frequência do que a ausência de uma funcionalidade. O primeiro é o email. Uma fatura numa pasta de spam é uma fatura por pagar, e nada lhe indica que isso aconteceu. O segundo são as cópias de segurança. Esta é a única base de dados self-hosted cuja perda se transforma num problema fiscal, e não apenas num incómodo.
Leia a licença antes de consultar a lista de funcionalidades. Três destas cinco opções usam licenças copyleft, uma usa uma licença permissiva e uma disponibiliza o código-fonte com limites reais sobre o que pode fazer com ele.
As cinco opções e para quem cada uma se destina
Invoice Ninja
Uma aplicação Laravel, atualmente na linha v5. O self-hosting é gratuito e sem restrições: faturas recorrentes, orçamentos, projetos, registo de tempo, despesas, um portal do cliente e gateways de pagamento incluindo Stripe e PayPal. O projeto descreve-se como "uma aplicação de faturação, orçamentos, projetos e registo de tempo com código disponível, construída com Laravel". Quem faz self-hosting paga por duas coisas. A primeira é a remoção da marca. Nas palavras do próprio projeto: "Oferecemos uma licença white-label de 40 USD por ano para remover a marca Invoice Ninja das partes da aplicação visíveis ao cliente". Este preço está atualizado em outubro de 2026. A segunda é o envio e receção de faturas eletrónicas através da rede Peppol, que funciona através da plataforma alojada do Invoice Ninja e é abordada abaixo na secção sobre o que o seu contabilista irá pedir.
Escolha esta opção se pretende o produto mais completo e aceita executar a stack mais pesada.
InvoiceShelf
Um fork do Crater, sob a licença GNU Affero General Public License version 3 (AGPL-3.0). Abrange faturas, estimativas, faturação recorrente, despesas, impostos, multi-moeda, um portal do cliente e multi-empresa. Os pagamentos e a funcionalidade white-label residem em repositórios de módulos oficiais separados, ambos sob a licença AGPL-3.0 e ambos gratuitos. O pagamento com cartão é processado através do Stripe checkout. Utilize a versão 2.x suportada para produção: o branch 3.x predefinido é uma pré-visualização alpha e o módulo de pagamentos existente não funciona nele.
Escolha esta opção se pretende uma aplicação pequena, totalmente open source e não precisa de trinta gateways.
InvoicePlane
Uma aplicação PHP baseada em CodeIgniter, distribuída sob a licença MIT, que se instala descompactando ficheiros na raiz do servidor web. Não é necessário Docker ou qualquer passo de compilação Node para o arquivo de lançamento. Os PDFs são gerados pelo mPDF, pelo que os modelos são em HTML e CSS. Os clientes recebem uma ligação de convidado para visualizar e pagar uma fatura.
Os pagamentos costumavam ser o ponto crítico. O InvoicePlane 1.6.0 foi lançado com o Stripe como o seu único gateway ativado e todos os outros fornecedores desativados. O PayPal regressou na linha 1.6: a versão 1.6.4 de 19 de janeiro de 2026 adicionou suporte para PayPal Advanced Credit Cards e Venmo, e as versões 1.6.5, 1.7.1 e 1.7.2 foram lançadas com Stripe e PayPal ativados, enquanto os outros drivers permanecem desativados. O guia de instalação fornecido com a 1.7.2, a versão atual de 28 de agosto de 2026, requer PHP 8.2 ou superior, com suporte para 8.3 e 8.4, e MariaDB, enquanto a página de requisitos da wiki do projeto ainda mostra o intervalo mais antigo de PHP 8.0 a 8.1. Leia as notas da versão que descarregar.
Escolha esta opção se estiver num alojamento partilhado ou num VPS de 512 MB.
Kimai
Um gestor de tempo sob licença AGPL-3.0 que gera faturas a partir de folhas de horas. É a resposta certa para quem fatura por horas. Os modelos de fatura são carregados como ficheiros DOCX, ODS ou XLSX, que a documentação confirma serem os únicos formatos aceites, sendo depois convertidos para PDF ou HTML. Pode estruturar a sua fatura num processador de texto em vez de escrever CSS, o que a maioria das pessoas considera mais fácil.
O Kimai não possui gateway de pagamento e a sua loja não lista nenhum plugin de pagamento, pelo que terá de enviar o PDF por e-mail. Um plugin gratuito de terceiros chamado Customer Portal partilha estatísticas de clientes e projetos e folhas de horas através de um URL secreto, opcionalmente protegido por palavra-passe, mas apresenta folhas de horas em vez de faturas. A faturação eletrónica estruturada é um plugin pago da loja chamado E-Invoice Plus, listado a 99 EUR (excluindo IVA) por ano em outubro de 2026. Abrange os perfis EN16931, Extended e XRechnung 3.0 em CII ou UBL, Peppol UBL em beta, e PDFs híbridos ZUGFeRD e Factur-X.
Escolha esta opção se a fatura for o resultado de tempo registado.
ERPNext
GPL-3.0, e uma categoria diferente de software. Uma fatura de venda é um tipo de documento dentro de um sistema contabilístico completo com plano de contas, lançamentos diários, stock e processamento de salários. É a resposta certa quando a faturação deixa de ser a única tarefa. Para um freelancer com oito clientes, é demasiado software. Colocá-lo em funcionamento é um projeto por si só, abordado em executar o ERPNext num VPS.
As faturas recorrentes dependem de um agendador que não é visível
Invoice Ninja, InvoiceShelf, InvoicePlane e ERPNext geram faturas recorrentes. O Kimai não tem uma funcionalidade de faturas recorrentes no núcleo, porque uma fatura é criada a partir dos registos da folha de horas de um período.
O modo de falha é igual em todas as aplicações baseadas em Laravel e é silencioso. As faturas recorrentes são criadas pelo agendador do Laravel. Este tem de ser acionado a cada minuto, através do cron a executar php artisan schedule:run ou de um processo php artisan schedule:work de longa duração. Se nada o acionar, a lista de faturas recorrentes continua a mostrar uma próxima data de envio, mas essa data passa. Não aparece nenhuma fatura. Nenhum erro é registado, porque nenhum código foi executado.
Depois de criar a primeira fatura recorrente, defina a próxima data de envio para alguns minutos depois e aguarde. Se nada chegar, o agendador não está a ser executado. Numa instalação Docker, isso normalmente significa que o serviço ou processo do agendador nunca arrancou ou terminou. Nas imagens atuais do Invoice Ninja e do InvoiceShelf, o agendador é executado dentro do contentor da aplicação, e não como um serviço separado. Por isso, são os logs desse contentor que deve consultar.
docker compose ps
docker compose logs --tail 50Todos os serviços no ficheiro devem indicar running. O serviço que estiver no estado exited é aquele cujos logs deve consultar.
Moedas e impostos: o que verificar antes de se comprometer
As listas de funcionalidades dizem "multi-moeda", mas podem referir-se a capacidades muito diferentes. Execute estas quatro verificações numa instância de demonstração, usando valores reais da sua empresa, porque um erro nesta área será detetado pelo seu contabilista, e não por si.
- A fatura guarda a taxa de câmbio aplicável na data de emissão? Tem de guardar. Se a aplicação recalcular os totais com base numa taxa atual, os relatórios do último trimestre mudam sempre que os abrir, e a contabilidade deixa de corresponder ao que já declarou.
- O imposto é aplicado por linha, por fatura ou de ambas as formas? Uma taxa única ao nível da fatura é suficiente até existir uma linha com taxa zero.
- Pode introduzir preços com imposto incluído e também sem imposto? Fazer a conversão posteriormente introduz diferenças de arredondamento de um cêntimo por linha, e esses cêntimos acumulam-se ao longo do ano.
- O que aparece no documento para um cliente de outro país que não deve IVA? A fatura tem de apresentar a menção de isenção, e não apenas um zero na coluna do imposto.
Invoice Ninja e ERPNext tratam dos quatro pontos. InvoiceShelf inclui impostos e multi-moeda na lista de funcionalidades. InvoicePlane e Kimai são mais simples, por isso teste-os com a sua fatura mais problemática, e não com a mais simples.
Portal do cliente e gateways de pagamento
O portal do cliente é uma página onde o cliente visualiza as suas faturas, descarrega o PDF e efetua o pagamento. Isto é mais importante do que parece, pois cobrar pagamentos por e-mail consome mais tempo do que a própria emissão da fatura.
O Invoice Ninja destaca-se neste aspeto, oferecendo um portal completo, múltiplos gateways, métodos de pagamento guardados e faturação automática em faturas recorrentes. O InvoiceShelf possui um portal do cliente e adiciona o Stripe checkout através do seu módulo de pagamentos. O InvoicePlane disponibiliza um link de convidado para cada fatura e suporta Stripe e PayPal, com o PayPal disponível novamente desde a versão 1.6.4. O Kimai não possui gateway de pagamento e o seu plugin gratuito Customer Portal partilha folhas de horas e estatísticas em vez de faturas, pelo que o PDF é enviado como anexo.
Um ponto causa confusão constante. A auto-hospedagem da aplicação de faturação não significa armazenar números de cartões. Com o Stripe checkout, o cliente é redirecionado para o Stripe, introduz o cartão lá e o seu VPS nunca vê o número. O seu âmbito PCI (payment card industry) permanece reduzido precisamente porque não foi você quem construiu o formulário de pagamento. Se futuramente precisar de mais do que um processador ou quiser encaminhar pagamentos por país, isso deve ser feito numa camada separada, como orquestração de pagamentos auto-hospedada com Hyperswitch.
Qualidade do PDF e o modelo que acabará por editar
Irá editar o modelo. Todas as predefinições aqui colocam o seu endereço no local errado para o seu país.
O Invoice Ninja renderiza modelos HTML e CSS para PDF usando o Chrome sem interface gráfica incluído na imagem (Chromium em arm64), razão pela qual o contentor é grande. Reserve memória para este processo: um navegador sem interface gráfica é o processo mais pesado da stack, pelo que 1 GB de VPS é pouco. O InvoicePlane usa mPDF, que é implementado apenas em PHP e é leve, mas ignora algum CSS moderno. O Kimai segue a abordagem oposta e permite carregar um ficheiro DOCX ou ODS, pelo que o layout é feito no LibreOffice ou no Word por alguém que nunca escreveu uma folha de estilos.
Se uma fatura com um design específico for importante e o CSS não for, a abordagem do Kimai é melhor. Se quiser o modelo sob controlo de versões e com diferenças comparáveis, o HTML é melhor.
A licença permite o uso comercial?
Todas as cinco permitem que você emita faturas para os seus próprios clientes. As diferenças surgem quando você faz algo além disso.
O Invoice Ninja está sob a Elastic License 2.0. Duas cláusulas são importantes.
Você não pode fornecer o software a terceiros como um serviço hospedado ou gerenciado, onde o serviço forneça aos usuários acesso a qualquer conjunto substancial de recursos ou funcionalidades do software.
Você não pode mover, alterar, desativar ou contornar a funcionalidade da chave de licença no software.
Portanto, executá-lo para o seu próprio negócio é permitido, mas executar instâncias para clientes como um produto não é. A segunda cláusula é o motivo pelo qual a remoção da marca é uma licença de 40 USD em vez de um patch no código-fonte.
InvoiceShelf, Kimai e Crater estão sob a licença AGPL-3.0. O uso comercial é gratuito em todas as três. A loja do Kimai vende plugins pagos para funcionalidades que a instalação gratuita não possui, como E-Invoice Plus, campos personalizados e gestão de despesas por 99 EUR cada, por ano. As assinaturas de plugins incluem uma licença de fallback perpétua: as versões compradas continuam a funcionar após o cancelamento, mas as atualizações exigem uma assinatura ativa. A obrigação da licença está na seção 13: se você modificar o código e permitir que outras pessoas usem a sua versão modificada através de uma rede, você deve oferecer a elas o código-fonte das suas alterações. Uma instância não modificada já está coberta pelo código-fonte público do projeto original, por isso a maioria dos utilizadores que fazem self-hosting nunca lida com isso.
InvoicePlane utiliza a licença MIT, a obrigação mais leve do grupo, embora o seu README observe que o nome e o logotipo permanecem com o projeto.
ERPNext utiliza a licença GPL-3.0. As modificações que você distribuir devem ser compartilhadas, e executá-lo de forma privada não acarreta nenhuma obrigação.
Esta é uma descrição do texto da licença e não um aconselhamento jurídico.
O projeto ainda é mantido? Verifique o log de commits
O Crater foi uma aplicação de faturação open source popular durante vários anos e muitos guias ainda a recomendam. A 10 de outubro de 2026, a sua branch padrão não tinha qualquer commit há 1329 dias, desde 19 de fevereiro de 2023.
Os dados por trás deste gráfico
[
{
"label": "ERPNext",
"commit_gap": 0
},
{
"label": "InvoicePlane",
"commit_gap": 0
},
{
"label": "Kimai",
"commit_gap": 4
},
{
"label": "InvoiceShelf",
"commit_gap": 11
},
{
"label": "Invoice Ninja",
"commit_gap": 22
},
{
"label": "Crater",
"commit_gap": 1329
}
]Dos 6 projetos nesse bloco, cinco tiveram um commit nas quatro semanas anteriores a essa verificação e três na semana anterior. O InvoiceShelf é o fork que deu continuidade ao trabalho do Crater, sob a mesma licença AGPL-3.0 e com o mesmo modelo de dados, pelo que a migração é uma transferência de dados e não uma reescrita. Instale o InvoiceShelf, não o Crater.
Instalando cada um num VPS
Tudo, exceto o InvoicePlane, é executado mais facilmente com o Docker Compose. Se isto é novo para si, comece com uma primeira stack Docker Compose num VPS e volte aqui.
O Invoice Ninja disponibiliza o seu próprio repositório compose. As instruções atuais utilizam a branch debian, com o ficheiro compose num subdiretório com o mesmo nome.
git clone https://github.com/invoiceninja/dockerfiles.git -b debian
cd dockerfiles/debian
docker run --rm -it invoiceninja/invoiceninja-debian php artisan key:generate --showCopie todo o output para APP_KEY no ficheiro .env nesse diretório, juntamente com o seu APP_URL real. Defina também IN_USER_EMAIL e IN_PASSWORD para a sua primeira conta, pois se os deixar vazios, o login assume por omissão admin@example.com com a palavra-passe changeme!. Depois, inicie-o.
docker compose up -dO serviço nginx incluído publica a porta 80 no host, por isso coloque o seu proxy TLS à frente dele ou altere esse mapeamento. No assistente de configuração, indique mysql como host da base de dados, pois esse é o nome do serviço na rede do compose. localhost aí aponta para o próprio contentor da aplicação.
O InvoiceShelf publica ficheiros compose prontos, um por motor de base de dados.
curl -fLO https://raw.githubusercontent.com/InvoiceShelf/docker/master/docker-compose.mysql.yml
mv docker-compose.mysql.yml docker-compose.ymlAbra esse ficheiro antes de o iniciar. Todas as palavras-passe nele são espaços reservados e o ficheiro indica isso nos seus próprios comentários. APP_URL, SESSION_DOMAIN e SANCTUM_STATEFUL_DOMAINS assumem todos por omissão localhost, e os três precisam que o seu hostname real seja definido antes do primeiro login. Depois, coloque-o em execução.
docker compose up -dEle publica a porta 8090 no host e serve a 8080 dentro do contentor. Coloque um reverse proxy com TLS (transport layer security) à frente dele antes de enviar um único cliente para lá.
Ficheiro compose de produção do Kimai, da documentação do projeto
services:
sqldb:
image: mysql:8.3
volumes:
- mysql:/var/lib/mysql
environment:
- MYSQL_DATABASE=kimai
- MYSQL_USER=kimaiuser
- MYSQL_PASSWORD=kimaipassword
- MYSQL_ROOT_PASSWORD=changemeplease
command: --default-storage-engine innodb
restart: unless-stopped
healthcheck:
test: mysqladmin -uroot -p$$MYSQL_ROOT_PASSWORD ping -h 127.0.0.1 --silent
interval: 10s
timeout: 5s
retries: 12
start_period: 30s
kimai:
image: kimai/kimai2:stable
depends_on:
sqldb:
condition: service_healthy
restart: true
volumes:
- data:/opt/kimai/var/data
- plugins:/opt/kimai/var/plugins
ports:
- 8001:8001
environment:
- APP_SECRET=your-fantastic-long-random-and-ultra-secure-secret
- TRUSTED_HOSTS=kimai.example.com
- ADMINMAIL=admin@example.com
- ADMINPASS=changemeplease
- DATABASE_URL=mysql://kimaiuser:kimaipassword@sqldb/kimai?charset=utf8mb4&serverVersion=8.3.0
restart: unless-stopped
volumes:
data:
mysql:
plugins:Defina APP_SECRET como uma string aleatória longa da sua autoria e TRUSTED_HOSTS como o domínio que irá realmente utilizar. ADMINMAIL e ADMINPASS criam o primeiro administrador no primeiro arranque, por isso altere essa palavra-passe na interface posteriormente e remova-a do ficheiro.
O InvoicePlane inclui configurações Docker para desenvolvimento e testes. Para uma instalação a partir de arquivo, crie primeiro uma base de dados vazia.
sudo mysql -e "CREATE DATABASE invoiceplane CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"Transfira o arquivo da página de releases do projeto, extraia-o para a sua web root, copie ipconfig.php.example para ipconfig.php e defina o seu URL dentro dele seguindo os comentários nesse ficheiro. Depois, abra https://your-domain.example/index.php/setup e siga os passos do instalador.
Por que sua fatura cai na pasta de spam
Esta é a falha que custa dinheiro, e a aplicação informará tranquilamente que a fatura foi enviada.
Não envie e-mails de fatura pelo próprio endereço IP do VPS. Um novo IP de VPS não tem histórico de envio, e grandes provedores tratam, por padrão, a primeira mensagem de um endereço desconhecido em uma faixa de hospedagem como suspeita. Envie por um relay SMTP (simple mail transfer protocol) em um domínio que você tenha autenticado. Fazer isso de ponta a ponta é assunto para um guia próprio, e enviar e-mails de forma confiável a partir de uma aplicação auto-hospedada aborda o relay, os registros DNS e os testes.
O endereço From é onde a maioria das configurações de faturamento dá errado. Ele deve estar em um domínio que autorize seu relay, e a forma simples de garantir isso é usar um domínio que você controla e com o qual seu relay assina usando DKIM (domainkeys identified mail). Colocar o endereço do cliente em From parece educado, mas geralmente interrompe a entrega. As diretrizes de remetentes do Gmail dizem que uma mensagem passa pelo DMARC somente quando SPF ou DKIM passa e o domínio autenticador está alinhado ao domínio no cabeçalho From. Seu relay autentica seu domínio, não o domínio do cliente. Isso só pode ser corrigido no lado do cliente: ele teria de incluir seu relay no próprio registro SPF ou configurar a assinatura DKIM do domínio dele por meio do relay. É isso que o Google exige de quem envia mensagens por um provedor: "Se você usa um provedor de serviços de e-mail, verifique se ele autentica o e-mail do seu domínio com SPF e DKIM." Se o cliente não tiver feito isso, a mensagem falhará no DMARC, e o Gmail informa que mensagens não autenticadas "podem ser marcadas como spam ou rejeitadas com um erro 5.7.26." Uma rejeição desse tipo se parece com isto:
550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policyMantenha seu próprio endereço em From e coloque o cliente em Reply-To. Verifique os registros publicados antes de enviar qualquer mensagem real.
dig +short TXT example.com
dig +short TXT _dmarc.example.com
dig +short TXT selector1._domainkey.example.comO primeiro deve retornar um registro SPF (sender policy framework) que identifique seu relay. O segundo deve retornar uma política DMARC (domain-based message authentication, reporting and conformance). O terceiro depende do seletor fornecido pelo seu relay. Uma resposta vazia significa que o registro DKIM está ausente ou foi publicado com o nome errado. Nesse caso, todas as mensagens enviadas falharão na verificação da assinatura.
Depois, envie uma fatura real para uma conta sua em um grande provedor e leia os cabeçalhos brutos. dkim=pass e spf=pass no cabeçalho Authentication-Results são a única prova que importa. O status "sent" da própria aplicação significa apenas que ela entregou a mensagem ao relay.
Backups: a única base de dados que não pode perder
Perder um servidor multimédia significa voltar a descarregar os ficheiros. Mesmo um servidor de fotografias self-hosted, como o PhotoPrism ou o Immich normalmente mantém uma segunda cópia dos originais que ainda existem no telefone que os captou. Perder a base de dados de faturação significa não conseguir mostrar o que faturou, o que recebeu ou o que ainda deve receber. Trate-a de acordo com essa importância.
Faça cópias de segurança de quatro elementos. A base de dados. O volume de armazenamento, que contém logótipos, PDFs gerados e recibos de despesas. O ficheiro de ambiente da aplicação. E os PDFs renderizados mantidos como ficheiros normais, porque um PDF abre daqui a dez anos sem a aplicação que o produziu.
O ficheiro de ambiente é mais importante do que muitas pessoas esperam. O Laravel cifra os valores sensíveis armazenados, incluindo as credenciais do gateway de pagamentos, usando o APP_KEY desse ficheiro. Se restaurar a base de dados junto de uma chave gerada novamente, esses valores não serão decifrados. Todas as suas faturas estarão presentes, mas as definições do gateway ficarão ilegíveis.
Um dump da stack do InvoiceShelf tem este aspeto. O serviço da base de dados é executado em mariadb:10, por isso a ferramenta dentro do contentor é mariadb-dump.
docker compose exec -T database mariadb-dump \
--user=root --password=YOUR_ROOT_PASSWORD \
--single-transaction --databases invoiceshelf > invoiceshelf.sql--single-transaction cria um snapshot consistente das tabelas InnoDB sem as bloquear, por isso a aplicação continua a servir pedidos enquanto o dump é executado. -T impede o Docker de alocar um terminal, o que poderia corromper a saída redirecionada e produzir um ficheiro de dump que não seria importado.
Envie esse ficheiro para fora do servidor segundo um agendamento, usando cópias de segurança restic cifradas para armazenamento externo, e defina a retenção por tempo suficiente para abranger o período indicado pelo seu contabilista.
Depois, restaure-o. Inicie o dump num contentor temporário, inicie sessão e abra a fatura do mês passado. Enquanto não fizer isto uma vez, não saberá se a cópia de segurança funciona.
O que o seu contabilista irá solicitar
Não aceite conselhos fiscais de um tutorial. O que se segue é o que este software pode produzir, para que possa levar a lista à pessoa que o aconselha.
Dados exportáveis. Deve ser capaz de exportar as suas faturas e pagamentos para CSV a partir da interface, sem um cliente de base de dados e sem abrir um pedido de suporte. Um dump SQL é uma cópia de segurança, não uma exportação, porque o seu contabilista não o consegue abrir.
Numeração imutável. Os números das faturas devem seguir uma sequência e nunca ser reutilizados, sem lacunas. Eliminar uma fatura deixa uma lacuna que terá de ser explicada. Em vez disso, cancele ou emita uma nota de crédito, o que todas as aplicações aqui suportam. Se a numeração sem lacunas é exigida no seu caso, depende de onde está registado, e vale a pena perguntar cedo.
Retenção. Mantenha os dumps da base de dados e os PDFs gerados durante o tempo que as suas regras exigirem. O PDF é o documento que foi efetivamente enviado, e esse é o artefacto que importa caso uma fatura seja contestada.
Histórico de alterações. Poder mostrar quem editou uma fatura e quando é algo que vale a pena ter, e varia bastante entre estas aplicações. O Invoice Ninja mantém um registo de atividade por registo.
A faturação eletrónica estruturada tornou-se um requisito real, em vez de um extra desejável, em partes da UE. O Invoice Ninja gera os formatos comuns, cobrindo ZUGFeRD e XRechnung, Facturae, FatturaPA e o genérico EN16931, embora a sua documentação indique que o FatturaPA não está pronto para produção porque a ligação ao SDI de Itália não está ativa. A entrega através da rede Peppol a partir de uma instância self-hosted é feita através da plataforma alojada do Invoice Ninja. Na documentação do fornecedor, regista a sua entidade no Invoice Ninja, que cria um ID de entidade legal para si; a sua instância faz proxy das faturas eletrónicas através do serviço deles, e as faturas eletrónicas recebidas chegam através de um cron que consulta os servidores deles a cada quatro horas. A página de faturação eletrónica do Invoice Ninja vende o acesso ao Peppol como parte do seu plano Enterprise, que começa em $18 por mês e inclui 250 créditos Peppol, um por cada submissão de fatura eletrónica. Créditos adicionais custam $50 por 500 ou $100 por 1.000, válidos por um ano. Instalações self-hosted não têm créditos incluídos e compram esses mesmos pacotes, à data de 15 de novembro de 2026. O plugin pago E-Invoice Plus do Kimai cobre EN16931, XRechnung, ZUGFeRD, Factur-X e Peppol em beta, mas não Facturae ou FatturaPA. O InvoicePlane tem um hook de faturação eletrónica, mas não disponibiliza nenhum formato no seu core: adiciona templates a partir do repositório InvoicePlane-e-invoices do projeto, que tem exemplos para ZUGFeRD, Factur-X e UBL. O ERPNext obtém XRechnung, ZUGFeRD e Factur-X, apenas em CII sem UBL ou Peppol, a partir da aplicação gratuita GPL-3.0 eu_einvoice da ALYF. O InvoiceShelf oferece agora PDFs híbridos EN16931 ZUGFeRD / Factur-X através do seu módulo oficial gratuito E-Invoicing para a pré-visualização alpha 3.x; o projeto continua a direcionar utilizadores de produção para a 2.x. O Invoice Ninja é o único com tudo isto integrado, o que é a razão mais forte para o escolher se fatura dentro da UE.
FAQ
Devo instalar o Crater ou o InvoiceShelf?
O InvoiceShelf. O branch padrão do Crater não recebe commits há 1329 dias, com data de 10 de outubro de 2026, e o guia de migração do próprio InvoiceShelf refere-se a ele como "o projeto Crater, agora abandonado". O InvoiceShelf utiliza a mesma licença AGPL-3.0 e o mesmo modelo de dados, portanto, a migração entre eles é uma transição de base de dados e não uma reescrita. Qualquer guia que ainda recomende o Crater foi escrito antes de o projeto ficar inativo.
Posso usar o Invoice Ninja para o meu próprio negócio sem pagar?
Sim. O Invoice Ninja auto-hospedado é totalmente funcional e gratuito sob a licença Elastic License 2.0, incluindo faturas recorrentes, portal do cliente e gateways de pagamento. Duas funcionalidades são pagas. Remover a marca Invoice Ninja das páginas visíveis ao cliente requer a licença white-label, que custa "$40 por ano", segundo o próprio projeto em outubro de 2026. O envio ou recebimento de faturas eletrónicas pela rede Peppol é feito através da plataforma hospedada do Invoice Ninja. Em 15 de novembro de 2026, instalações auto-hospedadas compram créditos Peppol, sem créditos incluídos: $50 por 500 ou $100 por 1.000, válidos por um ano. Cada fatura eletrónica enviada consome um crédito. O que a licença proíbe é executar o software como um serviço hospedado para terceiros.
Por que os meus e-mails de faturação vão para a pasta de spam?
Quase sempre porque a mensagem não está autenticada para o domínio no endereço From. Envie através de um relay SMTP em vez de enviar diretamente do VPS, publique registos SPF e DMARC para o seu domínio e adicione o registo DKIM sob o seletor fornecido pelo seu relay. Mantenha o seu próprio endereço no campo From e coloque o cliente no campo Reply-To. Definir o endereço do cliente como remetente faz com que a mensagem falhe no DMARC, a menos que o cliente tenha listado o seu relay no registo SPF dele ou configurado a assinatura DKIM para o domínio dele através desse relay; o Gmail pode marcar a mensagem como spam ou rejeitá-la com um erro como 550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policy. Confirme a correção localizando dkim=pass e spf=pass no cabeçalho Authentication-Results de uma mensagem de teste.
Qual devo escolher se faturo por hora?
O Kimai. Ele é, antes de tudo, um rastreador de tempo, portanto a fatura é gerada a partir de entradas de folhas de horas aprovadas e os itens da fatura são o trabalho que registou. Os modelos são ficheiros DOCX, ODS ou XLSX que desenha num processador de texto, o que é mais fácil do que editar CSS. A contrapartida é que o Kimai não aceita pagamentos online. O seu plugin gratuito Customer Portal partilha folhas de horas e estatísticas de projetos através de uma ligação secreta, mas não faturas; por isso, envia o PDF por e-mail e recebe por transferência. O Invoice Ninja também rastreia o tempo e possui um portal de faturação completo com pagamento por cartão; escolha este se o pagamento online por cartão for mais importante para si do que o detalhe da folha de horas.
O que exatamente preciso de copiar (backup)?
A base de dados, o volume de armazenamento que contém logótipos e PDFs gerados, o ficheiro de ambiente e os PDFs renderizados mantidos como ficheiros simples. O ficheiro de ambiente é o que as pessoas esquecem: aplicações Laravel, como o Invoice Ninja e o InvoiceShelf, encriptam credenciais armazenadas com APP_KEY, portanto, uma base de dados restaurada com uma chave recém-gerada deixará as definições do seu gateway de pagamento ilegíveis. Restaure tudo numa instância de teste uma vez e abra uma fatura antiga, pois essa é a única forma de saber se o backup funciona.