Referência da API
Changelog de regras
O que mudou no acervo, em ordem cronológica inversa: publicações de regras novas e supersessões — inclusive as retroativas, que reescrevem o passado e são exatamente o que você precisa ver.
GET/v1/changelog
Parâmetros de query
| Campo | Tipo | Descrição |
|---|---|---|
| desde | date | Só eventos a partir desta data. |
| limit | int | 1–500, default 100. |
Tipos de evento
| tipo | O que aconteceu |
|---|---|
| publicacao | Uma regra nova (ou versão nova) foi aprovada e passou a responder no cálculo. |
| substituicao | Uma versão nova fechou a vigência da anterior do mesmo rule_code a partir de uma data de virada. substituida_por aponta a versão que entrou. |
| substituicao_retroativa | A versão nova vale para trás: a anterior foi substituída integralmente (vigente_ate <= vigente_de). Se você calculou com a versão antiga, recalcule o período afetado — a versão anterior permanece no histórico, auditável. |
Exemplo
curl "https://api.finanseed.com.br/v1/changelog?desde=2026-08-01&limit=50" \ -H "X-API-Key: fs_live_SUA_CHAVE"
[
{
"rule_id": "BR-MG-SP-NCM2202-ICMSST-v4.2",
"tributo": "icms_st",
"uf_origem": "SP",
"uf_destino": "MG",
"municipio": null,
"vigente_de": "2026-08-10",
"publicado_em": "2026-08-09T19:04:12Z",
"tipo": "publicacao"
},
{
"rule_id": "BR-MG-SP-NCM2202-ICMSST-v4.1",
"tributo": "icms_st",
"uf_origem": "SP",
"uf_destino": "MG",
"municipio": null,
"vigente_de": "2026-01-01",
"vigente_ate": "2026-08-10",
"publicado_em": "2026-08-09T19:04:12Z",
"tipo": "substituicao",
"rule_code": "BR-MG-SP-NCM2202-ICMSST",
"substituida_por": "BR-MG-SP-NCM2202-ICMSST-v4.2"
}
]Como usar na integração
O webhook de mudança é o caminho de menor latência — o changelog é o complemento idempotente: um polling periódico (ex.: a cada hora, com desde = última consulta) garante que nenhum evento se perde mesmo se o seu endpoint de webhook ficar fora do ar.