Saltar al contenido
FlotaLista

API · plan Empresa

Tu empresa emite sus propias llaves

Con los permisos que decidas y la vigencia que tú controles. Nadie presta su contraseña para que un proveedor conecte un sistema, y cada llave deja rastro de cuándo se usó por última vez.

El candado es real: si la empresa baja de plan, una llave viva deja de autenticar en la siguiente petición.

Llaves de API

Integraciones · plan Empresa

Emitir llave

Apunta aquíhttps://api.flotalista.com/api/v1

  • Sistema de facturación9f4c1a…Leer gastos · Leer unidadesHoy 06:4014 may 2027
  • Sistema de despacho2a71bd…Registrar kilometrajeHoy 07:02Sin vencimiento
  • Tablero de direcciónc085e2…Leer tablero y reportesAyer 18:153 feb 2027

Reconstrucción del producto · datos de ejemplo

Das exactamente el acceso que quieres dar

Veinticuatro permisos repartidos en quince grupos, cada uno con su casilla. Al sistema de facturación le das leer gastos y nada más; al que empuja el kilometraje, escribir lecturas y nada más.

Aprobar, autorizar, cerrar y eliminar no están en el catálogo, y es a propósito: son decisiones de una persona, y una integración no es una persona. Tampoco hay permisos de equipo, roles, facturación ni ajustes.

Reconstrucción del producto · datos de ejemplo

Qué puedes construir con la llave

FlotaLista no trae conectores hechos y no queremos que lo descubras después: no hay un botón que diga «conectar con mi facturación». Lo que hay es un contrato estable y una llave, para que tú o tu proveedor escriban la conexión una vez y quede.

Tu sistema de facturación

Bajar los gastos del mes con su categoría, su centro de costo y su comprobante, para conciliarlos contra lo que ya facturaste.

Tu nómina o control de personal

Leer qué conductor trae qué unidad y desde cuándo, sin que nadie recapture la asignación en dos sistemas.

Tus hojas de cálculo

Alimentar el tablero de dirección que ya existe, en vez de pedirle a alguien que copie y pegue el lunes por la mañana.

El sistema que ya registra tu kilometraje

FlotaLista no instala equipos ni los lee: no hay rastreo, ni telemetría, ni geocercas, y no los habrá. Pero si un sistema tuyo ya registra el kilometraje —un despacho, una bitácora electrónica—, esa lectura sí se puede empujar a la llave, y entonces los servicios se programan solos con el uso real.

Qué se lee, qué se escribe y cómo se ve

PermisoEn una frase
Leer Tus unidades con su estado y su expediente, las lecturas de kilometraje, los gastos con su categoría y su comprobante, los documentos con su vencimiento, las fallas, las órdenes de trabajo, los conductores con su asignación vigente y el inventario de refacciones con sus existencias, costos promedio y movimientos.
Escribir Dar de alta unidades, registrar lecturas de kilometraje u horómetro, capturar gastos y reportar fallas — es decir, lo que otro sistema tuyo ya sabe y no debería teclearse dos veces.

Registrar el kilometraje de una unidad es la llamada que más se automatiza, porque es el dato que dispara los mantenimientos. Así se ve completa, sin librerías:

Lo que envías
curl -X POST \
  https://api.flotalista.com/api/v1/vehicles/01JD8FPZX2C4T9V7W3H5N8R6K1/meter-readings \
  -H "Authorization: Bearer 42|tu-llave-de-integracion" \
  -H "Content-Type: application/json" \
  -d '{"value": 142380}'
Lo que responde
{
  "data": {
    "id": "01JD8FQ0V9RN3EJ5MP9QK2M7XA",
    "meter_type": "odometro",
    "value": "142380.00",
    "reading_at": "2026-07-29T19:05:00.000000Z",
    "status": "valida"
  }
}

Si el valor viene por debajo de la lectura anterior, la respuesta no falla: la lectura nace marcada como sospechosa, no mueve el acumulado y queda pendiente de que una persona la revise. Una llave tiene un límite de 300 peticiones por minuto. No hay webhooks ni librería oficial todavía: hoy se consulta, no te avisa.

Ver la referencia completa, ruta por ruta

¿Tienes quien lo conecte?

Cuéntanos qué sistema quieres conectar y en la demostración te decimos si el contrato ya lo cubre o qué falta. Si falta algo, te lo decimos ahí, no después de firmar.