Sistema de Facturación

Sistema de Facturación en BikeCRM

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.

Offline

Genera datos VeriFACTU localmente. No envía a Hacienda automáticamente.

Online

Genera y envía a Hacienda. Cumplimiento completo automático.

Componentes de VeriFACTU

1. Hash Criptográfico

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

Identifica unívocamente la factura
Se encadena con la factura anterior
Impide modificaciones posteriores

2. Código QR

Contiene:

URL de verificación
Hash de la factura
Datos básicos de identificación

3. Certificado Digital

Requerido para firmar digitalmente las facturas:

Formato PFX/P12
Emitido por autoridad certificadora reconocida
Contraseña protegida

Tipos de Factura VeriFACTU

R1 Factura ordinaria
R2 Factura simplificada
R3 Factura en sustitución de simplificadas
R4 Factura rectificativa
R5 Facturas en regímenes especiales

🚫 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

📧 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:

Certificado digital válido y no caducado
Contraseña del certificado correcta
Hash de la factura anterior disponible
Datos fiscales completos de ambas partes

📊 API y 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_*