Importar Recibos

Esta funcionalidad permite cargar recibos de forma masiva a partir de un archivo Excel (.xls/.xlsx), en lugar de cargarlos uno por uno. El proceso valida cada fila antes de importar y muestra el resultado con observaciones; opcionalmente puede liquidar los recibos generados.

Se presenta como un asistente de 3 pasos (wizard): bienvenida, selección/validación del archivo y finalización.

1. Ingresá al sistema con tu usuario.
2. Abrí el menú Tesorería.
3. Buscá la opción Importar Recibos.

El punto exacto del menú depende de la configuración de su instalación.

La ventana (caption "Importación de Recibos") es un asistente con estas páginas:

El archivo Excel debe respetar el diseño de la plantilla. Columnas esperadas:

Opciones del paso 2:

Debe especificarse al menos un medio de pago por fila: ID_Caja, IDCuentaBancaria o Nro_Cta.

Al seleccionar el archivo, cada fila se valida y se muestra en la grilla con dos columnas clave:

Las filas con error se resaltan en color salmón. No se puede avanzar a la importación si hay filas con errores: hay que corregirlas en el Excel (o editar y revalidar) hasta que todas queden en verde.

Al confirmar e importar, el sistema guarda los recibos en paralelo y, al finalizar, muestra "Se ha finalizado la importación de Recibos." Cada fila actualiza su observación con el resultado ("Importado correctamente", o el error, y si corresponde "{Liquidada exitosamente!}").

1. Abrí Tesorería > Importar Recibos.
2. En la bienvenida, hacé clic en Descargar plantilla modelo y guardá el Excel.
3. Completá el Excel con tus recibos (una fila por recibo), respetando las columnas.
4. Hacé clic en Siguiente y luego elegí el archivo con el botón del campo Ubicación del archivo a importar.
5. Revisá la grilla: corregí las filas en salmón (mirá la columna Observaciones) hasta que todas estén en verde.
6. (Opcional) Tildá Liquidar Recibos automáticamente.
7. Hacé clic en Siguiente, confirmá la importación y esperá el mensaje de finalización.

• Descargá siempre la plantilla modelo y completá sobre ella: respeta los nombres de columna que el importador espera.
• No dejes filas en blanco ni caracteres extraños: el importador puede rechazar el archivo completo si no cumple el diseño.
• El Nro_Cta debe tener 8 dígitos y no puede ser una cuenta rubro; si usás caja o cuenta bancaria, dejá el otro medio en 0.
• Si tenés muchos errores de entidad por bajas/bloqueos y querés importar igual, usá Omitir validar la Entidad con criterio.
• La fecha con formato incorrecto se detecta como 01/01/1900: revisá el formato de fecha del Excel.

En el formulario FormTesoreria_Importador_Recibos no se invoca IsAllowedObject ni KeyLicences: no hay un permiso enforced dentro de esta pantalla. El acceso, si existe, se controla a nivel de menú.

Verificar contra el binario instalado: el acceso a esta pantalla puede gobernarse por el permiso del ítem de menú correspondiente.

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (FormTesoreria_Importador_Recibos, WinForms C# / Entity Framework).

Formularios principales

Permisos reales

Tablas de base de datos principales

Relación con otros módulos / manuales

Notas para soporte

• La plantilla se genera con RTF_LibraryNCG.DocumentFormat (worksheet "Recibos") y se guarda como Plantilla_ImportacionRecibos.xls.
• Validación por fila en Valid(...) (paralela vía Parallel.ForEach); errores comunes: fecha incorrecta (1900-01-01), especie/sucursal/entidad inválida, concepto vacío, sin medio de pago, Nro_Cta rubro o longitud distinta de 8.
• Guardado en SaveRecibos(...) (paralelo): arma clsRecibos, agrega detalle por banco/caja/cuenta, hace Save() y, si Liquidar está tildado, ejecuta setRelacion + Liquidar.
• Omitir validar la Entidad (chkOmitirEntidad) cambia el set de Ids consultado (no filtra bajas/bloqueos) y ajusta los mensajes de observación.
• Detalle técnico (verificar contra binario): existe un método duplicado SaveRecibosSalva (variante anterior, no usado por el wizard) y el callback de progreso en SaveRecibos se invoca con un ImportFichero vacío; el conteo de progreso es informativo. No afecta la importación.