Pedido del comensal
POST
Pedir que cancelen o cambien un producto
POST /api/orders/create-item-cancellation-request
Descripción
Envía al restaurante la solicitud de cancelar o cambiar un producto que ya está en preparación.
Detalles
Deja una solicitud sobre un solo producto del pedido, con la cantidad y lo que quiere el cliente: cancelarlo, o cambiarlo por otro que describe en la nota, obligatoria en un cambio. El personal la acepta quitando el producto o la rechaza con un motivo. Un producto tiene a lo sumo una solicitud esperando respuesta y no se pide si ya se pidió cancelar el pedido completo.
Permisos requeridos
auth-order
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| itemUuid | string | Sí |
min:36
max:36
|
| requestType | string | Sí |
enum:cancel,change
|
| quantity | int | No |
min_value:1
|
| note | string | No |
max:200
|
Respuesta
Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.
| Campo | Tipo | Descripción |
|---|---|---|
| orderUuid | string | Identificador del pedido |
| cancellationRequest | object | Solicitud de cancelación enviada al restaurante |
| cancellationRequest.cancellationRequestUuid | string | Identificador de la solicitud |
| cancellationRequest.status | string | Estado: pending, accepted, rejected o withdrawn |
| cancellationRequest.note | string Admite vacío | Nota que dejó el cliente |
| cancellationRequest.rejectionReason | string Admite vacío | Motivo del restaurante si la rechazó |
| cancellationRequest.itemUuid | string Admite vacío | Producto que pidió quitar o cambiar, o vacío si es el pedido completo |
| cancellationRequest.quantity | decimal Admite vacío | Unidades del producto que pidió quitar |
| cancellationRequest.requestType | string | Qué pidió: cancel (cancelar) o change (cambiar por otro producto) |
| cancellationRequest.createdAt | datetime | Cuándo se envió la solicitud |
| cancellationRequest.resolvedAt | datetime Admite vacío | Cuándo se respondió o retiró |
| isExistingRequest | bool | Si ya había una solicitud esperando respuesta y se devolvió esa |
Ejemplo de request
curl -X POST https://restofy.pro/api/orders/create-item-cancellation-request \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"itemUuid": "string",
"requestType": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.