Restofy Docs
Menú digital POST

Abrir un pedido del menú digital

POST /api/digital-menu/create-order

Descripción

Abre un pedido con el canal del enlace y sus primeros platos en el carrito.

Detalles

Inicia el pedido según el canal del enlace, con sus platos guardados sin enviar. En una mesa o habitación ocupa el lugar, que debe estar libre. Una persona puede tener varios pedidos a la vez, cada uno con su acceso. Devuelve el acceso con el que esa persona opera su pedido y lo que necesita para invitar a otros.

Permisos requeridos

public

Request

Nombre Tipo Requerido Reglas
slug string Sí
min:1 max:63
token string Sí
min:1 max:64
deviceUuid string Sí
min:36 max:36
guestName string No
max:60
items array Sí —
items[].productId int Sí
min_value:1
items[].menuId int Sí
min_value:1
items[].quantity int Sí
min_value:1 max_value:99
items[].consumptionMode string No
enum:eat_in,takeaway
items[].note string No
max:500
items[].productPriceId int No
min_value:1
items[].productPriceOptionId int No
min_value:1
items[].modifiers array No —
items[].modifiers[].modifierGroupId int Sí
min_value:1
items[].modifiers[].modifierId int Sí
min_value:1
items[].modifiers[].quantity int Sí
min_value:1

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
orderCode string Número del pedido para mostrar
joinCode string Últimos 3 caracteres del pedido, para sumarse en la mesa
inviteToken string Invitación para que otros se sumen fuera del local
orderPass string Pase del pedido, va en el encabezado X-Order-Pass
orderPassExpiresAt datetime Cuándo vence el pase

Ejemplo de request

curl -X POST https://restofy.pro/api/digital-menu/create-order \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "slug": "string",
    "token": "string",
    "deviceUuid": "string",
    "items": [
        {
            "productId": 1,
            "menuId": 1,
            "quantity": 1
        }
    ]
}'

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