Detalle
| Campo | Valor |
|---|---|
| Manual de Usuario | Actualización de Cheques Rechazados - Factoring |
| Módulo | Factoring |
| Ventana (nombre interno) | Actualización Cheques Rechazados |
| Tipo de proceso | Importación masiva de archivo |
Introducción
La opción Actualización de Rechazados permite cargar de manera masiva, a partir de un archivo, los datos de los cheques rechazados informados por una fuente externa (formato SVR). En lugar de registrar cada cheque rechazado de a uno, el sistema lee el archivo, valida la información y la envía automáticamente a la base de Plenario.
Esta herramienta está pensada para procesar lotes de cheques rechazados que llegan en un archivo con un formato fijo (cada línea del archivo representa un cheque, con sus campos ubicados en posiciones determinadas). Por eso es fundamental respetar el formato del archivo y el orden de las columnas.
Importante: el nombre interno de la ventana es "Actualización Cheques Rechazados". Es la misma función descrita en este manual.
Acceso al módulo
Se accede desde:
Menú principal → Factoring → Actualización de Rechazados
Pantalla principal
La ventana es sencilla y se divide en tres zonas:
| Campo | Descripción |
|---|---|
| Archivo | Ruta del archivo que se va a procesar. Se completa automáticamente al elegir el archivo con el botón .... |
| ... (Examinar) | Abre el cuadro de diálogo para buscar y seleccionar el archivo de actualización en el equipo. |
| Formatos Disponibles | Lista desplegable con el formato del archivo a importar. Por defecto está disponible el formato SVR (Sistema de Verificación de Riesgos). |
| Estado | Sector que muestra una barra de progreso indicando el avance del envío de los cheques durante el proceso. |
| Procesar | Botón de la barra superior que inicia la actualización masiva con el archivo seleccionado. |
Parámetros
El proceso se configura indicando el archivo a importar y su formato antes de iniciar la actualización:
| Parámetro | Descripción |
|---|---|
| Archivo | Archivo de actualización a procesar. Se selecciona con el botón ... y su ruta queda cargada en el campo Archivo. Es obligatorio: si está vacío, el botón Procesar no realiza ninguna acción. |
| Formatos Disponibles | Formato del archivo a importar. Por defecto SVR (Sistema de Verificación de Riesgos): archivo de texto con campos de posición fija, una línea por cheque rechazado. |
Importante: el formato SVR exige respetar exactamente las posiciones y longitudes de cada campo (banco, sucursal, número de cheque, CUIT, fechas, cuenta, motivo de rechazo y nombre del firmante).
Resultado del proceso
Antes de enviar los datos, el sistema realiza una serie de controles sobre el archivo:
| Acción | Descripción |
|---|---|
| Limpieza de caracteres | Reemplaza por espacios los caracteres "basura" que algunos sistemas dejan en las exportaciones, para evitar errores en el envío. |
| Validación de campos | Controla que cada línea respete las posiciones y longitudes esperadas (banco, sucursal, número de cheque, CUIT, fechas, cuenta, motivo de rechazo y nombre del firmante). |
| Validación de fechas | Verifica que las fechas tengan un formato válido. |
| Separación de registros | Los registros que pasan las validaciones se envían; los que no, quedan registrados en un archivo de log para su revisión. |
Al finalizar, el sistema muestra un mensaje informando el resultado de la actualización:
| Mensaje | Descripción |
|---|---|
| "La actualización fue exitosa" | Todos los cheques del archivo se enviaron correctamente. |
| "La operación se finalizó con algunos errores" | El proceso terminó, pero algunos cheques no pudieron actualizarse. Se muestra el detalle de los errores (línea, CUIT y nombre del firmante). |
| "El archivo tiene información que no se pudo actualizar" | Algunas líneas del archivo no superaron las validaciones de formato y quedaron registradas en el log (LogNoImportacion). |
Importante: si el archivo contiene información que no pudo actualizarse, al finalizar aparece el aviso "El archivo tiene información que no se pudo actualizar." y se genera un archivo de log (LogNoImportacion) con el detalle de las líneas con problemas, para que puedan corregirse y volver a procesarse.
Acciones disponibles
- Abrir la opción — Ingresar a Menú principal → Factoring → Actualización de Rechazados.
- Elegir el formato — En Formatos Disponibles verificar que esté seleccionado el formato correspondiente al archivo (SVR).
- Seleccionar el archivo — Presionar el botón ... junto al campo Archivo y buscar en el equipo el archivo a importar. Al confirmarlo, su ruta queda cargada en el campo Archivo.
- Procesar — Presionar el botón Procesar de la barra superior. El sistema valida el contenido del archivo y comienza a enviar los cheques a la base de Plenario.
- Seguir el avance — Observar la barra de progreso del sector Estado mientras se envían los registros.
- Leer el resultado — Al finalizar, el sistema muestra un mensaje informando si la actualización fue exitosa o si finalizó con errores.
Importante: si el campo Archivo está vacío, el botón Procesar no realiza ninguna acción. Primero hay que seleccionar un archivo.
Renombrado automático del archivo
Una vez procesado, el sistema renombra el archivo original agregándole una marca con la fecha y hora (por ejemplo, agregando (old-dd-MM-aaaa-hh-mm) al nombre). Esto sirve para identificar fácilmente que ese archivo ya fue utilizado en una actualización y evitar procesarlo nuevamente por error.
Importante: si necesita volver a procesar un archivo ya usado, tenga en cuenta que su nombre habrá cambiado por la marca automática. Conviene trabajar siempre con una copia limpia del archivo original.
Ejemplo práctico
- La fuente externa (SVR) envía un archivo con los cheques rechazados de la jornada.
- El usuario ingresa a Menú principal → Factoring → Actualización de Rechazados y confirma que el formato seleccionado sea SVR.
- Presiona ..., ubica el archivo recibido en el equipo y lo selecciona; la ruta queda cargada en el campo Archivo.
- Presiona Procesar. El sistema limpia caracteres, valida posiciones y fechas, y comienza a enviar los cheques a la base de Plenario mientras avanza la barra del sector Estado.
- Al finalizar aparece el mensaje "La actualización fue exitosa" y el archivo original queda renombrado con la marca
(old-...)para indicar que ya fue procesado.
Consejos útiles
- Trabaje siempre con una copia limpia del archivo original: tras procesarlo, su nombre cambia por la marca automática
(old-...). - Verifique el formato (SVR) antes de procesar; si el archivo no respeta las posiciones, las líneas afectadas no se actualizan.
- Espere a que la barra de Estado finalice y lea el mensaje de resultado antes de iniciar otra operación.
- Si aparece el aviso de información no actualizada, revise el log (LogNoImportacion), corrija las líneas y vuelva a procesar solo esos registros.
Preguntas frecuentes
¿Qué formato de archivo necesito?
El formato disponible es **SVR** (Sistema de Verificación de Riesgos), un archivo de texto con campos de posición fija. Cada línea representa un cheque rechazado, con sus datos (banco, sucursal, número de cheque, CUIT, fechas, cuenta, motivo y firmante) ubicados en posiciones determinadas. Es importante que el archivo respete exactamente ese formato.Procesé el archivo y no lo encuentro con el mismo nombre. ¿Qué pasó?
Es normal. Luego de procesarlo, el sistema le agrega automáticamente una marca con la fecha y hora al nombre (por ejemplo `(old-...)`) para indicar que ya fue utilizado. El archivo sigue estando en la misma carpeta, solo cambió su nombre.Apareció un mensaje de que hubo información que no se pudo actualizar. ¿Qué hago?
El sistema genera un archivo de log (LogNoImportacion) con el detalle de las líneas que no superaron las validaciones. Revise esas líneas, corrija el formato o los datos según corresponda, y vuelva a procesar solo esos registros con un nuevo archivo.¿Puedo cancelar el proceso una vez iniciado?
El proceso se ejecuta automáticamente una vez presionado **Procesar** y muestra el avance en la barra de **Estado**. Conviene esperar a que finalice y leer el mensaje de resultado antes de realizar otra operación.El botón Procesar no hace nada.
Verifique que haya seleccionado un archivo con el botón **...**. Si el campo *Archivo* está vacío, el sistema no inicia el proceso.Permisos
| Permiso | Descripción |
|---|---|
| Acceso al menú Factoring | El usuario debe tener habilitado el módulo Factoring para visualizar la opción Actualización de Rechazados en el menú principal. |
| Acceso a la ventana | El usuario debe contar con permiso para abrir la ventana Actualización Cheques Rechazados y ejecutar el proceso de importación. |
Información técnica
Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (
frmGestion_Operaciones_Actualizacion_Cheques_Rechazados.vb).
Formularios principales
| Componente | Detalle |
|---|---|
| Formulario | frmGestion_Operaciones_Actualizacion_Cheques_Rechazados.vb (carpeta Gestion) |
| Proyecto | VisualPlenarioNET (VB.NET). Existe una copia en VisualPlenarioNET.Legacy idéntica; la activa es la del proyecto principal |
| Tipo de proceso | Importación masiva de archivo de texto de posición fija; el envío corre en un hilo aparte (STA) |
| Formato soportado | SVR (combo cboFormatos, único valor cargado: "SVR") |
Permisos reales
El control se hace en el llamador (
FormTile/frmNewMain), no dentro del form, conclsSeguridad.IsAllowedObject.
| Permiso | Habilita |
|---|---|
Factoring.Operaciones.ActualizacionChequesRechazados |
Abrir la ventana de Actualización de Cheques Rechazados |
Tablas de base de datos principales
No accede a la base directamente. Cada registro validado se envía por web service SOAP
WS_Plenario.ChequesRechazados_Add(...)(conapikey/hash MD5 del Id de empresa). La persistencia ocurre del lado del servicio.
| Componente | Contenido |
|---|---|
WS_Plenario.ChequesRechazados_Add |
Alta del cheque rechazado (firmante, banco, sucursal, cuenta, número, fechas, importe, motivo, Id_Cliente, hash) |
getMD5Hash(idCliente) |
Hash de integridad enviado al WS |
LogNoImportacion-(yyyy-MM-dd-hh-mm).txt |
Log de líneas no importadas, en Application.StartupPath |
Parseo del archivo SVR (posiciones fijas)
| Campo | Posición | Largo |
|---|---|---|
| Código de banco | 0 | 3 |
| Sucursal | 3 | 3 |
| Número de cheque | 6 | 13 |
| CUIT | 18 | 11 |
Fecha (formato YYYYMMDD) |
29 | 8 |
| Número de cuenta | 154 | 15 |
| Motivo de rechazo | 199 | 30 |
| Nombre del firmante | 232 | hasta 20 |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Rechazo y Recobro de Cheques en el Módulo de Factoring | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte (comportamiento real del código)
- Largo máximo de línea: 253 caracteres; líneas más largas se rechazan.
- Limpieza previa: reemplaza bytes basura
0x00y0xA5(exportaciones COBOL) por espacio, y deja solo letras/dígitos/puntuación/espacios. - Renombrado posproceso:
txtPath.Text.Insert(len-4, "(old-dd-MM-yyyy-hh-mm)")→ asume extensión de 3 caracteres (.dat). - Procesar con campo vacío no hace nada: rama
Elsevacía, sin aviso al usuario. - Bugs confirmados (informar a desarrollo):
- El combo carga
"SVR"pero el filtro del diálogo de archivos compara contra"SVG": el filtro.datnunca se aplica (código muerto). - Las 5 fechas enviadas al WS (emisión, depósito, depositado, acreditación, acreditado, rechazado) se extraen todas de la posición 29 (copy-paste); en la práctica todas valen la fecha de rechazo.
codPos,importeybrutose envían hardcodeados en 0 (no se extraen del archivo).- El form usa
_objConexion/_objUsuariosin declararlos localmente (dependencia implícita del form padre). - Reintento del WS sin demora; renombrado del archivo se dispara mientras el hilo de fondo aún puede estar leyéndolo.