Skip to content
NeoApp Ingeniería SAS NeoPOS API Docs

Menú

Menú

Prefijo: /api/menu
Requiere Auth: Sí
Permiso requerido: productos, leer

Endpoints diseñados para la interfaz del mesero. Permiten consultar categorías y productos del menú de forma rápida.

GET /api/menu/categorias

Descripción: Obtiene todas las categorías del menú
Requiere Auth: Sí
Permiso requerido: productos, leer

Respuesta exitosa: 200 OK

Response:

[
  { "id": 1, "nombre": "Bebidas", "descripcion": "Bebidas frías y calientes", "estado": "ACTIVA" },
  { "id": 2, "nombre": "Comidas", "descripcion": "Platos principales", "estado": "ACTIVA" }
]

cURL:

Terminal window
curl http://localhost/api/menu/categorias -H "Authorization: Bearer <token>"

GET /api/menu/productos

Descripción: Obtiene los productos del menú. Opcional: filtrar por categoria_id
Requiere Auth: Sí
Permiso requerido: productos, leer

Parámetros query:

ParámetroTipoObligatorioDescripción
categoria_idint❌Filtrar por categoría

Respuesta exitosa: 200 OK

Response:

[
  {
    "id": 1, "codigo": "PROD001", "nombre": "Café Latte",
    "categoria_id": 1, "precio": 3500.0, "stock": 100, "iva": 19
  }
]

cURL:

Terminal window
curl "http://localhost/api/menu/productos?categoria_id=1" -H "Authorization: Bearer <token>"

GET /api/menu/productos/{producto_id}

Descripción: Obtiene un producto específico por ID
Requiere Auth: Sí
Permiso requerido: productos, leer

Respuesta exitosa: 200 OK
Errores: 404 (no encontrado)

cURL:

Terminal window
curl http://localhost/api/menu/productos/1 -H "Authorization: Bearer <token>"