MOTUM OS
Inicio › Documentación

API y documentación

Para desarrolladores y agentes

Motum OS expone una API pública para integrar el sistema operativo de tu flota. Todos los endpoints devuelven JSON y aceptan llamadas desde cualquier origen (CORS abierto). Empezá por el más útil: el motor de liquidación.

Recursos machine-readable

openapi.json — especificación OpenAPI 3.1  ·  llms.txt — guía para agentes/LLMs  ·  sitemap.xml

POST /api/calc

Calcula la liquidación dueño↔chofer con el mismo motor que usa el producto. Cálculo puro: no toca datos, sin PII, sin auth. pct_owner acepta fracción (0.4) o porcentaje (40).

curl -s https://motumfleet.com/api/calc \
  -H "Content-Type: application/json" \
  -d '{"bruto":800000,"cobrado_efectivo":300000,"gnc":60000,
       "rule":{"type":"porcentaje","pct_owner":40}}'

 {"ok":true,"neto":120000,"a_favor_de":"chofer",
     "resumen":"El dueño le paga al chofer $120.000."}

Modelo alquiler: {"cobrado_tarjeta":500000,"gnc":60000,"rule":{"type":"alquiler","monto_alquiler":250000}}. Probalo también en la calculadora.

POST /api/lead

Registra un interés comercial. Requiere email. Con soft:true no crea cuenta ni manda bienvenida (baja intención).

{"email":"dueño@flota.com","vehicles":8,"kind":"dueño","source":"api"}
 {"ok":true}

GET /api/pair?action=status&device=…

Estado de vinculación de un dispositivo de chofer con su flota.

 {"linked":true,"fleet":"Flota Uber — Neuquén","driverName":"Martín Gutiérrez"}

GET /api/positions

Posiciones en vivo. Sin owner devuelve solo datos de demostración; las posiciones reales requieren el email del dueño.

 {"positions":[ … ]}

POST /api/copilot

Copiloto de IA de la flota (lado dueño). Con owner (email real) usa datos y herramientas; degrada a {"fallback":true} si la IA está apagada.

{"message":"¿quién está manejando ahora?","owner":"dueño@flota.com"}
 {"reply":"Tenés 27 unidades transmitiendo ahora…"}