Con Revo XEF, puedes importar archivos CSV separados por ";". La primera fila debe tener la cabecera con los nombres de los campos exactamente como se describen a continuación.

Para acceder a la pantalla de importación de productos, entra la URL manualmente: https://revoxef.works/tools/import

  1. Importar Grupos
  2. Importar Categorías
  3. Importar Productos
  4. Actualizar Productos
  5. Contenedores
  6. Productos de Contenedor
  7. Formatos de Venta
  8. Añadir Inventario
  9. Establecer/Hacer Inventario
  10. Mover Inventario
  11. Importar Proveedores
  12. Productos de Proveedores
  13. Importar Clientes
  14. Tarjetas Regalo
  15. Recargar Tarjetas Regalo
  16. Tarifas
  17. Empleados
  18. Actualizar Empleados

1. IMPORTAR GRUPOS:

Para crear o actualizar grupos de forma masiva, dirígete en el Back Office a Catálogo -> GRUPOS y pulsa el botón Importar.

El Nuevo Importador

Con el nuevo importador no es necesario que las columnas de tu archivo CSV tengan nombres específicos. Al subir el archivo, el sistema te permitirá Mapear los campos, relacionando cada columna de tu archivo con el campo correspondiente de REVO.

Campos disponibles para mapear:

  • Id: (Solo para actualizaciones).
  • Activo: Para definir si el grupo está activo o no.
  • Nombre * (Obligatorio): El nombre principal del grupo.
  • Traducciones (Crítico): Es imprescindible mapear este campo con el nombre del grupo. Si no se mapean las traducciones, el grupo se creará con el nombre genérico "New Item".
  • Impuesto: El impuesto asociado.
  • Grupo analítico: El grupo analítico correspondiente.
  • Impresora: La impresora asignada.
  • Grupo de impresoras: El grupo de impresoras asignado.
  • Flujo de estados: El flujo de estados de cocina.
  • Extra ID: Campo para el Extra ID.

2. IMPORTAR CATEGORÍAS:

Para importar categorías de forma masiva dentro de un grupo específico, dirígete en el Back Office a Catálogo -> GRUPOS, entra dentro del grupo donde quieras añadir las categorías y pulsa el botón Importar.

El Nuevo Importador

El funcionamiento es idéntico al de los grupos, permitiendo subir cualquier CSV y realizar el mapeo de columnas manualmente.

Campos disponibles para mapear:

  • Id: (Solo para actualizaciones).
  • Activo: Para definir si la categoría está activa o no.
  • Nombre * (Obligatorio): El nombre de la categoría.
  • Grupo * (Obligatorio): El identificador del grupo al que pertenece la categoría.
  • Traducciones (Crítico): Es imprescindible mapear este campo con el nombre de la categoría. Si no se mapean las traducciones, la categoría se creará con el nombre genérico "New Item".
  • Impuesto: El impuesto asociado.
  • Grupo analítico: El grupo analítico correspondiente.
  • Impresora: La impresora asignada.
  • Grupo de impresoras: El grupo de impresoras asignado.
  • Flujo de estados: El flujo de estados de cocina.
  • Extra ID: Campo para el Extra ID.

3. IMPORTAR PRODUCTOS (products):

Opción para importar productos y configurarlos a través de archivo CSV.

Con Revo XEF, puedes importar archivos CSV separados por ";". La primera fila debe tener la cabecera con los nombres de los campos exactamente como se describen a continuación.

Para acceder a la pantalla de importación de productos, entra la URL manualmente: https://revoxef.works/tools/import

Campos obligatorios:

Estos campos son imprescindibles para crear productos nuevos a través de la importación. Sin ellos, aparecerá un error.

  • category_id: ID de la categoría. Antes de importar, crea manualmente en el back-office la estructura (grupos y categorías).
  • name: Nombre del producto (mínimo 3 caracteres).

Campos opcionales:

  • price: Precio con punto para decimales. Ejemplo: 10.20
  • photo: Nombre de archivo de la foto. Ejemplo: patata.jpg
  • order: Orden de visualización dentro de la categoría. Usa números: 1, 2, 3, 4, 5, etc.
  • active: 0 no activo, 1 activo. Si no se introduce, todos los productos se activarán por defecto.
  • info: Descripción del producto.
  • type: Tipo de producto: 0 Producto - 1 Menú - 2 Producto Contenedor - 3 Entrada - 4 Producto con formato de venta - 5 Tarjeta regalo - 6 Producto solo de gestión - 7 Kit
  • hasInventory: 0 sin control de inventario, 1 con control de inventario.
  • usesWeight: 0 no utiliza peso, 1 utiliza peso.
  • tax_id: ID del impuesto por defecto del producto.
  • printer_id: ID de la impresora por defecto del producto.
  • printer_group_id: Grupo de impresoras por defecto.

Es importante destacar que configurar la impresora directamente en los productos puede causar problemas futuros. Si está configurado por producto, deberás cambiarlo uno por uno. Si la configuración es en la categoría o grupo, se puede modificar con unos pocos clics.

  • modifier_group_id: Grupo de modificadores del producto.
  • modifier_category_id: Modificador asignado al producto.

Al igual que con las impresoras, si configuras los modificadores en los productos, tendrás que quitarlos uno por uno. Si los configuras en la categoría, solo necesitas quitarlos de la categoría y guardar.

  • isMenu: 0 no menú, 1 producto de tipo menú.
  • shouldAppearInMenuList: 0 no activada, 1 activada.
  • isOpen: 0 no es un producto abierto, 1 es un producto abierto.
  • nameKitchen: Nombre diferente para los tickets de preparación (mínimo 3 caracteres).
  • costPrice: Precio de coste con punto para decimales. Ejemplo: 8.2
  • displayInventory: 0 sin activar, 1 muestra stock en la app.
  • allergies: Alérgenos. Existen 13 tipos.
  • dish_order_id: Orden de plato por defecto.
  • barcode: Código de barras.
  • unit_id: ID de la unidad de venta.
  • extra_id: Código Nielsen si aplica.
  • useAverageCostPrice: 0 no activo, 1 activado.
  • cookDuration: Tiempo de elaboración en segundos (para KDS).
  • buttonName: Nombre alternativo en la app.
  • minQuantity: Cantidad mínima para añadir el producto.
  • extra_attributes: Atributos del producto. Existen 37 tipos.

IMPORTANTE: El nombre de los campos en la cabecera deben ser exactamente iguales a los escritos aquí. Sin mayúsculas al principio, sin espacios, sin el símbolo ":".

Correcto: category_id

Incorrecto: Category_id / CATEGORY_ID / category id

EJEMPLO DE IMPORTAR PRODUCTOS:

category_id name price hasInventory unit_id type
10 Café Solo 1.30 1 2 1
15 Coca Cola 1.80 1 2 1
17 Vino Tinto 0.00 1 7 4
24 Ensalada Verde 7.30 0 2 1
25 Menú Diario 12.50 0 1 1

4. ACTUALIZAR PRODUCTOS (products update):

Opción para actualizar o añadir información en productos existentes mediante un archivo CSV.

Al ser el ID obligatorio, se recomienda partir de la lista de productos de REVO y exportar el CSV.

Campos obligatorios:

  • id: ID del producto.

Campos opcionales:

Todos los campos vistos en la sección anterior.

EJEMPLO:

id nameKitchen costprice isMenu
100 Solo 0.00 0
101 Coca Cola 0.49 0
110 M. Diario 0.00 1

5. CONTENEDORES (containers):

Los contenedores son carpetas donde puedes agrupar productos. Son un "cuarto nivel" tras Grupos, Categorías y Productos.

Campos obligatorios:

  • category_id: ID de la categoría donde crear el contenedor.
  • name: Nombre del contenedor.

Campos opcionales:

  • photo: Nombre de archivo de la foto.

EJEMPLO:

category_id name
10 CAFÉS
15 AGUAS
17 VINOS TINTOS

6. PRODUCTOS DE CONTENEDOR (container items):

Asocia productos a un contenedor existente.

Campos obligatorios:

  • main_item_id: ID del contenedor.
  • item_id: ID de los productos.

Puedes obtener los IDs colocando el cursor sobre el icono del lápiz en el back-office.

Campos opcionales:

  • order: Orden de visualización dentro del contenedor.
  • dish_order_id: Orden de plato por defecto.
  • active: 0 no activo, 1 activo.

EJEMPLO:

main_item_id item_id
15 140
15 141
15 142

7. FORMATOS DE VENTA (item selling formats):

Importa productos con formatos de venta (combinado, solo, chupito, etc.).

Campos obligatorios:

  • quantity: Cantidad a descontar del stock.
  • price: Precio con punto para decimales.
  • order: Orden de visualización.
  • format_id: ID del formato de venta.
  • item_id: ID del producto.
  • combination_group_id: ID del grupo de combinados (0 si no aplica).
  • unit_id: ID de la unidad de stock.

EJEMPLO:

item_id format_id price quantity unit_id order combination_group_id
196 3 12 5 7 00 2
196 4 11 5 7 01 0
196 5 3 3 7 02 0

8. AÑADIR INVENTARIO (inventory add):

Añade stock a tus productos, especialmente útil la primera vez.

Campos obligatorios:

  • item_id: ID de los productos.
  • quantity: Cantidad a añadir.
  • warehouse_id: ID del almacén.

Si tienes varios almacenes, repite el ID del producto con distintos warehouse_id.

EJEMPLO:

item_id quantity warehouse_id
100 150 1
102 150 1
100 500 2

9. ESTABLECER/HACER INVENTARIO (inventory set):

Establece el stock exacto de tus productos. Ideal tras un recuento de inventario.

Campos obligatorios:

  • item_id: ID de los productos.
  • quantity: Cantidad a establecer.
  • warehouse_id: ID del almacén.

Campos opcionales:

  • defaultQuantity: Cantidad de referencia en el almacén.
  • alert: Mínimo de stock para recibir alerta.

EJEMPLO:

item_id quantity warehouse_id
100 100 1
110 232 1

10. MOVER INVENTARIO (inventory move):

Traslada stock entre almacenes.

Campos obligatorios:

  • item_id: ID de los productos.
  • quantity: Cantidad a mover.
  • warehouse_id: ID del almacén origen.
  • to_warehouse_id: ID del almacén destino.

EJEMPLO:

item_id quantity warehouse_id to_warehouse_id
100 100 1 2
102 100 1 2

11. IMPORTAR PROVEEDORES (vendors):

Importa proveedores en masa para usar el módulo de compras.

Campos obligatorios:

  • name: Nombre del proveedor (mínimo 3 caracteres).
  • address: Dirección.
  • nif: NIF del proveedor.

Campos opcionales:

  • city: Ciudad.
  • state: Provincia.
  • country: País.
  • postalCode: Código postal.
  • web: Página web.
  • email: Correo electrónico.
  • phone: Teléfono.
  • notes: Notas.
  • shouldBeNotified: 1 notificar cambios, 0 no notificar.

EJEMPLO:

name address nif postalCode city country notes
Proveedor 1 Gran Via, 30 A58818501 28010 Madrid España Alimentación.
Proveedor 2 Via Laietana, 222 B54416504 08010 Barcelona España Refrescos.

12. PRODUCTOS DE PROVEEDORES (vendors items):

Asocia productos a tus proveedores para usar el módulo de compras.

Campos obligatorios:

  • vendor_id: ID del proveedor.
  • item_id: ID del producto.

Campos opcionales:

  • reference: Código de referencia.
  • pack: Unidades por pack.
  • costPrice: Precio de coste.
  • unit_id: ID de la unidad.
  • tax_id: ID del impuesto.

EJEMPLO:

vendor_id item_id pack costPrice unit_id tax_id
1 100 24 0.25 1 2
1 102 24 0.30 1 2

13. IMPORTAR CLIENTES (customers):

Importa clientes en masa.

Campos obligatorios:

  • name: Nombre del cliente (mínimo 3 caracteres).
  • address_country: País (código ISO 3166-1 alfa-2, ejemplo: ES).

Si se incluye dirección, también son obligatorios:

  • address_street_address: Dirección.
  • address_postal_code: Código postal.
  • address_city: Ciudad.
  • address_state: Provincia.

Campos opcionales:

  • active: 0 inactivo, 1 activo.
  • nif: NIF del cliente (si se introduce, la dirección es obligatoria).
  • email: Correo electrónico.
  • phone: Teléfono.
  • language: Idioma.
  • nationality: Nacionalidad.
  • birth_date: Fecha de nacimiento.
  • gender: Género.
  • allergies: Alergias.
  • web: Página web.
  • notes: Notas.
  • extra_id: ID del grupo de clientes.
  • address_notes: Notas de la dirección.

EJEMPLO:

name address_street_address nif address_postal_code address_city address_state address_country notes
Hugo Reyes Gran Via, 30 A58818501 28010 Madrid Madrid ES Le gusta nuestro plato especial.
Maggie Greene Calle de La Paz, 11 V51218667 46003 Valencia Valencia ES Mesa con vistas al mar.

14. TARJETAS REGALO (gift cards):

Importa tarjetas regalo en masa al back-office.

Campos obligatorios:

  • uuid: Código único. Puede ser texto y números.
  • total: Saldo. Debe ser numérico.

Campos opcionales:

  • active: 0 inactivo, 1 activo.
  • balance: Saldo restante (si diferente al total).
  • campaign_id: ID de la campaña.
  • customer_id: ID del cliente asociado.

EJEMPLO:

uuid total campaign_id
00000123456 100 1
TR1234567 50 1
Pedro González 75 2

15. RECARGAR TARJETAS REGALO (gift cards reload):

Importa recargas en las tarjetas regalo.

Campos obligatorios:

  • uuid: Código de la tarjeta.
  • reloadAmount: Saldo a cargar.

EJEMPLO:

uuid reloadAmount
00000123456 100
00000789100 100

16. TARIFAS (price rates):

Para importar tarifas, accede a: https://revoxef.works/thrust/prices/import

Campos obligatorios:

  • priceable_id: ID del elemento.
  • table_price_id: ID de la tarifa.
  • price: Precio con punto para decimales.
  • priceable_type: Tipo de elemento:
Tipo Valor
Productos App\Models\Menu\MenuItem
Productos de menú App\Models\Menu\MenuMenuPivot
Modificadores App\Models\Menu\Modifier
Formato de venta App\Models\Menu\ItemSellingFormatPivot
Combinados App\Models\Menu\Combination

EJEMPLO:

priceable_id table_price_id price priceable_type
902 2 4.00 App\Models\Menu\MenuItem
870 2 3.00 App\Models\Menu\MenuMenuPivot
331 2 1.50 App\Models\Menu\Modifier

17. EMPLEADOS (Employees):

Importa empleados en masa.

Campos obligatorios:

  • name: Nombre del empleado.
  • pin: PIN numérico.
  • permission_id: ID del privilegio de app.

Campos opcionales:

  • active: 0 inactivo, 1 activo.
  • surname: Apellido.
  • username: Usuario.
  • email: Correo electrónico.
  • phone: Teléfono.
  • notes: Notas.
  • profile_id: ID del perfil.
  • password: Contraseña.
  • photo: Nombre del archivo de foto.
  • cashier_id: ID del cajero.
  • identifier: Identificador adicional (tarjeta magnética, QR, etc.).
  • back_permission_id: ID del privilegio del back-office.
  • nif: DNI del empleado.

EJEMPLO:

active name surname pin permission_id username back_permission_id
1 Fran Marjolaine 1111 1 Fran 2
1 Lucía Kailey 2222 2 1

18. ACTUALIZAR EMPLEADOS (update employees):

Actualiza información de empleados existentes. Parte de la lista de empleados de REVO exportada en CSV.

Campos obligatorios:

  • id: ID del empleado.

Campos opcionales:

Todos los campos vistos en la sección anterior.

EJEMPLO:

id username password back_permission_id
2 maria marIa24! 1
3 pedro pEdro24! 3
6 claudia clauDia24! 3