> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tp.sima.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> API de Terceros de SIMA — integrá tu sistema con la plataforma de gestión agropecuaria

## ¿Qué es SIMA?

SIMA es una plataforma de gestión agropecuaria que centraliza las operaciones de campo a través de establecimientos, campañas y cultivos. La API de Terceros permite que sistemas externos lean y escriban datos en SIMA de forma segura, habilitando la sincronización en tiempo real entre tu plataforma y las operaciones de tus clientes.

## ¿Para quién es esta API?

Esta API está diseñada para:

* **Proveedores de ERP / software agropecuario** que necesitan sincronizar Órdenes de Trabajo con SIMA
* **Apps de scouting y monitoreo** que registran observaciones de campo en tiempo real
* **Plataformas de analítica de datos** que consumen datos estructurados de campañas y productividad
* **Cooperativas y agro-holdings** que gestionan el intercambio de datos centralizado entre múltiples productores

## ¿Qué podés hacer con ella?

<CardGroup cols={2}>
  <Card title="Órdenes de Trabajo" icon="clipboard-list">
    Creá, actualizá y sincronizá operaciones de campo (OTs) entre tu sistema y SIMA de forma bidireccional.
  </Card>

  <Card title="Estructura Jerárquica" icon="sitemap">
    Consultá y gestioná la jerarquía de entidades: Sociedades → Establecimientos → Campañas → Lotes.
  </Card>

  <Card title="Datos Maestros" icon="database">
    Accedé y sincronizá Aplicadores, Máquinas, Formulados, Unidades y más — necesario antes de crear Órdenes de Trabajo.
  </Card>

  <Card title="Scouting y Monitoreo" icon="magnifying-glass">
    Registrá observaciones de campo y adversidades, habilitando la detección temprana de problemas desde sensores y apps de terceros.
  </Card>
</CardGroup>

## Resumen técnico

* **Protocolo:** REST — verbos HTTP estándar (GET, POST, PUT, DELETE)
* **Formato:** JSON para todas las solicitudes y respuestas
* **Autenticación:** Basada en tokens via `POST /api/v2/login`
* **Versionado:** Endpoints disponibles en `v1`, `v2` y `v3` — usá siempre la versión más reciente disponible

## Entornos

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

<Info>
  El entorno de QA se resetea cada 15 días. Usalo libremente durante el desarrollo y las pruebas.
</Info>

## Antes de empezar

1. Solicitá credenciales API a [soporte@sima.ag](mailto:soporte@sima.ag) o usá la [cuenta demo](/quickstart#cuenta-demo) para probar
2. Descargá la [colección de Postman](https://documenter.getpostman.com/view/12638281/2sA3Qy4Thh) para explorar todos los endpoints disponibles
3. Seguí el [Inicio Rápido](/quickstart) para hacer tu primera llamada a la API en menos de 5 minutos