Plataforma

Changelog

O que mudou no produto e no contrato da API, mês a mês. Dentro de /v1 toda mudança é aditiva — integração existente não quebra.

Procurando as mudanças de regra tributária (publicações e supersessões do acervo)? Isso é o GET /v1/changelog e o webhook.

Agosto 2026

Plataforma self-service no ar
Conta, chaves de API (criação, rotação com janela de graça, revogação), planos com checkout por cartão e dashboard de consumo em finanseed.com.br. PIX em ativação. Esta documentação passa a viver em docs.finanseed.com.br.
Reforma tributária: cbs e ibs (ano-teste 2026)
Dois discriminadores novos no /v1/calculate seguindo a LC 214/2025: base com os cinco montantes irmãos declarados, dispensa do recolhimento com valor_destaque sempre presente e recusas nomeadas (optante do Simples, regimes diferenciados por NCM/item).
Contribuições federais: pis e cofins
PIS/PASEP e COFINS por operação — regimes cumulativo e não cumulativo, monofásico por papel na cadeia, exclusão do ICMS destacado da base, e os eixos venda_a, ex (Ex tarifário) e destinacao_autopropulsado. Tudo aditivo: payloads anteriores seguem válidos byte a byte.
IPI com Ex tarifário
Primeiro tributo federal do contrato: regra nacional da TIPI por NCM, campo ex opcional com canonização ("1" → "01") e ex_aplicado na resposta.
ICMS próprio (icms) com split de FCP
Operação interna e interestadual, alíquota interestadual pela tabela assinada das Resoluções do Senado, split valor_icms/valor_fcp no envelope e fcp_st no ICMS-ST quando a regra modela o adicional. Recusas nomeadas para Simples Nacional e DIFAL de consumidor final.

Camada pública da API
Endpoint único POST /v1/calculate com dispatch por tributo (ICMS-ST, IPVA, ITCMD/ITCD, ISS, IPTU, ITBI), GET /v1/regras, GET /v1/changelog, GET /v1/usage e o sandbox. Envelope uniforme: valor + regra aplicada + citação legal em toda resposta.
Pauta fiscal/PMPF no ICMS-ST + corredor Sudeste
Base por pauta (valor unitário × quantidade) com precedência decidida pela regra e auditada em base_metodo; recusa 422 quando a pauta exige quantidade e o payload não a traz. Corredor de conteúdo ampliado para os 12 pares direcionais de SP, MG, RJ e ES.
Supersessão com trilha no changelog
GET /v1/changelog passa a reportar substituicao e substituicao_retroativa além das publicações — a versão substituída permanece no histórico, auditável, nunca apagada.
Webhook de mudança de regra
POST assinado (HMAC-SHA256 em X-FinanSeed-Signature) a cada publicação compatível com os filtros da inscrição, com 3 tentativas e backoff. Documentação.