Restofy Docs
Reservas del comensal POST

Detalle de mi reserva

POST /api/diner-reservations/get-reservation

Descripción

Devuelve el detalle de una reserva del cliente y si todavía puede cambiarla o cancelarla.

Detalles

Recibe el restaurante y la reserva, y devuelve cuándo es, en qué zona, para cuántas personas, la ocasión especial, la nota y su estado. Solo responde si la reserva es del cliente que tiene la sesión. Indica si todavía está a tiempo de cambiarla o cancelarla, y el depósito que le falta pagar, si le falta.

Permisos requeridos

public

Request

Nombre Tipo Requerido Reglas
slug string Sí
min:1 max:63
reservationUuid string Sí
min:36 max:36

Respuesta

Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.

Campo Tipo Descripción
reservation object Reserva del cliente
reservation.reservationUuid string Identificador de la reserva
reservation.reservedAt datetime Cuándo es la reserva
reservation.durationMinutes int Cuánto dura la reserva, en minutos
reservation.guestCount int Cuántas personas van
reservation.areaUuid string Admite vacío Identificador de la zona
reservation.areaName string Admite vacío Nombre de la zona
reservation.guestName string Admite vacío A nombre de quién está
reservation.guestOccasionId int Admite vacío Ocasión especial elegida
reservation.occasionName string Admite vacío Nombre de la ocasión especial
reservation.occasionIcon string Admite vacío Ícono de la ocasión especial
reservation.advanceAmountCents int Admite vacío Depósito recibido, en centavos
reservation.advanceRequiredCents int Admite vacío Depósito que pide la reserva, en centavos
reservation.advanceDueAt datetime Admite vacío Hasta cuándo hay plazo para pagar el depósito
reservation.isAwaitingAdvance bool Si la reserva espera el pago del depósito
reservation.status string Estado de la reserva
reservation.statusLabel string Estado para mostrar
reservation.statusTone string Tono del estado: success, warning, info, primary o neutral
reservation.notes string Admite vacío Nota del cliente
reservation.cancellationReason string Admite vacío Motivo de la cancelación
reservation.canEdit bool Si todavía se puede cambiar
reservation.canCancel bool Si todavía se puede cancelar

Ejemplo de request

curl -X POST https://restofy.pro/api/diner-reservations/get-reservation \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "slug": "string",
    "reservationUuid": "string"
}'

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

Ejemplo de respuesta

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

Request

{
    "slug": "restofy_test_dinerreservation_2238_1791511161_tenant",
    "reservationUuid": "0d4214a4-c385-11f1-a755-a2f78ac020f7"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "reservation": {
            "reservationUuid": "0d4214a4-c385-11f1-a755-a2f78ac020f7",
            "reservedAt": "2026-10-09T17:00:00.000Z",
            "durationMinutes": 90,
            "guestCount": 4,
            "areaUuid": "0ca03de1-c385-11f1-a755-a2f78ac020f7",
            "areaName": "Reservas b62e53",
            "guestName": "Comensal de prueba",
            "guestOccasionId": null,
            "occasionName": null,
            "occasionIcon": null,
            "advanceAmountCents": null,
            "advanceRequiredCents": null,
            "advanceDueAt": null,
            "isAwaitingAdvance": false,
            "status": "confirmed",
            "statusLabel": "Confirmada",
            "statusTone": "success",
            "notes": "Mesa cerca de la ventana",
            "cancellationReason": null,
            "canEdit": true,
            "canCancel": true
        }
    }
}