Split payment e ERP: integração, conciliação e testes
Adaptar o ERP para split payment significa vincular operação fiscal, cobrança e liquidação. Campos sem conciliação e testes de exceção não produzem um controle confiável.
Atualizado em:

Resposta direta: integrar split payment ao ERP exige uma cadeia transacional, não apenas uma API de pagamento. Nota, título, ordem de pagamento, liquidação, parcela segregada, débito fiscal, baixa e estorno precisam compartilhar chaves e estados sem perder o histórico.
Desenho de referência para avaliar com o fornecedor
Confirme quais arranjos, etapas e interfaces oficiais estão disponíveis para sua operação antes de contratar ou parametrizar a integração. O fluxo abaixo é uma recomendação de controle, não uma especificação oficial homologada. Para CBS, veja os arts. 28 a 35 do Decreto 12.955/2026.
pedido → documento fiscal → título → instrução de pagamento → retorno de liquidação → conciliação fiscal/contábil
Cada passagem deve registrar identificador, data, valor, versão e status. O ERP continua como fonte do evento empresarial; o emissor prova o documento; o provedor financeiro prova a liquidação; e a camada de conciliação explica diferenças.
Requisitos que devem entrar no desenho
Idempotência: o mesmo retorno recebido duas vezes atualiza a transação, mas não duplica baixa ou lançamento.
Granularidade: uma nota pode ter várias parcelas e um pagamento pode cobrir várias notas. O modelo não pode pressupor relação um para um.
Versionamento: regra fiscal, leiaute e integração mudam. Uma transação antiga deve ser reconstruída com a versão usada, não com o parâmetro atual.
Observabilidade: falhas precisam gerar alerta com contexto, não apenas uma linha de log técnico.
Reversão: cancelamento, devolução, chargeback e pagamento a maior exigem estados próprios e trilha de aprovação.
Três decisões de integração
- Síncrona ou assíncrona: autorização pode ser imediata, mas retornos financeiros frequentemente chegam depois. Trate pendência sem marcar erro definitivo.
- Motor fiscal interno ou externo: documente quem calcula, quem versiona e qual valor prevalece quando há divergência.
- Conciliação no ERP ou em camada dedicada: escolha pela capacidade de preservar chaves, exceções e lançamentos, não pela conveniência da primeira tela.
Roteiro de homologação
- Monte massa com regimes, destinos e formas de pagamento relevantes.
- Calcule resultado esperado fora da integração.
- Transmita e capture payloads sem dados pessoais desnecessários.
- Confira documento, liquidação, segregação e contabilidade.
- Reenvie o mesmo retorno para testar idempotência.
- Interrompa uma etapa e valide retomada.
- Reverta a operação e prove a cadeia inversa.
Checklist de perguntas ao fornecedor
- Qual chave relaciona nota e transação?
- Como são tratados parcial, lote, atraso e duplicidade?
- Por quanto tempo retornos e versões ficam disponíveis?
- Existe ambiente com os mesmos estados de produção?
- Quem corrige dado rejeitado e em qual prazo?
- Como exportar a trilha para auditoria?
Este artigo trata da implementação tecnológica. Para os critérios de negócio, consulte o checklist de split payment.
Fontes oficiais
Data de corte: 14 de outubro de 2026. APIs e leiautes devem ser confirmados com os provedores e atos oficiais vigentes.
Fontes e referências
Análise contábil, tributária e jurídica para decisões empresariais.
A VMAHUB conecta a execução contábil, tributária e jurídica à análise de riscos e decisões empresariais. O próximo passo é entender como este tema se aplica à sua operação e quais documentos sustentam a análise.
Como aplicar isso à sua empresa
Conheça o escopo do serviço e descreva sua atividade, regime e principal dúvida para a equipe avaliar o próximo passo.
Conhecer o serviço relacionado