Bot de Granos – Gestión de dimensiones en liquidaciones

Este instructivo tiene como objetivo explicar cómo el Bot de Granos gestiona de forma asistida las dimensiones al contabilizar una liquidación de granos, garantizando que cada comprobante llegue al ERP con las dimensiones requeridas.

:timer_clock: 10 min

¿Para qué sirve?

Permite contabilizar liquidaciones de granos con todas las dimensiones obligatorias exigidas por el ERP (Como por ejemplo, centro de Costo, Partida Financiera, Contrato u otras según la configuración de cada Espacio de Trabajo) íntegramente desde el Bot de Granos. Cuando alguna dimensión requerida no puede resolverse de forma automática, el sistema la detecta y asiste al operador con una ventana emergente para completarla, sin necesidad de salir del Bot de Granos ni realizar ajustes manuales en el ERP.


Contexto

Anteriormente, el operador debía reingresar manualmente las dimensiones cada vez que confeccionaba una liquidación, tanto en el ERP como al operar a través del Bot de Granos. Esta duplicación de carga generaba demoras, riesgo de inconsistencias contables y discontinuidad en la trazabilidad por proyecto, contrato o campaña.

La nueva funcionalidad elimina esa fricción mediante un motor de resolución por cascada jerárquica que determina automáticamente las dimensiones aplicables en segundo plano, aprovechando los datos registrados previamente en los Contratos de Ventas o en las Cartas de Porte. Además, integra una ventana emergente asistida en el Bot de Granos que detecta datos faltantes y solicita únicamente las dimensiones y/o distribuciones obligatorias no resueltas, permitiendo completar la contabilización sin salir del canal ni realizar ajustes manuales posteriores.


¿Cómo funciona?

Al contabilizar una Liquidación de Ventas de Granos, el sistema determina los valores de las dimensiones y sus distribuciones evaluando ítem por ítem mediante un mecanismo de resolución en cascada. La secuencia lógica del proceso responde al criterio de prioridad operacional: evaluar de lo más específico (decisión del operador u origen físico del grano) a lo más general (parámetros predeterminados del sistema).

1. Nivel 0: Sobrescritura manual del usuario (ERP)

  • Origen de los datos: Solapa Dimensiones dentro del formulario del comprobante en el ERP.

  • Criterio de prioridad: Prevalecer de forma definitiva sobre cualquier sugerencia del sistema. Cualquier valor ingresado o modificado manualmente por el operador fija la dimensión de forma inalterable para evitar recalculos automáticos.

2. Nivel 1: Traslado / Carta de Porte

Observación: Aplica exclusivamente a Centros de Costos

  • Origen de los datos: Documento de Traslado / Carta de Porte vinculado directamente a la línea del comprobante.

  • Criterio de prioridad: Priorizar el origen físico del grano. Si la carga proviene de un establecimiento o lote que cuenta con un Centro de Costo asignado en su comprobante de traslado, este dato prevalece sobre lo pactado comercialmente en el contrato.

3. Nivel 2: Contrato de Ventas de Granos

  • Origen de los datos: Dimensiones registradas en la cabecera del Contrato de Ventas asociado a la liquidación.

  • Criterio de prioridad: Heredar la información comercial.

:warning: En caso de no existir un Centro de Costo asignado en la Carta de Porte (o si el comprobante no proviene de un traslado), el sistema adopta las dimensiones y distribuciones acordadas en el Contrato de origen vinculado.

4. Nivel 3: Configuración predeterminada del ERP

  • Origen de los datos: Reglas generales del sistema configuradas según Producto, Tipo de Documento o Cuenta Contable.

  • Criterio de prioridad: Aplicar como último recurso de resolución automática. Cuando ni el traslado ni el contrato aportan definición para dimensiones requeridas, el sistema recurre a sus parámetros globales para completar la estructura del comprobante.

Pantalla asistida por el Bot de Granos

Cuando el Bot de Granos procesa la contabilización de una liquidación en segundo plano y detecta que alguna dimensión obligatoria no pudo ser resuelta mediante ninguno de los niveles automáticos previos (1, 2 o 3), o bien cuando la suma de una distribución porcentual no alcanza el 100%, el sistema interrumpe temporalmente el envío automático y despliega la ventana emergente “Dimensiones incompletas” para requerir la intervención del usuario.

  • Origen de los datos: Pantalla emergente “Dimensiones incompletas” en el entorno interactivo del Bot de Granos.

  • Criterio de prioridad: Intervenir únicamente por excepción. Durante la contabilización en segundo plano, el sistema evalúa los Niveles 1, 2 y 3. Si al finalizar el recorrido no es posible resolver una dimensión obligatoria requerida por el ERP o si una distribución porcentual no alcanza el 100%, la operación se detiene temporalmente para requerir al usuario completar exclusivamente la información faltante antes de confirmar el registro.


Funcionamiento para el Usuario :bust_in_silhouette:

1. Confección del Contrato de Ventas (ERP)

  1. Al registrar o editar un Contrato de Ventas, el operador puede ingresar Dimensiones y sus distribuciones en el campo plano de cabecera o abrir la matriz emergente de Dimensiones.

  1. La información se sincroniza automáticamente entre ambos controles sin requerir guardado intermedio.

  2. El contrato puede guardarse y firmarse con o sin dimensiones asignadas.


2. Registrar Traslados y Asignación de Centro de Costo

  1. Ingresar alMaestro de Traslado de Granos.

  2. Asociar el comprobante al contrato u origen correspondiente.

  3. Asignar el Centro de Costo correspondiente al ítem del traslado.

  4. Guardar el comprobante para habilitar la herencia prioritaria hacia la liquidación.

¿Qué sucede si tengo vinculadas varias Cartas de Porte?

Cuando la liquidación tiene múltiples Cartas de Porte con distintos Centros de Costo, cada ítem toma el valor correspondiente a su Carta de Porte asociada.

¿Qué sucede si no tengo un centro de costo establecido en la Carta de Porte?

Si la Carta de Porte vinculada no tiene Centro de Costo asignado, o si el valor no es heredado en los pasos mencionados anteriormente (ver sección ‘¿Cómo funciona?’), la dimensión se considera no resuelta. El sistema incluye ese ítem en la ventana emergente para que el operador seleccione manualmente el valor correcto. La operación no se bloquea de forma silenciosa: el faltante siempre queda expuesto en la ventana emergente.

Ejemplo de dos traslados

Como ejemplo, tenemos dos Traslados de Granos vinculados al Contrato, con diferentes Centros de Costos:


3. Contabilización Asistida desde el Bot de Granos

  1. El usuario accede a la sección correspondiente: :round_pushpin: Menú → Bot de Granos → Liquidaciones de granos.

  1. Visualiza la liquidación disponible y completa los datos restantes requeridos (por ejemplo, las deducciones).

Solapa Cartas de Porte:

  1. Presiona el botón Contabilizar. El sistema ejecuta en orden la herencia de la Carta de Porte, la consulta de exigencias contables al ERP y la validación de distribuciones al 100%.

Resultado 1: Dimensiones faltantes o distribuciones incompletas:

Se interrumpe el envío al ERP y se despliega la ventana emergente “Dimensiones incompletas”. Si existen múltiples líneas con faltantes, todos los campos requeridos se consolidan en una única ventana.

Ejemplo ventana emergente

En este caso, el usuario selecciona los valores requeridos y presiona Aceptar para enviar el comprobante en un solo intento.

Ejemplo de la liquidación una vez enviada al ERP

En el ERP visualizamos la Liquidación procesada desde el Bot de Granos, con las Dimensiones:

Y en ‘Vinculaciones’, vemos vinculados los dos Traslados:

  • Resultado 2 (Todas las dimensiones resueltas): La liquidación se envía al ERP desde el Bot de Granos, se registra el comprobante y se notifica la contabilización exitosa sin mostrar ventanas adicionales.

Si presiona Cancelar, la ventana se cierra sin enviar datos y la liquidación permanece en el Bot en estado pendiente con sus datos operativos intactos.


Consideraciones Importantes

  • Prioridad de Carta de Porte para Centro de Costo: Si una liquidación tiene asociada una Carta de Porte con Centro de Costo, ese valor prevalecerá siempre sobre el valor definido en el Contrato de Ventas para esa línea. Las demás dimensiones continuarán resolviéndose desde el Contrato en adelante.

  • Múltiples Cartas de Porte: En liquidaciones vinculadas a varias Cartas de Porte con distintos Centros de Costo, cada ítem toma el valor correspondiente a su traslado asociado.

  • Manejo de errores en la contabilización del Bot:

  • Error recuperable (ej. dato incorrecto): El mensaje se muestra dentro del mismo popup conservando los valores ingresados para permitir corregir y reintentar.

  • Error irrecuperable (ej. período contable cerrado): El sistema indica que la operación debe gestionarse directamente en el ERP. En ningún caso se generan comprobantes parciales o inconsistentes.

  • Interrupción de sesión: Si la sesión se cierra mientras el popup de dimensiones del Bot está abierto, no se envían datos al ERP. Al retomar, la liquidación conserva sus datos operativos y se deberá iniciar el flujo desde el botón Contabilizar.

  • Inmutabilidad histórica: Ninguna edición posterior en la matriz de dimensiones de un Contrato alterará las liquidaciones previamente guardadas (incluidas las que se encuentren en borrador).


Interrupción de sesión o cierre del navegador

Si la sesión expira, el navegador se cierra o el usuario navega fuera del Bot mientras la ventana emergente está abierta, no se envía ningún dato al ERP. Al retomar la sesión, la liquidación conserva sus datos operativos en el estado previo al intento de contabilización.

:backhand_index_pointing_right: El popup no recupera los valores que el operador había ingresado antes de la interrupción. Es necesario iniciar nuevamente el flujo desde el botón Contabilizar y seleccionar las dimensiones desde cero.


Qué hace y qué no hace

  • Sí: hereda automáticamente el Centro de Costo desde la Carta de Porte para los ítems directamente asociados, con prioridad sobre las reglas de cuenta del ERP.
  • Sí: valida contra el ERP qué dimensiones son obligatorias para cada cuenta contable antes de intentar el envío.
  • Sí: consolida todas las dimensiones faltantes en una única ventana emergente, independientemente de cuántas líneas tenga la liquidación.
  • Sí: verifica que cada distribución porcentual sume exactamente el 100 % antes de procesar el envío.
  • Sí: garantiza que ningún comprobante ingrese al ERP con dimensiones faltantes o distribuciones incompletas.
  • No: la herencia automática de dimensiones desde cabeceras de Contratos de Granos en el ERP no está disponible en esta etapa.
  • No: el popup no recupera los valores ingresados si la sesión se interrumpe antes de confirmar.
  • Cuidado: si un valor requerido no aparece en los selectores del popup, verificar que el perfil del operador tenga habilitada esa opción en el ERP, ya que los valores se filtran según los permisos del usuario autenticado.

Beneficios principales :sparkles:

  • Automatización e integración: Hereda automáticamente las dimensiones desde Cartas de Porte y Contratos de Ventas.

  • Operación asistida sin fricción: El Bot de Granos contabiliza en segundo plano y solo solicita intervención ante dimensiones obligatorias faltantes o distribuciones incompletas.

  • Soberanía de edición: El operador conserva la facultad de revisar y modificar manualmente cualquier dimensión en el ERP.

  • Inmutabilidad histórica: Las liquidaciones guardadas conservan su foto analítica intacta frente a modificaciones futuras en el contrato de origen.
    Relación con Otras Funcionalidades :link:

Esta mejora se integra directamente con los siguientes módulos del sistema:

  • Contratos de Ventas de Granos: Define la matriz de dimensiones predeterminada y habilita la sincronización bidireccional.

  • Cartas de Porte / Traslados de Granos: Aporta el Centro de Costo de mayor prioridad para los ítems asociados.

  • Bot de Granos: Procesa la contabilización asistida en segundo plano y despliega la ventana emergente por excepción.

  • Configuración del ERP: Administra las reglas por defecto (Nivel 3) y la exigencia de dimensiones obligatorias por cuenta contable.