Autenticación
Las llamadas server-to-server usan claves de API generadas en Ajustes → Integraciones de tu compañía. No compartas claves en frontend público ni las subas a repositorios.
Rotá claves si un desarrollador sale del equipo o si sospechás filtración. Cada request debe ir por HTTPS.
Recursos principales
Inventario: productos, variantes, stock por ubicación. Ventas: órdenes, pagos, estados. Catálogo público: lectura según slug de tienda.
Los campos multimoneda incluyen moneda y referencia de tasa aplicada en la venta cuando corresponde.
- Paginación cursor-based en listados grandes
- Idempotency-Key recomendada en POST de órdenes
- Filtros por updated_at para sincronización incremental
Límites y errores
Rate limits protegen la plataforma; respondemos 429 con Retry-After cuando aplica. Los errores 4xx traen código machine-readable y mensaje en español cuando es validación de negocio.
No garantizamos SLA enterprise en plan Free; planes pagos pueden acordar soporte según contrato.
Webhooks relacionados
Ventas, inventario bajo y eventos WhatsApp se documentan en páginas específicas. Ver /docs/whatsapp-webhooks.
Soporte técnico
Integraciones custom: support@kipuapp.store con descripción del caso de uso y volumen estimado.