Restofy Docs
Pedido del comensal POST

Agregar un producto al pedido

POST /api/orders/create-order-item

Descripción

Guarda un producto en el pedido del cliente, sin enviarlo todavía.

Detalles

Suma el producto al carrito del pedido en curso con el precio de la carta, nunca uno que mande el cliente. Queda guardado aunque el cliente cierre la aplicación o cambie de celular, y sale al restaurante recién cuando envía el pedido. Se corta si el canal no está recibiendo pedidos en ese momento.

Permisos requeridos

auth-order

Request

Nombre Tipo Requerido Reglas
productId int Sí
min_value:1
menuId int Sí
min_value:1
name string Sí
max:200
qty int Sí
min_value:1
consumptionMode string No
enum:eat_in,takeaway
note string No
max:500
guestName string No
max:60
productPriceId int No
min_value:1
productPriceOptionId int No
min_value:1
modifiers array No —
modifiers[].modifierGroupId int Sí
min_value:1
modifiers[].modifierId int Sí
min_value:1
modifiers[].quantity int Sí
min_value:1

Ejemplo de request

curl -X POST https://restofy.pro/api/orders/create-order-item \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "productId": 1,
    "menuId": 1,
    "name": "string",
    "qty": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-10-09T02:12:12Z
HTTP 200

Request

{
    "productId": 16,
    "menuId": 6,
    "name": "Limonada Natural",
    "qty": 1,
    "note": null
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orderUuid": "97025c6a-d75c-4d91-9745-c04e58e183d1"
    }
}