Actualizar estado del viaje

PUT

/teams/{teamId}/trips/{tripId}/status

curl --request PUT \
  --url https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/trips/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "status": "EN_PROCESO", "coordsLat": 25.6866, "coordsLng": -100.3161 }'

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Cambia el estado del viaje siguiendo las transiciones válidas

Authorizations

• cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

tripId

required

string format: uuid

ID del viaje (UUID)

Request Body^required

Media typeapplication/json

object

status

required

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

coordsLat

number

>= -90 <= 90

coordsLng

number

>= -180 <= 180

Example

{
  "status": "EN_PROCESO",
  "coordsLat": 25.6866,
  "coordsLng": -100.3161
}

Responses

200

Estado actualizado

Media typeapplication/json

object

id

string format: uuid

teamId

string format: uuid

status

Estado del viaje

string

Allowed values: NO_INICIADO EN_PROCESO FINALIZADO_A_TIEMPO FINALIZADO_CON_RETRASO CANCELADO

routeId

string format: uuid

nullable

routeName

string

nullable

clientId

string format: uuid

nullable

clientName

string

nullable

driverId

string format: uuid

nullable

driverName

string

nullable

driverPhone

string

nullable

vehicleId

string format: uuid

nullable

vehiclePlate

string

nullable

startDate

string format: date-time

nullable

endDate

string format: date-time

nullable

actualEndDate

string format: date-time

nullable

cargoDescription

string

nullable

cargoWeight

Weight in kg

number

nullable

cargoVolume

Volume in m3

number

nullable

cost

number

nullable

revenue

number

nullable

notes

string

nullable

specialInstructions

string

nullable

cancelledAt

string format: date-time

nullable

cancelledBy

string

nullable

createdAt

string format: date-time

Example

{
  "status": "NO_INICIADO"
}

400

Solicitud inválida

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

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

401

No autenticado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Unauthorized",
  "message": "Invalid or expired token"
}

403

Sin permisos

Media typeapplication/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

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

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