Commerce Invoice
Proporciona funcionalidad de generación, gestión y exportación a PDF de facturas para pedidos de Drupal Commerce.
commerce_invoice
Instalar
composer require 'drupal/commerce_invoice:8.x-2.2'
Overview
Commerce Invoice es una solución integral de facturación para Drupal Commerce que permite a las tiendas generar, gestionar y distribuir facturas para los pedidos de clientes. El módulo crea entidades Invoice e Invoice Item que capturan la información del pedido en un momento específico, asegurando la integridad de los datos y el cumplimiento de los requisitos contables.
El módulo se integra con Entity Print para la generación de PDF, soporta múltiples tipos de facturas (incluyendo notas de crédito para reembolsos) y proporciona flujos de trabajo personalizables para la gestión del ciclo de vida de las facturas. Las facturas pueden generarse automáticamente cuando se realizan pedidos o crearse manualmente por los administradores. Se pueden enviar notificaciones por correo electrónico con archivos PDF adjuntos a los clientes cuando las facturas son confirmadas o pagadas.
Las capacidades principales incluyen patrones de numeración de facturas personalizables, términos de pago y fechas de vencimiento configurables, soporte para logotipos, generación de facturas multilingües y un sistema de archivos privado para el almacenamiento seguro de PDF.
Features
- Entidad de factura con gestión completa del ciclo de vida a través de flujos de trabajo de máquina de estados personalizables (borrador, pendiente, pagada, reembolso_pendiente, reembolsada, cancelada)
- Generación automática de facturas cuando se realizan pedidos, configurable por tipo de pedido
- Creación manual de facturas a través de la interfaz de administración con control total sobre los elementos de factura y ajustes
- Soporte para notas de crédito para gestionar reembolsos y devoluciones con secuencia de numeración separada
- Generación de facturas en PDF usando la integración con Entity Print con soporte para el motor Php Wkhtmltopdf
- Patrones de numeración de facturas personalizables usando el módulo Commerce Number Pattern
- Sistema de confirmación por correo electrónico con PDF adjunto cuando las facturas son confirmadas o pagadas
- Configuración del tipo de factura incluyendo logotipo, términos de pago, cálculo de fecha de vencimiento y texto de pie de página
- Soporte de Token en términos de pago y texto de pie de página para contenido dinámico
- Almacenamiento seguro de PDF en el sistema de archivos privado con subdirectorios configurables por tipo de factura
- Soporte multilingüe para facturas con generación automática de traducciones
- Soporte para facturas parciales - genera múltiples facturas para el mismo pedido
- Resumen de totales de factura con subtotal, desglose de ajustes y precio total
- Vista de factura para el cliente con capacidad de descarga
- Integración con Commerce Log para seguimiento de actividad de facturas
Use Cases
Generación automática de facturas al realizar pedidos
Configure los tipos de pedido para generar facturas automáticamente cuando se realizan pedidos. Navegue al formulario de edición del tipo de pedido, habilite 'Facturar pedidos de este tipo', seleccione el tipo de factura y marque 'Facturar cuando se realiza el pedido'. Las facturas se crearán automáticamente con todos los elementos y ajustes del pedido.
Creación manual de facturas para facturación personalizada
Para pedidos que requieren facturación personalizada, los administradores pueden crear facturas manualmente desde la pestaña de Facturas del pedido. Esto permite modificar los elementos de factura, ajustes y cantidades antes de generar la factura. Útil para facturación parcial o acuerdos de facturación personalizados.
Nota de crédito para reembolsos
Al procesar reembolsos, cree una nota de crédito desde la pestaña de Notas de crédito del pedido. Las notas de crédito usan una secuencia de numeración separada y pueden usarse incluso para pedidos cancelados. Ayudan a mantener registros contables adecuados para artículos devueltos.
Envío de confirmaciones de factura
Habilite 'Enviar confirmación' en los ajustes del tipo de factura para enviar automáticamente correos a los clientes cuando las facturas son confirmadas o pagadas. El correo incluye el PDF de la factura como archivo adjunto. Opcionalmente configure un correo CCO para recibir copias de todas las confirmaciones.
Personalización de la apariencia de la factura
Suba un logotipo, configure los términos de pago y añada texto de pie de página en los ajustes del tipo de factura. Use tokens como [commerce_invoice:invoice_number] para contenido dinámico. Sobrescriba las plantillas Twig para control total sobre el diseño y estilo de la factura.
Facturas multilingües
Para tiendas multilingües, habilite la generación de traducción en los ajustes de idioma del tipo de factura. Las facturas se generarán automáticamente en todos los idiomas disponibles, con títulos de productos y contenido traducido basándose en las preferencias de idioma del cliente.
Tips
- Configure la ruta del sistema de archivos privado antes de habilitar el módulo para asegurar la seguridad adecuada del almacenamiento de PDF
- Use la opción 'per_store_sequence' en los patrones de numeración para numeración de facturas separada por tienda
- Personalice las plantillas de facturas copiando commerce-invoice.html.twig a su tema y modificando el diseño
- El archivo de factura se regenera cuando cambia el estado de la factura (por ejemplo, de pendiente a pagada) para reflejar el estado actualizado
- Use tokens en los términos de pago y texto de pie de página para contenido dinámico como fechas de vencimiento e información de la tienda
- Para facturación parcial, el módulo automáticamente rastrea las cantidades ya facturadas y previene la sobre-facturación
Technical Details
Admin Pages 7
/admin/commerce/invoices
Página principal de listado de facturas que muestra todas las facturas de todas las tiendas. Muestra número de factura, cliente, tienda, estado, precio total y acciones. Proporciona capacidades de filtrado y paginación.
/admin/commerce/invoices/{commerce_invoice}
Vista detallada de una factura individual que muestra elementos de factura, totales, información del cliente, información de facturación y botones de transición de estado. Incluye registro de actividad si Commerce Log está habilitado.
/admin/commerce/config/invoice-types
Lista todos los tipos de factura disponibles. Permite crear, editar y eliminar tipos de factura. Los tipos predeterminados son 'Factura' y 'Nota de crédito'.
/admin/commerce/config/invoice-types/{commerce_invoice_type}/edit
Formulario de configuración para ajustes del tipo de factura incluyendo flujo de trabajo, numeración, logotipo, notificaciones por correo electrónico y términos de pago.
/admin/commerce/config/invoices/invoice-item-types
Lista los bundles de elementos de factura que se crean dinámicamente basándose en los tipos de entidades comprables en el sistema.
/admin/commerce/orders/{commerce_order}/invoices
Pestaña en la página de vista del pedido que lista todas las facturas generadas para este pedido. Permite crear nuevas facturas para el pedido.
/admin/commerce/orders/{commerce_order}/credit-memos
Pestaña en la página de vista del pedido que lista todas las notas de crédito generadas para este pedido. Permite crear nuevas notas de crédito para reembolsos.
Permisos 8
Troubleshooting 5
Asegúrese de que Entity Print esté correctamente configurado con un motor de PDF funcional. Navegue a /admin/config/content/entityprint y configure los ajustes del motor de PDF. Se recomienda Php Wkhtmltopdf. También verifique que el sistema de archivos privado esté correctamente configurado en settings.php.
Verifique que el pedido no esté en estado borrador y tenga un precio total. Para facturas, los pedidos no deben estar cancelados. Para notas de crédito, se permiten pedidos cancelados. También verifique que el monto total facturado no exceda el total del pedido.
Asegúrese de que 'Enviar confirmación' esté habilitado en los ajustes del tipo de factura. Se requiere un módulo como Symfony Mailer para soporte de correos HTML. Verifique que la factura tenga una dirección de correo electrónico de cliente válida.
Verifique que el archivo del logotipo exista y sea accesible. Compruebe los permisos del archivo y asegúrese de que la URL del logotipo sea absoluta. Algunos motores de PDF pueden tener problemas con ciertos formatos de imagen - intente convertir a PNG.
Verifique la configuración del patrón de numeración en /admin/commerce/config/number-patterns. Verifique que el patrón esté correctamente asignado al tipo de factura. Limpie las cachés si los números parecen estar atascados.
Security Notes 4
- Los PDF de facturas se almacenan en el sistema de archivos privado para prevenir acceso no autorizado
- El permiso 'administer commerce_invoice_type' está marcado como acceso restringido debido a su naturaleza sensible
- Los correos de confirmación de factura incluyen el PDF de factura del cliente - asegure la seguridad del correo electrónico para datos financieros sensibles
- El permiso 'view own commerce_invoice' permite a los clientes ver solo sus propias facturas a través de una página de usuario dedicada