Primeros pasos

1. Pedí tus credenciales

Un administrador de tu sistema Gescom Web te tiene que dar estos cuatro datos:

Dato	Ejemplo	Para qué se usa
Realm	miempresa	Identifica tu tenant en el servidor de autenticación.
URL del sitio	miempresa.gescom.online	Dominio al que se hacen los llamados a la API.
Usuario	integracion	Usuario con permisos para los endpoints que vas a usar.
Clave		Clave de ese usuario.

2. Obtené un token

Pedí el token a Keycloak con usuario y clave. Reemplazá REALM, USUARIO y CLAVE:

curl https://auth.gescom.online/realms/REALM/protocol/openid-connect/token \
  --data client_id=gcw-web-api \
  --data grant_type=password \
  --data username=USUARIO \
  --data password=CLAVE

Si todo sale bien, la respuesta es un JSON con el token:

{
  "access_token": "eyJz93a...k4laUWw",
  "token_type": "Bearer",
  "expires_in": 300,
  "refresh_token": "eyJhbGciOi..."
}

expires_in es la vida del token en segundos. Más detalles en Autenticación.

3. Hacé tu primer llamado

Con el token, pedí las alícuotas de IVA de tu tenant. Reemplazá <sitioweb> y <token>:

curl https://<sitioweb>/data/cmd/config/api/v1/get-alicuotas-iva \
  -H "Authorization: Bearer <token>"

La respuesta es un array JSON:

[
  { "codigo": "I21", "descripcion": "IVA 21", "noGravado": false, "porcentaje": 0.21 },
  { "codigo": "I105", "descripcion": "Iva 10.5", "noGravado": false, "porcentaje": 0.105 }
]

O probalo desde el portal

1. Tocá Conectar arriba a la derecha y cargá tus cuatro datos.
2. Abrí la Referencia, elegí un endpoint y usá Test Request.
3. Copiá el snippet en el lenguaje que uses: ya trae tu URL y tu token.

Antes de integrar, leé las Convenciones: explican cómo se pasan los parámetros, cómo se pagina y cómo leer las respuestas de escritura.