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:

Fichas 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 ficha 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

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
Cumplan con la normativa fiscal española

Modos de operación

Desactivado

Sin procesamiento VeriFACTU. Facturas normales sin restricciones.

Online (VERI*FACTU)

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

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.
Si no tiene NIF (o el identificador es extranjero o no válido), se emite una factura simplificada (F2) sin identificar al cliente.

Antes de generar: confirmación

Con VeriFACTU activo, BikeCRM siempre pide confirmación antes de generar una factura, indicando:

Que la factura se enviará inmediatamente 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 ficha 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 automático

El sistema puede enviar automáticamente copias de las facturas por email:

Configurar email de copia en ajustes del negocio
Al generar una factura, se envía automáticamente a:
- El cliente (si tiene email)
- El email de copia configurado

Plantillas de email

Las facturas se envían con plantillas HTML que incluyen:

Logo del negocio
Datos completos de la factura
Código QR (si VeriFACTU está activo)
Enlace de descarga en PDF

🔍 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.