Referencia de API

Resumen

La referencia interactiva se genera automáticamente desde la especificación OpenAPI, sincronizada diariamente con la colección de Postman de SIMA. Incluye todos los endpoints agrupados por dominio, con schemas de request/response y un playground en vivo para probar llamadas directamente desde el browser.

Usá el playground de cada endpoint para probar con tu token. Necesitás autenticarte primero — seguí el Inicio Rápido o la guía de Autenticación.

Antes de explorar endpoints

Glosario SIMA ↔ ERP

Equivalencias Campaña / Cultivo / Ciclo con tu ERP

Versiones de la API

Qué versión usar para cada recurso (v1/v2/v3)

Schemas de Entidades

Tablas de campos: tipo, obligatorio, editable

Glosario

Términos de negocio ES → endpoints EN

Glosario SIMA ↔ ERP

Equivalencias con jerga de ERPs (Campaña, Cultivo, Ciclo…)

Errores y Límites

Códigos HTTP y manejo de errores

Dominios de endpoints

Dominio	Versiones	Notas
Authentication	v2	Login y refresh token
Work Orders	v1 (integración), v3	Lectura v3; escritura `/integration/api/v1/workOrders`
Hierarchy	v2, v3	Establecimientos, lotes, campañas, cultivos; listado de lotes en v2
Master Data	v2, v3	Formulados, aplicadores (CRUD v2), máquinas, unidades, tipos de labor
Scouting	v2, v3	Solo lectura; catálogo de adversidades en v2
Progress & Controls	v3	Avances, controles de siembra/fertilización/stand
Silobags	v3	Solo lectura
IoT / Weather	v3	Dispositivos, eventos, factores climáticos, anomalías
Campaign Import	v2	Importación asíncrona de rendimiento objetivo
Tags & Waypoints	v3	Etiquetas, asociaciones y waypoints de campo

URLs base

Entorno	URL
Pruebas (QA)	`https://api.qa.sima.ag`
Producción	`https://api.sima.ag`

Headers requeridos

Cada solicitud debe incluir:

Authorization: Bearer {access_token}
X-SIMA-SYSTEM-ID: 8
Accept: application/json
Content-Type: application/json

Sincronización con Postman

La especificación OpenAPI se regenera automáticamente cada día desde la colección de Postman autorizada. Postman y esta referencia comparten la misma fuente — nunca quedan desincronizados.

Colección de Postman

Explorá endpoints en Postman (alternativa al playground)

Especificación OpenAPI

La spec completa está disponible en el repositorio como openapi.yaml y se actualiza via GitHub Actions.

General

Endpoints

Resumen

Antes de explorar endpoints

Glosario SIMA ↔ ERP

Versiones de la API

Schemas de Entidades

Glosario

Glosario SIMA ↔ ERP

Errores y Límites

Dominios de endpoints

URLs base

Headers requeridos

Sincronización con Postman

Colección de Postman

Especificación OpenAPI

​Resumen

​Antes de explorar endpoints

Glosario SIMA ↔ ERP

Versiones de la API

Schemas de Entidades

Glosario

Glosario SIMA ↔ ERP

Errores y Límites

​Dominios de endpoints

​URLs base

​Headers requeridos

​Sincronización con Postman

Colección de Postman

​Especificación OpenAPI

Resumen

Antes de explorar endpoints

Dominios de endpoints

URLs base

Headers requeridos

Sincronización con Postman

Especificación OpenAPI