HubSpot, Stripe e NetSuite conciliados ao centavo para uma empresa de SaaS B2B

O problema

O motor de receita operava entre o HubSpot para o pipeline, o Stripe para assinaturas e cartões e o NetSuite para o livro razão e o ASC 606. Ligados por um conector de arrastar e soltar e por exportações em CSV, os três divergiam constantemente: os cronogramas de cobrança se afastavam dos termos contratuais no CRM, os chargebacks nunca chegavam ao saldo do cliente no ERP, e todo fim de mês a equipe financeira gastava oito dias úteis conciliando manualmente os repasses do Stripe com a conta bancária. A receita diferida ficava em uma planilha de amortização offline.

O que fizemos

Substituímos o conector por endpoints diretos e autenticados e por um motor de liquidação. Um negócio ganho no HubSpot provisiona o cliente e o pedido de venda no NetSuite, valida CNPJ/identificação fiscal, moeda e subsidiária, e cria o cliente e o cronograma de assinatura no Stripe. Cada webhook de pagamento do Stripe é decomposto em suas partes: um pagamento de cliente pelo valor bruto, um débito na conta transitória pelo depósito líquido exato e a taxa de processamento lançada em despesa na mesma transação. Os itens do negócio são mapeados para regras de reconhecimento de receita no fechamento, de modo que o arranjo ASC 606 e seus lançamentos de amortização são criados sem planilha. Cada payload recebe um hash do id do evento do Stripe, de modo que um webhook reenviado atualiza o registro que já criou.

Este diagrama é um dos desenhos de fluxo de trabalho, com seus pontos de controle e a evidência relacionada.

Como o mecanismo funciona

1. A discrepância nas taxas do gateway

   Um conector genérico registra um pagamento de $10,000 contra uma fatura de $10,000, mas o Stripe deposita $9,710 após uma tarifa de $290, e a conciliação bancária vira um exercício forense de centavos. O listener de liquidação lê a transação de saldo e lança valor bruto, líquido e tarifa como três partes de um único lançamento, de modo que o depósito bate ao centavo no dia em que cai.

2. Alocação de múltiplos elementos (ASC 606)

   Contratos corporativos agrupam serviços de implementação, licenças anuais e faixas de consumo que são reconhecidos em prazos diferentes, independentemente de como o cliente é faturado. Os itens de linha do HubSpot são mapeados para regras de receita do NetSuite no fechamento do negócio, de modo que o acordo, os saldos diferidos e os lançamentos de amortização existem no dia em que o negócio existe, seja o pagamento anual antecipado ou mensal postecipado.

3. Novas tentativas idempotentes e deduplicação de webhooks

   Redes falham e o Stripe tenta novamente. Cada payload recebido passa por hash SHA-256 com base no ID do evento do Stripe e é registrado em um registro de auditoria controlado. Um evento duplicado encontra o registro existente, retorna HTTP 200 ao Stripe e não lança nada duas vezes.

Resultados

O que levar disso

1. Seu CRM serve para vender; seu ERP serve para a verdade

   Representantes de vendas nunca devem ser donos de códigos fiscais ou taxas de câmbio do livro razão. Registre os termos comerciais no CRM e traduza-os em regras contábeis em código.

2. Separe a tarifa do gateway na ingestão

   Uma integração que lança pagamentos brutos e deixa a tarifa para o fechamento do mês está pagando a equipe financeira para ser calculadora humana.

3. Endpoints diretos superam middleware de múltiplos saltos

   RESTlets autenticados com validação de esquema oferecem lançamento em menos de um segundo, sem assinatura de middleware e com controle total sobre o que chega ao livro razão.

Retrospectiva composta; o cliente é apresentado como arquétipo e os números ilustram o mecanismo. Relacionado: Integração nativa vs middleware iPaaS: o pedágio recorrente que se transfere no fechamento