Transferencias Bancarias
No confundir con el módulo "Transferencias" (Cable/Cupón). Esta pantalla ejecuta transferencias bancarias online para PAGAR: desde una Orden de Pago se transfiere dinero desde las cuentas propias de la empresa (Banco Comafi, Comercio u otro banco que integre la API) hacia las cuentas de proveedores/clientes — para pagar facturas de proveedores u otorgamientos/liquidaciones de préstamos a clientes/comercios. El módulo de negocio de transferencias (tipo Cable/Cupón, con gastos/comisiones y conciliación) es otro: ver Transferencias (Cable y Cupón).
Detalle
|
|
| Tipo de documento |
Manual de Usuario |
| Módulo |
Tesorería |
| Formulario |
FormTransferenciasBancarias (caption "Transferencias Bancarias") |
| Tipo de pantalla |
ABM + proceso online (ejecuta transferencias contra API bancaria) |
Introducción
Transferencias Bancarias permite crear, gestionar y ejecutar transferencias bancarias online contra el servicio del banco (integración REST tipo Comafi). Sobre cada transferencia se puede consultar su estado, ver el balance de la cuenta, previsualizar y enviar por mail el comprobante, y consultar los logs/respuestas del servicio.
Es a la vez un ABM (alta/baja/modificación de transferencias) y un módulo de proceso, ya que la confirmación dispara la operación contra la API del banco y devuelve un resultado por cada registro.
Acceso al módulo
Menú principal → Tesorería → Transferencias Bancarias (btnTeso_TransBancaria). El formulario se abre embebido en el panel de la aplicación (DockPanel) y hereda de FrmResult (patrón estándar de grilla con búsqueda).
Relación con Órdenes de Pago
El uso típico de este módulo es pagar ejecutando la transferencia desde una Orden de Pago: cada transferencia bancaria se vincula al comprobante OP (u RC) que la origina, y se ejecuta desde las cuentas propias de la empresa hacia la cuenta de la entidad destino. Esto cubre:
| Caso |
Qué se paga |
| Proveedores |
Facturas de compra liquidadas en una Orden de Pago |
| Clientes / Comercios |
Otorgamientos y liquidaciones de préstamos a clientes o comercios |
Requisito: la transferencia vinculada a una OP/RC sólo puede confirmarse online una vez que el comprobante OP/RC está liquidado. Las cuentas propias y las credenciales del banco (Comafi / Comercio / otro que integre la API) se configuran en el setup correspondiente.
Pantalla principal
Grilla (gdvTransferenciasBancarias) con las transferencias. Las filas con estado de error (Id_Estado = 4) se muestran en rojo. La grilla soporta selección múltiple para procesar varios registros a la vez.
El menú contextual de la grilla incluye, además de las acciones estándar, las opciones Ver (última respuesta) y Descarga (comprobante).
Filtros de búsqueda
El panel de búsqueda permite filtrar por:
- Rango de fechas (control
uC_Fecha_Rango1: activación + Desde / Hasta)
- Estado de la transferencia (combo cargado desde
_manager.Estados)
El botón Buscar ejecuta la consulta. El check "Limpiar parámetros" reinicia los filtros.
Resultados
La grilla muestra las transferencias con sus datos de origen/destino (banco destino, CUIT, CBU/CVU/Alias), monto, estado y fechas. Estados de transferencia (EnumTransferenciaEstados): Pendiente, Completada, etc. Al procesar, se abre un formulario de resultados (FormTransferenciasBancarias_Resultado) con el detalle por registro (éxito/error y mensaje).
Acciones disponibles
- Nuevo: abre
FormTransferenciasBancarias_AddMod para crear una transferencia.
- Modificar: edita la transferencia seleccionada (doble clic en la grilla también).
- Eliminar: elimina la transferencia. No se permite si ya fue procesada (tiene fecha de transferencia) o si está vinculada a un comprobante OP/RC.
- Procesar / Confirmar: ejecuta online las transferencias seleccionadas contra el banco. Las vinculadas a OP/RC no liquidadas se rechazan con mensaje. Muestra el formulario de resultados.
- Última respuesta: muestra el último JSON de respuesta del servicio para la transferencia.
- Ver logs: abre
FormTransferenciasBancarias_Log con el historial de la transferencia.
- Consultar estado: consulta online el estado actual de la transferencia en el banco.
- Consultar balance de cuenta: muestra CBU, número de cuenta y saldo de la cuenta bancaria.
- Ver cuenta corriente: abre la cuenta corriente del cliente/proveedor/inversor asociado.
- Previsualizar comprobante: muestra el PDF del comprobante de transferencia (
FormPdfViewer).
- Enviar comprobante por mail: envía el PDF del comprobante por email a la entidad.
- Actualizar transferencia: regenera el
Transfer_Id y resetea el estado de respuesta para casos de error (sólo si no está aprobada/completada/en progreso).
- Consultar estado del servicio: verifica el estado del servicio online del banco.
Ejemplo práctico
- En Transferencias Bancarias se presiona Nuevo y se carga la transferencia (entidad destino, CBU/CVU/Alias, monto).
- Se selecciona el registro (o varios) y se presiona Procesar/Confirmar.
- El sistema ejecuta las transferencias online contra el banco y abre la ventana de resultados con el estado de cada una.
- Para una transferencia completada, se usa Previsualizar comprobante para ver el PDF, o Enviar comprobante por mail para remitirlo a la entidad.
- Si una transferencia quedó en error, se puede usar Consultar estado o Actualizar transferencia para reintentarla.
Consejos útiles
- Una transferencia vinculada a una OP/RC debe tener el comprobante liquidado antes de poder confirmarse online.
- No se puede eliminar una transferencia ya procesada ni una vinculada a un comprobante OP/RC.
- Si una transferencia muestra error (fila roja), revisá la última respuesta y los logs antes de reintentar; Actualizar transferencia sólo aplica a estados que aún permiten reintento.
- El comprobante se obtiene primero de la base de datos; si no está, se solicita en línea al banco (Base64) y se convierte a PDF.
Preguntas frecuentes
¿Por qué no puedo confirmar una transferencia vinculada a una OP?
Porque primero debe liquidarse el comprobante OP/RC asociado. El sistema rechaza esos registros con el mensaje "Debe liquidar primero el comprobante OP/RC para confirmar la transferencia online".
¿Por qué no puedo eliminar una transferencia?
Si ya fue procesada (tiene fecha de transferencia) o está vinculada a un comprobante OP/RC, no se permite eliminarla.
¿Qué hace "Actualizar transferencia"?
Regenera el identificador `Transfer_Id` (GUID nuevo) y resetea el estado de respuesta para poder reintentar una transferencia con error. No funciona si el estado del banco es APPROVED, PENDING_REVISION, COMPLETED, IN_PROGRESS o DELAYED.
No aparece el comprobante de la transferencia.
La transferencia debe estar procesada/completada. Si no está en la base, el sistema intenta obtenerlo del banco; si tampoco responde, avisa que no se pudo obtener el comprobante.
¿Las filas rojas qué significan?
Indican transferencias en estado de error (Id_Estado = 4). Revisá la última respuesta y los logs.
Permisos
Para abrir el módulo se requiere Tesoreria.TransferenciasBancarias.Busquedas. Cada acción valida su propio permiso mediante IsAllowedObject.
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form |
Rol |
FormTransferenciasBancarias |
Pantalla principal: búsqueda y gestión (caption "Transferencias Bancarias") |
FormTransferenciasBancarias_AddMod |
Alta y modificación de una transferencia |
FormTransferenciasBancarias_Resultado |
Resultado del procesamiento online por registro |
FormTransferenciasBancarias_Log |
Logs / historial de la transferencia |
Bancos_Transferencias_Manager |
Manager: búsqueda, ejecución (EjecutarTransfers), estado, balance, comprobantes |
Permisos reales
| Permiso |
Acción |
Tesoreria.TransferenciasBancarias.Busquedas |
Abrir el módulo y buscar |
Tesoreria.TransferenciasBancarias.Nuevo |
Crear una transferencia |
Tesoreria.TransferenciasBancarias.Modificar |
Modificar / actualizar una transferencia |
Tesoreria.TransferenciasBancarias.Eliminar |
Eliminar una transferencia |
Tesoreria.TransferenciasBancarias.Procesar |
Procesar (ejecutar) la transferencia online |
Tesoreria.TransferenciasBancarias.VerLogs |
Ver log / última respuesta / estado / cuenta corriente |
Tesoreria.TransferenciasBancarias.PrevisualizarDocumento |
Previsualizar el comprobante |
Tesoreria.TransferenciasBancarias.EnviarComprobantePorMail |
Enviar el comprobante por email |
Tesoreria.TransferenciasBancarias.VerBalanceCuenta |
Ver el balance de la cuenta bancaria |
Tablas de base de datos principales
| Tabla |
Uso |
Bancos_Transferencias |
Cabecera de la transferencia (destino, CUIT, CBU/CVU/Alias, monto, estado, Transfer_Id, fechas, vínculo a OP/RC) |
Bancos |
Banco destino de la transferencia |
Clientes / Proveedores / Proveedores_Financieros |
Entidad destino (cliente, proveedor o inversor) |
OrdenesDePago / Recibos |
Comprobantes OP/RC vinculados a la transferencia |
Plenario_Operaciones_Log |
Log de operaciones (p. ej. actualización del Transfer_Id) |
Relación con otros módulos / manuales
Notas para soporte
- La ejecución se hace contra una API REST bancaria (integración tipo Comafi, clase
Rest_Comafi); requiere conectividad y credenciales del servicio configuradas.
- El estado del banco se mapea a
EnumTransferenciaEstados / Id_Estado; el valor 4 corresponde a error (fila roja), 1 = pendiente, 2 = completada.
- Las respuestas del servicio se guardan y pueden verse como JSON (Última respuesta) o en el log.
Ver también