Calificar un plato del pedido
POST /api/orders/set-product-review
Descripción
Guarda las estrellas y el comentario del cliente sobre un plato que pidió.
Detalles
Guarda la calificación de 1 a 5 estrellas de un plato aprobado del pedido, con un comentario opcional. Cada plato se califica una sola vez aunque se haya pedido varias veces: volver a calificarlo la reemplaza. Suma al promedio del plato en la carta y queda marcada como compra verificada.
Permisos requeridos
auth-order
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| productUuid | string | Sí |
min:36
max:36
|
| ratingValue | int | Sí |
min_value:1
max_value:5
|
| body | string | No |
max:500
|
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 |
| reviewUuid | string | Identificador de la calificación |
| productUuid | string Admite vacío | Plato calificado, o vacío en la de la atención |
| ratingValue | int | Estrellas de 1 a 5 |
| body | string | Comentario, vacío si no dejó |
| isNew | bool | Si es la primera vez que califica o reemplazó la anterior |
Ejemplo de request
curl -X POST https://restofy.pro/api/orders/set-product-review \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"productUuid": "string",
"ratingValue": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
{
"productUuid": "3662a28e-18be-11f1-9da2-b627060a1ebe",
"ratingValue": 5,
"body": "Delicioso · Buena porción"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"orderUuid": "d06c7ffe-7462-4b28-8b66-1021ebe44800",
"reviewUuid": "f9df4e70-f994-4b25-9f1d-5faaeeeda3a5",
"productUuid": "3662a28e-18be-11f1-9da2-b627060a1ebe",
"ratingValue": 5,
"body": "Delicioso · Buena porción",
"isNew": true
}
}