Facturación Recapitulativa B2B — Documentación
Instala, configura y automatiza la facturación recapitulativa mensual B2B en PrestaShop 8 y 9.
Presentación
Facturación Recapitulativa agrupa todos los pedidos de un cliente profesional en un periodo (el mes anterior, por defecto) en una única factura consolidada. En lugar de una factura por pedido, tus clientes B2B reciben una única factura mensual, numerada en secuencia, con el desglose de IVA por tipo y el detalle pedido por pedido. El módulo genera el PDF con el motor nativo de PrestaShop, lo envía por email y elimina las facturas individuales de los emails de pedido enviados a los clientes profesionales.
Las facturas individuales de PrestaShop nunca se eliminan: se siguen generando y permanecen disponibles en tu back office y en el historial de pedidos. Solo se aligera de su PDF individual el email enviado al cliente B2B.
Instalación
Instala el módulo como cualquier módulo de PrestaShop, desde Módulos > Gestor de módulos > Subir un módulo, enviando el archivo ZIP. Al instalarse, el módulo crea sus tablas, su pestaña de administración y un valor de token aleatorio para el cron. No se requiere ninguna dependencia de Composer.
Configuración
Ve a Módulos > Gestor de módulos y haz clic en Configurar junto a Facturación Recapitulativa. La página de configuración reúne todos los ajustes.
Grupos de clientes B2B
Marca el o los grupos de clientes considerados profesionales. Solo los clientes de estos grupos ven sus pedidos consolidados, reciben la factura recapitulativa y acceden al área «Mis facturas recapitulativas». Este ajuste define tu ámbito B2B.
Estados de pedido incluidos
Selecciona los estados de pedido que hacen que un pedido sea elegible para la consolidación (por defecto: pago aceptado, preparación en curso, enviado, entregado). Un pedido cuyo estado actual no figure en esta lista se ignora en el momento de la generación.
Día de generación
Elige el día del mes (del 1 al 28) en el que el cron activa la generación del mes anterior. Un día entre 1 y 28 garantiza que la fecha exista en todos los meses.
Prefijo y numeración
Define el prefijo de numeración (por defecto REC). Las facturas recapitulativas se numeran en secuencia con el formato PREFIJO-AAAA-00042, mediante un contador dedicado. Los números nunca se reutilizan, ni siquiera tras eliminar una factura.
Envío automático y limpieza de emails
Dos interruptores controlan el comportamiento de envío:
- Envío automático por email: en el momento de la generación (cron o manual), la factura recapitulativa se envía al cliente con el PDF adjunto.
- Eliminar la factura individual de los emails de pedido: para los clientes B2B, el PDF de factura individual se elimina de los emails de pedido, de modo que solo queda un envío limpio: la factura recapitulativa mensual.
Notas legales y condiciones de pago
Dos áreas de texto multiidioma te permiten personalizar las notas legales (por defecto, un recordatorio del artículo 289 I-3 del Código General de Impuestos francés relativo a la factura periódica recapitulativa) y las condiciones de pago mostradas al pie de la factura. Estos textos pueden introducirse en cada idioma de la tienda.
Automatización por cron
La generación automática se apoya en una URL de cron protegida por un token. Recupera la URL completa (token incluido) en el panel de información de la página de configuración y prográmala en el planificador de tareas de tu servidor. Ejemplo de entrada crontab para un disparo diario:
0 6 * * * wget -q -O /dev/null "https://tutienda.tld/module/dfdeferredinvoicing/cron?token=TU_TOKEN"El cron es idempotente: solo genera la factura de un cliente si aún no existe para el periodo. Por tanto, puedes ejecutarlo cada día sin riesgo: solo el día de generación configurado activa realmente el procesamiento del mes anterior.
Parámetros opcionales
&force=1: fuerza la generación sea cual sea el día del mes.&month=6&year=2026: apunta a un periodo concreto (útil para reejecutar un mes pasado).
La respuesta se devuelve en formato JSON, con el número de clientes procesados, facturas creadas y pedidos consolidados.
Para probar de inmediato, abre la URL del cron con &force=1 en tu navegador: obtendrás el resumen JSON de la generación sin esperar al día programado.
Uso diario
Pestaña «Facturas recapitulativas»
Se añade una pestaña Facturas recapitulativas bajo Pedidos. Lista todas las facturas recapitulativas generadas, con el número, el cliente, el periodo, el número de pedidos, el total con IVA y el estado de envío del email. Cada fila permite descargar el PDF, reenviar el email o eliminar la factura.
Generación manual
En la parte superior de esta pestaña, un panel permite generar manualmente un periodo (mes y año, precargados con el mes anterior) para todos los clientes B2B o para un cliente concreto. Es útil para una recuperación puntual o para emitir la factura de un cliente bajo demanda.
Área de cliente
Los clientes profesionales disponen de un enlace «Mis facturas recapitulativas» en su cuenta, donde encuentran y descargan todas sus facturas consolidadas. Este enlace solo aparece para los clientes de los grupos B2B configurados.
Qué contiene la factura recapitulativa
Cada factura muestra: los datos de la tienda y la dirección de facturación del cliente (razón social, número de IVA), el detalle pedido por pedido (fecha, referencia, número de factura PrestaShop de origen, importe), el desglose de IVA por tipo (productos y gastos de envío), con una línea de ajuste de redondeo si aparece una pequeña diferencia, luego los totales base / IVA / total con IVA, y por último tus condiciones de pago y notas legales.
Los pedidos se agrupan por moneda: un cliente que haya pedido en dos monedas diferentes en el mismo periodo recibe una factura recapitulativa por moneda.
Garantías y límites
- Sin duplicados: cada pedido se registra en una tabla de enlace donde es único. Un pedido ya consolidado nunca puede reutilizarse en otra factura recapitulativa.
- Eliminación: eliminar una factura recapitulativa libera sus pedidos, que vuelven a ser elegibles para una nueva consolidación. Sin embargo, el número eliminado no se reasigna.
- Facturas individuales: siguen visibles en el historial de pedidos del lado del cliente; solo se aligera el email. Ocultarlas rompería la contabilidad de PrestaShop.
- Desglose de IVA: la distribución por tipo se reconstruye a partir de las líneas de pedido y del envío; puede ser aproximada en el raro caso de que un mismo producto acumule varias tasas apiladas.
Compatibilidad
Facturación Recapitulativa es compatible con PrestaShop 8.0 a 9.x, tanto en tienda única como en multitienda, en los cinco idiomas del catálogo (francés, inglés, español, alemán, italiano), sin ninguna dependencia de Composer.