================================================================================
  MANUAL DE AYUDA — EDITOR DE ALBARANES DE VENTA
================================================================================

1. DESCRIPCIÓN Y PROPÓSITO GENERAL
--------------------------------------------------------------------------------
Formulario de edición y creación de albaranes de venta a clientes. Permite gestionar los datos de cabecera del albarán (cliente, número, fecha, serie, forma de pago), las líneas de detalle con artículos, precios, descuentos y lotes, el cálculo automático del desglose de bases e IVA, y la gestión logística y de intercambio electrónico EDI (EDICOM DESADV) con árbol jerárquico de bultos y palets SSCC-18.

2. GUÍA DE USO Y PROCEDIMIENTO PASO A PASO
--------------------------------------------------------------------------------
▶ Paso 1: Datos de Cabecera: Seleccione el Cliente, Sucursal de Destino, Serie, Fecha de emisión y Forma de Pago. Si el albarán ya fue facturado, se mostrará el número de factura con enlace directo.
▶ Paso 2: Líneas de Detalle:
   - Pulse "Añadir Artículo" ([+]) para incorporar productos, indicando cantidad, bultos, precio y descuento.
   - Asigne el número de Lote y Fecha de Caducidad en las líneas para garantizar la trazabilidad alimentaria.
   - Menú contextual sobre líneas: Haga clic derecho sobre cualquier línea y seleccione "📦 Mostrar trazabilidad completa de Lote" para abrir directamente la ficha del lote y consultar todas sus salidas comerciales.
▶ Paso 3: Desglose de Impuestos y Totales: En el panel inferior se muestra el desglose automático por tipos de IVA (Base Imponible, % IVA, Cuota IVA y Total).
▶ Paso 4: Logística y Pestaña EDI (Información EDI / Bultos):
   - Muestra el estado de transmisión EDI, ID de Mensaje EDICOM, Fecha/Hora de envío, Ref. de Pedido del Cliente y SSCC global.
   - En el árbol jerárquico visual de bultos (Palets SSCC -> Cajas DUN-14 -> Lotes/Unidades), gestione el desglose de empaquetado logístico para las plataformas de distribución.
   - La carga del árbol se realiza bajo demanda (*Lazy Loading*) para maximizar la fluidez.
▶ Paso 5: Guardar Albarán: Pulse "Guardar" ([💾]) para persistir la cabecera, líneas y asignación de bultos en la base de datos.

3. GUÍA DE CAMPOS Y PESTAÑAS PRINCIPALES
--------------------------------------------------------------------------------
• Pestaña General / Detalle:
  - Serie / Número / Fecha: Identificación del documento.
  - Cliente / Destino: Destinatario fiscal y logístico de la entrega.
  - Facturado / Factura: Indicador y número de factura vinculada (doble clic para abrir).
  - Forma de Pago: Condición de cobro.
  - Rejilla de Líneas: Artículos, descripciones, cantidades, bultos, precios, descuentos y lotes.
  - sgIvaDesglose: Desglose en tiempo real de bases, cuotas y tipos de IVA aplicados.
• Pestaña Información EDI:
  - Estado de Envío EDI: PENDIENTE, ENVIADO, PROCESADO, ERROR.
  - ID de Mensaje y Fecha/Hora de Envío.
  - Referencia de Pedido Cliente y Código SSCC de paletización.
  - Árbol de Bultos: Estructura multinivel de palets y cajas para el aviso de expedición DESADV.

4. ACCIONES Y BOTONES DE LA BARRA DE HERRAMIENTAS
--------------------------------------------------------------------------------
* [💾] Guardar      : Valida y almacena el albarán en la base de datos.
* [✖] Cancelar     : Descarta las modificaciones no guardadas.
* [➕] Añadir       : Inicia la creación de un nuevo albarán en blanco.
* [🗑] Eliminar     : Elimina el albarán activo (si no está facturado).
* [⏮] Primero      : Salta al primer albarán del ejercicio.
* [◀] Anterior     : Retrocede al albarán anterior.
* [▶] Siguiente    : Avanza al albarán posterior.
* [⏭] Último       : Salta al último albarán.
* [🚪] Salir        : Cierra la ventana del editor.
* [❓] Ayuda        : Muestra este manual interactivo.

5. ATAJOS DE TECLADO Y NAVEGACIÓN RÁPIDA
--------------------------------------------------------------------------------
• [Enter]         : Confirma el valor y avanza al siguiente campo.
• [Escape]        : Cierra el editor o cancela la edición.
• [Espacio]       : Alterna checks en casillas.
• [F5]            : Refresca el albarán y sus líneas desde el servidor.

6. REGLAS DE NEGOCIO Y NOTAS IMPORTANTES
--------------------------------------------------------------------------------
⚠ Integridad de Lotes: Toda venta de productos elaborados debe registrar su lote para cumplir con los estándares de calidad IFS y trazabilidad alimentaria.
⚠ Lazy Loading EDI: El árbol de palets y bultos EDI solo se consulta al ingresar a la pestaña correspondiente, optimizando el rendimiento.
⚠ Protección de Albaranes Facturados: Si un albarán está marcado como facturado, sus campos quedan protegidos para evitar descuadres contables con la factura emitida.