Bot de granos: Discriminación de calidad en liquidaciones primarias de venta

Bot de granos: Discriminación de calidad en liquidaciones primarias de venta


Este instructivo describe cómo configurar y operar la discriminación de calidad en el procesamiento de liquidaciones primarias de venta de granos desde el Bot de Granos.

:timer_clock: 5 min

¿Para qué sirve?

Al procesar una liquidación única proveniente de ARCA que contiene factor y grado de calidad, el Bot de Granos puede registrar en el ERP dos ítems diferenciados: uno con el precio de fijación pleno del grano y otro con el importe de bonificación o castigo de calidad. Esta opción es configurable y está desactivada por defecto; si no se activa, el comportamiento es el estándar y el precio afectado por factor y grado se envía como un único ítem al ERP.

La discriminación permite visualizar y contabilizar por separado el impacto de calidad, con mayor transparencia en el comprobante de liquidación.

Antes de empezar

Configuraciones iniciales en el sistema.

  • Contar con acceso a la aplicación Agro y permisos sobre la configuración del Bot de Granos.
  • Tener configurado al menos un workflow de liquidación primaria de venta activo en el Bot de Granos.
  • Tener creado y activo en el ERP un producto puente del tipo “Bonificaciones y Castigos Comerciales de Granos”. Este producto no puede ser el mismo producto físico del grano que se está liquidando.

:backhand_index_pointing_right: La creación del producto puente en el ERP es responsabilidad operativa previa. Sin él, el sistema no permite activar la discriminación de calidad.

Modo de uso

:round_pushpin: Bot de Granos → Configuración de documentos → [documento de liquidación primaria de venta]

1. Configurar la discriminación de calidad

En la pantalla de configuración del documento de liquidación, localizar y completar los siguientes campos:

  • Discriminar Calidad en Liquidación: activa la generación del ítem separado de bonificación/castigo de calidad. Por defecto está desactivado; el flujo estándar se mantiene hasta que se active de forma explícita.
  • Producto Bonificación/Castigo (*): selector del producto puente configurado en el ERP para registrar el ítem de calidad. Es obligatorio cuando el indicador anterior está activo.

Nota aclaratoria: Los campos marcados con un asterisco (*) son de carácter obligatorio cuando la discriminación de calidad está activa.

:backhand_index_pointing_right: Ambos campos se guardan de forma conjunta. El sistema impide guardar la configuración si se intenta activar la discriminación sin haber seleccionado un producto válido en el campo Producto Bonificación/Castigo.

2. Procesar una liquidación con discriminación activa

Una vez activa la configuración, el flujo de procesamiento desde el Bot de Granos es el siguiente:

  1. Acceder a la liquidación de venta disponible en la pantalla de edición del Bot de Granos, originada desde Deals.
  2. Verificar los datos de cabecera provenientes de ARCA: precio por tonelada (precioTn), factor de calidad, porcentaje de grado e importe total. La presentación de estos datos en pantalla no cambia respecto al flujo estándar.
  3. Confirmar el procesamiento hacia el ERP.

Al confirmar, el sistema construye automáticamente dos ítems en el payload enviado al ERP:

Ítem 1 — Grano (fijación pura)

  • Precio unitario: el precio de fijación pleno informado por ARCA (precioTn), sin aplicar factor de grado ni porcentaje de grado.
  • Cantidad: toneladas (peso neto / 1000).

Ítem 2 — Bonificación/Castigo de calidad

  • Producto: el configurado en el campo Producto Bonificación/Castigo.
  • Importe: diferencia entre el importe total de la liquidación informado por ARCA en cabecera y el importe del ítem grano calculado con fijación pura. Si el resultado es positivo se registra como bonificación; si es negativo, como castigo.
  • Cuadratura: cualquier diferencia de centavos por redondeo se absorbe en este ítem, de modo que la suma de ambos ítems sea exactamente igual al importe total informado por ARCA.

El ERP recibe ambos ítems como líneas independientes dentro del comprobante y los registra en las cuentas contables según la configuración del producto puente.

3. Comportamiento cuando no hay desvío de calidad

Si la discriminación está activa pero el factor y el porcentaje de grado de la liquidación no generan diferencia respecto al precio de fijación puro (importe del ítem calidad igual a cero), el Bot genera únicamente el ítem del grano con precio de fijación pleno. No se genera el ítem de bonificación/castigo y el flujo continúa normalmente hacia el ERP.

Qué hace y qué no hace

  • Sí: genera dos ítems hacia el ERP (grano con fijación pura + bonificación/castigo de calidad) cuando la discriminación está activa y la liquidación tiene factor o grado con desvío.
  • Sí: impide guardar la configuración si se intenta activar la discriminación sin seleccionar un producto puente válido.
  • Sí: absorbe diferencias de centavos por redondeo en el ítem de calidad para garantizar cuadratura exacta contra el importe total de ARCA.
  • Sí: aplica la misma lógica de discriminación tanto en el flujo automático como en el manual de procesamiento de liquidaciones.
  • No: modifica la visualización de la liquidación en la pantalla del Bot de Granos; el precio que ve el operador sigue siendo el informado por ARCA con factor y grado aplicados.
  • No: aplica a liquidaciones parciales, de ajuste ni de compra secundaria; solo a liquidaciones únicas primarias de venta provenientes de Deals con datos de factor y grado en cabecera.
  • No: gestiona el IVA del ítem de calidad como una línea separada; el IVA de la calidad queda neteado dentro del IVA del producto grano.
  • Cuidado: si el producto configurado en el campo Producto Bonificación/Castigo es eliminado o desactivado en el ERP con posterioridad a la configuración del Bot, el sistema bloquea el procesamiento de la liquidación y muestra un mensaje de error. Es necesario corregir el producto en el ERP o actualizar la configuración del Bot antes de continuar; la liquidación queda en estado pendiente sin modificaciones.
  • Cuidado: verificar que el producto puente tenga asignada en el ERP la misma alícuota de IVA que el producto grano, dado que la base gravada del ítem grano cambia al separar el impacto de calidad.

:round_pushpin: Ver también: Bot de granos: Integración con ARCA para liquidaciones primarias de venta de granos