Sistema de Facturación

Esta página documenta el funcionamiento completo del sistema de facturación de BikeCRM, incluyendo la generación automática, facturas rectificativas, y la integración con VeriFACTU.

📋 Conceptos básicos

¿Qué es una factura?

En BikeCRM, una factura es un documento fiscal que se genera para:

Hojas de servicio (reparaciones de bicicletas)
Pedidos de TPV (ventas en tienda)
Alquileres de bicicletas

Cada factura contiene:

Número único de factura
Datos fiscales del vendedor (tu taller)
Datos fiscales del comprador (cliente)
Desglose de artículos/servicios
Base imponible e IVA aplicado
Total a pagar

Numeración de facturas

El sistema utiliza un formato de numeración automático:

[ID-TALLER]-BCRM[AÑO]-[NÚMERO]

Por ejemplo: BIKE01-BCRM2025-142

⚙️ Modos de generación

BikeCRM soporta tres modos de generación de facturas:

Modo Automático (`auto`)

Las facturas se generan automáticamente cuando:

Una hoja de servicio se marca como pagada y cerrada
Un pedido de TPV se marca como pagado
Se solicita un ticket/recibo

Ideal para: Talleres que quieren automatización completa

Modo Manual (`manual`)

Las facturas solo se generan cuando:

El usuario hace clic explícitamente en “Generar Factura”
Se solicita mediante la API

Ideal para: Talleres que prefieren control total sobre cuándo facturar

Modo Semi-automático (`semi`)

El backend funciona como modo manual
El frontend sugiere generar factura cuando se completa un pago
El usuario decide si generar o no

Ideal para: Balance entre automatización y control

💳 Proceso de generación

1. Captura de datos fiscales

Cuando se genera una factura, el sistema congela los datos fiscales actuales:

Datos del Vendedor

Nombre fiscal del negocio
NIF/CIF
Dirección completa
Ciudad y código postal
País

Datos del Comprador

Nombre del cliente
NIF/NIE/Pasaporte
Dirección de facturación
Ciudad y código postal
País

2. Cálculo de impuestos

El sistema calcula automáticamente:

Base imponible por tipo de IVA (0%, 4%, 10%, 21%)
Importe del IVA para cada tipo
Total con y sin impuestos

3. Asignación de número

Se asigna un número secuencial único dentro de:

El año fiscal actual
La serie correspondiente
Sin huecos en la numeración

🔄 Facturas rectificativas

Las facturas rectificativas (credit notes) permiten corregir facturas ya emitidas.

Sustitución (Tipo S)

Anula completamente la factura original y la reemplaza por una nueva.

Usar cuando:

Error total en la factura original
Cambio completo de cliente
Anulación de la venta

Características especiales

Se crean con Crear Factura Rectificativa desde la venta, la hoja de servicio o el alquiler facturado. En un alquiler, la rectificativa se crea como un nuevo alquiler devuelto con los mismos artículos a precio negativo
Usan la serie 10 exclusivamente
Numeración: [ID]-BCRM[AÑO]/CN10-[NÚMERO]
Referencian siempre la factura original
No pueden modificarse una vez emitidas

🔐 VeriFACTU

VeriFACTU es el sistema de la Agencia Tributaria española para garantizar la integridad y trazabilidad de las facturas.

¿Qué es VeriFACTU?

Sistema de Verificación Fiscal

VeriFACTU asegura que las facturas:

No puedan ser modificadas después de emitirse
Estén encadenadas criptográficamente
Sean trazables por la administración
Conserven una huella de sus registros de facturación

La aceptación de un registro o la presencia de un QR no acredita por sí sola todo el cumplimiento fiscal.

Modos de operación

Desactivado

Sin procesamiento VeriFACTU. No equivale a un sistema NO VERI*FACTU conforme. Las obligaciones de facturación y los bloqueos de facturas ya selladas siguen vigentes.

Online (VERI*FACTU)

Cada factura genera su registro de facturación y se envía automáticamente a la AEAT en tiempo real.

La AEAT aclara que, antes del plazo obligatorio aplicable a cada contribuyente en 2027, empezar a utilizar VERI*FACTU no obliga a mantenerlo hasta final de año. Después se aplica la permanencia del año natural. Un cambio en los ajustes no sustituye el procedimiento fiscal de cese.

Las pruebas deben realizarse en el entorno externo de pruebas de la AEAT y con datos y numeración separados. El nombre «beta» de una aplicación no garantiza que sus envíos sean de prueba.

Componentes de VeriFACTU

1. Hash criptográfico (huella)

Cada factura genera un hash SHA-256 único que:

Identifica unívocamente el registro de facturación
Se encadena con el registro anterior
Impide modificaciones posteriores

2. Código QR tributario

Impreso en la cabecera de la factura, contiene la URL oficial de cotejo de la AEAT con:

NIF del emisor
Número y serie de la factura
Fecha de expedición
Importe total

3. Envío a la AEAT

Tras generarse, cada registro se remite automáticamente a la Agencia Tributaria. Puedes ver el estado de cada factura en el listado de facturas:

⏳ Pendiente de envío
✓ Aceptada por la AEAT
⚠️ Aceptada con errores
✗ Rechazada

Tipos de factura VeriFACTU

F1 Factura completa (con NIF del cliente)
F2 Factura simplificada (ticket, sin identificar al cliente)
R1-R5 Facturas rectificativas (abonos)

El tipo se decide automáticamente:

Si el cliente tiene un NIF/CIF/NIE español válido, se emite una factura completa (F1) con sus datos.
La implementación actual propone F2 cuando no encuentra un NIF español válido. Un identificador extranjero no autoriza por sí mismo a emitir una factura anónima: estos casos necesitan revisión antes de emitir.

El límite legal general de las facturas simplificadas es 400 € IVA incluido. La excepción de 3.000 € solo corresponde a las actividades enumeradas en el artículo 4 del Reglamento de facturación, como determinadas ventas al por menor. Reparaciones y alquileres de bicicletas no quedan incluidos automáticamente. El tope técnico de 3.000 € de BikeCRM todavía no aplica esa distinción: hay que comprobar la operación antes de emitir.
BikeCRM valida actualmente los tipos de IVA 0%, 4%, 10% y 21% del régimen soportado. Esto no cubre todos los supuestos históricos, exenciones o regímenes especiales; un 0% no equivale a una exención.
Si el cliente necesita deducir el IVA, añade su NIF y nombre fiscal antes de generar la factura: después ya no se puede cambiar.

Antes de generar: confirmación

En los flujos manuales que muestran el diálogo VeriFACTU, la confirmación indica:

Que el registro se pondrá en la cola de envío automático a la AEAT
Que quedará bloqueada de forma permanente (junto con la venta o ficha asociada)
Si se emitirá como F1 (con los datos del cliente) o como F2 simplificada

En modo de facturación automática, el aviso aparece en la tarjeta de pago antes de cobrar: al completar el pago se genera la factura, se envía a la AEAT y la venta queda bloqueada.

🚫 Inmutabilidad

Una vez que una factura tiene hash VeriFACTU:

No se puede:

❌ Modificar ningún dato de la factura
❌ Eliminar la factura
❌ Cambiar la hoja de servicio o pedido asociado
❌ Alterar los importes o impuestos

Sí se puede:

✅ Generar una factura rectificativa
✅ Consultar y descargar la factura
✅ Enviar por email al cliente
✅ Verificar mediante el código QR
✅ Registrar pagos pendientes y cambiar estados operativos (entrega, recogida)

📧 Envío de facturas por correo

Las facturas se envían al cliente cuando tú lo decides:

En una venta: Enviar factura al cliente o el menú de envío
En una hoja de servicio: Enviar factura

El correo llega a la dirección de la ficha del cliente y lleva la factura completa en el propio mensaje, con el nombre y el logotipo del negocio. Si el cliente no tiene correo, BikeCRM te avisa y no se envía nada.

Envío automático de los pedidos de la tienda online

El único envío automático es el de las facturas de los pedidos de WooCommerce y Shopify, si BikeCRM gestiona sus facturas y activas la opción en la página de la integración (Enviar facturas por email automáticamente al cliente en WooCommerce, Enviar la factura al cliente por email automáticamente en Shopify). Está desactivada por defecto.

BikeCRM no envía copias automáticas de las facturas a ninguna otra dirección. Para tener todas las facturas de un periodo, pide el Libro de facturas PDF en Informes con Solicitar por correo: te llega como adjunto al correo de tu usuario (el de tu cuenta, no el correo del taller). Cada factura sale completa, con todas sus líneas (tareas, productos, bicis y accesorios de alquiler) y la base imponible de cada una.

Descargar el informe de facturas (xls) en Informes es otra cosa: una fila por factura, con la base y el IVA de cada tipo, pensado para el registro de facturas del gestor.

Consulta en Notificaciones y correos todo lo que BikeCRM envía a tu equipo y a tus clientes.

🔍 Validaciones importantes

Antes de generar

Para VeriFACTU

Requisitos adicionales:

Datos fiscales completos del negocio (nombre legal y NIF)
Datos fiscales del cliente para facturas completas (F1)

📊 API e integración

Endpoints principales

GET /api/invoices/          # Listar facturas
POST /api/invoices/         # Crear factura manual
GET /api/invoices/{id}/     # Detalle de factura
GET /api/invoices/{id}/pdf/ # Descargar PDF

Campos de solo lectura

Los siguientes campos son inmutables via API:

verifactu_xml
previous_invoice_hash
current_record_hash
qr_code_data
Todos los campos seller_* y buyer_*

🛠️ Resolución de problemas

”No se puede modificar factura con hash VeriFACTU”

Solución: Crear una factura rectificativa en lugar de modificar.

”Faltan datos fiscales del vendedor/comprador”

Solución: Completar los datos fiscales en:

Ajustes del negocio (vendedor)
Ficha del cliente (comprador)

“Factura rechazada por la AEAT” (✗)

Solución: Pasa el ratón por el estado en el listado de facturas para ver el motivo exacto que devuelve la AEAT. Suele deberse a datos fiscales incorrectos (NIF o nombre legal del negocio que no coinciden con el censo de la AEAT o, en facturas completas, del cliente). Si el problema persiste, contacta con soporte.