Saldo

Biblioteca TypeScript para cálculos fiscais portugueses.

Cobre recibos de vencimento de trabalhadores por conta de outrem e rendimentos de trabalhadores independentes (categoria B), com suporte completo para TypeScript.

Início Rápido

Escolha o caminho:

Trabalhadores por conta de outrem - Processamento salarial com tabelas de retenção. Começar.
Trabalhadores independentes - Regime simplificado / RNH. Começar.

Funcionalidades

Trabalhadores por conta de outrem: tabelas de retenção 2025 para continente, Açores e Madeira
Trabalhadores independentes: regime simplificado, limites de despesas, calendário de 248 dias úteis
Situações familiares: solteiro, casado, dependentes, deficiências
Subsídios de refeição: cartões e dinheiro
Subsídios de férias: distribuição do 13.º e 14.º mês
Informação fiscal detalhada: escalões, tabelas e taxas
TypeScript nativo: segurança de tipos completa e IntelliSense
Zero dependências (exceto o commander para a CLI)
Funcionalidade completa via CLI: simule diretamente do terminal

Instalação


npm install saldo
# ou
pnpm add saldo
# ou
yarn add saldo

Conceitos Fundamentais

Situações Fiscais

A biblioteca escolhe a tabela fiscal correta com base em:

Estado civil: solteiro ou casado
Número de titulares de rendimentos: 1 ou 2 (para casais)
Dependentes: filhos ou outros qualificados
Estado de deficiência: trabalhador ou cônjuge

Localizações

continent: Portugal Continental
azores: Açores
madeira: Madeira

Cada região tem taxas fiscais e regras próprias.

Períodos Temporais

As tabelas fiscais mudam ao longo do tempo. A biblioteca inclui dados históricos para cálculos precisos em diferentes períodos.

Casos de Uso

Sistemas de processamento salarial
Simulações de salários de RH
Projeções de salário líquido
Comparação de cenários fiscais