igcp-aforro

Simulador determinístico e seguro em decimal para Certificados de Aforro Séries A, B, C, D, E e F. Integra-se em apps JS/TS; inclui CLI e um `rates.json` estático para todos os outros consumidores.

Início rápido Experimentar no navegador Referência da API Ver no GitHub

O que faz

igcp-aforro reproduz de ponta a ponta o cálculo dos Certificados de Aforro do IGCP para as Séries A, B, C, D, E e F:

Para a Série A (legado; perpétua; €0,34916 por unidade de certificado), a taxa-base mensal segue uma cascata histórica (taxas administrativas até 1986-06, TBA mensal arquivada 1986-07…1999-01, Lisbor 1999-02…2002-03, Euribor a partir de 2002-04) e 0,60 × TBA onde aplicável, com a mesma escada de prémios que a Série B (ver Série A — pesquisa e parâmetros).
Para a Série B (subscrições encerradas; sem maturidade contratual), a taxa-base mensal é 0,60 × TBA, com a TBA a partir de médias móveis de 20 dias úteis TARGET2 da Euribor 3M e 12M na mesma data de fixação que nas outras séries (ver Metodologia).
Para as Séries C, D, E e F, resolve a taxa-base mensal a partir da média da Euribor 3M dos 10 dias úteis até ao antepenúltimo dia útil. A Série F limita a média arredondada a [0%, 2,5%]; as Séries D e E somam um spread de +1pp (E3 + 1%) e limitam a [0%, 3,5%]; a Série C usa 0,85×E3 − 0,25 até fevereiro de 2009 e 0,85×E3 + 0,25 a partir de março de 2009 (ver Série C — pesquisa e parâmetros).
Soma o prémio de permanência aplicável ao ano contratual do grupo de subscrição, usando a tabela da série.
Capitaliza trimestralmente com retenção de IRS de 28% em cada capitalização.
Devolve strings decimais para que os resultados possam ser serializados em JSON sem perda de precisão.

Escolha a interface

Aplicação JS/TS? Instale o pacote npm e chame simulate().
Linha de comandos? Instale a CLI e execute aforro simulate.
Python / Java / Excel? Use o rates.json pré-calculado e escreva um capitalizador de ~50 linhas.

Estado

A biblioteca cobre de ponta a ponta a Série A (subscrições até 30 de junho de 1986; perpétua; cascata de taxa-base histórica; valor facial por unidade), a Série B (subscrições de 1 de julho de 1986 a 25 de janeiro de 2008; perpétua; taxa-base por TBA), a Série C (série encerrada, maturidade de 10 anos), a Série D (subscrições abertas de 1 de fevereiro de 2015 a 31 de outubro de 2017, maturidade de 10 anos), a Série E (subscrições abertas de 1 de novembro de 2017 a 1 de junho de 2023, maturidade de 10 anos) e a Série F (subscrições abertas desde 1 de junho de 2023, maturidade de 15 anos). A referência da API é gerada a partir dos comentários TSDoc em inglês e permanece em inglês nesta fase.