Listar cajas disponibles

GET

/teams/{teamId}/boxes/available

const url = 'https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/boxes/available';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

curl --request GET \
  --url https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/boxes/available \
  --header 'Authorization: Bearer <token>'

Lista las cajas del equipo en estado DISPONIBLE — usado por el flujo de creación de rentas para elegir caja.

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Responses

200

Cajas disponibles

application/json

object

boxes

Array<object>

Caja de traslado/almacenaje — contenedor de carga seca intercambiable, activo propio del equipo (no un atributo del vehículo)

object

string format: uuid

teamId

string format: uuid

code

Identificador visible de la caja, se normaliza a mayúsculas

string

boxType

string

Allowed values: SECA REFRIGERADA PLATAFORMA OTRO

capacityM3

number

nullable

capacityKg

number

nullable

dailyRate

Tarifa diaria por defecto para rentas de esta caja

number

status

string

Allowed values: DISPONIBLE EN_VIAJE APARTADA RENTADA MANTENIMIENTO DESACTIVADA

currentVehicleId

string

nullable

currentReservationId

string

nullable

currentClientId

string

nullable

currentClientName

string

nullable

currentLocation

object

notes

string

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

Example

{
  "boxes": [
    {
      "id": "bb0e8400-e29b-41d4-a716-446655440006",
      "code": "CAJA-001",
      "status": "DISPONIBLE"
    }
  ]
}

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"
}