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 y Productor

El contexto de tu sociedad se devuelve en la respuesta del login como society.id. Las sociedades no se crean via API. Los productores sí: CRUD en v3 (GET/POST/PATCH/DELETE /api/v3/third_party/farmers). Ver Productores.

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