El conductor marca su viaje como finalizado

POST

/trips/{tripId}/complete

const url = 'https://api.dev.lade.com.mx/trips/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/complete';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"lat":19.4326,"lng":-99.1332}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.dev.lade.com.mx/trips/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "lat": 19.4326, "lng": -99.1332 }'

Transiciona el viaje de EN_PROCESO a FINALIZADO_A_TIEMPO o FINALIZADO_CON_RETRASO — a diferencia de PATCH /trips/{tripId}/status, aquí el estado final no lo elige quien llama: se calcula server-side comparando la hora actual contra trip.endDate. Solo el conductor asignado puede completarlo.

Authorizations

cognitoDriversAuth

Parameters

Path Parameters

tripId

required

string format: uuid

ID del viaje (UUID)

Request Body

application/json

Coordenadas opcionales del punto de finalización

object

lat

number

>= -90 <= 90

lng

number

>= -180 <= 180

Example

{
  "lat": 19.4326,
  "lng": -99.1332
}

Responses

200

Viaje finalizado

application/json

object

message

string

tripId

string format: uuid

previousStatus

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

newStatus

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

Example

{
  "message": "Trip status updated successfully",
  "tripId": "880e8400-e29b-41d4-a716-446655440003",
  "previousStatus": "EN_PROCESO",
  "newStatus": "FINALIZADO_A_TIEMPO"
}

400

Solicitud inválida

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}

409

Conflicto con recurso existente

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Conflict",
  "message": "Resource already exists"
}