Ir al contenido principal

Integración Algoritmo

Información importante asociada a la integración SIMA-Algoritmo.

Elisa avatar
Escrito por Elisa
Actualizado hace más de 3 semanas

⭕Beneficios

  • Evitar duplicidad de trabajo

  • Órdenes viajan de SIMA a Algoritmo (aprobadas, no ejecutadas/confirmadas)

  • Trazabilidad entre ambos sistemas

  • Reducción del error humano

  • Vinculación sencilla de lotes, cultivos, insumos, contratistas, máquinas, etc.

🤔¿Cómo activar la integración?

  1. Contactar con SIMA y Algoritmo para informar sobre la necesidad y chequear que todo está en condiciones de poder iniciar la vinculación entre ambos sistemas.
    En el caso de SIMA podes contactar a tu responsable de cuenta o vendedor.
    ​

  2. Ambas empresas se ponen en contacto para coordinar acciones y hacer soporte mutuamente.
    SIMA genera una mail específico dentro de la cuenta del cliente para poder, mediante este correo, conectar ambas plataformas.
    Este paso es mediante un e-mail entre los equipos de SIMA y Algoritmo.
    ​

  3. Se comparte con el usuario interesado en integrar una serie de pasos para poder vincular la información creada en los dos sistemas y que quede compatibilizada.

Los maestros que se vinculan entre ambos sistemas:

A. Establecimientos/Campos; Lotes; Campañas/Cultivos:

Tener en cuenta que si los lotes y campos en ambos sistemas tienen los mismos nombres, facilitan la integración. Si un mismo lote se llama de dos formas diferentes entre los sistemas, esto complejiza la transparencia al momento de "hablar de un mismo lote".

👉 Para vincular esta información se debe completar el siguiente sheet (hacer una copia del mismo) LINK Acceso

*En esta planilla de cultivos se debe seguir el ejemplo de cada columna para poder completar los datos.

*Video instructivo para códigos de cultivos en SIMA:

B. Insumos/Productos/Artículos


Una vez marcados como "favoritos" los insumos mas utilizados y que se quieren integrar desde SIMA, se debe exportar el listado o copiar los códigos desde la misma pantalla de "Admin">"Insumos".

Estos insumos "favoritos" son los que primero van a salir en las OTs de SIMA.

*Los insumos de SIMA forman parte de un listado de productos estandarizados verificados contra SENASA y que tienen toda la información necesaria para poder realizar posteriores análisis sobre los mismos y de vinculación directa con el "REPORTE DE CREA".

*Cualquier insumo nuevo creado, es personalizado para la empresa o sociedad que lo genera.

C. Contratistas/Proveedores

Si ya tienen contratistas cargados en Algoritmo, deben darse de alta en SIMA desde "Administración>Contratistas".

Una vez creados, pueden obtenerse los códigos para vincularlos.

Si no están creados en Algoritmo, deben darse de alta allí al igual que en SIMA.

D. Tipos de labores

Si ya tienen los "tipos de labor" cargados en Algoritmo, deben darse de alta en SIMA desde "Administración>Tipos de labor".

Una vez creados, pueden obtenerse los códigos para vincularlos.

Si no están creados en Algoritmo, deben darse de alta allí al igual que en SIMA.

4. Con todos estos maestros cargados en ambos sistemas iguales y teniendo los IDs para compatibilizar, sumado al mail de la conexión inicial y el entorno listo desde Algoritmo, se puede proceder a activar la integración.

⭕Actividades compatibles entre ambos sistemas

Órdenes de trabajo:

  • Orden de aplicación/pulverización

  • Orden de siembra

  • Orden de fertilización

  • Orden de cosecha

  • Órdenes de laboreo

⭕Flujos de envío de órdenes

  1. Las órdenes se realizan en SIMA y se envían a Algoritmo.

  2. Las importaciones de OTs se realizan manualmente desde Algoritmo.

  3. Si una orden no puede viajar por falta de alguna vinculación, veremos en Algoritmo un mensaje comentando que falta vincular.

  4. Las órdenes viajan en estado APROBADA

  5. Las ejecuciones/confirmaciones de las OTs no vuelven a SIMA. Tampoco las eliminaciones ni ediciones.

  6. OTs creadas en Algoritmo no viajan a SIMA.

⚠️No se importan en Algoritmo modificaciones y bajas (eliminaciones) en OTs ya integradas desde SIMA.

⚠️Las órdenes que se emitan en SIMA y se importen a Algoritmo, deben cumplir con la estructura y restricciones actuales de la emisión de órdenes en ese sistema, por ejemplo, una orden por establecimiento.

👉 INFOMACIÓN EXTRA: Documentación de Algoritmo

Importación de Órdenes de Trabajo desde SIMA

Se agregó un proceso accesible desde Producción → Procesos Especiales → Importación Partes de Producción SIMA, desde el cual se importan a SoftCereal las Órdenes de Trabajo (OT) emitidas en SIMA. Para utilizar esta opción se debe adquirir una licencia específica.

Al presionar Importar, el sistema se conecta con el servicio de SIMA y obtiene todas las OT a partir de la Fecha Desde, emitiéndolas en SoftCereal una por una y mostrando el resultado de cada emisión.

  • Si la importación fue correcta, en Resultado se muestra código, sucursal y número de la OT emitida.

  • Si hubo error, se muestra el mensaje de error.

Antes de la primera importación deben configurarse:

  1. Equivalencias (ver “Definición de equivalencias”).

  2. Parámetros de conexión al servicio de SIMA.

Las OT importadas deben respetar la estructura y restricciones vigentes en SoftCereal (p. ej., una OT por Campo).

Al importar la OT, SoftCereal aplica cada insumo a cada lote: cada insumo se distribuye según hectáreas del lote y dosis/ha.

Estado inicial: todas las OT se importan en estado Planificada.
​Sin sincronización de cambios: no se importan modificaciones ni bajas realizadas luego en SIMA sobre esas OT.

Para cada OT importada correctamente se registra el ID de SIMA, visible luego en la impresión del comprobante.

Condiciones para la importación

Para que la OT se importe deben cumplirse todas estas condiciones:

  • Pertenencia a la empresa donde se está importando. Se determina buscando la equivalencia de CULTIVO_SIMA. Si no pertenece, no se procesa y no deja mensaje de error.

  • Estado en SIMA: debe ser Aprobada.

  • No importada previamente: se controla que no exista otra OT en SoftCereal con el mismo ID de SIMA.

Datos de la Orden de Trabajo en SoftCereal

Cada OT se emite con los siguientes datos:

  1. ID SIMA: header/local_id.

  2. Estado SIMA: si header/state/pending = true entonces Aprobada.

  3. Código de comprobante: definido por parámetro.

  4. Estado: Planificado.

  5. Fecha: header/voucher_date.

  6. Moneda: definida por parámetro.

  7. Tipo de cambio: TC vigente para moneda y fecha; si moneda nacional, 0.

  8. Moneda insumos: igual a Moneda (6).

  9. TC insumos: igual a Tipo de cambio (7).

  10. Lista de Precios: 0.

  11. Lista de Precios (Insumos): 0.

  12. Actividad / Campo / Lote: equivalencia de CULTIVO_SIMA para labours/cultivation/local_id del primer ítem de labours.

  13. Sociedad: la definida para la actividad (12).

  14. Campaña: la cosecha definida para la actividad (12).

  15. Proveedor: productor cuyo Tax Id sea igual a labours/contractors/local_id del primer ítem de labours.

  16. Encargado: el definido para el campo (12).

  17. Depósito: el definido para el campo (12).

  18. Comentario: header/observations.

  19. Labor: equivalencia de LABOR_SIMA para header/extra_fields/voucher_type/local_id.

  20. Fecha de la labor: igual a Fecha (5).

  21. Participación de la labor: obtenida según la Sociedad (13).

  22. Detalle de insumos: un ítem por cada supplies, agrupados por Lote y Actividad (24).

  23. Insumo – Fecha: igual a Fecha (5).

  24. Insumo – Actividad/Lote: equivalencia de CULTIVO_SIMA para supplies/cultivation/local_id.

  25. Insumo – Has a tratar: supplies/area_applied.

  26. Insumo – Artículo: equivalencia de ARTICULO_SIMA para supplies/formulated/local_id.

  27. Insumo – Unidades: supplies/total_applied.

  28. Insumo – Dosis/Ha: Unidades (27) / Has a tratar (25).

Particularidad: Órdenes de Cosecha

Las Órdenes de Cosecha no tienen supplies. En la importación, la cabecera y la labor se completan igual que en las demás OT. A nivel de detalle solo hay labours que se completan como lotes de la OT en SoftCereal, agregando una línea por cada ítem de labours.

  • Fecha (23), Actividad/Lote (24) y Has a tratar (25) se toman de labours (no de supplies).

Definición de equivalencias

Es necesario definir equivalencias para artículos, cultivos y labores de SIMA desde Cereales → Interfases Otros Sistemas → Equivalencias.

Tablas externas (valor fijo):

  • ARTICULO_SIMA → Código SIMA ↔ Código Artículo SoftCereal

  • CULTIVO_SIMA → Código SIMA ↔ Código Actividad;Código Campo;Código Lote en SoftCereal

  • LABOR_SIMA → Código SIMA ↔ Código Labor SoftCereal

Ejemplos:

  • Empresa Externa: 2222 – Tabla: ARTICULO_SIMA – Código Externo: 24612 – 3531

  • Empresa Externa: 2222 – Tabla: CULTIVO_SIMA – Código Externo: 228698 – ALG M2122;216;EM 11

  • Empresa Externa: 2222 – Tabla: LABOR_SIMA – Código Externo: 17 – SIEMBRA

Log del proceso y envío por correo

Al finalizar se guardan dos archivos en la carpeta parametrizada para logs:

  1. SIMA_LOG: CSV con el detalle de pantalla y resultado por registro.

    • Ej.:

    ID;Fecha;Resultado 265533;11/03/2022;OT 0001 00000002 264872;11/03/2022;<descripción del error>

  2. SIMA_API_RESPONSE: JSON con la respuesta recibida desde el servicio de SIMA.

Los nombres incluyen fecha y hora (p. ej., SIMA_LOG_20220311_1533.csv).

Si están configurados los Parámetros de Correo, el archivo SIMA_LOG se envía automáticamente a los destinatarios indicados.

Modificaciones en Emisión de Partes de Producción

En Producción → Comprobantes → Emisión de Partes de Producción se agregó el botón Otros Datos en la barra de herramientas, que permite ver y cargar el ID de SIMA.

Automatización de la importación

La funcionalidad incluye un ejecutable para correr por fuera de SoftCereal (p. ej., tarea programada).

  • Por defecto importa en la empresa principal.

  • Se puede definir otra empresa mediante un archivo config.ini en la carpeta del ejecutable (primera línea: código de empresa).

  • El usuario de la importación se define por parámetro.

  • La empresa se toma del config.ini (o empresa principal) y la sucursal la establecida para el usuario definido.

  • Las OT se importan en el ejercicio contable vigente.

Resumen de parámetros

Ruta → Parámetro → Descripción → Valor por defecto

  • Producción\Procesos Especiales\Importación Partes de Producción SIMA**Comprobante Parte de Producción** → Código de comprobante de producción → OT.

  • Producción\Procesos Especiales\Importación Partes de Producción SIMA**Código Moneda Comprobante** → Código de moneda SoftCereal → D.

  • Producción\Procesos Especiales\Importación Partes de Producción SIMA**Path Log del proceso** → Carpeta para archivos de log → (sin valor por defecto).

  • Producción\Procesos Especiales\Importación Partes de Producción SIMA**Endpoint SIMA** → (sin valor por defecto).

  • Producción\Procesos Especiales\Importación Partes de Producción SIMA**Usuario SIMA** → (sin valor por defecto).

  • Producción\Procesos Especiales\Importación Partes de Producción SIMA**Pass SIMA** → (sin valor por defecto).

  • Parámetros de Correo\Importación Partes de Producción SIMA**Asunto y Mensaje** → (sin valor por defecto).

  • Parámetros de Correo\Importación Partes de Producción SIMA**Destinatario de Mensajes** → (sin valor por defecto).

  • Parámetros de Correo\Importación Partes de Producción SIMA**Enviar Copia A** → (sin valor por defecto).

  • Parámetros de Correo\Importación Partes de Producción SIMA**Remitente de notificaciones** → (sin valor por defecto).

  • Opciones\Usuario Interfase Genérica → Usuario para la importación vía ejecutable → ADMIN (por defecto).

¿Ha quedado contestada tu pregunta?