Rutas
Crear Ruta
Crear una nueva ruta/territorio.
POST /api/routes
Crea una nueva ruta para la gestión de territorios.
Auth: Requerida — permiso MANAGE_ROUTES
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
code | string | Sí | Código único por tenant |
name | string | Sí | Nombre de la ruta |
Ejemplo
curl -X POST https://api.reten.ai/api/routes \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{
"code": "ZONE-NORTH",
"name": "North Zone"
}'const response = await fetch("https://api.reten.ai/api/routes", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"Content-Type": "application/json",
},
body: JSON.stringify({ code: "ZONE-NORTH", name: "North Zone" }),
});
const route = await response.json();import requests
response = requests.post(
"https://api.reten.ai/api/routes",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
json={"code": "ZONE-NORTH", "name": "North Zone"},
)
route = response.json()Respuesta 201 Created
{
"id": "dd0e8400-e29b-41d4-a716-446655440000",
"code": "ZONE-NORTH",
"name": "North Zone",
"isActive": true
}Respuestas de Error
| Estado | Descripción |
|---|---|
409 | El código de ruta ya existe |