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.
Al cambiar el tipo en “Listado de:”, el sistema ajusta automáticamente las columnas visibles del detalle. Para Notas de venta se muestran campos adicionales: Factura, Código recepción, Caja/Banco, Crédito, Nota de salida.

📋 Detalle (grilla de resultados)

Columnas principales y su función:

ColumnaDescripción / acciónDisponibilidad
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.
Restricción: si una nota de venta tiene factura en línea vigente, no se permite eliminar o anular hasta anular primero la factura.

↔️ 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.