Cancelar una reserva de caja

PATCH

/teams/{teamId}/box-reservations/{reservationId}/cancel

const url = 'https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/box-reservations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cancel';
const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"reason":"El cliente canceló el servicio"}'
};

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

curl --request PATCH \
  --url https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/box-reservations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "reason": "El cliente canceló el servicio" }'

Cancela una reserva en estado RESERVADA o ACTIVA. Si estaba ACTIVA, libera la caja a DISPONIBLE. Falla con 409 si la reserva ya está FINALIZADA o CANCELADA.

Authorizations

cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

reservationId

required

string format: uuid

ID de la reserva/renta de caja (UUID)

Request Body

application/json

object

reason

string

<= 500 characters

Example

{
  "reason": "El cliente canceló el servicio"
}

Responses

200

Reserva cancelada

application/json

object

message

string

reservationId

string format: uuid

Example

{
  "message": "Box reservation cancelled successfully",
  "reservationId": "dd0e8400-e29b-41d4-a716-446655440008"
}

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