SN - Analytics

A solução SN - Analytics reúne os domínios da WebApiAlcance que sustentam o produto Simples Analytics - a análise tributária do Simples Nacional por empresa e competência. A partir do cadastro de empresas SN e de suas competências (receitas, folha, faturamento e registros do Domínio), a plataforma apura os cálculos do regime (RBT12, Fator R, anexo aplicado, alíquota efetiva e valor do DAS) e consolida tudo em um dashboard único.

Cada domínio é servido por um router FastAPI sob o prefixo /api/v1/, com o recurso de escopo derivado do caminho público (sn-empresassn_empresas, e assim por diante). Os endpoints privilegiam operações em lote (PUT /batch, com até 5000 itens) para alimentar o analytics, além das declarações do Simples Nacional e das contas contábeis do cliente no NS Sistemas.

Autenticação e envelope

Todos os endpoints exigem Authorization: Bearer <API_KEY> com os escopos apropriados e respondem no envelope padrão { status, message, data }. Veja Autenticação e Conceitos.

Endpoints