Configuración e Instalación de la Integración Agriness

Agro
, ,
1

Descripción :pushpin:

Esta funcionalidad permite conectar e integrar de forma automatizada la plataforma Agriness con Finnegans ERP.

Su objetivo principal es simplificar la gestión agropecuaria centralizando de forma automática las novedades operativas registradas en campo (como nacimientos, muertes, cambios de categoría, despachos de hacienda e insumos/alimentos). Esto optimiza los tiempos de carga, evita la duplicación de tareas y minimiza los errores de registración manual en el ERP.

¿Cómo funciona? :gear:

La integración funciona mediante un proceso sincronizado y programable que opera en segundo plano:

  1. Extracción de novedades: El sistema consulta periódicamente las novedades registradas en la plataforma Agriness.

  2. Procesamiento de datos: Finnegans analiza la información recibida e inserta automáticamente los registros correspondientes en el ERP.

  3. Mapeo y Homologación de Términos: Si un código enviado por Agriness no coincide con los maestros de Finnegans (por ejemplo, el nombre de una categoría o insumos/alimentos), el registro se pausa en estado Pendiente para que el usuario pueda asociarle el equivalente exacto dentro del ERP a través de la pantalla de Sinónimos.

Configuración :hammer_and_wrench:

El proceso de configuración comprende tres etapas clave: asignación de permisos, activación de módulos con credenciales y programación de servicios automáticos.

1. Asignación de Permisos de Acceso

  1. Desde el menú principal de Finnegans ERP, ingresa a Plug & Go y selecciona la opción Administrar > Plug & Go.

  2. En el catálogo, busca la aplicación Agriness y haz clic en Administrar.

  3. En la pantalla Definición de Permisos, define los usuarios o roles responsables de administrar u operar la integración en la sección Parámetros Generales y presiona Aceptar.

  4. Asigna los accesos marcando el check de confirmación en la columna Accede para los grupos o roles requeridos.

2. Habilitación de Módulos y Carga de Credenciales

  1. Una vez otorgados los permisos, haz clic en el botón Abrir en la tarjeta de Agriness dentro de Plug & Go.

  2. Visualizarás dos grupos de trabajo:

    • Gestión de Hacienda: Módulos de Cambio de Categoría, Nacimientos, Recepción de Hacienda, Muertes y Despacho de Hacienda.

    • Insumos: Módulos vinculados al consumo y movimientos de materiales/alimentos.

  3. Despliega el grupo deseado, activa el módulo a sincronizar e ingresa los parámetros de conexión:

    • Token de Desarrollador: Identificador provisto por el portal de Agriness.

    • Clave API: Clave de seguridad otorgada por Agriness.

    • Usuario y Contraseña de Granja: Credenciales de acceso registradas en la granja de Agriness.

    • Sucursal: Código correspondiente a la sucursal del ERP Finnegans (obtenido desde el maestro de Sucursales).

    • Rango de Fechas: Dejar vacíos para extraer automáticamente los datos del día anterior. Si se requiere sincronizar un rango histórico específico, deben completarse manualmente.

  4. Presiona Confirmar para guardar.

3. Programación de Servicios Automáticos

Para automatizar la extracción e inserción de datos:

  1. En el menú principal de Finnegans ERP, ingresa a Servicios Programables.

  2. Filtra en el buscador por la palabra Agriness. Visualizarás dos tipos de eventos programables por cada módulo:

    • Publicación: Método encargado de consultar y extraer las novedades desde Agriness.

    • Descarga: Método encargado de procesar e insertar los registros en Finnegans ERP.

  3. En los tres puntos (...) del extremo derecho de cada evento, selecciona Administrar.

  4. Activa el servicio, define la frecuencia o días/horarios de ejecución y guarda los cambios.

Funcionamiento para el Usuario :bust_in_silhouette:

Monitoreo del Historial de Eventos

  1. Ingresa a la integración Agriness desde Plug & Go.

  2. En la tarjeta del módulo requerido (ej. Nacimientos, Muertes, etc.), haz clic en la opción Historial.

  3. Define un rango de fechas (Fecha Desde / Fecha Hasta) para consultar el listado de ejecuciones.

  4. Consulta el estado de cada procesamiento (Éxito o Error). Haz clic en la línea deseada para visualizar el detalle del mensaje devuelto.

Tratamiento de Errores y Homologación de Sinónimos

Cuando se procesa una novedad cuyos identificadores de origen (Agriness) no coinciden exactamente con los maestros de Finnegans ERP:

  1. Ve al menú principal y selecciona Deals > Sinónimos.

  2. Filtra por la palabra Agriness y abre el documento correspondiente (ej. Recepción de Hacienda Agriness).

  3. Identifica las líneas en estado Pendiente.

  4. Evalúa la variable recibida en Valor (código de Agriness) y asigna en el campo Sinónimo el código exacto registrado en el maestro correspondiente de Finnegans ERP.

  5. Presiona Guardar.

Reprocesamiento de Eventos

Una vez corregidos y mapeados los sinónimos faltantes:

  1. Vuelve al Historial de Eventos dentro del módulo correspondiente en Agriness.

  2. Selecciona los registros pendientes o fallidos.

  3. Haz clic en Reprocesar para completar la inserción de los datos en Finnegans ERP.

Consideraciones :light_bulb:

  • Manejo de Fechas: Mantener los campos de fecha vacíos asegura la sincronización continua del día anterior. Únicamente deben ingresarse fechas de forma manual si se requiere recuperar información histórica específica.

  • Sincronización Dual: Para que un flujo operativo funcione correctamente, es indispensable activar tanto el servicio de Publicación como el de Descarga en la sección de Servicios Programables.

  • Validación de Sinónimos: Los registros marcados como pendientes no se perderán; quedarán a la espera de que el usuario asocie el sinónimo correcto para poder reprocesarse.

Ejemplo de configuración

image
image320×283 6.3 KB

Acceso a usuarios internos

image
image507×514 19.5 KB

Confirmación de acceso

image
image691×491 25.2 KB

Acceso a Agriness - Componentes de la integración

image
image1327×543 35.5 KB

Ingreso de credenciales de Agriness

image
image742×474 23.6 KB

Servicios programables

image
image1332×550 69.5 KB

Configuración de evento en Servicios Programables

image
image846×590 41.2 KB

Historial de eventos

image
image1294×558 36.9 KB

Sinónimos

image
image1358×459 26.9 KB

image
image1331×534 53.3 KB

Beneficios :rocket:

  • :high_voltage: Automatización integral: Elimina la carga manual repetitiva de partes diarios y movimientos agropecuarios.

  • :bullseye: Mayor precisión: Minimiza errores humanos de transcripción entre la granja y el sistema administrativo.

  • :magnifying_glass_tilted_left: Control y Trazabilidad: Permite un seguimiento detallado del estado de cada transacción y facilita la autocorrección mediante la gestión de sinónimos.

Relación con otras funcionalidades :link:

  • Plug & Go: Funciona como el centro de administración y control de accesos de la integración.

  • Deals / Sinónimos: Módulo utilizado para mapear y homologar las equivalencias entre las codificaciones de Agriness y Finnegans ERP.

  • Servicios Programables: Motor que gestiona las ejecuciones periódicas automáticas en segundo plano.