> ## 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.

# Inicio Rápido

> Hacé tu primera llamada a la API de SIMA en menos de 5 minutos

## Lo que necesitás

* Una cuenta API (usá la [cuenta demo](#cuenta-demo) para empezar de inmediato)
* Un cliente REST — [Postman](https://documenter.getpostman.com/view/12638281/2sA3Qy4Thh) o `curl`

***

## Paso 1 — Autenticarte

Todas las llamadas a la API requieren un `access_token` válido. Obtenelo llamando al endpoint de login.

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.qa.sima.ag/api/v2/login \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "X-SIMA-SYSTEM-ID: 8" \
    -d '{
      "email": "demo@sima.ag",
      "password": "demo_sima"
    }'
  ```

  ```php PHP theme={null}
  $response = $client->post('/api/v2/login', [
      'headers' => [
          'Accept'           => 'application/json',
          'Content-Type'     => 'application/json',
          'X-SIMA-SYSTEM-ID' => '8',
      ],
      'json' => [
          'email'    => 'demo@sima.ag',
          'password' => 'demo_sima',
      ],
  ]);
  $token = json_decode($response->getBody())->access_token;
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.qa.sima.ag/api/v2/login",
      headers={
          "Accept": "application/json",
          "Content-Type": "application/json",
          "X-SIMA-SYSTEM-ID": "8",
      },
      json={"email": "demo@sima.ag", "password": "demo_sima"},
  )
  token = response.json()["access_token"]
  ```
</CodeGroup>

**Respuesta exitosa (HTTP 200):**

```json theme={null}
{
  "access_token": "aff6ac1d-b48c-4ea4-aba2-a2753bf2abf5",
  "refresh_token": "20626ffd-1288-4106-ac10-dc5a5f3487bc",
  "expiration_datetime": "2024-06-16T17:38:58-03:00",
  "society": {
    "id": 34,
    "legalName": "Sociedad Demo"
  }
}
```

<Warning>
  Guardá tu `access_token` — lo vas a necesitar en cada llamada siguiente. Tiene fecha de expiración; usá el `refresh_token` para renovarlo sin volver a hacer login.
</Warning>

***

## Paso 2 — Tu primera solicitud

Con el token, consultá la lista de Establecimientos para verificar que todo funciona:

<CodeGroup>
  ```bash curl theme={null}
  curl -X GET https://api.qa.sima.ag/api/v3/establishments \
    -H "Accept: application/json" \
    -H "Authorization: Bearer TU_ACCESS_TOKEN" \
    -H "X-SIMA-SYSTEM-ID: 8"
  ```

  ```php PHP theme={null}
  $response = $client->get('/api/v3/establishments', [
      'headers' => [
          'Accept'           => 'application/json',
          'Authorization'    => 'Bearer ' . $token,
          'X-SIMA-SYSTEM-ID' => '8',
      ],
  ]);
  ```

  ```python Python theme={null}
  response = requests.get(
      "https://api.qa.sima.ag/api/v3/establishments",
      headers={
          "Accept": "application/json",
          "Authorization": f"Bearer {token}",
          "X-SIMA-SYSTEM-ID": "8",
      },
  )
  ```
</CodeGroup>

Si recibís una lista de establecimientos (aunque sea un array vacío `[]`), tu integración está funcionando correctamente.

***

## Paso 3 — Explorá la colección de Postman

La colección de Postman incluye todos los endpoints disponibles con ejemplos preconfigurados para cada recurso.

<Card title="Abrir colección de Postman" icon="arrow-up-right-from-square" href="https://documenter.getpostman.com/view/12638281/2sA3Qy4Thh">
  Explorá y probá todos los endpoints de la API de Terceros de SIMA
</Card>

***

## Cuenta demo

Usá estas credenciales para probar contra el entorno de QA sin costo:

|                      | Valor                                            |
| -------------------- | ------------------------------------------------ |
| **Email API**        | `demo@sima.ag`                                   |
| **Contraseña API**   | `demo_sima`                                      |
| **URL Web**          | [https://env.qa.sima.ag](https://env.qa.sima.ag) |
| **Usuario web (ES)** | `demo-web@sima.ag`                               |
| **Usuario web (PT)** | `demo-web-pt@sima.ag`                            |

<Info>
  El entorno de QA se resetea periódicamente. Los datos que crees ahí pueden ser eliminados durante los resets.
</Info>

***

## Próximos pasos

Ahora que estás autenticado, seguí las guías de integración según tu caso de uso:

<CardGroup cols={2}>
  <Card title="Integrar Órdenes de Trabajo" icon="clipboard-list" href="/guides/work-orders">
    La guía completa para crear y sincronizar OTs
  </Card>

  <Card title="Configurar la Jerarquía" icon="sitemap" href="/guides/hierarchy-setup">
    Sociedades, Establecimientos, Campañas y Lotes
  </Card>

  <Card title="Sincronizar Datos Maestros" icon="database" href="/guides/master-data">
    Aplicadores, Máquinas, Formulados y Unidades
  </Card>

  <Card title="Scouting y Monitoreo" icon="magnifying-glass" href="/guides/scouting">
    Registrá adversidades y observaciones de campo
  </Card>
</CardGroup>