← Índice de manuales
Manual funcional · Sistema Plenario v14

Importar cheques con IA en Liquidaciones de Factoring

El importador de cheques lee los cheques de los archivos que tengas —fotos, PDF de eCheq, la planilla del banco, un Word o un JSON—, los valida contra el sistema y te los muestra con un semáforo antes de agregarlos a la…

Módulo: FactoringVersión: 2.1Actualizado: 2026-10-06

Detalle

Campo Descripción
Manual de Usuario Importar cheques con IA en la liquidación de Factoring
Módulo Factoring
Pantalla Importador de cheques, que se abre desde la liquidación de cheques
Disponible desde Asistente IA v1.0.106 (changeset 23677); renovado en la v1.0.108 (changeset 23697); PDF largos en la v1.0.116 (changeset 23763)

Introducción

El importador de cheques lee los cheques de los archivos que tengas —fotos, PDF de eCheq, la planilla del banco, un Word o un JSON—, los valida contra el sistema y te los muestra con un semáforo antes de agregarlos a la liquidación. Ningún cheque entra sin pasar por esa revisión, y ninguno se descarta en silencio: si tiene un problema, queda a la vista con el motivo.

Reemplaza a la pantalla anterior "Agregar por IA". La lectura usa el modelo de IA configurado en el Asistente IA (el mismo proveedor, la misma clave y el mismo tope de gasto mensual): no hay una configuración aparte para cheques. Los JSON y las planillas que coinciden con una plantilla se leen sin IA, en segundos.

El mismo importador se usa desde el chat del Asistente: "leé estos cheques para el cliente X" o "liquidame estos cheques al 4 %" pasan por acá.

Acceso al módulo

  1. Abrí la liquidación — solapa Factoring → Liquidaciones, botón Nuevo (o modificá una liquidación de cheques todavía no confirmada).
  2. Elegí el cliente — el importador lo usa para validar (cheques repetidos, firmante igual al cliente, cartera, etc.).
  3. Abrí el importador — botón Importar cheques (IA) de la barra de la liquidación.

Otras formas de llegar:

  • Arrastrar y soltar archivos sobre la grilla de cheques de la liquidación. Si es un solo cheque sin errores, se abre directamente el alta del cheque precargada; en cualquier otro caso, el importador con los archivos ya cargados.
  • Desde el chat del Asistente: adjuntá los archivos y pedí "leé estos cheques para el cliente X" o "liquidame estos cheques". El Asistente los lee, te muestra el semáforo y abre el importador sobre una liquidación, respetando la tasa o los gastos que le pidas encima de las condiciones habituales del cliente. Ver Asistente IA.

Importante: leer fotos, PDF escaneados, Word o planillas sin plantilla usa IA y requiere la licencia del Asistente IA. Los JSON y las planillas que coinciden con una plantilla se leen sin licencia de IA.

Pantalla principal

Zona Qué muestra
Encabezado El cliente, con su CUIT y el modelo de IA. A la derecha, lo que falta para poder agregar (en rojo) o ✓ Listo para agregar (en verde), y el botón Agregar a la liquidación ›.
Barra de acciones Tres grupos: Traer (agregar archivos, agregar carpeta, pegar), Revisar (volver a leer, quitar, marcar revisados) y Más (preguntar al Asistente, copiar JSON, exportar a Excel). Los de Más son íconos: el tooltip explica cada uno.
CHEQUES La grilla, con un cheque por fila y su semáforo. Cualquier dato se puede corregir en la grilla y el cheque se vuelve a validar. Abierto desde la liquidación, suma las columnas Días, Interés y Neto calculadas con las condiciones de la liquidación.
ARCHIVOS Debajo de los cheques, la lista de archivos leídos y su estado.
CHEQUE SELECCIONADO La imagen del cheque (o del PDF), con Ver frente / Ver dorso cuando hay dorso, los avisos del cheque y la banda CMC7 con sus cinco partes: banco · sucursal · código postal · número · cuenta. La parte que no coincide con lo impreso se marca en ámbar; en un eCheq se ve su ID.
Barra de estado El resumen: cantidad de cheques, cuántos en rojo y en amarillo, y el total.

Vacía, la pantalla muestra solo la zona para soltar archivos, con los botones Elegir archivos y Pegar. Mientras lee aparecen el avance y el botón Cancelar lectura.

Parámetros

Lo que el importador sabe leer:

Origen Cómo se lee
Fotos (JPG, PNG, BMP, GIF, TIF) Con IA. Una foto puede traer varios cheques, y el frente y el dorso del mismo cheque se leen juntos.
PDF Constancias de eCheq y cheques escaneados, con todas sus páginas (escaneado, hasta 60). Con IA.
Excel o CSV del banco Si coincide con una plantilla incluida (la de Plenario o la de un banco), sin IA. Si no, la IA solo reconoce qué columna es cada dato y el resto se lee directo.
Word o TXT Con IA.
JSON Formato estándar Plenario.Cheques (o el formato anterior de 15 campos), sin IA. Sirve para pasar cheques entre sistemas o retomar una importación.

Un PDF con texto se lee entero, de a 6 páginas por consulta a la IA. Uno escaneado se lee hasta las primeras 60 páginas, de a 5; si tiene más, la lista de archivos avisa "Se leyeron las primeras 60 de N páginas (PDF escaneado): partí el archivo para leer el resto." y el archivo queda listo con lo leído. Mientras lee, el estado del archivo muestra por qué parte va, por ejemplo "consultando IA · las páginas 7 a 12 de 30".

La lectura queda guardada: si volvés a cargar el mismo archivo no se gasta IA otra vez. Volver a leer fuerza una lectura nueva.

Resultados

Cada cheque sale con un color:

Color Qué significa
🔴 Rojo Hay un problema que impide agregarlo, por ejemplo que ya está cargado o que el firmante está bloqueado. Hay que corregir el dato o quitar el cheque.
🟡 Amarillo Hay algo para mirar: una lectura dudosa, un firmante con rechazos, un cheque eliminado antes. Hay que revisarlo y marcarlo Revisado, que queda registrado a tu nombre.
🟢 Verde Sin observaciones.
ℹ️ Info Un dato para tener en cuenta que no frena nada: cheque al día, firmante nuevo dado de alta, gasto No a la Orden.

Qué controla, por grupo (el detalle de cada regla está en la información técnica):

Grupo Controles
Datos Faltantes; CUIT del firmante con dígito verificador válido; importe en números contra el de letras; lecturas dudosas; dígito verificador del recuadro y banda CMC7; banco y código postal existentes.
Fechas Vencido para presentar; pago a más de 360 días de la emisión; pago anterior a la emisión; emisión futura o muy vieja; depósito anterior a la fecha valor de la liquidación.
Firmante Bloqueado o dado de baja; cheques rechazados; mala calificación; cheques en cartera de otros clientes; parentesco o igual al cliente; rechazado por el Motor de decisión; nuevo o sin nombre.
Cheque Repetido en la importación o en la liquidación; ya existente en el sistema; denunciado en el BCRA; moneda distinta a la de la liquidación; No a la Orden; eliminado antes.
eCheq Estado (pendiente de aceptación o no liquidable); orden de no pagar; cesión o mandato vigente; endoso al cliente repudiado; ya cargado o eliminado antes.

Acciones disponibles

Acción Qué hace
Agregar archivos / Agregar carpeta Elige fotos, PDF, Excel, CSV, Word, TXT o JSON con cheques, o todos los archivos de una carpeta.
Pegar (Ctrl+V) Pega una imagen, archivos o un JSON de cheques.
Volver a leer Vuelve a leer desde cero los archivos de los cheques elegidos.
Quitar Saca de la importación los cheques elegidos.
Marcar revisados Da por revisados todos los amarillos. Queda registrado a tu nombre.
Elegir localidad Aparece cuando el código postal del cheque no está cargado: permite elegir la localidad correcta.
Preguntar al Asistente Le manda al Asistente el cheque elegido, con su imagen y sus avisos, para que lo explique o te ayude a corregirlo.
Copiar JSON Copia los cheques elegidos (o todos) en formato JSON.
Exportar a Excel Guarda la grilla como .xlsx.
Agregar a la liquidación › Agrega todos los cheques a la liquidación. Solo funciona cuando no queda ninguno en rojo y todos los amarillos están revisados; si no, el encabezado dice qué falta.

Importante: si cerrás el importador con cheques sin agregar, te pide confirmación antes de descartarlos.

Ejemplo práctico

Liquidar los cheques que el cliente mandó por WhatsApp (fotos y un PDF de eCheq):

  1. Abrí la liquidación — Factoring → Liquidaciones → Nuevo, y elegí el cliente.
  2. Abrí el importador — botón Importar cheques (IA) y arrastrá las fotos y el PDF a la zona para soltar.
  3. Mirá el semáforo — por ejemplo: 4 verdes, 1 amarillo ("Lectura dudosa del importe") y 1 rojo ("Ya está cargado en esta liquidación").
  4. Resolvé el rojo — elegí ese cheque y presioná Quitar.
  5. Revisá el amarillo — compará el importe con la imagen; si hace falta, corregilo en la grilla. Después Marcar revisados.
  6. Agregá — el encabezado muestra ✓ Listo para agregar: presioná Agregar a la liquidación ›.
  7. Guardá la liquidación — los cheques quedan en la grilla con el cálculo de siempre; revisá el neto y presioná Aceptar.

Consejos útiles

  • Sacá las fotos derechas, con buena luz y sin reflejos. Si el cheque tiene endosos, mandá también el dorso.
  • Para muchos cheques, la planilla del banco es lo más rápido: con una plantilla conocida se lee sin IA.
  • Si no entendés un aviso, elegí el cheque y usá Preguntar al Asistente.
  • Corregir un dato en la grilla vuelve a validar el cheque y le quita el "Revisado": revisalo de nuevo.
  • Usá Copiar JSON para guardar una importación y retomarla después con Pegar.

Preguntas frecuentes

¿Hay que configurar la IA para leer cheques? No. El importador usa la configuración del Asistente IA (proveedor, modelo y tope de gasto). La configuración anterior de cheques (IA.Cheques.*) y el servicio N8N ya no se usan.
¿Por qué no se habilita "Agregar a la liquidación"? Porque queda algún cheque en rojo o algún amarillo sin revisar. El encabezado dice exactamente qué falta, por ejemplo "Para agregar: corregí o quitá 1 en rojo y marcá como revisados 2 en amarillo".
El firmante no existe en el sistema, ¿qué pasa? Se da de alta solo, con el nombre que figura en el padrón (aviso informativo "Firmante nuevo"). Si no está en el padrón, el cheque queda en rojo para que completes el nombre en la grilla.
Un cheque sale "Denunciado en el BCRA", ¿es seguro? El control compara banco, sucursal, cuenta y número con la información del BCRA. Si figura denunciado, no se puede liquidar. Verificalo con el cliente antes de seguir.
En un eCheq dice que el tenedor no es el cliente. ¿Es un error? No necesariamente. Es un aviso informativo: la constancia puede ser anterior al endoso con el que el cheque le llegó al cliente. Sí avisa en amarillo si el endoso al cliente figura repudiado.
¿Por qué el Motor de decisión deja un cheque en rojo? Si el parámetro Factoring.Cheques.Firmante.Motor.Id tiene un motor configurado, el firmante se evalúa con él. Si el motor lo rechaza, el cheque queda en rojo con los motivos; si el motor no responde, queda en amarillo para revisarlo.
¿Puedo usar el importador sin la licencia de IA? Sí, para JSON y para planillas que coinciden con una plantilla. Las fotos, los PDF, los Word y las planillas desconocidas necesitan la licencia del Asistente IA.
¿Por qué la lectura sale con errores? Generalmente por fotos borrosas, torcidas o con reflejos. Corregí el dato en la grilla o sacá una foto mejor y usá Volver a leer.

Permisos

  • El importador se abre desde la liquidación de cheques: rigen los permisos de la liquidación (por ejemplo, Factoring.Liquidaciones.Busquedas.Nuevo_Cheque para crear una).
  • Leer con IA requiere la licencia del Asistente IA.
  • Desde el chat, el Asistente solo prepara la importación: los cheques los agrega el usuario desde la pantalla, con sus permisos.
  • Marcar un cheque como revisado queda registrado a nombre del usuario.

Información técnica

Basada en el análisis del formulario real de la v14 (changesets 23676, 23677, 23678, 23697 y 23699).

Formularios principales

Componente Detalle
FormImportadorCheques Importador (C#, VPNET_WinForms\Factoring). Recibe el contexto de la liquidación (cliente, especie, fecha valor, cheques ya cargados) y un simulador opcional para las columnas Días, Interés y Neto.
frmLiquidacionesCheques_AddMod Botón ttbtnLecturaPorIA ("Importar cheques (IA)") y arrastrar y soltar sobre la grilla. Con 1 cheque sin rojos abre frmCheques_AddMod precargado.
Tools del Asistente leer_cheques_de_archivo y nueva_liquidacion_cheques abren el importador precargado (ImportadorCheques.AbrirEnPantalla, con condiciones del pedido encima de las del cliente).

Managers y clases

Carpeta VPNET_DataModel\Manager\Factoring\ImportacionCheques\:

Clase Rol
ImportadorCheques Orquesta lectura → normalización → resolución → validación.
LectorArchivos Fotos, PDF (render con Pdfium), Excel/CSV/XLS, Word y TXT.
PlantillasPlanilla Plantillas de planilla incluidas (Plenario y bancos).
ExtractorLlm, AsistenteLlm, PromptsCheques Llamada al LLM con la configuración del Asistente; prompts versionados (la versión invalida la caché).
ConversorJson Formato Plenario.Cheques v1 y formato anterior de 15 claves.
NormalizadorCheque, ChequeUtil CMC7, dígitos verificadores, importes y fechas.
ResolutorCheques Firmante (alta con el padrón de InfoAPI GetAFIP_PadronFull), banco, localidad, denuncia BCRA (banco + sucursal + cuenta + número) y Motor de decisión.
ValidadorCheque Reglas del semáforo.
AuditoriaImportacion Registra la importación, sus eventos y el eCheq (InsertarECheq).

Reglas del semáforo

Regla Nivel Aviso
D01 Rojo Faltan datos obligatorios.
D03 Rojo El CUIT del firmante no es válido (dígito verificador).
D04 Amarillo El importe en números no coincide con el de letras (legalmente vale el de letras).
D05 Amarillo Lectura dudosa de un campo (confianza baja).
D06 Amarillo Control del dígito verificador del recuadro y de la banda CMC7.
D07 Rojo No existe un banco con ese código BCRA.
D08 Rojo El código postal no está cargado en Localidades (acción "Elegir localidad").
F00 Info El pago cae en día no hábil: el depósito se corre.
F01 Rojo Vencido para presentar (más de 30 días).
F02 Info Cheque al día.
F03 Rojo Pago diferido a más de 360 días de la emisión.
F04 Rojo La fecha de pago es anterior a la de emisión.
F05 Amarillo La fecha de emisión es posterior a la fecha de trabajo.
F06 Amarillo Emitido hace más de N días (Factoring.Cheques.ValidarFechaEmisionCantDiasAnteriores, 30).
F08 Rojo La fecha de depósito es anterior a la fecha valor de la liquidación.
R01 / R02 Rojo Firmante bloqueado / eliminado.
R03 / R04 / R05 Amarillo Firmante con rechazos / con mala calificación / con cheques de otros clientes en cartera.
R06 Amarillo Parentesco entre firmante y cliente.
R07 Rojo / Amarillo El Motor de decisión rechazó al firmante / no se pudo evaluar.
R08 Amarillo El firmante (librador) es el propio cliente.
R09 Info Firmante nuevo dado de alta.
R10 Rojo Firmante no encontrado ni en la base ni en el padrón: completar el nombre.
R12 Rojo CUIT válido con nombre pero sin firmante en el sistema (falló el alta automática).
C01 / C02 Rojo Repetido en esta importación / ya cargado en esta liquidación.
C03 Rojo Ya existe en el sistema (no anulado).
C04 Rojo Denunciado en el BCRA.
C05 Rojo La moneda no es la de la liquidación.
C06 Info No a la orden: se aplica el gasto No a la Orden.
C07 Amarillo El cheque ya fue eliminado antes.
E01 Amarillo / Rojo eCheq pendiente de aceptación / en un estado que no se puede liquidar.
E02 Rojo Orden de no pagar.
E03 Amarillo Cesión pendiente o mandato de negociación vigente.
E04 / E05 Info El tenedor no es el cliente / no figura el tenedor.
E06 Rojo El eCheq ya está cargado en el sistema.
E07 Amarillo El endoso al cliente figura repudiado.
E08 Amarillo El eCheq ya fue eliminado antes.
P01 Amarillo Tiene beneficiario y no hay dorso, o el dorso no muestra endosos.

Parámetros

Parámetro Default Uso
Factoring.ImportacionCheques.Prompt.Extra (vacío) Instrucciones adicionales para la IA.
Factoring.ImportacionCheques.Reglas {} JSON para cambiar el nivel (color) de una regla por su código.
Factoring.Cheques.Firmante.Motor.Id 0 Motor de decisión para evaluar al firmante (0 = no evalúa).
Factoring.Cheques.ValidarFechaEmisionCantDiasAnteriores 30 Días para la regla F06.

Tablas de base de datos principales

Tabla Contenido
IA_Importaciones_Cheques Una fila por archivo leído: usuario, cliente, archivo y hash, método (plantilla o IA), proveedor y modelo, tokens, costo, segundos, cantidad de cheques, resultado y el JSON leído.
IA_Importaciones_Cheques_Eventos Eventos de cada cheque (revisado, correcciones, quitado): campo, valor leído, valor final, regla, usuario y fecha.
Documentos_ECheq Datos propios del eCheq (ID, estado, endosos), 1:1 con el documento.
Firmantes, Bancos, Localidades Consulta y alta de firmantes; validación de banco y código postal.

Permisos reales

Control Habilita
Licencia KeyLicences.Access(2,1,14,2) Lectura con IA (fotos, PDF, Word, planillas sin plantilla).
Factoring.Liquidaciones.Busquedas.Nuevo_Cheque Las tools del Asistente que preparan cheques.

Relación con otros módulos / manuales

Manual relacionado Vínculo operativo
Liquidaciones en Factoring Desde la liquidación se abre el importador y ahí quedan los cheques agregados. Incluye el Asistente en la liquidación (avisos, cotización, explicar el cálculo).
Asistente IA Leer y liquidar cheques desde el chat; su configuración de IA es la que usa el importador.
Importación de cheques desde Excel (carga masiva) La otra vía de carga masiva, con plantilla Excel o lectora CMC7.
Motor de Decisión Evalúa al firmante (regla R07).

Notas para soporte

  • N8N retirado para cheques: los parámetros IA.Cheques.* y N8N.Setup ya no intervienen en la lectura de cheques.
  • Caché de lecturas por contenido del archivo y versión del prompt: el mismo archivo no se vuelve a leer con IA salvo con "Volver a leer".
  • PDF largos (v1.0.116): se leen por tandas, PaginasTextoPorLlamada = 6 con texto y PaginasPorLlamada = 5 escaneados, hasta LectorArchivos.MaxPaginasEscaneadas = 60. Antes se leían solo las primeras 10 páginas.
  • Denuncia BCRA: la API busca por banco y número; el importador solo marca C04 si además coinciden sucursal y cuenta.
  • Firmante nuevo: se da de alta con el padrón de InfoAPI. Si el alta falla, el cheque queda en R12 (rojo) en lugar de entrar sin firmante.
  • Pegar en la liquidación: la liquidación solo sugiere pegar cuando el portapapeles tiene un JSON de cheques. Las imágenes se pegan desde el importador (Pegar / Ctrl+V).
  • Lo leído no se pierde: si la validación contra el sistema falla, el cheque queda con lo leído y el aviso del error.
¿Te resultó útil este manual?