Split payment e ERP: integração, conciliação e testes

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.

Arquitetura mínima

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

1. Monte massa com regimes, destinos e formas de pagamento relevantes.
2. Calcule resultado esperado fora da integração.
3. Transmita e capture payloads sem dados pessoais desnecessários.
4. Confira documento, liquidação, segregação e contabilidade.
5. Reenvie o mesmo retorno para testar idempotência.
6. Interrompa uma etapa e valide retomada.
7. 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

• Lei Complementar nº 214/2025 — texto compilado
• Receita Federal — Reforma Tributária do Consumo

Data de corte: 13 de agosto de 2026. APIs e leiautes devem ser confirmados com os provedores e atos oficiais vigentes.

Desenhar a integração fiscal.