Productos

/v1alpha1/products

Los productos son los ítems del menú del restaurante. Cada producto tiene un nombre, precio de venta, categoría, cocina asignada y configuración de visibilidad. Se usan para armar el menú digital, QR, o de delivery. Pueden estar activos o inactivos, y algunos tienen control de stock habilitado.

250+
Registros
15
Campos
4
Cocinas
Campos disponibles
name
string
Nombre del producto tal como aparece en el menú.
price
float
Precio de venta al público en moneda local.
active
boolean
Si el producto está disponible actualmente para la venta.
cost
float
Costo de producción del ítem (puede ser nulo si no se cargó).
description
string
Descripción del plato para menú digital o QR.
favourite
boolean
Marcado como favorito para destacarlo en pantalla de caja.
imageUrl
string
URL de la imagen del plato para el menú online o QR.
stockControl
boolean
Si tiene control de inventario habilitado.
stock
integer
Unidades disponibles (si stockControl es true).
preparationTime
integer
Tiempo estimado de preparación en minutos.
sellAlone
boolean
Si puede venderse individualmente o solo como parte de combo.
enableOnlineMenu
boolean
Si se muestra en el menú online.
enableQrMenu
boolean
Si aparece en el menú QR del local.
position
integer
Orden de aparición dentro de su categoría.
code
string
Código interno del producto (integraciones / código de barras).
3 ejemplos reales
Pan con MantecaID #10
precio$7.000
activoActivo
favoritoDestacado
cocinaCocina (#2)
stock controlHabilitado
MelenaID #12
precio$26.000
activoActivo
favoritoNo
cocinaCocina (#2)
stock controlHabilitado
CrackerID #11
precio$14.000
activoInactivo
favoritoNo
cocinaSin asignar
stock controlHabilitado

Items

/v1alpha1/items

Un ítem es cada línea de pedido dentro de una venta. Cuando un mozo agrega un plato a la comanda, se crea un ítem vinculado a esa venta y a un producto. Registran el precio al momento de la venta, la cantidad, si fue cancelado y el motivo. Son el nivel más granular del sistema de ventas.

250+
Registros
8
Campos
Campos disponibles
createdAt
datetime
Cuándo fue agregado el ítem a la comanda.
quantity
float
Cantidad del producto pedido (puede ser fraccionado).
price
float
Precio unitario al momento de la venta.
canceled
boolean
Si el ítem fue cancelado antes del cierre de la venta.
cancellationComment
string
Motivo de cancelación ingresado por el mozo.
comment
string
Observación del cliente (ej: "sin cebolla").
paid
boolean
Si este ítem fue incluido en un pago.
status
string
Estado en el sistema KDS: pendiente, preparando, listo.
3 ejemplos reales
Ítem canceladoID #1
productoProduct #43
ventaSale #3
precio$600
cantidad1
canceladoSí — "error"
pagadoNo
Ítem pagadoID #5
productoProduct #60
ventaSale #4
precio$8.100
cantidad1
canceladoSí
pagadoSí
Ítem de comandaID #2
productoProduct #61
ventaSale #3
precio$9.700
cantidad1
canceladoSí — "sdf"
fecha01/09/2023 23:53

Ventas

/v1alpha1/sales

Las ventas representan cada sesión de consumo en el restaurante. Se abren cuando el mozo crea una comanda, pueden tener múltiples ítems, descuentos y pagos, y se cierran al cobrar. Registran quién atendió, qué mesa, cuántos comensales y el total cobrado.

250+
Registros
10
Campos
Campos disponibles
createdAt
datetime
Cuándo se abrió la mesa / comenzó la venta.
closedAt
datetime
Cuándo se cerró y cobró la venta.
total
float
Monto total cobrado en la venta.
saleType
enum
EAT-IN (local), TAKE-AWAY (para llevar), DELIVERY (domicilio).
saleState
enum
OPEN (abierta), CLOSED (cobrada), CANCELED (cancelada).
people
integer
Cantidad de comensales en la mesa.
customerName
string
Nombre del cliente en ventas sin cuenta registrada.
comment
string
Observación general de la venta.
expectedPayments
object
Pagos esperados si se dividió la cuenta.
table / waiter / customer
relation
Referencias a la mesa, mozo y cliente asociados.
3 ejemplos reales
Venta cerradaID #1
tipoEAT-IN
estadoCLOSED
mesaTable #12
comensales1
apertura01/09/2023 19:43
cierre01/09/2023 19:50
Venta con clienteID #2
tipoEAT-IN
estadoCLOSED
mesaTable #37
mozoTablet 1 (#2)
clienteCustomer #2
comensales2
Venta canceladaID #4
tipoEAT-IN
estadoCANCELED
comensales1
apertura07/10/2023 02:22
cierre07/10/2023 04:23
items4 ítems cancelados

Clientes

/v1alpha1/customers

Los clientes son personas registradas en el sistema. Permiten asociar ventas a clientes recurrentes, asignarles un descuento permanente y habilitarles una cuenta corriente (fiado). El saldo negativo indica deuda con el local. Es el módulo de fidelización del restaurante.

28
Clientes
14
Campos
Campos disponibles
name
string
Nombre completo del cliente.
email
string
Email de contacto (opcional).
phone
string
Teléfono del cliente.
active
boolean
Si el cliente está activo en el sistema.
discountPercentage
float
Descuento automático aplicado a sus ventas (0–100%).
houseAccountEnabled
boolean
Si tiene habilitada la cuenta corriente (fiado).
houseAccountBalance
float
Saldo de su cuenta corriente. Negativo = deuda con el local.
birthDate
date
Fecha de nacimiento (para campañas de cumpleaños).
address
string
Dirección del cliente (para delivery).
vatNumber
string
CUIT/CUIL para facturación.
fiscalAddress
string
Domicilio fiscal para la factura.
comment
string
Notas internas sobre el cliente.
origin
string
Cómo llegó el cliente (referido, web, etc.).
createdAt
datetime
Fecha de registro del cliente.
3 ejemplos reales
Gustavo RomañachID #2
activoSí
descuento100%
cta. corrienteHabilitada
saldo— $659.910
registrado01/09/2023
Tomi CourielID #3
activoSí
descuento100%
cta. corrienteHabilitada
saldo— $1.565.690
registrado01/09/2023
Christian SoldanID #7
activoSí
descuento100%
cta. corrienteHabilitada
saldo— $947.430
registrado09/10/2023

Pagos

/v1alpha1/payments

Los pagos registran cada transacción de cobro asociada a una venta. Una venta puede tener múltiples pagos si el cliente paga con distintos métodos (efectivo + tarjeta) o si varios comensales pagan por separado. Cada pago referencia su método y la venta correspondiente.

250+
Registros
6
Campos
Campos disponibles
amount
float
Monto cobrado en este pago.
createdAt
datetime
Fecha y hora en que se registró el pago.
canceled
boolean
Si el pago fue anulado.
externalReference
string
Referencia externa (ej: número de aprobación de tarjeta).
paymentMethod
relation
Método de pago: efectivo, tarjeta, QR, cuenta corriente, etc.
sale
relation
Venta a la que pertenece este pago.
3 ejemplos reales
Pago altoID #1
monto$82.150
métodoPaymentMethod #1
ventaSale #4
fecha07/10/2023 04:23
canceladoNo
Pago estándarID #3
monto$17.900
métodoPaymentMethod #1
ventaSale #8
fecha07/10/2023 23:45
canceladoNo
Pago mínimoID #5
monto$700
métodoPaymentMethod #1
ventaSale #17
fecha09/10/2023 20:45
canceladoNo

Mesas

/v1alpha1/tables

Las mesas son los puntos físicos del salón. Cada una tiene un número, posición en la grilla del mapa (columna/fila), forma y tamaño. Están organizadas por sala. El mapa en Fudo refleja la distribución real del local, permitiendo que los mozos gestionen las mesas visualmente.

58
Mesas
5
Campos
Campos disponibles
number
integer
Número visible de la mesa (el que ven mozos y clientes).
column
integer
Posición horizontal en la grilla del mapa del salón.
row
integer
Posición vertical en la grilla del mapa del salón.
shape
enum
"0" = cuadrada, "1" = redonda. Define el ícono visual.
size
enum
"s" = pequeña, "m" = mediana, "l" = grande.
room
relation
Sala a la que pertenece esta mesa.
3 ejemplos reales
Mesa 1 — RedondaID #1
número1
salaRoom #1
formaRedonda
tamañoPequeña
posicióncol 17 · fila 19
Mesa 2 — CuadradaID #2
número2
salaRoom #1
formaCuadrada
tamañoGrande
posicióncol 2 · fila 10
Mesa 8 — CuadradaID #8
número8
salaRoom #1
formaCuadrada
tamañoGrande
posicióncol 1 · fila 8

Usuarios

/v1alpha1/users

Los usuarios son las personas que operan el sistema Fudo: mozos, encargados, administradores y dispositivos tablet. Cada usuario tiene un rol que define sus permisos. Los tablets son usuarios de sistema usados para la toma de pedidos. El código promocional es un identificador único por usuario.

34
Usuarios
5
Campos
Campos disponibles
name
string
Nombre completo del usuario.
email
string
Email de acceso al sistema.
active
boolean
Si el usuario puede ingresar al sistema actualmente.
admin
boolean
Si tiene permisos de administrador completo.
promotionalCode
string
Código único. Formato: F.[LOCAL].[USUARIO].
role
relation
Rol asignado que define qué puede hacer en el sistema.
3 ejemplos reales
Tablet 1ID #2
emailtablet@tablet.com
activoSí
rolCamarero (#3)
códigoF.PIEDRAPASILLO.TABLET1
Yamila MonteroID #6
emailyamila@yamila.com
activoInactivo
rolCamarero (#3)
códigoF.PIEDRAPASILLO.YAMILA
Mauro CristofanettiID #7
emailmauro@mauro.com
activoInactivo
rolCamarero (#3)
códigoF.PIEDRAPASILLO.MAURO

Cocinas

/v1alpha1/kitchens

Las cocinas son las estaciones de trabajo del restaurante. Cada producto se asigna a una cocina para que las comandas lleguen al destino correcto. El sistema KDS (Kitchen Display System) muestra los pedidos según la estación. Piedra Pasillo tiene 4 estaciones: Caja, Cocina principal y dos zonas AFB.

4
Cocinas
1
Campo
Campos disponibles
name
string
Nombre de la estación de cocina o barra.
Las 4 cocinas del negocio
CAJAID #1
nombreCAJA
uso típicoProductos de caja y bebidas simples
CocinaID #2
nombreCocina
uso típicoCocina principal del local
Cocina AFB · Barra AFBID #3 y #4
COCINA AFBCocina zona AFB
BARRA AFBBarra zona AFB
sectorÁrea independiente del local

Roles

/v1alpha1/roles

Los roles definen qué puede hacer cada usuario dentro de Fudo. Son plantillas de permisos: desde el Admin con acceso total hasta el Camarero con permisos mínimos. Cubren ventas, productos, caja, reportes, stock, delivery y configuración del sistema.

4
Roles
4
Campos
Campos disponibles
name
string
Nombre del rol.
isWaiter
boolean
Si los usuarios de este rol son mozos (ven sus mesas propias).
isDeliveryman
boolean
Si el rol corresponde a un repartidor de delivery.
permissions
array
Lista de acciones habilitadas: ventas, productos, stock, caja, reportes, delivery, configuración.
Los 4 roles del negocio
AdminID #1
es mozoNo
repartidorNo
permisosAcceso total
incluyeVentas, productos, stock, caja, reportes, usuarios, config.
EncargadoID #2
es mozoSí
repartidorNo
permisosAcceso amplio
incluyeVentas, productos, caja, reportes básicos. Sin config.
Camarero · IntegracionesID #3 y #4
CamareroMozo básico
accesoAgregar, mover y cancelar ítems
IntegracionesUso técnico / API
permisosSin permisos definidos