Cobros y pagos

Este módulo te permite registrar y hacer seguimiento de los pagos que realizan tus clientes, desde registrar un cobro manual por transferencia hasta recibir pagos online con tarjeta y conciliarlos con tu banco.

Para quién es este recorrido y requisitos previos

Esta guía continúa el recorrido de Tu primera factura para autónomos y pequeñas empresas que ya han emitido su factura y quieren cobrarla, verificar el estado del pago (total o parcial) y dejarla conciliada con el extracto bancario.

Antes de empezar, comprueba qué necesitas según la vía de cobro que vayas a utilizar:

Vía de cobro	Plan requerido	Requisitos previos en Frihet	Estado requerido de la factura
Transferencia bancaria manual	Cualquier plan (Free, Pro, Premium, Enterprise)	Ninguno adicional (opcional: indicar tu IBAN en Notas / Info Legal).	Enviada / Emitida (no Borrador).
Código QR SEPA (EPC069-12 v2.0) en el PDF	Cualquier plan	Tener configurado tu IBAN en Ajustes → Perfil Fiscal y emitir la factura en EUR.	Pendiente de pago (el QR se incluye automáticamente al generar el PDF).
Enlace de pago con tarjeta (Stripe Connect)	Pro o superior	Cuenta de Stripe Connect activa en Integraciones.	Enviada, no pagada y cuya Fecha de Vencimiento aún no haya pasado.

---

Ejemplo continuo: cobrar la factura de Estudio Norte S.L.

Siguiendo el caso sintético de Tu primera factura, este recorrido utiliza un ejemplo generado para documentación con el fin de comprender los importes, los estados y la interfaz:

• Cliente sintético: Estudio Norte S.L. · CIF B12345674 (supera la validación algorítmica del dígito de control 4 en validateCIF_ES(), pero no acredita existencia, titularidad ni alta en el censo de la AEAT) · correo facturacion@example.com (dominio reservado de documentación IANA/RFC 6761; no es un buzón de prueba controlado ni garantiza entrega o bloqueo de correo).
• Factura: F-2026-0001 por Servicio de consultoría técnica (octubre) (10 unidades × 150,00 €).
• Importe a cobrar:
  • Sin retención de IRPF (sociedad o factura entre empresas): base imponible 1.500,00 € + IVA 21 % (315,00 €) = 1.815,00 €.
  • Con retención profesional de IRPF del 15 % (autónomo profesional): base 1.500,00 € + IVA 21 % (315,00 €) - IRPF 15 % (225,00 €) = 1.590,00 € líquidos a recibir en cuenta.
  • Caso de pago parcial al 50 % (sin IRPF): primer abono de 907,50 € (la factura pasa a Pago parcial con un saldo pendiente de 907,50 €).

Alcance ilustrativo del ejemplo (no ejecutar cobros ni emisiones reales con estos datos)

El escenario F-2026-0001 con Estudio Norte S.L. (B12345674, facturacion@example.com) sirve exclusivamente para explicar qué verificar en la interfaz y cómo recuperar errores frecuentes. No es una instrucción para emitir una factura real, iniciar un cobro real en Stripe ni conciliar un abono bancario real con datos ficticios. Para ejecutar operaciones con efectos externos utiliza tus propios datos legítimos con autorización, o un entorno de QA autorizado con recursos y buzones controlados; los fixtures de documentación no prueban cobros ni conciliaciones bancarias en runtime.

---

Recorrido paso a paso: del envío al cobro conciliado

El ciclo de cobro parte de la factura en estado Enviada (F-2026-0001), transita a Pago parcial (907,50 € cobrados y 907,50 € pendientes) o directamente a Pagada (1.815,00 € sin IRPF / 1.590,00 € con IRPF) y culmina al cruzar el movimiento en Finanzas → Bancos y verificarlo en Informes → Cobros:

Flujo de estados: Factura → Cobro parcial o completo → Conciliación bancaria

Estudio Norte S.L. · F-2026-0001 (1.815,00 €)

1Factura emitida

status: sent1.815,00 €

La factura F-2026-0001 sale de Borrador. Queda pendiente de cobro por el total (1.500,00 € base + 315,00 € IVA 21 %).

2Registro del cobro

Parcial (907,50 €)Completo (1.815,00 €)

Si entra un anticipo o plazo, se actualiza paidAmount y resta saldo pendiente; si entra el 100 %, pasa directamente a Pagada.

3Factura pagada

status: paidSaldo: 0,00 €

Al cubrir el importe íntegro (en un único abono o sumando tramos), la factura queda saldada y dispara el evento invoice.paid.

4Conciliación bancaria

Finanzas → Conciliaciónmatch_transaction_to_invoice

El abono del extracto bancario (CSV/Open Banking) se vincula con F-2026-0001 verificando importe, fecha y NIF B12345674.

Vía A — Cobro parcial en varios tramos

Borrador → Enviada (pendiente 1.815,00 €) → Cobro parcial 50 % (pagado 907,50 €, pendiente 907,50 €) → Segundo cobro 50 % → Pagada (0,00 € pendiente) → Conciliada con 2 movimientos bancarios.

Vía B — Cobro íntegro en un único abono

Borrador → Enviada (pendiente 1.815,00 €) → Marcar como pagada / Stripe / transferencia única (1.815,00 €) → Pagada → Conciliada con 1 movimiento bancario.

Ver especificación textual y fuente Mermaid del flujo de estados

stateDiagram-v2
  [*] --> Emitida: Emisión F-2026-0001 (1.815,00 €)
  Emitida --> ParcialmentePagada: Cobro parcial (p. ej. 907,50 € -> paidAmount < total)
  Emitida --> Pagada: Cobro completo (1.815,00 € -> mark_invoice_paid / POST /v1/invoices/:id/paid)
  ParcialmentePagada --> Pagada: Cobro del saldo pendiente (907,50 € restantes)
  Pagada --> Conciliada: Conciliación con movimiento bancario (Finanzas -> Conciliación)

Paso 1. Elegir vía de cobro (transferencia/QR SEPA vs enlace Stripe)

1. Si cobras por transferencia bancaria o QR SEPA: descarga o envía el PDF de la factura F-2026-0001. Si tienes tu IBAN configurado y la factura está en EUR, el PDF incluye automáticamente el QR EPC069-12 v2.0 con el importe exacto (1.815,00 € o 1.590,00 €) y la referencia F-2026-0001 para que Estudio Norte S.L. lo escanee desde su banca móvil.
2. Si cobras con tarjeta mediante Stripe Connect: con la factura en estado Enviada y antes de su fecha de vencimiento, abre el menú de la factura, pulsa Enlace de pago y usa Compartir enlace para enviarlo al cliente.

Paso 2. Registrar o recibir el cobro (total o parcial)

• Vía online (Stripe Connect): cuando Estudio Norte S.L. completa el pago con tarjeta en el checkout de Stripe, Frihet registra el cobro de forma automática y cambia la factura a Pagada sin intervención manual.
• Vía manual o programática (interfaz web, API REST o MCP): elige el canal con el que operas en tu cuenta:

Interfaz web

1. Ve a Ventas → Facturas y abre la factura F-2026-0001.
2. Pulsa Registrar cobro.
3. Introduce el Importe recibido:
   • Si recibiste el total (1.815,00 € sin IRPF o 1.590,00 € con IRPF), la factura pasará a Pagada.
   • Si acordaste un anticipo o cobro del 50 % (907,50 €), introduce 907,50 €: la factura pasará a Pago parcial y mostrará 907,50 € cobrados y 907,50 € pendientes.
4. Selecciona el Método de pago (Transferencia bancaria, Manual u Otro), la Fecha real del abono y pulsa Registrar pago.

API REST

Para marcar una factura como pagada al 100 % (POST /v1/invoices/{invoiceId}/paid) o actualizar su estado tras un abono (PATCH /v1/invoices/{invoiceId}):

# Cobro completo (1.815,00 EUR) -> estado "paid"
curl -X POST "https://api.frihet.io/v1/invoices/inv_01J8X9N4P2/paid" \
  -H "X-API-Key: $FRIHET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"paidDate": "2026-10-15"}'

MCP

Desde tu agente conectado a @frihet/mcp-server, invoca mark_invoice_paid para el cobro completo o match_transaction_to_invoice al conciliar el movimiento bancario:

{
  "tool": "mark_invoice_paid",
  "arguments": {
    "id": "inv_01J8X9N4P2",
    "paidDate": "2026-10-15"
  }
}

Paso 3. Conciliar con el extracto bancario

1. Ve a Finanzas → Bancos y pulsa Importar extracto para subir los movimientos de tu cuenta bancaria.
2. Comprueba que el abono de Estudio Norte S.L. (1.815,00 €, 1.590,00 € o 907,50 €) queda emparejado con la factura F-2026-0001.
3. Abre Informes → Cobros, filtra el periodo actual y verifica que el cobro figura con su fecha, número de factura, cliente, método e importe (puedes descargarlo con Exportar CSV).

---

Resultado esperado

Al completar el recorrido sobre la factura F-2026-0001, comprobarás tres evidencias en tu cuenta:

1. Estado actualizado en el listado: en Ventas → Facturas, la etiqueta de F-2026-0001 muestra Pagada (si el saldo pendiente es 0,00 €) o Pago parcial indicando el importe cobrado sobre el total (907,50 € / 1.815,00 €).
2. Historial de pagos trazable en la factura: dentro del detalle de la factura aparece el registro con fecha, método, importe y, para cobros registrados a mano, la acción Revertir por si necesitas deshacer un apunte erróneo.
3. Reflejo en informes y conciliación: el cobro aparece en Informes → Cobros listo para exportar en CSV y cruza con el movimiento bancario importado en Finanzas → Bancos.

---

Registrar un cobro

Cuando el cliente te paga por fuera (transferencia, efectivo, cheque):

1. Ve a Ventas → Facturas y abre la factura.
2. Pulsa Registrar cobro.
3. En el diálogo indica:
   • Importe: lo que recibiste.
   • Método de pago: Transferencia bancaria, Manual u Otro.
   • Fecha: cuándo recibiste el dinero.
   • Notas: para tu registro (opcional).
4. Pulsa Registrar pago.

La factura pasa a pagada cuando el importe cobrado alcanza el total. Si te equivocas, Revertir en el historial de pagos deshace el cobro.

En lote

Si varias facturas se pagaron juntas:

1. En Ventas → Facturas, selecciona las facturas con las casillas.
2. Pulsa Marcar pagadas y confirma.

Úsalo después de conciliar con tu banco. Frihet no reparte un único pago entre varias facturas; ver Cobro multifactura.

Pagos parciales

Si el cliente paga solo parte de la factura, registra el cobro con un importe menor al total (por ejemplo, 500 de 1.000 EUR). La factura queda parcialmente pagada, con el importe cobrado y el pendiente, y puedes registrar cada pago posterior. En la lista, la factura muestra el estado Pago parcial y el importe cobrado sobre el total. Un importe superior al saldo pendiente se rechaza. Ver Pagos parciales.

Condiciones de pago

Las condiciones de pago definen cuánto tiempo tiene el cliente para pagar. Al crear la factura puedes elegir:

• Pago inmediato
• Neto 15 días, Neto 30 días, Neto 45 días, Neto 60 días o Neto 90 días
• Fecha personalizada

Condiciones por cliente

Si todas las facturas de un cliente se pagan al mismo plazo, define Condiciones de pago por defecto en su ficha de Contactos. Las nuevas facturas a ese cliente las usarán y puedes cambiarlas en cada factura.

Pagos online (Stripe Connect)

Frihet se integra con Stripe Connect para recibir pagos con tarjeta.

Activar Stripe Connect

1. Ve a Integraciones y busca la tarjeta de Stripe Connect.
2. Sigue el proceso de conexión y autorización de Stripe.
3. Cuando Stripe confirme tu cuenta, vuelves a Frihet con Stripe conectado.

Enlace de pago

Con Stripe conectado:

1. Abre una factura emitida.
2. Pulsa Enlace de pago.
3. Copia el enlace con Compartir enlace y envíaselo al cliente.

Los recordatorios automáticos incluyen el enlace al portal de la factura, desde donde el cliente puede pagar si tu plan es Pro o superior y tienes Stripe conectado.

Flujo de pago

1. El cliente abre el enlace y ve el resumen de la factura.
2. Introduce los datos de su tarjeta en el checkout de Stripe.
3. Stripe procesa el pago.
4. Frihet marca la factura como pagada y registra el cobro.

Más detalle en Enlace de pago.

Domiciliación bancaria (adeudo directo SEPA)

Frihet no inicia adeudos directos SEPA ni gestiona mandatos de domiciliación. Si acuerdas con un cliente que su banco te pague por adeudo, gestionas el adeudo fuera de Frihet y registras el cobro a mano con Registrar cobro cuando el dinero llegue. Si cobras por domiciliación con GoCardless, conecta la integración para importar esos cobros.

Recordatorios de pago

Automáticos

1. Ve a Ajustes → Recordatorios de pago. Los recordatorios automáticos están activos por defecto. Para ajustarlos:

2. Define cuántos días antes o después del vencimiento se envía cada recordatorio (los valores negativos se envían antes) y qué niveles desactivar.

Frihet envía el email al cliente según ese calendario. Más detalle en Recordatorios de pago.

Enviar un recordatorio manual

1. Abre la factura vencida.
2. Pulsa Enviar recordatorio.
3. Revisa el email y envíalo.

También puedes seleccionar varias facturas en la lista y pulsar Recordar.

Gestionar atrasos

Las facturas que vencen sin ser pagadas pasan al estado Vencida.

Análisis de atrasos

Ve a Informes → Antigüedad para ver las facturas pendientes por tramos (al día, 1-30, 31-60, 61-90 y más de 90 días), con estas cifras:

Métrica	Descripción
Total Pendiente	Importe total por cobrar
Total Vencido	Importe cuyo vencimiento ya pasó
Facturas Vencidas	Número de facturas vencidas
Días Promedio	Días de retraso promedio
Clientes con Mayor Deuda Vencida	Quién debe más

Desde ese informe puedes pulsar Enviar recordatorio en cada factura.

Acciones por atraso

1. Enviar recordatorio por email.
2. Aplicar recargo por mora (ver Recargos por demora).
3. Registrar cobro si finalmente pagó.
4. Crear rectificativa si se va a cancelar (ver Facturas rectificativas).

Devoluciones

En facturas, Frihet no procesa devoluciones de dinero ni reembolsos a tarjeta. Para registrar fiscalmente una devolución, crea una factura rectificativa desde la factura original con Crear rectificativa (ver Facturas rectificativas). La devolución del dinero al cliente la haces fuera de Frihet.

Conciliación bancaria

Para cruzar los cobros con tu banco:

1. Ve a Finanzas → Bancos y usa Importar extracto para cargar el extracto.
2. Revisa las transacciones y compáralas con los cobros registrados.
3. Consulta Informes → Cobros para ver los cobros del periodo. Filtra por fechas, cliente o método y pulsa Exportar CSV para descargar fecha, número de factura, cliente, método, importe, divisa y pasarela.

Busca discrepancias como facturas cobradas sin depósito bancario, depósitos sin factura asociada y diferencias de fechas (Frihet registra la fecha de cobro; el banco, la fecha de valor).

Problemas frecuentes y cómo recuperarlos

Problema o síntoma	Causa raíz verificada	Cómo resolverlo
No aparece el botón «Enlace de pago» en la factura	La factura sigue en Borrador, ya está Vencida o Pagada, tu cuenta está en el plan Free (requiere Pro o superior) o Stripe Connect no está activo.	Comprueba que la factura esté en estado Enviada y dentro de plazo, revisa tu plan y verifica la conexión de Stripe en Integraciones (ver Enlace de pago).
El formulario rechaza el importe al pulsar «Registrar pago»	El importe introducido supera el saldo pendiente de la factura (por ejemplo, ya registraste un pago parcial o estás introduciendo 1.815,00 € en una factura cuyo neto con IRPF es 1.590,00 €).	Revisa el saldo pendiente que muestra la factura y el historial de cobros previos antes de introducir la cifra.
Registré un cobro manual por error o con fecha equivocada	Error humano al introducir el apunte manual en Registrar cobro.	Abre la factura en Ventas → Facturas, localiza el apunte en el historial de pagos, pulsa Revertir y vuelve a registrar el cobro con los datos correctos.
El cobro figura en Frihet pero no cuadra con el extracto bancario	Diferencia entre la fecha de cobro y la fecha de valor del banco, o liquidación de Stripe con comisión de pasarela descontada en el depósito.	Cruza el movimiento en Finanzas → Bancos teniendo en cuenta la comisión o fecha de liquidación. Más detalle en Conciliación bancaria.
El cliente pide una devolución tras haber pagado la factura	Frihet no ejecuta reembolsos de dinero ni devoluciones a tarjeta desde la factura.	Emite una factura rectificativa desde la factura original con Crear rectificativa (Facturas rectificativas) y realiza la devolución económica desde tu banco o el panel de Stripe.

Casos de uso comunes

Cliente recurrente a 60 días

1. Configura el cliente con Condiciones de pago por defecto a Neto 60 días.
2. Cada factura nueva vence a 60 días.
3. Ajusta el calendario de Recordatorios de pago si quieres un aviso antes del vencimiento.

Pago inmediato con Stripe

1. Creas y emites la factura.
2. Generas el Enlace de pago.
3. El cliente paga online y la factura se marca pagada.

Límites reales y siguiente acción

Ten presentes estos límites operativos del producto al organizar tus cobros:

• Sin emisión de adeudos SEPA: Frihet no inicia adeudos directos SEPA ni gestiona mandatos (salvo importación de cobros desde GoCardless).
• Sin reparto automático en el diálogo individual: Registrar cobro aplica a una factura individual y Marcar pagadas cierra varias facturas por su total; para agrupar varias facturas en una sola operación revisa Cobro multifactura.
• Sin reembolso bancario/tarjeta desde la factura: el ajuste fiscal se hace con Crear rectificativa (Facturas rectificativas) y el reembolso del dinero se ordena en tu banco o pasarela.

Siguientes pasos recomendados:

• Conciliar el extracto bancario paso a paso: revisa el flujo de 5 estados y emparejamiento en Conciliación bancaria.
• Revisar el impacto en tus impuestos trimestrales: comprueba cómo las facturas emitidas y cobradas alimentan el Modelo 303, el Modelo 130 o el IGIC en Modelos fiscales.
• Diagnosticar incidencias de pasarela o entrega de correos: consulta la tabla de resolución en Soporte y diagnóstico rápido.

---

Anterior: Impuestos | Volver a: Facturación