Autenticación

Resumen

SIMA usa autenticación basada en tokens. Cada solicitud debe incluir un access_token válido obtenido via el endpoint de login. Los tokens tienen fecha de expiración y pueden renovarse con un refresh_token sin necesidad de hacer login nuevamente.

string

/api/v2/login

Headers requeridos

Header	Valor	Descripción
`Accept`	`application/json`	Requerido en todas las solicitudes
`Content-Type`	`application/json`	Requerido en todas las solicitudes
`X-SIMA-SYSTEM-ID`	`8`	Identifica tu sistema como integrador de Terceros

El header X-SIMA-SYSTEM-ID: 8 es requerido en todas las llamadas a la API, no solo en el login. Sin él, las solicitudes serán rechazadas.

Cuerpo de la solicitud

{
  "email": "tu-usuario-api@example.com",
  "password": "tu-contraseña"
}

Respuesta

{
  "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": "Nombre de tu Sociedad",
    "syncCheck": "usuario@example.com3293547"
  }
}

Guardá tanto el access_token como el refresh_token — los vas a necesitar para sesiones continuas.

Usar el token

Incluí el access_token como Bearer token en el header Authorization de cada solicitud:

Authorization: Bearer aff6ac1d-b48c-4ea4-aba2-a2753bf2abf5

Ejemplo completo:

curl -X GET https://api.qa.sima.ag/api/v3/establishments \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer aff6ac1d-b48c-4ea4-aba2-a2753bf2abf5" \
  -H "X-SIMA-SYSTEM-ID: 8"

Expiración y renovación del token

Los tokens expiran según la fecha indicada en expiration_datetime. Cuando un token expira, tenés dos opciones: Opción A — Re-login: Llamá a /api/v2/login nuevamente con tus credenciales. Opción B — Refresh: Usá el refresh_token para obtener un nuevo access_token sin enviar credenciales (recomendado para integraciones en producción).

Requisitos del usuario

La cuenta utilizada para acceso API debe tener el rol api_integrated asignado en SIMA. Si la autenticación falla con email/contraseña válidos, contactá a soporte@sima.ag para verificar que el rol esté configurado.

Respuestas de error

Los errores de login se detallan abajo. Para el catálogo completo de códigos HTTP que aplican a todos los endpoints, consultá Errores y Límites.

HTTP Status	Significado
`401 Unauthorized`	Token inválido o expirado
`403 Forbidden`	Token válido pero permisos insuficientes
`400 Bad Request`	Cuerpo de la solicitud faltante o mal formado

Resumen

Llamá a POST /api/v2/login

Incluí el header X-SIMA-SYSTEM-ID: 8 y tus credenciales en el cuerpo.

Guardá el access_token

Almacenalo de forma segura — lo usarás en cada solicitud siguiente.

Agregá el header Authorization

Incluí Authorization: Bearer TU_TOKEN y X-SIMA-SYSTEM-ID: 8 en cada solicitud.

Manejá la expiración

Monitoreá expiration_datetime y renovalo proactivamente para evitar interrupciones.

Empezar

Guías de Integración

Resumen

Headers requeridos

Cuerpo de la solicitud

Respuesta

Usar el token

Expiración y renovación del token

Requisitos del usuario

Respuestas de error

Resumen

​Resumen

​Endpoint de login

​Headers requeridos

​Cuerpo de la solicitud

​Respuesta

​Usar el token

​Expiración y renovación del token

​Requisitos del usuario

​Respuestas de error

​Resumen

Resumen

Endpoint de login

Headers requeridos

Cuerpo de la solicitud

Respuesta

Usar el token

Expiración y renovación del token

Requisitos del usuario

Respuestas de error

Resumen