================================================================================
  MANUAL DE AYUDA — PEDIDOS DE CLIENTES (EDI / VENTAS)
================================================================================

1. DESCRIPCIÓN Y PROPÓSITO GENERAL
--------------------------------------------------------------------------------
Este módulo proporciona la vista de rejilla (listado) de los Pedidos de Ventas de Clientes. Permite listar los pedidos de la empresa seleccionada, filtrarlos por estado, fecha y alfabéticamente por cliente, realizar búsquedas de texto e importar pedidos de clientes en formato XML de EDICOM, desde WooCommerce o desde PDF mediante IA.

2. GUÍA DE USO Y PROCEDIMIENTO PASO A PASO
--------------------------------------------------------------------------------
▶ Paso 1: Consulta y Búsqueda: Al acceder a la pantalla se muestra el listado general de registros. Escriba en el cuadro "Buscar..." para filtrar al instante por código, nombre o descripción.
▶ Paso 2: Filtros Avanzados: Utilice el panel lateral izquierdo para acotar el listado por Estado (Todos, Activo, Inactivo), por Rango de Fechas (Hoy, Última semana, Mes actual, Personalizado) o por Inicial Alfabética (A-Z).
▶ Paso 3: Crear Nuevo Registro: Pulse el botón "Añadir" ([+]) en la barra de herramientas superior para abrir la ficha de alta en blanco.
▶ Paso 4: Consultar o Modificar: Seleccione el registro deseado en la cuadrícula y pulse "Editar" ([✎]) o haga doble clic sobre la fila para abrir su ficha completa.
▶ Paso 5: Eliminar Registro: Seleccione la fila que desea dar de baja y pulse "Eliminar" ([🗑]). El sistema solicitará confirmación previa.
▶ Paso 6: Imprimir / Exportar: Pulse "Imprimir" ([🖨]) para generar el informe oficial, listado en PDF o exportación a hoja de cálculo Excel.

3. GUÍA DE CAMPOS Y CONTROLES PRINCIPALES
--------------------------------------------------------------------------------
• Cuadro de Búsqueda Rápida: Permite localizar registros escribiendo cualquier coincidencia de texto.
• Filtro de Estado: Desplegable para alternar entre registros activos, inactivos o todos.
• Filtro de Rango de Fechas: Opciones predefinidas (Todos, Creados hoy, La última semana, El último mes, Personalizado) con selector de fechas.
• Selector Alfabético: Botones de acceso directo (0-9 y A-Z) para filtrar al instante por la letra inicial.
• Rejilla Principal: Cuadrícula interactiva con ordenación por columnas al hacer clic sobre su encabezado.

4. ACCIONES Y BOTONES DE LA BARRA DE HERRAMIENTAS
--------------------------------------------------------------------------------
* [+] Añadir       : Abre el formulario de alta para crear un nuevo registro.
* [✎] Editar       : Abre la ficha del registro seleccionado para consultar o modificar sus datos.
* [🗑] Eliminar     : Da de baja el registro seleccionado previa confirmación.
* [🖨] Imprimir     : Genera el informe oficial en PDF o exportación de datos.
* [❓] Ayuda        : Muestra este manual de usuario.
* [📥] Descargar EDI (WS): Descarga e integra pedidos pendientes desde el WebService de EDICOM.
* [📁] Importar EDI: Permite seleccionar e importar un fichero de pedido XML de EDICOM desde el disco.
* [🌐] Importar Web: Conecta con la tienda online WooCommerce para descargar pedidos de clientes.
* [📄] Importar PDF (IA): Analiza mediante Inteligencia Artificial pedidos en formato PDF y extrae sus líneas automáticamente.

5. ATAJOS DE TECLADO Y NAVEGACIÓN RÁPIDA
--------------------------------------------------------------------------------
• [Enter]         : Confirma la selección, abre la ficha o avanza al siguiente campo.
• [Escape]        : Cierra la ventana actual o cancela la edición en curso.
• [Espacio]       : Marca o desmarca casillas de verificación (Checkboxes) en rejilla.
• [F5]            : Refresca inmediatamente los datos desde el servidor.
• [Flechas Arriba/Abajo] : Desplaza el cursor entre registros de la lista.

6. REGLAS DE NEGOCIO Y NOTAS IMPORTANTES
--------------------------------------------------------------------------------
⚠ Filtro de Fechas Server-Side: El filtro de fechas se aplica directamente en la cláusula WHERE de la SQL para minimizar la transferencia de datos en conexiones remotas. Cuando el usuario cambia el filtro temporal, fuerza una reconsulta completa al servidor.
⚠ Filtro Automático Client-Side: Utiliza las capacidades integradas en para filtrar localmente por estado y letra (alfabético). El filtro client-side de fechas del base es redundante pero no dañino.
⚠ Sin OnCalcFields: Los totales de unidades/bultos se calculan directamente en la SQL con un LEFT JOIN agregado, eliminando la necesidad de consultas N+1 por registro.
⚠ Relación Pedido-Albarán 1:1: Un pedido genera como máximo un único albarán, por lo que el JOIN es directo por id_pedido.