Listar reservas de cajas del equipo

GET

/teams/{teamId}/box-reservations

const url = 'https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/box-reservations?status=RESERVADA&reservationType=TRIP_HOLD';
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/box-reservations?status=RESERVADA&reservationType=TRIP_HOLD' \
  --header 'Authorization: Bearer <token>'

Lista las reservas/rentas de cajas del equipo con filtros opcionales por estado, tipo, cliente y caja.

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

Query Parameters

status

string

Allowed values: RESERVADA ACTIVA FINALIZADA CANCELADA

reservationType

TRIP_HOLD: apartado breve ligado a un viaje (Fase 3, no implementado aún). STORAGE_RENTAL: renta de almacenaje independiente.

string

Allowed values: TRIP_HOLD STORAGE_RENTAL

clientId

string format: uuid

boxId

string format: uuid

Responses

200

Lista de reservas

application/json

object

data

Array<object>

Registro de que una caja quedó en manos de un cliente (renta de almacenaje o apartado ligado a un viaje)

object

string format: uuid

reservationId

string format: uuid

teamId

string format: uuid

boxId

string format: uuid

boxCode

string

nullable

clientId

string format: uuid

clientName

string

nullable

reservationType

TRIP_HOLD: apartado breve ligado a un viaje (Fase 3, no implementado aún). STORAGE_RENTAL: renta de almacenaje independiente.

string

Allowed values: TRIP_HOLD STORAGE_RENTAL

tripId

string

nullable

status

string

Allowed values: RESERVADA ACTIVA FINALIZADA CANCELADA

startAt

string format: date-time

expectedEndAt

string format: date-time

nullable

actualEndAt

string format: date-time

nullable

dailyRate

number

billable

boolean

billedDays

integer

nullable

totalAmount

number

nullable

invoiceId

string

nullable

location

object

notes

string

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

count

integer

Example

{
  "data": [
    {
      "id": "dd0e8400-e29b-41d4-a716-446655440008",
      "status": "ACTIVA"
    }
  ],
  "count": 1
}

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