API / v1

Changelog da API

Cálculos, contratos e integração: o registro público da API VatBR.

Ver documentação

v1

Estado atual

Base de referência

Este registro documenta as capacidades atuais. Não há histórico de datas de lançamento verificadas; novas alterações serão registradas quando ocorrerem.

Cálculos

Cálculo por destino

POST /api/public/v1/calculations

Valores estimados de CBS, IBS estadual e IBS municipal separados por jurisdição. Destino por CEP ou código IBGE e classificação pelo catálogo de itens disponível.

Lotes

Carrinhos e faturas em lote

POST /api/public/v1/calculations/batch

Até 100 itens por chamada, com destino, classificação e regime herdados ou definidos por item. Retorno com resultados individuais, erros e totais dos itens calculados. Cada item bem-sucedido conta como um cálculo.

Validação

Regimes e acesso autenticado

standard · reduced_60 · zero_rate

Validação de elegibilidade para regime padrão, redução de 60% e alíquota zero. Chaves de API com uso e logs por conta; chaves de produção exigem plano pago ativo. Sandbox anônimo disponível sem chave.

Documentação

Referência de integração

OpenAPI 3.1 · Postman

Especificação JSON e YAML, coleção Postman e exemplos REST em cURL, TypeScript, Python, PHP e Go, com sandbox interativo na documentação.

Alíquotas e classificações ilustrativas, ainda sujeitas à validação tributária. Este registro não comprova atualização por fonte oficial nem substitui orientação fiscal.