Configuración de Jerarquía

Resumen

SIMA organiza los datos agropecuarios en una jerarquía estricta. Cada OT se vincula en última instancia a un cultivo, que es la combinación de un lote, una campaña y un cultivo. Debés configurar esta jerarquía antes de poder registrar operaciones de campo.

Sociedad
  └── Productor
        └── Establecimiento
              └── Lote
                    └── Ciclo (master_campaign_cycles)
                          └── Campaña madre / Planificación (master_campaigns)
                                └── Campaña (campaigns)  ← en ERP suele llamarse "Cultivo"
                                      └── Orden de Trabajo

¿Tu ERP usa otros nombres (Cultivo, Ciclo, Planificación)? Consultá el Glosario SIMA ↔ ERP antes de mapear IDs.

Si tu sistema ya tiene establecimientos y lotes, creálos en SIMA y vinculálos usando el campo external_code para mapear entre tus IDs y el local_id de SIMA.

Orden de configuración

El orden importa — cada nivel depende del anterior.

Verificar tu Sociedad (Productor)

El contexto de tu sociedad se devuelve en la respuesta del login como society.id. Es la raíz de todos tus datos. Las sociedades no se crean via API — son aprovisionadas por SIMA durante el onboarding.

Crear Establecimientos

Un establecimiento es un campo o grupo de campos perteneciente a un productor. Requiere un farmer_id.

Crear Lotes

Un lote es una parcela específica dentro de un establecimiento. Requiere un establishment_id.

Crear Campañas Madre y Campañas

Una campaña madre es la planificación (especie + época + ciclo, ej. “Soja 1ra 24/25”). Una campaña es la instancia en un lote — en muchos ERPs eso se llama Cultivo. Ver Glosario SIMA ↔ ERP.

Usar Campañas en OTs

Cada línea de supply y labour en una OT referencia una campaña (campaigns.id). En el payload de integración aparece como cultivation.local_id.

Establecimientos

Crear

POST /api/v3/third_party/establishments

{
  "farmer_id": 13873,
  "name": "La Correntina",
  "observations": "Sector norte, bajo riego"
}

Respuesta:

{
  "id": 118422,
  "farmer_id": 13873,
  "name": "La Correntina",
  "observations": "Sector norte, bajo riego",
  "location": null,
  "created_at": "2024-08-30T18:03:13-03:00",
  "active": true
}

Guardá el id devuelto — lo vas a necesitar para crear lotes.

Actualizar

PATCH /api/v3/third_party/establishments/{id}

Eliminar

DELETE /api/v3/third_party/establishments/{id}

Listar

GET /api/v3/third_party/establishments

Filtros principales:

Parámetro	Tipo	Descripción
`farmer_id`	int	Filtrar por productor
`updated_at_from`	datetime	Detectar establecimientos nuevos o modificados
`page` / `size`	int	Paginación

Lotes

El listado está en v2; la creación, actualización y eliminación en v3.

Listar (v2)

GET /api/v2/third_party/plots

Filtros v2: establishment_id, modified_at_from, page, size.

Crear (v3)

POST /api/v3/third_party/plots

{
  "establishment_id": 118422,
  "name": "Lote 1 Norte",
  "area": 150.5
}

Actualizar / eliminar (v3)

PATCH /api/v3/third_party/plots/{id}
DELETE /api/v3/third_party/plots/{id}

Campañas Madre y Campañas

Una Campaña Madre representa una temporada agrícola (ej: “2024/25 Finos”). Una Campaña es el cultivo específico + período vinculado a un conjunto de lotes dentro de esa temporada.

Listar Campañas Madre

GET /api/v3/third_party/master_campaigns

Listar Ciclos de Campaña Madre

GET /api/v3/third_party/master_campaign_cycles

Los ciclos agrupan las campañas madre por período (ej. “2024/25”). Útil para filtrar campañas por temporada.

Listar Campañas

GET /api/v3/third_party/campaigns

Filtros principales:

Parámetro	Descripción
`establishment_id`	Campañas dentro de un establecimiento
`updated_at_from`	Detección de cambios
`active`	Solo campañas activas

Cultivos

Un cultivo en SIMA (cultivations) es una especie del catálogo (Soja, Maíz, Trigo). No confundir con la campaña — que es lo que muchos ERPs llaman Cultivo y es lo que referencian las OTs.

Listar especies (catálogo)

GET /api/v3/third_party/cultivations

Listar campañas (instancia en lote — referencia de OTs)

GET /api/v3/third_party/campaigns

Es el endpoint que vas a consultar con más frecuencia para obtener los IDs que necesitás en OTs (cultivation.local_id). Consulta típica para campañas de un establecimiento:

GET /api/v3/third_party/campaigns?establishment_id=118422&active=true

Vincular tus IDs con los IDs de SIMA

Cuando tu sistema tiene sus propios identificadores, usá external_code para crear un mapeo persistente:

{
  "farmer_id": 13873,
  "name": "La Correntina",
  "external_code": "TU-ERP-ESTAB-001"
}

Luego podés buscar la entidad por tu propio código: GET /api/v3/third_party/establishments?external_code=TU-ERP-ESTAB-001

Manejo de entidades existentes

Si tu cliente ya tiene establecimientos y lotes configurados en SIMA (ej: cargados manualmente via la app web), no los recreés. En su lugar:

Listá los establecimientos existentes: GET /api/v3/third_party/establishments
Hacé el match por nombre o ubicación con tus propios registros
Guardá el local_id de SIMA mapeado a tu propio ID
Usá external_code en creaciones/actualizaciones futuras para mantener el vínculo

Empezar

Guías de Integración

Resumen

Orden de configuración

Establecimientos

Crear

Actualizar

Eliminar

Listar

Lotes

Listar (v2)

Crear (v3)

Actualizar / eliminar (v3)

Campañas Madre y Campañas

Listar Campañas Madre

Listar Ciclos de Campaña Madre

Listar Campañas

Cultivos

Listar especies (catálogo)

Listar campañas (instancia en lote — referencia de OTs)

Vincular tus IDs con los IDs de SIMA

Manejo de entidades existentes

Próximos pasos

Datos Maestros

Órdenes de Trabajo

​Resumen

​Orden de configuración

​Establecimientos

​Crear

​Actualizar

​Eliminar

​Listar

​Lotes

​Listar (v2)

​Crear (v3)

​Actualizar / eliminar (v3)

​Campañas Madre y Campañas

​Listar Campañas Madre

​Listar Ciclos de Campaña Madre

​Listar Campañas

​Cultivos

​Listar especies (catálogo)

​Listar campañas (instancia en lote — referencia de OTs)

​Vincular tus IDs con los IDs de SIMA

​Manejo de entidades existentes

​Próximos pasos

Datos Maestros

Órdenes de Trabajo

Resumen

Orden de configuración

Establecimientos

Crear

Actualizar

Eliminar

Listar

Lotes

Listar (v2)

Crear (v3)

Actualizar / eliminar (v3)

Campañas Madre y Campañas

Listar Campañas Madre

Listar Ciclos de Campaña Madre

Listar Campañas

Cultivos

Listar especies (catálogo)

Listar campañas (instancia en lote — referencia de OTs)

Vincular tus IDs con los IDs de SIMA

Manejo de entidades existentes

Próximos pasos