Inicio Rápido

Lo que necesitás

Una cuenta API (usá la cuenta demo para empezar de inmediato)
Un cliente REST — Postman o curl

Paso 1 — Autenticarte

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

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"
  }'

$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;

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"]

Respuesta exitosa (HTTP 200):

{
  "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"
  }
}

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.

Paso 2 — Tu primera solicitud

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

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"

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

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

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

{
  "items": [
    {
      "id": 1234,
      "name": "Establecimiento Demo",
      "external_code": null,
      "active": true,
      "created_at": "2024-01-15T10:30:00-03:00",
      "updated_at": "2024-06-01T08:00:00-03:00",
      "deleted_at": null
    }
  ],
  "current_page": 1,
  "next_page": null,
  "total_pages": 1,
  "total_items": 1
}

Paso 3 — Explorá la referencia de API

La referencia interactiva incluye todos los endpoints con un playground en vivo. Ya no necesitás Postman para explorar la API — aunque la colección de Postman sigue disponible como alternativa.

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
Usuario web (ES)	`demo-web@sima.ag`
Usuario web (PT)	`demo-web-pt@sima.ag`

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

Próximos pasos

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

Integrar Órdenes de Trabajo

La guía completa para crear y sincronizar OTs

Configurar la Jerarquía

Sociedades, Establecimientos, Campañas y Lotes

Sincronizar Datos Maestros

Aplicadores, Máquinas, Formulados y Unidades

Scouting y Monitoreo

Registrá adversidades y observaciones de campo

Referencia de API

108 endpoints con playground interactivo

Empezar

Guías de Integración

Lo que necesitás

Paso 1 — Autenticarte

Paso 2 — Tu primera solicitud

Paso 3 — Explorá la referencia de API

Cuenta demo

Próximos pasos

Integrar Órdenes de Trabajo

Configurar la Jerarquía

Sincronizar Datos Maestros

Scouting y Monitoreo

Referencia de API

​Lo que necesitás

​Paso 1 — Autenticarte

​Paso 2 — Tu primera solicitud

​Paso 3 — Explorá la referencia de API

​Cuenta demo

​Próximos pasos

Integrar Órdenes de Trabajo

Configurar la Jerarquía

Sincronizar Datos Maestros

Scouting y Monitoreo

Referencia de API

Lo que necesitás

Paso 1 — Autenticarte

Paso 2 — Tu primera solicitud

Paso 3 — Explorá la referencia de API

Cuenta demo

Próximos pasos