Split Fiscal

Para quem integra

A API da Split Fiscal

O cálculo de IBS e CBS onde a sua operação precisa dele — no ERP, no checkout ou no meio de pagamento. Esta página reúne o essencial enquanto a documentação técnica completa é publicada.

O que a API resolve

No split payment, o tributo é separado dentro da liquidação — e para isso a transação precisa chegar ao meio de pagamento com IBS e CBS já destacados e coerentes com a nota fiscal. Divergência ali não é ajuste no mês seguinte: é a operação caindo no procedimento simplificado do §2º-A, com retenção sobre o valor cheio.

A API existe para que esse número nasça certo no ponto onde ele é criado. Ela recebe os dados da operação e devolve o cálculo item a item, considerando o enquadramento de quem emite e de quem recebe — regime normal, Simples Nacional, imunidades e isenções, que alteram a alíquota efetiva.

Onde ela entra

Três pontos de integração, conforme o desenho da sua operação.

No ERP

O cálculo acontece antes da emissão, para que a nota saia com os valores que serão segregados na liquidação. É o ponto onde o erro sai mais barato de corrigir.

No checkout ou no meio de pagamento

Os dados fiscais acompanham a transação no formato que a plataforma pública espera. É a integração que não existia no desenho anterior e que o split payment torna obrigatória.

Na conciliação

O valor creditado deixa de ser o valor da nota. A API devolve a composição da transação para que a baixa de título reconheça a diferença como tributo, e não como divergência.

O que você precisa para começar

Credenciais de ambiente de testes, que entregamos junto com o acesso. O ambiente de testes reproduz o comportamento do split sem efeito financeiro — é onde a integração deve ser validada antes de 2027, enquanto as alíquotas ainda são simbólicas.

Do seu lado, o que costuma definir o prazo de implantação é quão centralizado está o cálculo hoje. Operação com a regra fiscal espalhada em vários pontos do ERP leva mais tempo que operação com um ponto único de decisão — e o diagnóstico inicial responde isso antes de qualquer compromisso.

Documentação técnica

A referência completa — autenticação, endpoints, formato das requisições, códigos de erro e ambiente de testes — está sendo publicada e ficará disponível nesta página.

Enquanto isso, o acesso à documentação e às credenciais de teste é liberado sob solicitação. Fale com a gente e recebe o material junto com o acesso ao ambiente.

Quer ver isso na sua operação?

Uma conversa de 30 minutos com um especialista fiscal para mapear onde a sua operação sente o split payment — sem compromisso.