Integrar ODECIS

ODECIS tiene una API REST y un sistema de webhooks para que conectes tus aplicaciones, tu tienda web o cualquier sistema externo con tu ERP.

Esta es la parte técnica de la guía. Si llegaste acá y todavía no sabes qué es una ubicación, un SKU o una lista de precios, mira primero los Conceptos — la API usa esos mismos nombres, y entenderlos ahorra la mitad del trabajo de integración.

Por dónde empezar

• API REST — los endpoints para productos, inventario, ventas, clientes y facturación.
• Webhooks — cómo recibir un aviso en el momento en que algo pasa, sin estar preguntando.

Base URL

Todas las peticiones van a:

https://api.odecis.com

Autenticación

La API usa JWT. Primero inicias sesión y obtienes un token:

curl -X POST https://api.odecis.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tu-correo@ejemplo.com",
    "password": "tu-password"
  }'

Y después incluyes ese token en el encabezado de cada petición:

Authorization: Bearer <tu-token-jwt>

Todas las respuestas viajan en JSON, con códigos HTTP estándar.

Límites de uso

Para que el servicio sea estable para todos, aplicamos estos topes:

Límite	Alcance
100 peticiones por minuto	por usuario
1000 peticiones por hora	por organización

Cada respuesta trae el encabezado X-RateLimit-Remaining con lo que te queda disponible.

Formato de respuesta

Un recurso individual viene tal cual:

{
  "id": "uuid",
  "name": "..."
}

Una lista viene paginada, con los datos en data y el conteo en meta:

{
  "data": [],
  "meta": {
    "total": 150,
    "page": 1,
    "limit": 20,
    "totalPages": 8
  }
}

Y un error (400, 401, 403, 404, 500) viene con el código y la descripción:

{
  "statusCode": 400,
  "message": "Descripción del error",
  "error": "Bad Request"
}