Skip to main content
POST
/
mision
/
{id}
/
finalizar
curl -X POST "https://api.example.com/mision/1/finalizar" \
  -H "Content-Type: application/json" \
  -d '{
    "kilometrajeFin": 45450,
    "combustibleFinalGalones": 8.0,
    "incidencias": "Sin novedad"
  }'

{
  "success": true,
  "message": "Misión finalizada exitosamente",
  "data": {
    "idMision": 1,
    "idSolicitud": 1,
    "idVehiculoAsignado": 1,
    "idMotoristaAsignado": 5,
    "descripcion": "Traslado de personal al aeropuerto",
    "fechaProgramada": "2025-06-15",
    "kilometrajeInicio": 45230,
    "kilometrajeFin": 45450,
    "kilometrajeRecorrido": 220,
    "combustibleInicialGalones": 12.5,
    "combustibleFinalGalones": 8.0,
    "combustibleConsumidoGalones": 4.5,
    "incidencias": "Sin novedad",
    "idEstadoMision": 5,
    "codigoEstado": "COMPLETADA",
    "fechaHoraInicio": "2025-06-15 08:05:30",
    "fechaHoraFin": "2025-06-15 09:45:20"
  }
}

​
Finish Mission

Finalizes a mission by changing its state to COMPLETADA and recording final mileage and fuel consumption.

​
Path Parameters

​
id
integer
required
ID of the mission to finish.

​
Request Body

​
kilometrajeFin
integer
required
Final mileage reading from the vehicle odometer. Must be >= 0.
​
combustibleFinalGalones
number
required
Final fuel amount in gallons. Must be >= 0.
​
incidencias
string
Description of any incidents that occurred during the mission.

​
Response

​
success
boolean
Indicates if the request was successful.
​
message
string
Response message: “Misión finalizada exitosamente”
​
data
object
The completed mission object with calculated distance traveled and fuel consumed.

​
Validations

  • Mission must be in EN_EJECUCION, EN_RUTA_RECOGIDA, EN_RUTA_REGRESO, or EN_ESPERA state
  • Final mileage cannot be less than initial mileage
  • Automatically calculates:
    • KilometrajeRecorrido = final mileage - initial mileage
    • CombustibleConsumidoGalones = initial fuel - final fuel
  • If all missions for the parent request are COMPLETADA, changes request to COMPLETADA
curl -X POST "https://api.example.com/mision/1/finalizar" \
  -H "Content-Type: application/json" \
  -d '{
    "kilometrajeFin": 45450,
    "combustibleFinalGalones": 8.0,
    "incidencias": "Sin novedad"
  }'

{
  "success": true,
  "message": "Misión finalizada exitosamente",
  "data": {
    "idMision": 1,
    "idSolicitud": 1,
    "idVehiculoAsignado": 1,
    "idMotoristaAsignado": 5,
    "descripcion": "Traslado de personal al aeropuerto",
    "fechaProgramada": "2025-06-15",
    "kilometrajeInicio": 45230,
    "kilometrajeFin": 45450,
    "kilometrajeRecorrido": 220,
    "combustibleInicialGalones": 12.5,
    "combustibleFinalGalones": 8.0,
    "combustibleConsumidoGalones": 4.5,
    "incidencias": "Sin novedad",
    "idEstadoMision": 5,
    "codigoEstado": "COMPLETADA",
    "fechaHoraInicio": "2025-06-15 08:05:30",
    "fechaHoraFin": "2025-06-15 09:45:20"
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us