Albarán de entrega agrupado

El módulo hace un solo documento para varias expediciones validadas del mismo cliente. Lee las expediciones y nunca las modifica.

Crear un albarán agrupado

1. En ProductosEnvíosListado, marque las expediciones del cliente.
2. Elija la acción masiva «Albarán de entrega agrupado (un solo PDF)».
3. Una pantalla recuerda el cliente y las expediciones seleccionadas: pedido, referencia del cliente, fecha de entrega prevista, número de líneas, estado. Añada si hace falta una nota, que se imprime en el documento, y después «Crear el albarán de entrega agrupado».

El PDF se crea enseguida. Antes, el módulo comprueba tres cosas:

• hay al menos una expedición seleccionada;
• ninguna está en borrador (si no, el mensaje indica su referencia);
• todas corresponden al mismo cliente.

Si falla una comprobación, no se crea nada y se muestra el motivo.

El documento

• Cabecera: el logotipo de su empresa (si no, su nombre), el título «Albarán de entrega agrupado», la referencia BLGyymm-NNNN, la fecha, el número de expediciones y el número de página.
• Un bloque «Emisor» con la dirección de su empresa; un bloque «Dirección de envío» con el contacto de envío de la primera expedición o, si no lo hay, la dirección del cliente.
• Un bloque por expedición, por orden de fecha de entrega prevista (fecha de creación si no la hay): «Envío – Pedido (Ref. cliente) – fecha».
• Para cada línea: referencia, descripción, cantidad pedida, cantidad enviada y peso (peso del producto × cantidad enviada).
• Abajo: cantidad total entregada, peso total cuando las líneas tienen peso, su nota, y un recuadro «Recibido en buen estado el: / Nombre y firma:».

En varias páginas, la cabecera de página y la cabecera de la tabla se repiten, y la expedición cortada por el salto de página se recuerda con «(continuación)».

El idioma del PDF

El documento se redacta en el idioma indicado en la ficha del cliente o, si no lo hay, en el del usuario. Las etiquetas propias del módulo (título, totales, recuadro de firma) existen en francés, inglés, alemán y español; para los demás idiomas, están en inglés.

Encontrar un albarán agrupado

• La ficha del albarán agrupado muestra el cliente, la fecha, la nota, el enlace al PDF y las expediciones, con los botones «Descargar el PDF», «Regenerar el PDF» (después de modificar una expedición) y «Eliminar».
• ProductosEnvíos«Albaranes de entrega agrupados»: el listado de todos los albaranes.
• En la ficha de cada expedición, una línea «Albarán de entrega agrupado» enlaza con el albarán o los albaranes que la contienen.

El PDF hecho para tres expediciones de una tienda de alimentación ficticia: un bloque por expedición, con su pedido, su referencia del cliente y su fecha, y después las cantidades y los pesos. Abajo, la cantidad total entregada (116), el peso total (71,6 kg), la nota «Livraison hebdomadaire - quai 2» y el recuadro de firma.

En el listado de envíos, en Dolibarr 24.0.1, las tres expediciones del cliente están marcadas. La acción «Albarán de entrega agrupado (un solo PDF)» se añade a las acciones propias de Dolibarr, debajo de «Fusión PDF».

La ficha del albarán agrupado BLG2610-0009: cliente, fecha, nota, enlace al PDF, las tres expediciones con su pedido, su referencia del cliente y su fecha de entrega prevista, y los botones para descargar, regenerar y eliminar.

Ninguno: el módulo no tiene página de configuración. El PDF usa el logotipo y la dirección de su empresa, y el formato de papel y los márgenes definidos en Dolibarr.

• Dos permisos propios: «Ver y descargar los albaranes de entrega agrupados» y «Crear, regenerar y eliminar los albaranes de entrega agrupados».
• Sin el segundo permiso, la acción masiva no aparece en el listado de envíos, y la ficha del albarán agrupado solo muestra el botón de descarga. Se rechazan la creación, la regeneración y la eliminación.
• Además, el permiso de Dolibarr: el listado, la ficha del albarán agrupado y su PDF exigen también el permiso para consultar las expediciones.
• Comerciales limitados a sus clientes: sin el permiso de Dolibarr para ver todos los terceros, un usuario solo ve, descarga y crea los albaranes agrupados de los clientes de los que es el comercial asignado, como en los listados de Dolibarr; se rechaza un enlace manipulado hacia otro albarán.
• Expediciones solo en lectura: el módulo no modifica ninguna expedición ni ningún pedido.
• Eliminación confirmada: eliminar un albarán agrupado pide confirmación; se eliminan el albarán, sus líneas y su PDF, y las expediciones quedan intactas.
• Un albarán agrupado y sus expediciones se registran en una sola transacción: si falla la escritura en la base de datos, no se registra nada.

• La carpeta del módulo, dolixblgroupe, para colocar en htdocs/custom/ o para instalar desde el zip.
• Cuatro idiomas: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
• Un README.md y un historial de versiones (ChangeLog.md) en la carpeta del módulo.
• Licencia GPL v3 o posterior, código fuente completo y legible.

• Se añaden dos tablas: llx_dolixblg (un albarán agrupado: referencia, cliente, nota, usuario, fecha de creación, entidad) y llx_dolixblg_exp (las expediciones de cada albarán, en el orden de impresión).
• El PDF se guarda en documents/dolixblgroupe/, en una carpeta con el nombre de la referencia del albarán.
• Las expediciones, sus líneas y los pedidos solo se leen. No se modifica ningún archivo de Dolibarr.
• Al desactivarlo, el menú, la acción masiva y la línea en la ficha de la expedición desaparecen. Las tablas llx_dolixblg y llx_dolixblg_exp y los PDF ya creados no se eliminan.