Silobolsas

Resumen

Las silobolsas son bolsas de almacenamiento de grano en campo. SIMA registra su ubicación, estado (semáforo), cultivos asociados y el historial de monitoreos e extracciones. Sistemas de acopio, logística o ERP pueden sincronizar estos datos en solo lectura.

Monitoreo de campo (scouting) y monitoreo de silobolsa (silobag_scoutings) son dominios distintos con endpoints separados. No uses scouting para inspecciones de silobolsa.

Mapa de entidades

Silobag (silobolsa)
  ├── SilobagCampaign (cultivo / campaña almacenada en la bolsa)
  │     └── quantity_tn, humedad, semáforo de calidad de grano
  └── SilobagScouting (monitoreo o extracción)
        └── semáforo silo, semáforo cereal, toneladas extraídas (si aplica)

Recurso API	Qué representa
`silobags`	La bolsa: código, GPS, semáforo global, fecha de extracción
`silobag_campaigns`	Qué campaña (cultivo en SIMA) y cuántas tn hay en esa bolsa
`silobag_scoutings`	Cada recorrida de control o registro de extracción de grano

Endpoints (v3 — solo lectura)

Operación	Método y ruta
Listar silobolsas	`GET /api/v3/third_party/silobags`
Detalle de silobolsa	`GET /api/v3/third_party/silobags/{id}`
Listar cultivos en silobolsa	`GET /api/v3/third_party/silobag_campaigns`
Listar monitoreos / extracciones	`GET /api/v3/third_party/silobag_scoutings`

Filtros de auditoría v3 (listados): updated_at_from, updated_at_to, created_at_from, created_at_to, deleted_at_from, deleted_at_to, active, más page y size. Ver Estrategia de sincronización.

Detalle

GET /api/v3/third_party/silobags/{id}

Response (ejemplo):

{
  "id": 8,
  "code": "766code",
  "date_extracted": "2024-05-13T12:18:41-03:00",
  "silobag_longitude": "55.000",
  "rebagged": false,
  "semaphore": 3,
  "latitude": "-32.93489339",
  "longitude": "-60.65658509",
  "observations": null,
  "created_at": "2024-05-06T15:56:09-03:00",
  "modified_at": "2024-05-06T15:56:08-03:00",
  "deleted_at": null,
  "active": true
}

Listar

GET /api/v3/third_party/silobags

Filtros propios:

Parámetro	Tipo	Descripción
`id`	int	Filtrar por ID de silobolsa
`code`	string	Código de la bolsa
`semaphore`	int	`1` verde, `2` amarillo, `3` rojo
`rebagged`	int	`1` reembolsada, `0` no
`dateExtractedFrom`	datetime	Extracción desde (inclusive)
`dateExtractedTo`	datetime	Extracción hasta (inclusive)

Los filtros por rango de fecha de extracción usan nombres en camelCase (dateExtractedFrom / dateExtractedTo), no date_extracted_from. El resto de filtros de auditoría v3 siguen el patrón updated_at_from, etc.

Paginación: page, size. La respuesta incluye items, current_page, next_page, total_pages, total_items.

Monitoreos y extracciones (`silobag_scoutings`)

Cada registro es una inspección de la bolsa o una extracción de grano. El semáforo del silo y del cereal se evalúan por separado.

GET /api/v3/third_party/silobag_scoutings

Filtros propios:

Parámetro	Tipo	Descripción
`id`	int	ID del monitoreo
`silobag_id`	int	Silobolsa asociada
`scouting_type`	int	`1` = monitoreo, `2` = extracción
`semaphore_silo`	int	Estado del silo: `1` / `2` / `3`
`semaphore_cereal`	int	Estado del cereal: `1` / `2` / `3`

Response (ítem de ejemplo):

{
  "id": 120,
  "silobag_id": 8,
  "extracted_tn": 12.5,
  "semaphore_silo": 2,
  "semaphore_cereal": 3,
  "scouting_type": 1,
  "created_at": "2024-05-10T09:00:00-03:00",
  "modified_at": "2024-05-10T09:00:00-03:00",
  "deleted_at": null,
  "active": true
}

Para alertas de estado crítico en ambos semáforos:

GET /api/v3/third_party/silobag_scoutings?semaphore_silo=3&semaphore_cereal=3&active=1

Cultivos en silobolsa (`silobag_campaigns`)

Relaciona una silobolsa con una campaña SIMA (cultivo en lote) y las toneladas almacenadas.

GET /api/v3/third_party/silobag_campaigns

Filtros propios:

Parámetro	Tipo	Descripción
`id`	int	ID del vínculo silobolsa–campaña
`silobag_id`	int	Silobolsa
`campaign_id`	int	Campaña SIMA (`campaigns`)
`grain_quality_semaphore`	int	Semáforo de calidad del grano: `1` / `2` / `3`

Response (ítem de ejemplo):

{
  "id": 45,
  "silobag_id": 8,
  "campaign_id": 506362,
  "quantity_tn": 180.0,
  "grain_humidity_percent": 13.5,
  "grain_quality_semaphore": 2,
  "observations": null,
  "created_at": "2024-05-06T15:56:09-03:00",
  "modified_at": "2024-05-06T15:56:08-03:00",
  "deleted_at": null,
  "active": true
}

Para el detalle de la campaña (cultivo, lote, ciclo), combiná con GET /api/v3/third_party/campaigns filtrando por campaign_id.

Valores del semáforo

El campo semaphore en silobags resume el estado actual de la bolsa. En scoutings, semaphore_silo y semaphore_cereal pueden diferir.

Valor	Significado
`1`	Verde — sin problemas relevantes
`2`	Amarillo — requiere atención
`3`	Rojo — situación crítica

Ejemplo: silobolsas en estado crítico:

GET /api/v3/third_party/silobags?semaphore=3&active=1

Campos principales (silobolsa)

Campo	Descripción
`code`	Código de referencia de la bolsa
`silobag_longitude`	Longitud de la bolsa en metros (no confundir con `longitude` GPS)
`latitude` / `longitude`	Coordenadas GPS del punto de la bolsa
`date_extracted`	Fecha de extracción del grano (`null` si sigue en uso)
`rebagged`	Si el grano se transfirió a otra bolsa
`semaphore`	Estado de monitoreo resumido (`1` / `2` / `3`)

Frecuencia de sincronización recomendada

Cosecha / acopio activo: cada pocas horas con updated_at_from en silobags y silobag_scoutings.
Fuera de temporada: sincronización diaria suele alcanzar.
Alertas: priorizá semaphore=3 en silobolsas y combinaciones críticas en silobag_scoutings.

Limitaciones

La API de Terceros expone solo lectura para silobolsas, monitoreos y cultivos en bolsa. Alta y edición se hacen en la app web o móvil de SIMA. Si necesitás escritura por API, contactá soporte@sima.ag.

Próximos pasos

Scouting de campo

Monitoreo en lote (adversidades) — no silobolsa

Jerarquía y campañas

Campañas y cultivos referenciados por silobag_campaigns

Estrategia de sincronización

Filtros updated_at_from y detección de bajas

Glosario

Términos SIMA ↔ endpoints

Empezar

Guías de Integración

Silobolsas

Resumen

Mapa de entidades

Endpoints (v3 — solo lectura)

Silobolsas

Detalle

Listar

Monitoreos y extracciones (`silobag_scoutings`)

Cultivos en silobolsa (`silobag_campaigns`)

Valores del semáforo

Campos principales (silobolsa)

Frecuencia de sincronización recomendada

Limitaciones

Próximos pasos

Scouting de campo

Jerarquía y campañas

Estrategia de sincronización

Glosario

​Resumen

​Mapa de entidades

​Endpoints (v3 — solo lectura)

​Silobolsas

​Detalle

​Listar

​Monitoreos y extracciones (silobag_scoutings)

​Cultivos en silobolsa (silobag_campaigns)

​Valores del semáforo

​Campos principales (silobolsa)

​Frecuencia de sincronización recomendada

​Limitaciones

​Próximos pasos

Scouting de campo

Jerarquía y campañas

Estrategia de sincronización

Glosario

Resumen

Mapa de entidades

Endpoints (v3 — solo lectura)

Silobolsas

Detalle

Listar

Monitoreos y extracciones (`silobag_scoutings`)

Cultivos en silobolsa (`silobag_campaigns`)

Valores del semáforo

Campos principales (silobolsa)

Frecuencia de sincronización recomendada

Limitaciones

Próximos pasos