Split Payment, Cashback & Crédito Tributário

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:

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.

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

  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

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

Desenhar a integração fiscal.

Fontes e referências

  1. Decreto 12.955/2026
  2. Lei Complementar nº 214/2025 — arts. 31 a 35, texto compilado
  3. Receita Federal — Programa da Reforma Tributária do Consumo
Análise que orienta decisões

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
Simular o efeito no caixa
Próximo Passo

Pronto para transformar sua estratégia?

A equipe analisa o contexto enviado e retorna pelo canal mais adequado ao seu caso.

Escolha o canal mais adequado para iniciar a conversa.

A equipe analisa o contexto enviado e retorna pelo canal mais adequado ao seu caso.

Ao enviar, você concorda com o uso dos dados para responder à sua solicitação, conforme a Política de Privacidade.

WhatsApp