HubSpot, Stripe y NetSuite conciliados al centavo para una empresa SaaS B2B

El problema

El motor de ingresos operaba en HubSpot para el pipeline, Stripe para suscripciones y tarjetas, y NetSuite para el libro mayor y ASC 606. Unidos mediante un conector de arrastrar y soltar y exportaciones CSV, los tres sistemas discrepaban constantemente: los calendarios de facturación se desviaban de los términos del contrato en el CRM, las devoluciones de cargos (chargebacks) nunca llegaban al saldo del cliente en el ERP, y cada cierre de mes el equipo de finanzas dedicaba ocho días hábiles a cotejar manualmente los pagos de Stripe con la cuenta bancaria. Los ingresos diferidos vivían en un libro de amortización fuera del sistema.

Qué hicimos

Reemplazamos el conector con endpoints directos y autenticados y un motor de liquidación. Un negocio cerrado-ganado en HubSpot crea el cliente y la orden de venta en NetSuite, valida el ID fiscal, la moneda y la subsidiaria, y crea el cliente y el calendario de suscripción en Stripe. Cada webhook de pago de Stripe se descompone en sus partes: un pago del cliente por el monto bruto, un débito a la cuenta transitoria por el depósito neto exacto, y la comisión de procesamiento registrada como gasto en la misma transacción. Las líneas del negocio se asignan a reglas de reconocimiento de ingresos al cierre, de modo que el acuerdo ASC 606 y sus asientos de amortización se crean sin libro de cálculo. Cada payload se codifica con hash contra el ID de evento de Stripe, de modo que un webhook reintentado actualiza el registro que ya creó.

Este diagrama es uno de los diseños de flujo de trabajo, con sus puntos de control y la evidencia relacionada.

Cómo funciona el mecanismo

1. La discrepancia por comisión de la pasarela

   Un conector genérico registra un pago de $10,000 contra una factura de $10,000, pero Stripe deposita $9,710 tras una comisión de $290, y la conciliación bancaria se convierte en un ejercicio forense de centavos. El listener de liquidación lee la transacción de saldo y registra el bruto, el neto y la comisión como tres partidas de un mismo asiento, de modo que el depósito coincide al centavo el día en que llega.

2. Asignación multielemento bajo ASC 606

   Los negocios empresariales agrupan servicios de implementación, licencias anuales y niveles de consumo que se reconocen en plazos distintos sin importar cómo se facture al cliente. Las líneas de HubSpot se asignan a reglas de ingresos de NetSuite al cierre, de modo que el acuerdo, los saldos diferidos y los asientos de amortización existen el mismo día que el negocio, ya sea que el cliente pague anualmente por adelantado o mensualmente por vencido.

3. Reintentos idempotentes y deduplicación de webhooks

   Las redes fallan y Stripe reintenta. Cada payload entrante se codifica con hash SHA-256 contra el ID de evento de Stripe y se registra en un registro de auditoría gobernado. Un evento duplicado encuentra el registro existente, devuelve HTTP 200 a Stripe y no registra nada dos veces.

Resultados

Qué conviene tomar de este caso

1. Su CRM es para vender; su ERP es para la verdad

   Los representantes de ventas nunca deberían ser responsables de los códigos de impuestos del libro mayor ni de los tipos de cambio. Capture los términos comerciales en el CRM y tradúzcalos a reglas contables en código.

2. Separe la comisión de la pasarela en la ingesta

   Una integración que registra pagos brutos y deja la comisión para el cierre de mes está pagando al equipo de finanzas para que sea una calculadora humana.

3. Los endpoints directos superan al middleware de múltiples saltos

   Los RESTlets autenticados con validación de esquema permiten un registro en menos de un segundo, sin suscripción a middleware y con control total sobre lo que llega al libro mayor.

Retrospectiva compuesta; el cliente se presenta como un arquetipo y las cifras ilustran el mecanismo. Relacionado: Integración nativa vs. middleware iPaaS: el peaje recurrente que se transfiere al cierre