Cómo crear un producto
Da de alta un producto vendible en la ubicación u organización activa, completando nombre, precio, tipo de producto y tipo impositivo antes de guardarlo para su uso posterior en cartas, TPV y cocina.
En este artículo
El producto es la ficha vendible que el equipo prepara antes de montar una carta: define cómo se nombra, cuánto cuesta, cómo tributa y si debe pasar por cocina. En el ejemplo ES, el alta se documenta desde Marea Gran Via con precio en EUR y taxonomía local del catálogo.
Crear el producto solo registra la ficha en el ámbito actual. Si se crea desde una ubicación queda asociado a esa ubicación; si se crea desde organización queda asociado a la organización. La asignación a una carta se hace después desde el formulario de catálogo.
Antes de empezar
- Tener una sesión activa con organización seleccionada; para crear desde ubicación, también debe estar seleccionada la ubicación.
- Contar con permiso `catalog:manage` en el ámbito donde se va a crear el producto.
- Tener al menos un tipo de producto disponible en el mismo ámbito exacto de creación.
- Tener una categoría fiscal disponible para seleccionarla en el formulario.
- Preparar una imagen solo si se quiere asociar al producto; la imagen es opcional.
Instrucciones
- 1.
Abre Productos
Entra en la gestión de catálogos de Marea Gran Via y abre la pestaña Productos. Desde ahí puedes revisar productos existentes y empezar el alta con el botón Crear Producto.
- 2.
Inicia el alta
Pulsa Crear Producto. La aplicación abre el formulario vacío para el ámbito actual: ubicación si vienes de Marea Gran Via u organización si vienes desde catálogos de organización.
- 3.
Completa los campos obligatorios
Introduce nombre, precio, tipo de producto y tipo impositivo. Para una captura localizada puede usarse un nombre temporal como `tostadocs`, precio `12,50`, tipo `Principales` y categoría fiscal `IVA 10%` si están visibles en el runtime demo.
- 4.
Añade información opcional
Si aplica, completa nombre corto, descripción, color, imagen, alérgenos, especificaciones y la opción Requiere cocina. Al activar Requiere cocina, el producto queda preparado para seguir el flujo de cocina y ser visible en KDS.
- 5.
Guarda el producto
Cuando el formulario tenga cambios válidos, pulsa Crear Producto. La app envía el alta, vuelve al listado de Productos e invalida el listado para mostrar la información actualizada.
Validaciones y límites
- Nombre no puede estar vacío.
- Precio debe ser un número válido; aunque el campo permite escribir `0`, el guardado real exige un precio mayor que 0.
- Tipo de producto es obligatorio en la UI y debe pertenecer al mismo ámbito exacto de creación.
- Tipo impositivo es obligatorio en la UI.
- El botón de creación queda deshabilitado si no hay cambios, faltan campos obligatorios o el envío está en curso.
- Un producto creado en ubicación se guarda con `location_id`; un producto creado en organización se guarda con `org_id`.
- Crear el producto no lo añade automáticamente a una carta; esa asignación se realiza desde el formulario de catálogo.
- Si no se seleccionan alérgenos o especificaciones, el producto se guarda sin relaciones de ese tipo.
Resultado esperado
El producto queda creado en el ámbito activo, el listado de Productos se refresca y la ficha queda disponible para asignarla después a una carta o usar sus metadatos operativos.