Obtené un token
- En el panel de la tienda, abrí Configuración → API y webhooks y creá una aplicación. Ponele el nombre de tu sistema, por ejemplo
ERP sync. - Elegí los scopes que necesita la aplicación, por ejemplo
catalog:readeinventory:write, y ninguno más: mirá aplicaciones, tokens y scopes. - Emití un token para la aplicación. Se muestra una sola vez: copialo al almacén de secretos de tu sistema.
Los ejemplos leen el token de la variable de entorno SALEYA_API_TOKEN. Cada solicitud lo envía en el encabezado Authorization: Bearer; un token en la dirección se rechaza.
Verificá el token
GET /me funciona con cualquier token y dice en nombre de quién habla: la aplicación, sus scopes y locales, y sus límites de solicitudes.
curl "https://api.saleya.app/v1/me" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"HTTP/1.1 200 OK
{
"app": {
"id": 12,
"name": "ERP sync",
"description": null,
"scopes": [
"catalog:read",
"catalog:write",
"inventory:read",
"inventory:write",
"orders:read"
],
"allowed_ips": [
"203.0.113.10"
],
"all_locations": true,
"location_ids": [],
"created_at": "2026-11-02T09:15:00Z"
},
"token": {
"name": "Production",
"prefix": "saleya_at_3kQ9",
"expires_at": null
},
"store_id": 7,
"rate_limits": {
"app": {
"per_minute": 300,
"burst": 100
},
"store": {
"per_minute": 1200,
"burst": 400
}
}
}Un 401 acá significa que el token no fue aceptado: revisá que se haya copiado entero. El type de la respuesta dice qué está mal exactamente — mirá errores.
Leé la configuración de la tienda
GET /store devuelve con qué se leen las demás respuestas:
- el dinero es un entero en las unidades menores de
currency:129900en ARS es 1.299,00; los campos que terminan en_micro, como los costos, están en millonésimas de unidad menor; - los momentos van en UTC, RFC 3339:
2026-11-11T14:30:00Z; los días y horarios de la tienda siguen sutimezone; - los nombres y descripciones son objetos por idioma,
{"es": "…", "en": "…"}, en los idiomas desupported_locales.
curl "https://api.saleya.app/v1/store" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"HTTP/1.1 200 OK
{
"id": 7,
"name": {
"es": "Almacén Norte",
"en": "North Grocery"
},
"currency": "ARS",
"timezone": "America/Argentina/Buenos_Aires",
"country": "AR",
"default_locale": "es",
"supported_locales": [
"es",
"en"
],
"marketing_consent_mode": "opt_in"
}Leé los productos
Un listado devuelve una página de registros en data y el cursor de la página siguiente. Pedí la primera página de productos:
curl "https://api.saleya.app/v1/products?limit=50" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"Para mantener una copia del catálogo, leé el listado hasta el final y guardá el cursor de sincronización de la última página: paginación y sincronización muestra el ciclo.
Próximos pasos
- Enviá un
Idempotency-Keycon cada escritura, para que un reintento no la aplique dos veces — idempotencia. - El cambio de un registro con versión necesita su
ETagenIf-Match— versiones e If-Match. - Suscribite a eventos en lugar de consultar una y otra vez — webhooks.
- Probá contra una tienda aparte de tu cuenta — tienda de desarrollo.