Skip to main content

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

Abrir colección de Postman

Explorá y probá todos los endpoints de la API de Terceros de SIMA

​
Cuenta demo

Usá estas credenciales para probar contra el entorno de QA sin costo:
Valor
Email APIdemo@sima.ag
Contraseña APIdemo_sima
URL Webhttps://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