Flota

Vehículos, posiciones, lugares, horario, mantención y documentos.

Crear un vehículo

POSThttps://api.drometra.com/v1/fleet/vehicles

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

labelobligatoriostring
externalReferencestring o null

Respuesta · 201

idstring · uuidsiempre
tenantIdstring · uuidsiempre
labelstringsiempre
externalReferencestring o nullsiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre
object o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/vehicles" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "…"
  }'

respuesta · 201

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "label": "…",
  "externalReference": "…",
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z",
  "latestPosition": {
    "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "eventId": "…",
    "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "sequence": 1,
    "observedAt": "2026-10-21T14:02:31Z",
    "receivedAt": "2026-10-21T14:02:31Z",
    "latitude": 0,
    "longitude": 0,
    "accuracyMeters": 50000,
    "speedMetersPerSecond": 500,
    "headingDegrees": 0,
    "ageSeconds": 0,
    "quality": {
      "reportedAccuracyMeters": 50000
    }
  }
}

Listar vehículos

GEThttps://api.drometra.com/v1/fleet/vehicles

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

limitinteger
cursorstring

Respuesta · 200

array de objectsiempre
watermarkintegersiempre
nextCursorstring o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/vehicles" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "externalReference": "…",
      "active": true,
      "version": 1,
      "createdAt": "2026-10-21T14:02:31Z",
      "updatedAt": "2026-10-21T14:02:31Z",
      "latestPosition": {
        "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "eventId": "…",
        "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "sequence": 1,
        "observedAt": "2026-10-21T14:02:31Z",
        "receivedAt": "2026-10-21T14:02:31Z",
        "latitude": 0,
        "longitude": 0,
        "accuracyMeters": 50000,
        "speedMetersPerSecond": 500,
        "headingDegrees": 0,
        "ageSeconds": 0,
        "quality": {
          "reportedAccuracyMeters": 50000
        }
      }
    }
  ],
  "watermark": 0,
  "nextCursor": "…"
}

Ver trazos en vivo

GEThttps://api.drometra.com/v1/fleet/live-tracks

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

afterstring · uuid
limitinteger

Respuesta · 200

array de objectsiempre
nextAfterstring · uuid o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/live-tracks" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "items": [
    {
      "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "matched": {
        "fromPositionId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "toPositionId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "geometry": {
          "type": "LineString",
          "coordinates": []
        },
        "confidence": 0.5,
        "provenance": {
          "kind": "valhalla",
          "engine": "…",
          "engineVersion": "…",
          "graphVersion": "…",
          "coverage": {},
          "roadNetwork": true,
          "method": "match"
        }
      }
    }
  ],
  "nextAfter": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d"
}

Ver un vehículo

GEThttps://api.drometra.com/v1/fleet/vehicles/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Respuesta · 200

idstring · uuidsiempre
tenantIdstring · uuidsiempre
labelstringsiempre
externalReferencestring o nullsiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre
object o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "label": "…",
  "externalReference": "…",
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z",
  "latestPosition": {
    "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "eventId": "…",
    "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "sequence": 1,
    "observedAt": "2026-10-21T14:02:31Z",
    "receivedAt": "2026-10-21T14:02:31Z",
    "latitude": 0,
    "longitude": 0,
    "accuracyMeters": 50000,
    "speedMetersPerSecond": 500,
    "headingDegrees": 0,
    "ageSeconds": 0,
    "quality": {
      "reportedAccuracyMeters": 50000
    }
  }
}

Cambiar un vehículo

PATCHhttps://api.drometra.com/v1/fleet/vehicles/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

versionobligatoriointeger
labelstring
externalReferencestring o null
activeboolean

Respuesta · 200

idstring · uuidsiempre
tenantIdstring · uuidsiempre
labelstringsiempre
externalReferencestring o nullsiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre
object o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PATCH "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 0
  }'

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "label": "…",
  "externalReference": "…",
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z",
  "latestPosition": {
    "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "eventId": "…",
    "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "sequence": 1,
    "observedAt": "2026-10-21T14:02:31Z",
    "receivedAt": "2026-10-21T14:02:31Z",
    "latitude": 0,
    "longitude": 0,
    "accuracyMeters": 50000,
    "speedMetersPerSecond": 500,
    "headingDegrees": 0,
    "ageSeconds": 0,
    "quality": {
      "reportedAccuracyMeters": 50000
    }
  }
}

Listar posiciones de un vehículo

GEThttps://api.drometra.com/v1/fleet/vehicles/{id}/positions

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Parámetros de consulta

sourceIdstring · uuid
fromstring · date-time
tostring · date-time
limitinteger
cursorstring

Respuesta · 200

array de objectsiempre
watermarkintegersiempre
nextCursorstring o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/positions" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "eventId": "…",
      "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "sequence": 1,
      "observedAt": "2026-10-21T14:02:31Z",
      "receivedAt": "2026-10-21T14:02:31Z",
      "latitude": 0,
      "longitude": 0,
      "accuracyMeters": 50000,
      "speedMetersPerSecond": 500,
      "headingDegrees": 0
    }
  ],
  "watermark": 0,
  "nextCursor": "…"
}

Ver el día de un vehículo

GEThttps://api.drometra.com/v1/fleet/vehicles/{id}/days/{date}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d
dateobligatoriostring

Respuesta · 200

vehicleIdstring · uuidsiempre
vehicleLabelstringsiempre
datestringsiempre
timeZonestringsiempre
objectsiempre
objectsiempre
objectsiempre
objectsiempre
objectsiempre
object o nullsiempre
objectsiempre
array de object o object o objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/days/<date>" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "vehicleLabel": "…",
  "date": "…",
  "timeZone": "…",
  "window": {
    "from": "2026-10-21T14:02:31Z",
    "to": "2026-10-21T14:02:31Z"
  },
  "rules": {
    "version": "…",
    "maxAccuracyMeters": 0,
    "maxJumpMetersPerSecond": 0,
    "stopRadiusMeters": 0,
    "minStopSeconds": 0,
    "minTripMeters": 0,
    "maxGapSeconds": 0,
    "stillMetersPerSecond": 0,
    "movingMetersPerSecond": 0
  },
  "source": {
    "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "positions": 0,
    "otherSourcesPositions": 0,
    "truncated": true,
    "discarded": {
      "accuracy": 0,
      "jump": 0,
      "duplicate": 0
    }
  },
  "totals": {
    "distanceMeters": 0,
    "movingSeconds": 0,
    "stoppedSeconds": 0,
    "trips": 0,
    "stops": 0,
    "firstDepartureAt": "2026-10-21T14:02:31Z",
    "lastArrivalAt": "2026-10-21T14:02:31Z",
    "maxSpeedMetersPerSecond": 0
  },
  "deliveries": {
    "total": 0,
    "delivered": 0,
    "failed": 0,
    "pending": 0
  },
  "schedule": {
    "hours": {
      "start": "…",
      "end": "…"
    },
    "rules": {
      "version": "…",
      "outside": "…",
      "suggestion": "…"
    }
  },
  "speeding": {
    "limitKmh": 1,
    "episodes": [
      {
        "startedAt": "2026-10-21T14:02:31Z",
        "endedAt": "2026-10-21T14:02:31Z",
        "seconds": 0,
        "maxSpeedMetersPerSecond": 0
      }
    ],
    "rules": {
      "version": "…",
      "limit": "…"
    }
  },
  "timeline": [
    {
      "kind": "stop",
      "startedAt": "2026-10-21T14:02:31Z",
      "endedAt": "2026-10-21T14:02:31Z",
      "durationSeconds": 0,
      "center": {
        "latitude": 0,
        "longitude": 0
      },
      "points": 1,
      "place": {
        "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "name": "…",
        "distanceMeters": 0
      },
      "deliveries": [
        {
          "routeId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
          "stopId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
          "reference": "…",
          "state": "pending",
          "arrivedAt": "2026-10-21T14:02:31Z",
          "outcomeAt": "2026-10-21T14:02:31Z",
          "failureReason": "…",
          "evidence": []
        }
      ]
    }
  ]
}

Ver el mes de un vehículo

GEThttps://api.drometra.com/v1/fleet/vehicles/{id}/months/{month}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d
monthobligatoriostring

Respuesta · 200

vehicleIdstring · uuidsiempre
vehicleLabelstringsiempre
objectsiempre
array de objectsiempre
objectsiempre
object o nullsiempre
objectsiempre
truncatedDaysintegersiempre
scheduledbooleansiempre
objectsiempre
objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/months/<month>" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "vehicleLabel": "…",
  "month": {
    "month": "…",
    "from": "…",
    "to": "…",
    "through": "…",
    "partial": true,
    "timeZone": "…"
  },
  "days": [
    {
      "date": "…",
      "distanceMeters": 0,
      "movingSeconds": 0,
      "trips": 0,
      "stops": 0,
      "firstDepartureAt": "2026-10-21T14:02:31Z",
      "lastArrivalAt": "2026-10-21T14:02:31Z",
      "positions": 0,
      "truncated": true,
      "outsideHours": 0,
      "speeding": 0
    }
  ],
  "totals": {
    "distanceMeters": 0,
    "movingSeconds": 0,
    "trips": 0,
    "activeDays": 0,
    "elapsedDays": 0,
    "outsideHours": 0,
    "speeding": 0
  },
  "longest": {
    "date": "…",
    "distanceMeters": 0
  },
  "analyzed": {
    "positions": 0,
    "trips": 0,
    "stops": 0,
    "vehicles": 0
  },
  "truncatedDays": 0,
  "scheduled": true,
  "narrative": {
    "text": "…",
    "evidence": "…",
    "source": "template"
  },
  "rules": {
    "calendar": {
      "version": "…",
      "days": "…",
      "marks": "…",
      "longest": "…"
    },
    "trips": {
      "version": "…",
      "maxAccuracyMeters": 0,
      "maxJumpMetersPerSecond": 0,
      "stopRadiusMeters": 0,
      "minStopSeconds": 0,
      "minTripMeters": 0,
      "maxGapSeconds": 0,
      "stillMetersPerSecond": 0,
      "movingMetersPerSecond": 0
    },
    "schedule": {
      "version": "…",
      "outside": "…",
      "suggestion": "…"
    },
    "speed": {
      "version": "…",
      "limit": "…"
    }
  }
}

Crear una fuente de posiciones

POSThttps://api.drometra.com/v1/fleet/sources

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

nameobligatoriostring

Respuesta · 201

idstring · uuidsiempre
tenantIdstring · uuidsiempre
namestringsiempre
kindenum: synthetic | phonesiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/sources" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "…"
  }'

respuesta · 201

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "name": "…",
  "kind": "synthetic",
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Listar fuentes de posiciones

GEThttps://api.drometra.com/v1/fleet/sources

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

idstring · uuidsiempre
tenantIdstring · uuidsiempre
namestringsiempre
kindenum: synthetic | phonesiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/sources" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

[
  {
    "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
    "name": "…",
    "kind": "synthetic",
    "active": true,
    "version": 1,
    "createdAt": "2026-10-21T14:02:31Z",
    "updatedAt": "2026-10-21T14:02:31Z"
  }
]

Cambiar una fuente de posiciones

PATCHhttps://api.drometra.com/v1/fleet/sources/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

versionobligatoriointeger
namestring
activeboolean

Respuesta · 200

idstring · uuidsiempre
tenantIdstring · uuidsiempre
namestringsiempre
kindenum: synthetic | phonesiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PATCH "https://api.drometra.com/v1/fleet/sources/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 0
  }'

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "tenantId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "name": "…",
  "kind": "synthetic",
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Enviar posiciones

POSThttps://api.drometra.com/v1/fleet/positions

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

sourceIdobligatoriostring · uuid
eventIdobligatoriostring
vehicleIdobligatoriostring · uuid
observedAtobligatoriostring · date-time
latitudeobligatorionumber
longitudeobligatorionumber
accuracyMetersnumber
speedMetersPerSecondnumber
headingDegreesnumber

Respuesta · 200

idstring · uuidsiempre
sourceIdstring · uuidsiempre
eventIdstringsiempre
vehicleIdstring · uuidsiempre
actorIdstring · uuidsiempre
sequenceintegersiempre
observedAtstring · date-timesiempre
receivedAtstring · date-timesiempre
latitudenumbersiempre
longitudenumbersiempre
accuracyMetersnumber o nullsiempre
speedMetersPerSecondnumber o nullsiempre
headingDegreesnumber o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/positions" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceId": "…",
    "eventId": "…",
    "vehicleId": "…",
    "observedAt": "…",
    "latitude": 0,
    "longitude": 0
  }'

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "sourceId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "eventId": "…",
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "actorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "sequence": 1,
  "observedAt": "2026-10-21T14:02:31Z",
  "receivedAt": "2026-10-21T14:02:31Z",
  "latitude": 0,
  "longitude": 0,
  "accuracyMeters": 50000,
  "speedMetersPerSecond": 500,
  "headingDegrees": 0
}

Listar lugares de la empresa

GEThttps://api.drometra.com/v1/fleet/places

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/places" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "name": "…",
      "kind": "base",
      "coordinate": {
        "latitude": 0,
        "longitude": 0
      },
      "radiusMeters": 275,
      "active": true,
      "version": 1,
      "createdAt": "2026-10-21T14:02:31Z",
      "updatedAt": "2026-10-21T14:02:31Z"
    }
  ]
}

Crear un lugar

POSThttps://api.drometra.com/v1/fleet/places

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.
idempotency-keyobligatoriostring · uuid: Un UUID nuevo por operación. Si repites la petición con la misma clave, el cambio no se aplica dos veces.

Cuerpo

nameobligatoriostring
kindobligatorioenum: base | customer | supplier | fuel | other
coordinateobligatorioobject
radiusMetersinteger

Respuesta · 201

idstring · uuidsiempre
namestringsiempre
kindenum: base | customer | supplier | fuel | othersiempre
objectsiempre
radiusMetersintegersiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/places" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "idempotency-key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "…",
    "kind": "…",
    "coordinate": {}
  }'

respuesta · 201

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "name": "…",
  "kind": "base",
  "coordinate": {
    "latitude": 0,
    "longitude": 0
  },
  "radiusMeters": 275,
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Cambiar un lugar

PATCHhttps://api.drometra.com/v1/fleet/places/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

versionobligatoriointeger
namestring
kindenum: base | customer | supplier | fuel | other
radiusMetersinteger
activeboolean

Respuesta · 200

idstring · uuidsiempre
namestringsiempre
kindenum: base | customer | supplier | fuel | othersiempre
objectsiempre
radiusMetersintegersiempre
activebooleansiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PATCH "https://api.drometra.com/v1/fleet/places/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 0
  }'

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "name": "…",
  "kind": "base",
  "coordinate": {
    "latitude": 0,
    "longitude": 0
  },
  "radiusMeters": 275,
  "active": true,
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Sugerir lugares

GEThttps://api.drometra.com/v1/fleet/places/suggestions

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

daysinteger

Respuesta · 200

objectsiempre
objectsiempre
objectsiempre
array de objectsiempre
objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/places/suggestions" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "window": {
    "from": "…",
    "to": "…",
    "days": 0,
    "timeZone": "…"
  },
  "rules": {
    "places": {
      "version": "…",
      "cluster": "…",
      "frequent": "…",
      "known": "…"
    },
    "trips": {
      "version": "…",
      "maxAccuracyMeters": 0,
      "maxJumpMetersPerSecond": 0,
      "stopRadiusMeters": 0,
      "minStopSeconds": 0,
      "minTripMeters": 0,
      "maxGapSeconds": 0,
      "stillMetersPerSecond": 0,
      "movingMetersPerSecond": 0
    }
  },
  "analyzed": {
    "vehicles": 0,
    "days": 0,
    "stops": 0
  },
  "items": [
    {
      "center": {
        "latitude": 0,
        "longitude": 0
      },
      "spreadMeters": 0,
      "visits": 0,
      "days": 0,
      "vehicles": 0,
      "dwellSeconds": 0,
      "usualArrival": "…",
      "weekdays": [
        4
      ],
      "known": {
        "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
        "name": "…"
      }
    }
  ],
  "heat": {
    "rules": {
      "version": "…",
      "stops": "…",
      "cells": "…",
      "top": "…"
    },
    "totalMinutes": 0,
    "cells": [
      {
        "latitude": 0,
        "longitude": 0,
        "minutes": 0,
        "stops": 0,
        "days": 0
      }
    ],
    "top": [
      {
        "latitude": 0,
        "longitude": 0,
        "minutes": 0,
        "stops": 0,
        "days": 0,
        "share": 0.5,
        "name": "…"
      }
    ]
  }
}

Ver el horario de la flota

GEThttps://api.drometra.com/v1/fleet/schedule

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

array de object o null o nullsiempre
versionintegersiempre
updatedAtstring · date-time o nullsiempre
objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/schedule" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "days": [
    {
      "start": "…",
      "end": "…"
    }
  ],
  "version": 0,
  "updatedAt": "2026-10-21T14:02:31Z",
  "rules": {
    "version": "…",
    "outside": "…",
    "suggestion": "…"
  }
}

Guardar el horario de la flota

PUThttps://api.drometra.com/v1/fleet/schedule

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

daysobligatorioarray de object o null o null
versionobligatoriointeger

Respuesta · 200

array de object o null o nullsiempre
versionintegersiempre
updatedAtstring · date-time o nullsiempre
objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PUT "https://api.drometra.com/v1/fleet/schedule" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "days": [],
    "version": 0
  }'

respuesta · 200

{
  "days": [
    {
      "start": "…",
      "end": "…"
    }
  ],
  "version": 0,
  "updatedAt": "2026-10-21T14:02:31Z",
  "rules": {
    "version": "…",
    "outside": "…",
    "suggestion": "…"
  }
}

Sugerir un horario

GEThttps://api.drometra.com/v1/fleet/schedule/suggestion

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

objectsiempre
objectsiempre
objectsiempre
array de object o null o nullsiempre
array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/schedule/suggestion" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "window": {
    "from": "…",
    "to": "…",
    "weeks": 0,
    "timeZone": "…"
  },
  "rules": {
    "schedule": {
      "version": "…",
      "outside": "…",
      "suggestion": "…"
    },
    "trips": {
      "version": "…",
      "maxAccuracyMeters": 0,
      "maxJumpMetersPerSecond": 0,
      "stopRadiusMeters": 0,
      "minStopSeconds": 0,
      "minTripMeters": 0,
      "maxGapSeconds": 0,
      "stillMetersPerSecond": 0,
      "movingMetersPerSecond": 0
    }
  },
  "analyzed": {
    "vehicles": 0,
    "days": 0,
    "trips": 0
  },
  "days": [
    {
      "start": "…",
      "end": "…"
    }
  ],
  "basis": [
    {
      "weekday": 4,
      "weeks": 0,
      "earliestDeparture": "…",
      "latestArrival": "…"
    }
  ]
}

Ver mantención y papeles por vencer

GEThttps://api.drometra.com/v1/fleet/care

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

todaystringsiempre
array de objectsiempre
array de objectsiempre
kmLimitedbooleansiempre
objectsiempre
objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/care" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "today": "…",
  "vehicles": [
    {
      "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "active": true,
      "care": {
        "technicalReviewUntil": "…",
        "circulationPermitUntil": "…",
        "soapUntil": "…",
        "nextServiceOn": "…",
        "serviceDueKm": 1500000,
        "odometerKm": 1499999.5,
        "odometerAt": "2026-10-21T14:02:31Z",
        "fuelKmPerLiter": 25.5,
        "fuelPricePerLiter": 2550,
        "fuelPriceOn": "…"
      },
      "version": 0,
      "updatedAt": "2026-10-21T14:02:31Z",
      "odometer": {
        "estimatedKm": 0,
        "sinceKm": 0,
        "paceKmPerDay": 0,
        "leftKm": 0,
        "daysLeft": 0,
        "text": "…",
        "serviceText": "…",
        "reminder": "…"
      }
    }
  ],
  "due": [
    {
      "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "item": "technical_review",
      "date": "…",
      "daysLeft": 0,
      "status": "expired",
      "km": {
        "dueKm": 1500000,
        "estimatedKm": 0,
        "leftKm": 0
      },
      "text": "…",
      "attention": true
    }
  ],
  "kmLimited": true,
  "rules": {
    "version": "…",
    "items": "…",
    "soon": "…",
    "today": "…"
  },
  "odometerRules": {
    "version": "…",
    "reading": "…",
    "estimate": "…",
    "pace": "…",
    "soon": "…"
  }
}

Guardar la mantención de un vehículo

PUThttps://api.drometra.com/v1/fleet/vehicles/{id}/care

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

technicalReviewUntilobligatoriostring o null
circulationPermitUntilobligatoriostring o null
soapUntilobligatoriostring o null
nextServiceOnobligatoriostring o null
serviceDueKminteger o null
versionobligatoriointeger

Respuesta · 200

vehicleIdstring · uuidsiempre
labelstringsiempre
activebooleansiempre
object o nullsiempre
versionintegersiempre
updatedAtstring · date-time o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PUT "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/care" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "technicalReviewUntil": "…",
    "circulationPermitUntil": "…",
    "soapUntil": "…",
    "nextServiceOn": "…",
    "version": 0
  }'

respuesta · 200

{
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "label": "…",
  "active": true,
  "care": {
    "technicalReviewUntil": "…",
    "circulationPermitUntil": "…",
    "soapUntil": "…",
    "nextServiceOn": "…",
    "serviceDueKm": 1500000,
    "odometerKm": 1499999.5,
    "odometerAt": "2026-10-21T14:02:31Z",
    "fuelKmPerLiter": 25.5,
    "fuelPricePerLiter": 2550,
    "fuelPriceOn": "…"
  },
  "version": 0,
  "updatedAt": "2026-10-21T14:02:31Z"
}

Anotar el kilometraje

PUThttps://api.drometra.com/v1/fleet/vehicles/{id}/odometer

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

kmobligatoriointeger

Respuesta · 200

vehicleIdstring · uuidsiempre
labelstringsiempre
activebooleansiempre
object o nullsiempre
versionintegersiempre
updatedAtstring · date-time o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PUT "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/odometer" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "km": 0
  }'

respuesta · 200

{
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "label": "…",
  "active": true,
  "care": {
    "technicalReviewUntil": "…",
    "circulationPermitUntil": "…",
    "soapUntil": "…",
    "nextServiceOn": "…",
    "serviceDueKm": 1500000,
    "odometerKm": 1499999.5,
    "odometerAt": "2026-10-21T14:02:31Z",
    "fuelKmPerLiter": 25.5,
    "fuelPricePerLiter": 2550,
    "fuelPriceOn": "…"
  },
  "version": 0,
  "updatedAt": "2026-10-21T14:02:31Z"
}

Anotar rendimiento y precio de combustible

PUThttps://api.drometra.com/v1/fleet/vehicles/{id}/fuel

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

kmPerLiterobligatorionumber o null
pricePerLiterobligatoriointeger o null

Respuesta · 200

vehicleIdstring · uuidsiempre
labelstringsiempre
activebooleansiempre
object o nullsiempre
versionintegersiempre
updatedAtstring · date-time o nullsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PUT "https://api.drometra.com/v1/fleet/vehicles/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/fuel" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "kmPerLiter": 0,
    "pricePerLiter": 0
  }'

respuesta · 200

{
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "label": "…",
  "active": true,
  "care": {
    "technicalReviewUntil": "…",
    "circulationPermitUntil": "…",
    "soapUntil": "…",
    "nextServiceOn": "…",
    "serviceDueKm": 1500000,
    "odometerKm": 1499999.5,
    "odometerAt": "2026-10-21T14:02:31Z",
    "fuelKmPerLiter": 25.5,
    "fuelPricePerLiter": 2550,
    "fuelPriceOn": "…"
  },
  "version": 0,
  "updatedAt": "2026-10-21T14:02:31Z"
}

Listar documentos de la flota

GEThttps://api.drometra.com/v1/fleet/documents

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

todaystringsiempre
objectsiempre
array de objectsiempre
array de objectsiempre
array de objectsiempre
array de objectsiempre
array de objectsiempre
array de objectsiempre
array de objectsiempre
array de objectsiempre
objectsiempre
objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/documents" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "today": "…",
  "rules": {
    "version": "…",
    "items": "…",
    "soon": "…",
    "missing": "…",
    "care": "…",
    "today": "…"
  },
  "types": [
    {
      "key": "…",
      "subject": "vehicle",
      "name": "…",
      "expires": true,
      "blocksDispatch": true,
      "noticeDays": 90.5,
      "renewerActorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "active": true,
      "builtin": true,
      "version": 0
    }
  ],
  "vehicles": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "active": true
    }
  ],
  "drivers": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "active": true
    }
  ],
  "documents": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "typeKey": "…",
      "subject": "vehicle",
      "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "workerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "number": "…",
      "issuedOn": "…",
      "expiresOn": "…",
      "notes": "…",
      "file": {
        "mimeType": "application/pdf",
        "sizeBytes": 5242884,
        "sha256": "…",
        "uploadedAt": "2026-10-21T14:02:31Z"
      },
      "replacesId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "replacedAt": "2026-10-21T14:02:31Z",
      "removedAt": "2026-10-21T14:02:31Z",
      "version": 1,
      "createdAt": "2026-10-21T14:02:31Z",
      "updatedAt": "2026-10-21T14:02:31Z"
    }
  ],
  "slots": [
    {
      "subject": "vehicle",
      "subjectId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "typeKey": "…",
      "typeName": "…",
      "documentId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "expiresOn": "…",
      "status": "expired",
      "daysLeft": 0,
      "hasFile": true,
      "blocksDispatch": true,
      "text": "…"
    }
  ],
  "due": [
    {
      "subject": "vehicle",
      "subjectId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "typeKey": "…",
      "typeName": "…",
      "documentId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "expiresOn": "…",
      "status": "expired",
      "daysLeft": 0,
      "hasFile": true,
      "blocksDispatch": true,
      "text": "…"
    }
  ],
  "missing": [
    {
      "subject": "vehicle",
      "subjectId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "typeKey": "…",
      "typeName": "…",
      "documentId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "expiresOn": "…",
      "status": "expired",
      "daysLeft": 0,
      "hasFile": true,
      "blocksDispatch": true,
      "text": "…"
    }
  ],
  "blocked": [
    {
      "subject": "vehicle",
      "subjectId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "label": "…",
      "typeKeys": [
        "…"
      ]
    }
  ],
  "counts": {
    "expired": 0,
    "soon": 0,
    "missing": 0,
    "valid": 0
  },
  "storage": {
    "usedBytes": 0,
    "quotaBytes": 1
  }
}

Crear un documento

POSThttps://api.drometra.com/v1/fleet/documents

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

typeKeyobligatoriostring
vehicleIdobligatoriostring · uuid o null
workerIdobligatoriostring · uuid o null
numberobligatoriostring o null
issuedOnobligatoriostring o null
expiresOnobligatoriostring o null
notesobligatoriostring o null
replacesobligatoriostring · uuid o null

Respuesta · 201

idstring · uuidsiempre
typeKeystringsiempre
subjectenum: vehicle | driversiempre
vehicleIdstring · uuid o nullsiempre
workerIdstring · uuid o nullsiempre
numberstring o nullsiempre
issuedOnstring o nullsiempre
expiresOnstring o nullsiempre
notesstring o nullsiempre
object o nullsiempre
replacesIdstring · uuid o nullsiempre
replacedAtstring · date-time o nullsiempre
removedAtstring · date-time o nullsiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/documents" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "typeKey": "…",
    "vehicleId": "…",
    "workerId": "…",
    "number": "…",
    "issuedOn": "…",
    "expiresOn": "…",
    "notes": "…",
    "replaces": "…"
  }'

respuesta · 201

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "typeKey": "…",
  "subject": "vehicle",
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "workerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "number": "…",
  "issuedOn": "…",
  "expiresOn": "…",
  "notes": "…",
  "file": {
    "mimeType": "application/pdf",
    "sizeBytes": 5242884,
    "sha256": "…",
    "uploadedAt": "2026-10-21T14:02:31Z"
  },
  "replacesId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "replacedAt": "2026-10-21T14:02:31Z",
  "removedAt": "2026-10-21T14:02:31Z",
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Cambiar un documento

PATCHhttps://api.drometra.com/v1/fleet/documents/{id}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

numberobligatoriostring o null
issuedOnobligatoriostring o null
expiresOnobligatoriostring o null
notesobligatoriostring o null
versionobligatoriointeger

Respuesta · 200

idstring · uuidsiempre
typeKeystringsiempre
subjectenum: vehicle | driversiempre
vehicleIdstring · uuid o nullsiempre
workerIdstring · uuid o nullsiempre
numberstring o nullsiempre
issuedOnstring o nullsiempre
expiresOnstring o nullsiempre
notesstring o nullsiempre
object o nullsiempre
replacesIdstring · uuid o nullsiempre
replacedAtstring · date-time o nullsiempre
removedAtstring · date-time o nullsiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PATCH "https://api.drometra.com/v1/fleet/documents/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "…",
    "issuedOn": "…",
    "expiresOn": "…",
    "notes": "…",
    "version": 0
  }'

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "typeKey": "…",
  "subject": "vehicle",
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "workerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "number": "…",
  "issuedOn": "…",
  "expiresOn": "…",
  "notes": "…",
  "file": {
    "mimeType": "application/pdf",
    "sizeBytes": 5242884,
    "sha256": "…",
    "uploadedAt": "2026-10-21T14:02:31Z"
  },
  "replacesId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "replacedAt": "2026-10-21T14:02:31Z",
  "removedAt": "2026-10-21T14:02:31Z",
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Quitar un documento

POSThttps://api.drometra.com/v1/fleet/documents/{id}/remove

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

versionobligatoriointeger

Respuesta · 200

idstring · uuidsiempre
typeKeystringsiempre
subjectenum: vehicle | driversiempre
vehicleIdstring · uuid o nullsiempre
workerIdstring · uuid o nullsiempre
numberstring o nullsiempre
issuedOnstring o nullsiempre
expiresOnstring o nullsiempre
notesstring o nullsiempre
object o nullsiempre
replacesIdstring · uuid o nullsiempre
replacedAtstring · date-time o nullsiempre
removedAtstring · date-time o nullsiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/documents/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/remove" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 0
  }'

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "typeKey": "…",
  "subject": "vehicle",
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "workerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "number": "…",
  "issuedOn": "…",
  "expiresOn": "…",
  "notes": "…",
  "file": {
    "mimeType": "application/pdf",
    "sizeBytes": 5242884,
    "sha256": "…",
    "uploadedAt": "2026-10-21T14:02:31Z"
  },
  "replacesId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "replacedAt": "2026-10-21T14:02:31Z",
  "removedAt": "2026-10-21T14:02:31Z",
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Ver el historial de un documento

GEThttps://api.drometra.com/v1/fleet/documents/{id}/history

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Respuesta · 200

array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/documents/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/history" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "typeKey": "…",
      "subject": "vehicle",
      "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "workerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "number": "…",
      "issuedOn": "…",
      "expiresOn": "…",
      "notes": "…",
      "file": {
        "mimeType": "application/pdf",
        "sizeBytes": 5242884,
        "sha256": "…",
        "uploadedAt": "2026-10-21T14:02:31Z"
      },
      "replacesId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "replacedAt": "2026-10-21T14:02:31Z",
      "removedAt": "2026-10-21T14:02:31Z",
      "version": 1,
      "createdAt": "2026-10-21T14:02:31Z",
      "updatedAt": "2026-10-21T14:02:31Z"
    }
  ]
}

Descargar el archivo de un documento

GEThttps://api.drometra.com/v1/fleet/documents/{id}/file

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X GET "https://api.drometra.com/v1/fleet/documents/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/file" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"

respuesta · 200

(application/pdf)

Subir el archivo de un documento

PUThttps://api.drometra.com/v1/fleet/documents/{id}/file

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid: ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

El cuerpo es el archivo, con Content-Type: application/pdf.

Respuesta · 200

idstring · uuidsiempre
typeKeystringsiempre
subjectenum: vehicle | driversiempre
vehicleIdstring · uuid o nullsiempre
workerIdstring · uuid o nullsiempre
numberstring o nullsiempre
issuedOnstring o nullsiempre
expiresOnstring o nullsiempre
notesstring o nullsiempre
object o nullsiempre
replacesIdstring · uuid o nullsiempre
replacedAtstring · date-time o nullsiempre
removedAtstring · date-time o nullsiempre
versionintegersiempre
createdAtstring · date-timesiempre
updatedAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PUT "https://api.drometra.com/v1/fleet/documents/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/file" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/pdf" \
  --data-binary @archivo

respuesta · 200

{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "typeKey": "…",
  "subject": "vehicle",
  "vehicleId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "workerId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "number": "…",
  "issuedOn": "…",
  "expiresOn": "…",
  "notes": "…",
  "file": {
    "mimeType": "application/pdf",
    "sizeBytes": 5242884,
    "sha256": "…",
    "uploadedAt": "2026-10-21T14:02:31Z"
  },
  "replacesId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "replacedAt": "2026-10-21T14:02:31Z",
  "removedAt": "2026-10-21T14:02:31Z",
  "version": 1,
  "createdAt": "2026-10-21T14:02:31Z",
  "updatedAt": "2026-10-21T14:02:31Z"
}

Crear un tipo de documento

POSThttps://api.drometra.com/v1/fleet/document-types

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

subjectobligatorioenum: vehicle | driver
nameobligatoriostring
expiresobligatorioboolean
blocksDispatchobligatorioboolean
noticeDaysobligatoriointeger
renewerActorIdobligatoriostring · uuid o null
activeobligatorioboolean

Respuesta · 201

keystringsiempre
subjectenum: vehicle | driversiempre
namestringsiempre
expiresbooleansiempre
blocksDispatchbooleansiempre
noticeDaysintegersiempre
renewerActorIdstring · uuid o nullsiempre
activebooleansiempre
builtinbooleansiempre
versionintegersiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X POST "https://api.drometra.com/v1/fleet/document-types" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "…",
    "name": "…",
    "expires": true,
    "blocksDispatch": true,
    "noticeDays": 0,
    "renewerActorId": "…",
    "active": true
  }'

respuesta · 201

{
  "key": "…",
  "subject": "vehicle",
  "name": "…",
  "expires": true,
  "blocksDispatch": true,
  "noticeDays": 90.5,
  "renewerActorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "active": true,
  "builtin": true,
  "version": 0
}

Guardar un tipo de documento

PUThttps://api.drometra.com/v1/fleet/document-types/{key}

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid: El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

keyobligatoriostring

Cuerpo

namestring
blocksDispatchobligatorioboolean
noticeDaysobligatoriointeger
renewerActorIdobligatoriostring · uuid o null
activeobligatorioboolean
versionobligatoriointeger

Respuesta · 200

keystringsiempre
subjectenum: vehicle | driversiempre
namestringsiempre
expiresbooleansiempre
blocksDispatchbooleansiempre
noticeDaysintegersiempre
renewerActorIdstring · uuid o nullsiempre
activebooleansiempre
builtinbooleansiempre
versionintegersiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición

curl -X PUT "https://api.drometra.com/v1/fleet/document-types/<key>" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "blocksDispatch": true,
    "noticeDays": 0,
    "renewerActorId": "…",
    "active": true,
    "version": 0
  }'

respuesta · 200

{
  "key": "…",
  "subject": "vehicle",
  "name": "…",
  "expires": true,
  "blocksDispatch": true,
  "noticeDays": 90.5,
  "renewerActorId": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "active": true,
  "builtin": true,
  "version": 0
}