A Reforma Tributária vai separar o imposto no momento do pagamento. Você não precisa ser um PSP (banco ou instituição de pagamento homologada) para usar isto: o toolkit deixa você entender e simular isso hoje, na sua máquina, de graça.
Antes de qualquer código ou conta, siga o passo a passo abaixo e veja o imposto ser separado no momento do pagamento. Depois, brinque com os valores você mesmo.
Simulador ao vivo · sem instalar nada
Siga o passo a passo abaixo. Cada valor é calculado pelo código publicado no @splitbr/client.
Você vendeu R$ 1.000,00 e emitiu a nota. Até aqui, nada de imposto: só o registro de que a venda aconteceu.
O imposto aparece aqui no momento do pagamento. Avance até lá.
Alíquotas de teste de 2026 (fase de transição); as definitivas ainda não valem. Veja a base legal ou o tutorial.
Quer os detalhes em português claro? Leia o guia completo. Prefere rodar na sua máquina? Siga o tutorial de 10 minutos.
A Plataforma Pública do Split Payment é restrita a PSPs homologados, e até julho de 2026 não encontramos nenhuma ferramenta open source de split payment em nenhuma linguagem. Quem precisa se preparar (bancos, fintechs, ERPs, software houses e as próprias empresas) não tinha onde encostar a mão. Mas você não precisa ser PSP para usar o splitbr: o guia em português serve para qualquer empresa, e o mock roda para qualquer dev, sem licença nenhuma.
O splitbr fecha esse buraco com dois pacotes testados e um princípio: o contrato oficial, vendorado com hash pinado, é sempre a fonte da verdade. Quando o contrato muda, o build quebra em vez de mentir.
| Pacote | O que faz |
|---|---|
| @splitbr/mock | A plataforma inteira rodando local, sem precisar de licença nenhuma: 7 fluxos, matrizes de campos como dados, segregação em 3 passos, long polling do Super Inteligente, motor de caos e divergências RSUP. |
| @splitbr/client | SDK TypeScript tipado da plataforma, para PSPs homologados (o pedaço de nicho do toolkit): tipos gerados do OpenAPI oficial, os 4 headers obrigatórios injetados, erros RFC 7807 tipados e a fórmula de segregação como função pura. |
Os dois estão publicados no npm: @splitbr/client e @splitbr/mock.
Roadmap: a prioridade são os validadores NF-e da NT 2025.002, porque tocam toda empresa que emite nota fiscal. Depois vêm o client da Calculadora oficial e um simulador de fluxo de caixa. A lista curada de fontes oficiais vive no awesome-split-payment.
Projeto independente e não oficial. Não é afiliado à RFB, ao Comitê Gestor do IBS, ao Serpro ou à Núclea, e nada aqui é aconselhamento jurídico ou tributário. Confira sempre a fonte primária.
