Índice:
1. Resumen
La integración hace que las órdenes de trabajo cargadas en SIMA se importen a Physis como órdenes de trabajo, y así se termina la doble carga manual. El flujo va en un solo sentido: de SIMA a Physis. Physis no devuelve nada a SIMA.
Qué es Physis: el ERP que muchos clientes de SIMA usan para contabilidad, stock, facturación y costos. En Physis se carga el parte de trabajo, que es lo que efectivamente descuenta stock y genera el asiento contable.
Qué hace SIMA: gestión de campo. Los ingenieros cargan las órdenes de aplicación, siembra, cosecha, etc., desde el campo o la web (dosis, producto, lote, hectáreas, contratista).
Qué hace la integración: desde una pantalla nueva dentro de Physis (módulo Labores → Parametrización → SIMA), el administrativo trae por API las órdenes de SIMA de un rango de fechas, elige cuáles importar y las pasa a Physis. Después arma el parte de trabajo a partir de esa orden.
Quién la desarrolló y la mantiene: Physis. SIMA expone la API y homologa algunos datos del lado SIMA (por ejemplo, depósitos).
Para quién es: clientes que usan SIMA para la gestión de campo y Physis para la administración.
No es en tiempo real: alguien tiene que entrar a la pantalla de Physis, revisar las órdenes y ejecutar la importación. No hay sincronización automática en segundo plano.
2. Conceptos clave para soporte
Concepto | Dónde vive | Qué es | ¿Mueve stock? |
Orden de trabajo (OT) | SIMA → se importa a Physis | Lo que el ingeniero pidió o registró: producto, dosis, lote, hectáreas, contratista. Es una expectativa. | No |
Parte de trabajo | Physis | Lo efectivamente realizado, validado por administración. Funciona "como un remito". | Sí, descuenta stock y genera el asiento |
Código de intercambio | Cada maestro (ABM) de Physis | Campo donde se guarda el ID de SIMA que corresponde a ese registro de Physis. Es la base del mapeo. | — |
Orden de Trabajo SIMA (OTS) | Physis | Formulario/tipo de orden nuevo, recomendado para separar lo que viene de SIMA de las órdenes cargadas a mano en Physis. | — |
3. Beneficios
El beneficio principal es eliminar la doble carga: hoy un administrativo imprime o exporta las órdenes de SIMA y las vuelve a tipear en Physis.
Menos tiempo administrativo: el parte de trabajo se arma llamando a la orden importada y se autocompleta. Solo se valida y se ajusta lo que cambió (hectáreas reales, dosis, depósito, precio).
Menos errores de transcripción: productos, lotes, dosis y hectáreas llegan tal cual los cargó el ingeniero.
Importación selectiva, no "todo o nada": se puede empezar por un campo, por un tipo de labor o por un rango de fechas. Cada orden se puede marcar para no importar.
Sin duplicados: las órdenes ya importadas quedan marcadas con un tilde, y si se reimporta un período, el sistema avisa y pregunta si se quiere actualizar.
Trazabilidad pedido vs. ejecutado: la OT guarda lo que pidió el agrónomo y el parte lo que realmente se hizo. Sirve para explicar diferencias de rinde o de costo.
Mejor visibilidad de stock en Physis: al usar órdenes de trabajo, Physis muestra existencia real, cantidad comprometida ("a entregar") y pendiente de recepción, y permite anticipar traslados o compras.
El campo sigue ágil: los ingenieros no tienen que saber de depósitos ni de stock. Eso lo resuelve administración en Physis.
Menos productos para mantener en Physis: varios insumos de SIMA pueden apuntar a un mismo producto de Physis (ej. tres 2,4-D distintos en SIMA → un solo 2,4-D en Physis).
4. Requisitos previos
Antes de configurar nada, el cliente necesita tener resuelto lo comercial en los dos sistemas y las credenciales de integración correctas.
Comercial
SIMA – Plan Conexión. Habilita la API que usa Physis. Si ya tienen una licencia anual, el cambio lo gestiona el CSM de la cuenta.
Physis – interfaz SIMA. Se gestiona con el consultor de Physis de la cuenta.
Técnico / operativo
Versión de Physis que incluya la pantalla Labores → Parametrización → SIMA (se instala/activa desde Physis).
Insumos favoritos marcados en SIMA: los 20 a 30 insumos que el cliente usa de verdad en la campaña.
Depósitos dados de alta en SIMA (los carga el equipo de SIMA a partir de una lista que pasa el cliente). Si el cliente no maneja depósitos en el campo, alcanza con uno genérico (ver paso 6).
Nomenclatura de cultivos y campañas revisada en SIMA para que se pueda emparejar con la de Physis (ej. campaña 26-27, soja de primera / de segunda).
Una persona del cliente que conozca bien Physis para hacer el mapeo.
Stock cargado en Physis: sin stock positivo en el depósito no se puede cerrar el parte de trabajo.
5. Paso a paso de la integración
La puesta en marcha tiene dos partes: una configuración inicial que se hace una vez (pasos 1 a 7) y un ciclo que se repite cada vez que se importan órdenes (pasos 8 a 11). Todo se hace dentro de Physis, salvo los preparativos en SIMA.
Flujo: SIMA: el ingeniero carga la orden → Physis: traer órdenes por rango de fechas → Validar códigos → (si faltan) completar códigos de intercambio y volver a validar → Importar órdenes seleccionadas → Generar parte de trabajo y completar precios → Baja de stock y asiento contable.
El ciclo vuelve a "Validar códigos" hasta que la lista de pendientes queda vacía; recién ahí deja importar.
Configuración inicial (una sola vez)
Paso 1 – Preparar SIMA
En SIMA: marcar como favoritos los insumos de uso frecuente (20 a 30). SIMA tiene miles de formulados en su base; no hace falta mapearlos todos, solo los que el campo va a usar.
Pedir al equipo de SIMA el alta de los depósitos (lista enviada por el cliente) o de un depósito genérico.
Revisar que campañas y cultivos tengan nombres que se puedan emparejar con Physis. Si en SIMA hay variedades o nombres que no existen en Physis, ajustarlos antes.
Paso 2 – Entrar a la interfaz en Physis
En Physis: módulo Labores → Parametrización → SIMA. Ahí está la ventana de interfaz con las opciones: Importar Órdenes de SIMA, Ver Órdenes de SIMA, Cargar Tablas de SIMA, Vincular Insumos, Vincular Depósitos, Configuración, Obtener Token y Conexión con Physis.
Labores → Parametrización → SIMA abre la ventana "Interfaz Physis – SIMA" con sus botones.
Paso 3 – Configurar la conexión
En Configuración, cargar los parámetros de la cuenta SIMA del cliente (usuario de integración y URL de producción). Las credenciales se guardan encriptadas.
Definir el tipo de orden de trabajo que se va a usar para lo importado y el prefijo que llevarán esas órdenes.
Presionar Obtener token. Sirve para comprobar que la comunicación entre la API de SIMA y Physis funciona. Si no devuelve token, no avanzar: revisar credenciales y URL.
"Obtener Token" devuelve el token contra https://api.sima.ag/api/. Si aparece, la conexión funciona.
Paso 4 – Crear el formulario "Orden de Trabajo SIMA" (recomendado)
Dar de alta en Physis un tipo/formulario de orden nuevo (ejemplo: OTS – Orden de Trabajo SIMA). Así las órdenes que vienen de SIMA quedan separadas de las que se cargan a mano en Physis (ganadería, mantenimiento de maquinaria, estructuras) y se puede filtrar por ese formulario.
En Labores → Órdenes → Búsqueda aparece el tipo "OTS – Orden Trabajo (SIMA)"; las importadas llevan en Observaciones "SIMA Importación …".
Paso 5 – Traer las tablas de SIMA
Usar Cargar Tablas de SIMA. Physis baja de SIMA los maestros (insumos, depósitos, etc.) para que después el mapeo se haga eligiendo de una lista, no escribiendo códigos a mano. Esto evita errores de tipeo.
Sección "Tablas": Cargar Tablas de SIMA, Vincular Insumos y Vincular Depósitos.
Paso 6 – Vincular insumos y depósitos
Vincular insumos: para cada insumo favorito de SIMA, elegir el producto equivalente de Physis y guardar. Se permite varios de SIMA → uno de Physis.
Vincular depósitos: para cada depósito de SIMA, elegir el de Physis. En la lista, Physis muestra código y descripción concatenados (los primeros dígitos son el código).
El depósito es obligatorio para que la orden migre. Si el campo no sabe de qué depósito sale el producto, usar un depósito genérico (ejemplo: "SIMA") y asignar el depósito real después, al armar el parte.
Vincular Insumos: a la izquierda el insumo de SIMA, a la derecha el insumo de Physis elegido de la lista.
Vincular Depósitos: cada depósito de SIMA con su depósito de Physis (código y descripción juntos).
Paso 7 – Completar los códigos de intercambio en los maestros de Physis
En cada ABM de Physis hay un campo nuevo, Código de intercambio, donde se carga el ID de SIMA. Hay que completarlo en:
Maestro en Physis | Qué se empareja | Ejemplo |
Campañas | Campaña SIMA ↔ campaña Physis | 26-27 de SIMA → código de la 26-27 en Physis |
Cultivos | Cultivo SIMA ↔ cultivo Physis | Puede requerir ajustar nombres/variedades en SIMA |
Actividades | Lo que se hace en el lote | Soja de primera, soja de segunda, maíz, trigo |
Campos y lotes | Establecimiento y lote | El código debe corresponder a la referencia completa campo + lote |
Labores | Tipo de labor | Pulverización, siembra, cosecha, fertilización |
Contratistas | Aplicador/contratista | Ej. "Juan López, código 34 en SIMA" |
Personal propio | Personal que ejecuta | Cuando no es contratista |
Maquinaria e implementos | Tractores, pulverizadoras, implementos | Dar de alta en Physis los que falten |
Physis tiene un instructivo actualizado con capturas de dónde está cada campo.
Campaña: en Ejercicios de Gestión, editar la campaña (ej. 26/27) y completar "Código Intercambio" abajo a la derecha.
Lote: en Campos – Lotes, editar el lote y cargar el código de SIMA en "Código Intercambio". Lo mismo en Cultivos, Actividades, Labores, Personal y Maquinaria.
Ciclo de importación (cada vez)
Paso 8 – Traer las órdenes de SIMA
En "Importación previa", elegir el rango de fechas (Desde / Hasta) y presionar "Importar Órdenes de SIMA". Physis consulta la API de SIMA en ese momento (lee de la nube, no de una copia local).
Ir a Ver órdenes de SIMA. Se listan todas las órdenes del período, cualquiera sea su estado en SIMA (aprobada o ejecutada).
Usar los filtros de columna: tipo de labor (siembra, cosecha, aplicación), fechas, campaña, campo, estado confirmado/ejecutado. Por cada orden se pueden ver sus labores y sus insumos.
Ventana "Órdenes de SIMA": columnas Importado, No Importar, Actualizar Importado, Ver Labores y Ver Insumos, con filtro en cada columna.
Paso 9 – Validar códigos
Presionar Validar ("Validar Vínculos de Tablas"). Physis lista todo lo que no encuentra vinculado: códigos de insumo, contratistas, implementos, actividades, lotes. La lista no se agrupa por orden, muestra todo lo pendiente del período.
La lista se puede exportar a Excel para parametrizar en bloque.
Volver al paso 6/7, completar, y validar de nuevo. Cuando la lista queda vacía, se puede importar.
Si falta algo, Importar no deja avanzar y avisa qué datos faltan.
Consejo: acotar el rango de fechas para que la lista sea más manejable.
"Validar Vínculos de Tablas" abre la lista de pendientes: campaña, actividad, cultivo, labor, campo, lote, contratista. Se puede exportar a Excel.
Paso 10 – Seleccionar e importar
Marcar las órdenes que no se quieren importar en esta pasada (quedan afuera solo de esta importación; en la próxima vuelven a aparecer).
Importar. Las importadas quedan con un tilde y se pueden ocultar con el filtro.
Se crean en Physis como órdenes de trabajo (del formulario OTS), no como partes. No mueven stock.
Al tildar "No Importar", Physis pide confirmación. La importación final se hace con "Importar Órdenes a Physis (Final)".
Paso 11 – Generar el parte de trabajo
Desde la orden, o desde el parte llamando a las órdenes (por ejemplo, eligiendo el contratista y viendo qué órdenes tenía pendientes).
El parte se autocompleta con productos, lotes, hectáreas y dosis de la orden.
Ajustar lo real: hectáreas (ej. 40 pedidas, 45 hechas), dosis, depósito real, precio/costo de la labor (no viaja desde SIMA).
Al confirmar el parte, Physis descuenta stock (precio promedio ponderado) y genera el asiento.
Orden de Trabajo tipo OTS ya importada: zona/campo, actividad, lote, labor, personal y maquinaria. Costo de labor todavía en 0.
Parte de Trabajo generado desde la orden: la columna "Orden de Trabajo" muestra de qué OTS viene cada línea, y el detalle de insumos muestra depósito, cantidad, dosis y PPP.
6. Qué datos viajan y en qué sentido
Viaja solo la orden de trabajo, de SIMA a Physis. Nada vuelve de Physis a SIMA en esta etapa.
Dato | ¿Viaja? | Nota |
Orden de trabajo (cabecera: fecha, campaña, campo, lote, estado) | Sí, SIMA → Physis | Todas, aprobadas o ejecutadas; se filtra en Physis |
Labores de la orden | Sí | Requieren código de labor/actividad vinculado |
Insumos, dosis y cantidades | Sí | Requieren insumo vinculado |
Hectáreas | Sí | Se ajustan en el parte si lo real difiere |
Contratista / personal propio | Sí | Requiere código de intercambio |
Maquinaria / implemento | Sí | Requiere código de intercambio |
Depósito | Sí, obligatorio | Puede ser genérico y cambiarse en el parte |
Precio o costo de la labor | No | Se asigna en el parte de trabajo en Physis |
Stock / existencias | No | SIMA no maneja stock; el control es de Physis |
Estado del parte ("ejecutado en Physis") | No vuelve a SIMA |
|
Cambios hechos en Physis (dosis final, depósito) | No vuelven a SIMA | Physis manda para stock y costos |
Reimportación y actualizaciones: si se vuelve a traer un período ya importado y la orden cambió en SIMA, Physis avisa que ya existe y pregunta si se quiere actualizar. Si esa orden ya tiene un parte de trabajo asociado, no se pisa.
7. Uso diario después de integrar
Una vez configurado, el trabajo de todos los días es corto: traer, filtrar, validar, importar y cerrar partes. El mapeo se mantiene solo cuando aparece algo nuevo.
Quién hace qué
Rol | Sistema | Qué hace |
Ingeniero / asesor de campo | SIMA | Carga la orden (producto, dosis, lote, hectáreas, contratista). La aprueba y, cuando vuelve del campo, la marca ejecutada. No gestiona stock ni depósitos. |
Administrativo | Physis | Trae órdenes, filtra (por ejemplo, solo ejecutadas), valida, importa y arma el parte con depósito y precio reales. |
Responsable de configuración (cliente) | SIMA + Physis | Mantiene favoritos y códigos de intercambio cuando se agregan lotes, campos alquilados, insumos o contratistas nuevos. |
Rutina sugerida
Elegir la frecuencia (diaria, semanal o a fin de mes) y el criterio: por ejemplo, importar solo las órdenes ejecutadas usando el filtro de estado.
Traer el período, filtrar, validar.
Si aparecen códigos pendientes, es porque algo nuevo se cargó en SIMA (un lote, un insumo no favorito, un contratista). Vincularlo y volver a validar.
Importar y generar los partes.
Buenas prácticas
Se solicita usar solo insumos favoritos. Si eligen un insumo parecido pero distinto (hay decenas de 2,4-D), aparece como pendiente.
Cada campaña nueva: vincular la campaña y revisar actividades y lotes (los campos alquilados cambian de año a año).
Editar la orden importada solo si es necesario. La idea es que la OT refleje lo que pidió el ingeniero y el parte lo que se hizo.
El depósito genérico que viene de SIMA se reemplaza en el parte por el depósito real.
Servicios como análisis de suelo o semilla se pueden cargar como labores por unidad en lugar de por hectárea.
8. Problemas y preguntas de frecuentes
La mayoría de los casos de soporte van a ser códigos sin vincular o dudas sobre orden vs. parte.
Problemas y cómo resolverlos
Síntoma | Causa probable | Qué hacer |
"Obtener token" falla o no trae órdenes | Credenciales mal cargadas, usuario inexistente, URL de testing/demo en lugar de producción | Verificar usuario de integración y URL de login de producción. Pedir credenciales nuevas al equipo de SIMA si hace falta. |
Importar dice que no puede y lista datos faltantes | Insumos, lotes, actividades, contratistas o implementos sin código de intercambio | Exportar la lista a Excel, completar códigos en los ABM de Physis, volver a validar. |
Aparecen pendientes nuevos en una integración que ya andaba | Se cargó en SIMA un lote, campo, insumo no favorito o contratista nuevo | Vincular el registro nuevo. Recordar usar favoritos. |
Un lote no matchea aunque está cargado | El código de intercambio no corresponde a la referencia completa campo + lote | Revisar que el código cargado en Physis sea el del lote dentro de ese campo. |
El cultivo no matchea | Nombres o variedades distintos entre SIMA y Physis | Ajustar la nomenclatura en SIMA o completar el código en el maestro de cultivos. |
La orden no migra por depósito | El depósito es obligatorio y no está vinculado | Crear/vincular un depósito genérico y corregirlo en el parte. |
No deja cerrar el parte | Stock insuficiente en el depósito asignado | Cargar el remito de entrada o el movimiento de stock en Physis, o cambiar el depósito. La orden no mueve stock; el parte sí. |
Al reimportar no actualiza una orden | La orden ya tiene un parte asociado | Es el comportamiento esperado. Corregir directamente en el parte. |
Cambié algo en Physis y no se ve en SIMA | La integración es unidireccional | Es el comportamiento esperado. |
No se sabe qué orden específica falló | El validador lista pendientes del período, no por orden | Acotar el rango de fechas o filtrar hasta aislar la orden. |
Preguntas frecuentes
¿Se importa todo de una o puedo elegir? Se elige. Por fecha, por labor, por campo, orden por orden.
¿Viajan solo las ejecutadas? Viajan todas (aprobadas y ejecutadas). Hay una columna/filtro de estado para quedarse solo con las ejecutadas.
¿Se importa como parte? No. Siempre entra como orden de trabajo; el parte se genera después en Physis.
¿Es automático? No. Alguien entra a la pantalla y ejecuta la importación.
¿Tengo que mapear los miles de insumos de SIMA? No. Solo los favoritos que se usan.
Uso tres 2,4-D distintos en SIMA y uno solo en Physis, ¿se puede? Sí, varios de SIMA pueden apuntar al mismo de Physis.
Si marco "no importar", ¿queda excluida para siempre? No, solo de esa importación. Vuelve a aparecer la próxima vez.
Si importo dos veces lo mismo, ¿se duplica? No. Queda con tilde de importada y pide confirmación para actualizar.
¿Qué pasa si importo una orden y no hay stock? Nada: la orden no mueve stock. Physis puede avisar. El bloqueo aparece al cerrar el parte.
¿La orden genera remito o traslado al campo? No. El envío del depósito al campo sigue siendo una tarea administrativa aparte.
¿Viaja el precio de la labor? No, se carga en el parte.
¿Quién configura los códigos? El propio cliente, alguien que conozca sobre Physis.
¿Cuánto cuesta? Derivar al CSM y al consultor de Physis.