Alcance y límites
Reglas de alcance
Antes de diseñar (y cotizar) tu integración, tené en cuenta estas reglas del alcance actual:
- Cada app/token está asociada a un solo depósito.
- Cada app/token está asociada a un solo punto de venta.
- El stock que recibís y los pedidos que enviás se resuelven dentro de esa configuración.
- La autenticación se realiza por token.
Una app = un depósito + un punto de venta
Si tu proyecto necesita múltiples depósitos o múltiples puntos de venta, hoy se resuelve con integraciones separadas o coordinando el caso con el equipo.
Límites de frecuencia
| Operación | Límite | Si lo superás |
|---|---|---|
GetData / GetDataCurva (catálogo) | mínimo 10 min entre consultas | 403 Forbidden |
exportar/* (exportaciones) | 10 min en producción (3 min en test), bucket compartido | 403 Forbidden |
stock/movimiento | 3 s entre requests | 403 Forbidden |
Endpoints de parámetros (config, config/depositos, depositos, medios-pago) | 60 s en producción (10 s en test) | 403 Forbidden |
venta | anti-duplicados 30 s por ordenId | rechazo |
facturar | anti-duplicados 30 s por facturaId | rechazo |
No existe "stock en tiempo real" por polling
La frecuencia mínima de catálogo es de 10 minutos. Para acercarte a tiempo real usá webhooks (push) + caché local, no polling agresivo.
Bucket compartido de exportaciones
Las exportaciones (exportar/clientes, exportar/ventaitems, exportar/stock,
exportar/saldos/*) comparten la misma ventana de rate limit por tenant: solo se puede
ejecutar una exportación dentro de la ventana. Planificá las corridas para no pisarte.
Qué conviene definir antes de desarrollar
- Si tu caso necesita solo lectura o también pedidos/ventas.
- Si vas a trabajar con stock por caché + webhooks o por polling respetando los 10 min.
- Si tu modelo debe contemplar variantes (talle/color).
- Dónde vas a guardar el token (siempre backend).
- Cómo vas a persistir catálogo, stock, logs e idempotencia de pedidos.