Skip to main content
POST
/
mision
/
{id}
/
iniciar
curl -X POST "https://api.example.com/mision/1/iniciar" \
  -H "Content-Type: application/json" \
  -d '{
    "kilometrajeInicio": 45230,
    "combustibleInicialGalones": 12.5
  }'
{
  "success": true,
  "message": "Misión iniciada exitosamente",
  "data": {
    "idMision": 1,
    "idSolicitud": 1,
    "idVehiculoAsignado": 1,
    "idMotoristaAsignado": 5,
    "descripcion": "Traslado de personal al aeropuerto",
    "fechaProgramada": "2025-06-15",
    "horaSalidaProgramada": "08:00:00",
    "kilometrajeInicio": 45230,
    "combustibleInicialGalones": 12.5,
    "idEstadoMision": 2,
    "codigoEstado": "EN_EJECUCION",
    "fechaHoraInicio": "2025-06-15 08:05:30"
  }
}

Start Mission

Initiates a mission by changing its state from PROGRAMADA to EN_EJECUCION (in progress).

Path Parameters

id
integer
required
ID of the mission to start.

Request Body

kilometrajeInicio
integer
required
Starting mileage reading from the vehicle odometer. Must be >= 0.
combustibleInicialGalones
number
required
Initial fuel amount in gallons. Must be > 0.

Response

success
boolean
Indicates if the request was successful.
message
string
Response message: “Misión iniciada exitosamente”
data
object
The updated mission object with starting mileage and fuel recorded.

Validations

  • Mission must be in PROGRAMADA state
  • Mission must have assigned vehicle and driver
  • Starting mileage cannot be less than the vehicle’s last recorded mileage
  • Automatically changes parent request to EN_PROCESO if it was in APROBADA state
curl -X POST "https://api.example.com/mision/1/iniciar" \
  -H "Content-Type: application/json" \
  -d '{
    "kilometrajeInicio": 45230,
    "combustibleInicialGalones": 12.5
  }'
{
  "success": true,
  "message": "Misión iniciada exitosamente",
  "data": {
    "idMision": 1,
    "idSolicitud": 1,
    "idVehiculoAsignado": 1,
    "idMotoristaAsignado": 5,
    "descripcion": "Traslado de personal al aeropuerto",
    "fechaProgramada": "2025-06-15",
    "horaSalidaProgramada": "08:00:00",
    "kilometrajeInicio": 45230,
    "combustibleInicialGalones": 12.5,
    "idEstadoMision": 2,
    "codigoEstado": "EN_EJECUCION",
    "fechaHoraInicio": "2025-06-15 08:05:30"
  }
}

Build docs developers (and LLMs) love