Listado de documentos de ventas
Listado maestro–detalle de proformas, pedidos, notas de venta y devoluciones. Permite filtrar por fechas y cliente, seleccionar múltiples registros, paginar, imprimir/exportar a PDF, abrir factura/caja/crédito/nota de salida y ejecutar acciones masivas (eliminar, anular, habilitar) con control de permisos e integración contable.
📘 Propósito del formulario
El Listado de documentos de ventas centraliza la consulta y gestión de: proformas, pedidos, notas de venta y devoluciones. Es un formulario maestro–detalle desde el que puedes filtrar, seleccionar, paginar y ejecutar acciones por registro o en lote.
🗂️ Encabezado y selector “Listado de:”
- 📄 Listado de: combo superior para elegir Proformas, Pedidos, Notas de venta o Devoluciones.
- ➕ Nuevo: crea un documento del tipo actualmente seleccionado (valida módulo, permisos y límites de nube).
- 🔎 Buscar: texto libre por Cliente (Nombre o Contacto).
- ⏱️ Filtrado entre fechas: al activarlo aparecen Fecha inicio y Fecha fin (por defecto, últimos 7 días).
- 🔄 Actualizar: recarga la grilla aplicando los filtros vigentes.
- ❎ Cerrar: cierra el listado.
📋 Detalle (grilla de resultados)
Columnas principales y su función:
| Columna | Descripción / acción | Disponibilidad |
|---|---|---|
| Sel. A. | Columna auxiliar de selección (según parametrización) para operaciones específicas. | Todos |
| Contabilizado / Contabilizar | Marca del registro. Doble clic alterna el estado. Se usa para acciones masivas. | Todos |
| Nota de venta | Número correlativo. Clic abre el documento para edición (si tiene factura en línea, pide confirmación). Botón PDF exporta el documento a PDF. | Notas de venta |
| Factura | Nro. de factura relacionada. Clic abre/visualiza/impresión según corresponda. | Notas de venta |
| Código recepción | Identificador de recepción del SIAT para facturación en línea. Útil para seguimiento y auditoría. | Notas de venta con factura en línea |
| Crédito | Nro. de contrato de crédito asociado. Clic abre el Contrato de crédito. | Notas de venta |
| Pago en efectivo (Id1, Id2, Id3) | IDs de recibos de Caja/Banco vinculados a la venta (cuota inicial o pagos). Clic para abrir/crear recibo. | Notas de venta |
| Sal. alm. | Nro. de Nota de salida de almacén. Clic abre o genera la NS si hay ítems con control de inventario. | Notas de venta |
| Fecha / Hora | Fecha y hora del documento. | Todos |
| Crédito / Contado / Total | Totales monetarios del documento (según forma de pago) y el total general. | Todos |
| NIT | NIT del cliente. | Todos |
✅ Selección y acciones masivas
- Seleccionar todo: marca la columna Contabilizar de los registros filtrados.
- Funciones (lista desplegable):
- 🗑️ Eliminar seleccionados: borra el documento y referencias (factura, caja, crédito, nota de salida) cuando aplique.
- 🚫 Anular seleccionados: cambia el estado a Anulado y anula referencias asociadas.
- ✅ Habilitar seleccionados: revierte una anulación del documento y de sus referencias.
↔️ Paginación y rendimiento
En conexión con SQL Server, la lista usa paginación de 15 registros por página (controles Primero/Anterior/Siguiente/Último y el campo “Página: 1 de N”). En modo Access puro, la grilla se carga completa sin paginar.
🧰 Acciones rápidas por fila
- 🖨️ Imprimir (icono de impresora/lupa): vistas previas y reportes.
- 📄 PDF (en Nota de venta): exporta a
docu_nit{NIT}\notaVenta\notaVenta{Nro}.pdf. - 🏦 Caja/Banco: crea/abre el recibo asociado (requiere caja asignada al usuario).
- 💳 Crédito: abre el contrato de crédito (alta/edición/seguimiento).
- 📦 Nota de salida: abre o genera la NS si hay ítems con control de inventario.
- 📊 Contabilizar (doble clic): alterna la marca del registro actual.
🔐 Permisos y validaciones
- Licencia del módulo y permisos del usuario para agregar y acciones masivas.
- Comprobaciones automáticas: caja asignada, existencia de factura relacionada, existencia de NS, etc.
- Mensajes típicos: “Módulo no contratado”, “No se puede anular porque tiene factura en línea”, “El usuario no posee ninguna caja asignada”, “No corresponde nota de salida”.
🧠 Recomendaciones
- Define primero el tipo en “Listado de:” y luego aplica Buscar y Fechas.
- Para lotes, usa Seleccionar todo y después elige la opción en Funciones.
- Antes de eliminar/anular, verifica si hay Factura, Crédito, Caja/Banco o Nota de salida vinculados.
- Si trabajas con SQL Server, navega por páginas para mantener el rendimiento.