DEV Community

berthelius
berthelius

Posted on • Originally published at frihet.io

Importa tus cobros de Stripe como facturas en 3 clics

Cobras con Stripe. Tus clientes pagan. Pero esas transacciones no son facturas hasta que alguien las convierte en una. Ese "alguien" ya no necesitas ser tú.

Hoy lanzamos Stripe Revenue Sync: una integración que importa automáticamente tus cobros de Stripe como facturas registradas en Frihet. Con deduplicación, cadena de hash VeriFactu y auto-sync cada 6 horas.

El problema: cobrar por un lado, facturar por otro

Si eres founder de un SaaS, freelancer que cobra por Stripe o vendes productos digitales, probablemente vives en esta situación:

  • Stripe cobra. Tus clientes pagan con tarjeta, se renuevan suscripciones, llegan pagos puntuales.
  • Tu contabilidad no se entera. Esos cobros existen en Stripe pero no en tu software de facturación.
  • Tú haces de puente. Cada mes, creas facturas manualmente copiando datos de Stripe. O peor: no lo haces y tu gestor se vuelve loco el trimestre siguiente.

Stripe emite recibos, pero no facturas fiscalmente válidas en España. No incluye tu NIF, no aplica la numeración que exige Hacienda, no genera la cadena de hash que requiere VeriFactu. Para cumplir con la normativa fiscal española, necesitas crear facturas reales en un software de facturación.

Hasta ahora, eso significaba doble trabajo. Ya no.

Qué es Stripe Revenue Sync

Revenue Sync conecta tu cuenta de Stripe con Frihet usando una API Key restringida de solo lectura. Sin OAuth, sin redireccionamientos, sin dar permisos de escritura sobre tu dinero.

Lo que hace:

  1. Consulta tus facturas pagadas en Stripe — solo las que tienen estado paid
  2. Crea una factura en Frihet por cada cobro — con cliente, líneas de detalle e importes
  3. Marca la factura como pagada — el pipeline de VeriFactu se activa automáticamente
  4. Deduplica por ID de Stripe — si la factura ya existe, la ignora

El resultado: tus cobros de Stripe aparecen en Frihet como facturas registradas, con numeración secuencial, hash SHA-256 y listos para tu Modelo 303.

Cómo funciona en la práctica

Tres pasos. Sin código, sin configuraciones complejas.

Paso 1: Crea una API Key restringida en Stripe

Ve a tu Stripe Dashboard > Developers > API Keys. Crea una clave restringida con dos permisos:

  • Invoices → Read
  • Customers → Read

Nada más. No necesitas permisos de escritura ni acceso a pagos, transferencias o saldos. La clave empieza por rk_live_ y es de solo lectura.

Paso 2: Conecta en Frihet

Ve a Ajustes > Integraciones > Stripe Revenue Sync. Pega tu API Key y selecciona desde qué fecha quieres importar. Puedes importar los últimos 90 días o elegir una fecha concreta.

Paso 3: Importa

Haz clic en "Importar ahora". Frihet consulta Stripe, trae las facturas pagadas y las crea en tu cuenta. Cada factura pasa por los triggers de Firestore: numeración gap-free y cadena de hash VeriFactu.

:::tip
Activa auto-sync para que Frihet consulte Stripe cada 6 horas automáticamente. Los nuevos cobros aparecen en tu contabilidad sin que tengas que hacer nada.
:::

VeriFactu compatible desde el primer import

Las facturas importadas de Stripe no son "de segunda". Pasan exactamente por el mismo pipeline que las facturas que creas manualmente en Frihet:

  • Numeración gap-free — Contador atómico en el servidor. Sin huecos, sin saltos.
  • Hash SHA-256 — Cadena de hash con 8 campos que exige la AEAT. Cada factura referencia el hash de la anterior.
  • Inmutabilidad — Una vez registrada, los campos críticos quedan bloqueados. Las modificaciones generan rectificativas.
  • Libro registro — Las facturas importadas aparecen en tu exportación CSV con las 19 columnas que pide Hacienda.

:::info
VeriFactu será obligatorio para sociedades en enero de 2027 y para autónomos en julio de 2027. Las facturas que importes hoy con Revenue Sync ya cumplen con la normativa.
:::

Esto significa que tus cobros de Stripe están listos para el Modelo 303, el Modelo 130 y cualquier inspección. Sin pasos adicionales.

Para quién es Revenue Sync

Founder de SaaS que cobra con Stripe Billing

Cobras suscripciones directamente en Stripe. Cada mes se renuevan decenas o cientos de clientes. Con Revenue Sync, cada renovación aparece como factura en Frihet automáticamente. Tu MRR, tu IVA trimestral y tu libro registro siempre al día.

Freelancer que cobra proyectos por Stripe

Tus clientes te pagan por Stripe y quieres tener todas las facturas en un solo sitio para tus trimestrales. Sin crear cada factura a mano, sin cruzar datos entre Stripe y tu hoja de cálculo.

eCommerce con Stripe directo

Vendes productos digitales o físicos y cobras con Stripe (no a través de Shopify o WooCommerce). Cada venta se convierte en factura registrada. Especialmente útil si vendes a clientes de la UE y necesitas control del IVA.

Agencia con facturación mixta

Algunos clientes te pagan por Stripe y otros por transferencia. Revenue Sync importa los de Stripe mientras facturas el resto manualmente o con la facturación directa de Frihet. Todo convive en el mismo libro registro.

Qué NO es Revenue Sync

Conviene aclararlo para evitar confusiones:

  • No es la integración OAuth de Stripe. Esa ya existe en Frihet y permite cobrar desde la propia app con links de pago. Revenue Sync es unidireccional: solo importa.
  • No emite cobros. No procesa pagos ni crea cargos en Stripe. Solo lee facturas ya pagadas.
  • No sustituye Stripe Billing. Lo complementa. Stripe cobra, Frihet registra.
  • No filtra por cliente. Importa todas las facturas pagadas desde la fecha que elijas. La deduplicación se encarga de que no haya duplicados.

Seguridad

La API Key restringida tiene permisos de solo lectura en dos recursos: invoices y customers. No puede mover dinero, crear cobros ni modificar tu cuenta de Stripe.

La clave se almacena cifrada con AES-256-GCM en el servidor de Frihet. Nunca se expone al frontend. Si Stripe detecta que la clave ha expirado o ha sido revocada, Frihet marca la integración como "requiere reconexión" y te avisa.

Puedes desconectar en cualquier momento desde Ajustes > Integraciones. Las facturas ya importadas permanecen en Frihet.

Empieza ahora

Si cobras con Stripe, tus facturas ya están ahí. Solo necesitan llegar a tu contabilidad. Stripe Revenue Sync lo hace en 3 clics, sin OAuth, sin permisos peligrosos y con VeriFactu desde el primer día.

Conecta tu cuenta de Stripe y deja que tus cobros se conviertan en facturas registradas automáticamente.

:::newsletter-cta
:::


Publicado originalmente en frihet.io

Top comments (0)