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.
Antes de empezar
Hay dos importadores
Comprueba cuál debes usar para cada tipo de datos.
Antes de empezar: hay dos importadores
Nuevo importadorCabeceras libres · mapeo de columnas
Se utiliza para Grupos y Categorías. Se accede desde Catálogo → Grupos. Para importar grupos, pulsa Importar. Para importar categorías, entra primero en el grupo al que quieras añadirlas y, desde dentro, pulsa Importar. El sistema permite mapear las columnas, por lo que el CSV no necesita utilizar cabeceras con nombres exactos.
También se utiliza para las categorías de modificador, desde Catálogo → Modificadores.
Importador CSV antiguoCabeceras estrictas
Se utiliza para el resto de importaciones. Se accede desde revoxef.works/tools/import. En este importador, las cabeceras deben coincidir exactamente con las indicadas en cada apartado. Tarifas utiliza su URL específica.
Si partes de la plantilla del importador, elimina las líneas de instrucciones que hay antes de la cabecera: la primera fila debe ser la cabecera, con los campos separados por ;. Puedes eliminar las columnas opcionales que no necesites.
Catálogo
Crea y actualiza tu catálogo
Importa grupos, categorías, productos, contenedores y formatos de venta.
Catálogo
1Importar grupos
Nuevo importador
Cabeceras libres: al subir el CSV, relaciona cada columna con su campo en Mapear los campos.
Para crear o actualizar grupos de forma masiva, accede a Catálogo → Grupos y pulsa Importar. Se abrirá el nuevo importador de grupos.
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:
| Campo para mapear | Requisito | Descripción | Información adicional |
|---|---|---|---|
| Nombre | Obligatorio | El nombre principal del grupo. | Texto libre. |
| Traducciones | Crítico | Traducciones para el multi-idioma. | Imprescindible: Mapear con la columna del nombre. Si no, se creará con el nombre genérico "New Item". |
| Id | Opcional | Identificador del grupo en el sistema. | Solo se rellena para actualizaciones. |
| Activo | Opcional | Define si el grupo está activo o no. | 0 (Inactivo), 1 (Activo). |
| Impuesto | Opcional | El impuesto asociado al grupo. | Introducir el ID numérico interno del impuesto. |
| Grupo analítico | Opcional | El grupo analítico correspondiente. | Introducir el ID numérico. |
| Impresora | Opcional | La impresora de comandas asignada. | Introducir el ID numérico. |
| Grupo de impresoras | Opcional | El grupo de impresoras asignado. | Introducir el ID numérico. |
| Flujo de estados | Opcional | El flujo de estados de cocina (KDS). | Introducir el ID numérico. |
| Extra ID | Opcional | Campo adicional para identificadores de integración. | Texto alfanumérico libre. |
Ejemplo CSV · Importar Grupos
| Nombre | Bebidas | Comida | Postres |
| Traduccion | Bebidas | Comida | Postres |
| ID | 15 | ||
| Activo | 1 | 1 | 1 |
| Impuesto | 1 | 2 | 2 |
| Grupo_Analitico | 3 | 4 | 5 |
| Impresora | 2 | 4 | 4 |
| Grp_Impresoras | 0 | 2 | 0 |
| Flujo_Estados | 1 | 1 | 2 |
| Extra_ID | EXT-001 | EXT-002 | EXT-003 |
2Importar categorías
Nuevo importador
Cabeceras libres: al subir el CSV, relaciona cada columna con su campo en Mapear los campos.
Para importar categorías de forma masiva, accede a Catálogo → Grupos, entra en el grupo al que quieras añadir las categorías y, desde dentro del grupo, pulsa Importar. Se abrirá el nuevo importador de categorías.
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:
| Campo para mapear | Requisito | Descripción | Información adicional |
|---|---|---|---|
| Grupo | Obligatorio | El grupo al que pertenece la categoría. | Introducir el ID numérico o el nombre exacto del grupo padre. |
| Nombre | Obligatorio | El nombre de la categoría. | Texto libre. |
| Traducciones | Crítico | Traducciones para el multi-idioma. | Imprescindible: Mapear con la columna del nombre. Si no, se creará con el nombre genérico "New Item". |
| Id | Opcional | Identificador interno de la categoría. | Solo se rellena para actualizaciones. |
| Activo | Opcional | Define si la categoría está activa o no. | 0 (Inactivo), 1 (Activo). |
| Impuesto | Opcional | El impuesto asociado a la categoría. | Introducir el ID numérico. |
| Grupo analítico | Opcional | El grupo analítico correspondiente. | Introducir el ID numérico. |
| Impresora | Opcional | La impresora de comandas asignada. | Introducir el ID numérico. |
| Grupo de impresoras | Opcional | El grupo de impresoras asignado. | Introducir el ID numérico. |
| Flujo de estados | Opcional | El flujo de estados de cocina. | Introducir el ID numérico. |
| Extra ID | Opcional | Campo adicional para integraciones externas. | Texto alfanumérico libre. |
Ejemplo CSV · Importar Categorías
| Nombre | Refrescos | Cervezas | Tapas |
| Grupo | Bebidas | Bebidas | Comida |
| Traduccion | Refrescos | Cervezas | Tapas |
| ID | 32 | ||
| Activo | 1 | 1 | 1 |
| Impuesto | 1 | 1 | 2 |
| Grupo_Analitico | 6 | 6 | 7 |
| Impresora | 2 | 3 | 5 |
| Grp_Impresoras | 0 | 0 | 2 |
| Flujo_Estados | 1 | 1 | 2 |
| Extra_ID | EXT-010 | EXT-011 | EXT-012 |
3Importar categorías de modificador
Nuevo importador
Cabeceras libres: al subir el CSV, relaciona cada columna con su campo en Mapear los campos.
Para importar categorías de modificador de forma masiva, accede a Catálogo → Modificadores y pulsa Importar. Se abrirá el nuevo importador de categorías de modificador.
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:
| Campo para mapear | Requisito | Descripción | Información adicional |
|---|---|---|---|
| Nombre | Obligatorio | El nombre de la categoría de modificador. | Texto de al menos 3 caracteres. Ejemplo: Punto de cocción. |
| Min | Obligatorio | Mínimo de la configuración de mínimo y máximo de modificadores. | Número entero igual o mayor que 1 y no mayor que Max. Ejemplo: 1. |
| Max | Obligatorio | Máximo de la configuración de mínimo y máximo de modificadores. | Número entero entre 1 y 1000, igual o mayor que Min. Ejemplo: 1. |
| Id | Opcional | Identificador de la categoría de modificador. | ID numérico. |
| Activo | Opcional | Define si la categoría de modificador está activa o no. | 0 (Inactivo), 1 (Activo). |
| Oculto | Opcional | Define si la categoría de modificador está oculta o no. | 0 (Visible), 1 (Oculto). |
| Traducciones | Opcional | Traducciones para el multi-idioma. | |
| Selección | Opcional | Configuración anterior: si hay selección. | 0 (Sin selección), 1 (Con selección). Obsoleto. |
| Último campo, sin nombre | Opcional | Configuración anterior: si la selección es obligatoria u opcional. | 0 (Obligatorio), 1 (Opcional). Obsoleto. |
Ejemplo CSV · Importar Categorías de Modificador
| Nombre | Punto de cocción | Salsas | Guarnición |
| Activo | 1 | 1 | 1 |
| Oculto | 0 | 0 | 0 |
| Min | 1 | 1 | 1 |
| Max | 1 | 3 | 1 |
En el importador, los obligatorios llevan asterisco (*). Selección y el último campo sin nombre están obsoletos: los sustituyen Min y Max, que requieren la app 4.3 o superior.
4Importar productosPRODUCTS
Importador CSV antiguoCabeceras estrictas
name;nameKitchen;buttonName;price;photo;order;active;info;isOpen;cookDuration;type;hasInventory;usesWeight;category_id;super_group_id;extra_id;minQuantity;report_category_id;config;tax_id;printer_id;printer_group_id;modifier_category_id;modifier_group_id;costPrice;useAverageCostPrice;displayInventory;allergies;dish_order_id;barcode;unit_id;extra_attributes;nutrition;kds_status_flux_idOpció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.
ImportanteEl 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:
Incorrecto:
Correcto:
category_idIncorrecto:
Category_id / CATEGORY_ID / category id| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| category_id | Obligatorio | ID de la categoría. Antes de importar, crea manualmente la estructura para obtener este ID. | Introducir ID numérico. |
| name | Obligatorio | Nombre del producto. | Texto libre (mínimo 3 caracteres). |
| super_group_id | Opcional | ID del grupo analítico asignado al producto. | Introducir ID numérico. |
| price | Opcional | Precio de venta al público. | Usar punto para decimales. Ejemplo: 10.20 |
| costPrice | Opcional | Precio de coste interno. | Usar punto para decimales. Ejemplo: 8.20 |
| type | Opcional | Define la naturaleza operativa del producto. | 0: Producto, 1: Menú, 2: Contenedor, 3: Entrada, 4: Formato, 5: Tarjeta regalo, 6: Solo gestión, 7: Kit. |
| active | Opcional | Estado de visibilidad en el TPV. | 0 (Inactivo), 1 (Activo). Si se omite, se activan todos. |
| hasInventory | Opcional | Control de unidades y stock. | 0 (Sin control), 1 (Con control). |
| displayInventory | Opcional | Muestra las unidades restantes en la app. | 0 (No muestra), 1 (Muestra stock). |
| usesWeight | Opcional | Enlaza con balanza. | 0 (No utiliza peso), 1 (Utiliza peso). |
| allergies | Opcional | Alergias asociadas al producto. | Introducir los IDs numéricos separados por punto y coma (Ej: 1;5;14). |
IDs DE ALÉRGENOS0Sin alérgenos (null)1Huevos2Sésamo3Altramuces4Mostaza5Pescado6Apio7Crustáceos8Cacahuetes9Moluscos10Soja11Frutos de cáscara12Sulfitos13Lácteos14Gluten | |||
| isMenu | Opcional | Define si actúa como agrupador de menú. | 0 (No menú), 1 (Producto tipo menú). |
| shouldAppearInMenuList | Opcional | Si es seleccionable dentro de otros menús. | 0 (No activada), 1 (Activada). |
| isOpen | Opcional | Exige introducir un precio manualmente al vender. | 0 (Precio cerrado), 1 (Producto abierto). |
| order | Opcional | Orden de visualización dentro de la categoría. | Usar números: 1, 2, 3, etc. |
| barcode | Opcional | Código de barras del producto. | Valor numérico o EAN. |
| tax_id | Opcional | Impuesto por defecto del producto. | ID numérico. |
| printer_id | Opcional | Impresora directa por defecto del producto. | ID numérico. |
| printer_group_id | Opcional | Grupo de impresoras directo por defecto. | ID numérico. |
| modifier_group_id | Opcional | Grupo de modificadores específicos del producto. | ID numérico. |
| modifier_category_id | Opcional | Categoría de modificador asignada al producto. | ID numérico. |
| photo | Opcional | Imagen del producto. | Nombre del archivo y extensión. |
| info | Opcional | Descripción ampliada del producto. | Texto libre. |
| buttonName | Opcional | Nombre alternativo reducido. | Para mostrar en la botonera de la app. |
| nameKitchen | Opcional | Nombre diferente para los tickets de preparación. | Texto libre. |
| dish_order_id | Opcional | Orden de salida de platos. | ID numérico. |
| unit_id | Opcional | ID de la unidad de venta. | ID numérico. |
| extra_id | Opcional | Código externo o Nielsen si aplica. | Texto alfanumérico. |
| useAverageCostPrice | Opcional | Cálculo de coste promediado. | 0 (No activo), 1 (Activado). |
| cookDuration | Opcional | Tiempo de elaboración estimado. | Valor en segundos (Para KDS). |
| minQuantity | Opcional | Cantidad mínima al añadir producto. | Valor numérico. |
| extra_attributes | Opcional | Atributos especiales. | ID numérico. |
ImportanteEs importante destacar que configurar la impresora o los modificadores directamente en los productos puede causar problemas futuros. Si está configurado por producto, deberás cambiarlo/quitarlo uno por uno. Si la configuración es en la categoría o grupo, se puede modificar con unos pocos clics.
Ejemplo CSV · Importar Productos
| category_id | 10 | 15 | 25 |
| super_group_id | 3 | ||
| name | Café Solo | Coca Cola | Menú Diario |
| price | 1.30 | 1.80 | 12.50 |
| costPrice | 0.20 | 0.50 | 4.00 |
| type | 0 | 0 | 1 |
| active | 1 | 1 | 1 |
| hasInventory | 1 | 1 | 0 |
| displayInventory | 0 | 0 | 0 |
| usesWeight | 0 | 0 | 0 |
| allergies | 1;5;14 | ||
| isMenu | 0 | 0 | 1 |
| shouldAppearInMenuList | 0 | 0 | 1 |
| isOpen | 0 | 0 | 0 |
| order | 1 | 2 | 3 |
| barcode | 84123456 | 84123457 | |
| tax_id | 1 | 1 | 2 |
| printer_id | 2 | ||
| printer_group_id | 1 | ||
| modifier_group_id | 4 | ||
| modifier_category_id | 5 | ||
| photo | cafe.jpg | cola.jpg | menu.jpg |
| info | Arábica | Refresco | Completo |
| buttonName | Café S | Coca C | Menu Dia |
| nameKitchen | CAFE SOLO | COCA COLA | MENU DIARIO |
| dish_order_id | 0 | 0 | 0 |
| unit_id | 2 | 2 | 1 |
| extra_id | EX-001 | EX-002 | EX-003 |
| useAverageCostPrice | 0 | 1 | 0 |
| cookDuration | 120 | 0 | 0 |
| minQuantity | 1 | 1 | 1 |
| extra_attributes | 0 | 0 | 0 |
5Actualizar productosPRODUCTS UPDATE
Importador CSV antiguoCabeceras estrictas
Misma cabecera que la plantilla de Importar productos, con id como primera columna.
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 exportada previamente.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| id | Obligatorio | Identificador único del producto en base de datos. | ID numérico interno de REVO. |
| super_group_id | Opcional | ID del grupo analítico asignado al producto. | Introducir ID numérico. |
Ejemplo CSV · Actualizar Productos
| id | 100 | 101 |
| category_id | 10 | 15 |
| super_group_id | 3 | |
| name | Café Solo Intenso | Coca Cola Zero |
| price | 1.40 | 1.90 |
| costPrice | 0.22 | 0.55 |
| type | 0 | 0 |
| active | 1 | 1 |
| hasInventory | 1 | 1 |
| displayInventory | 0 | 0 |
| usesWeight | 0 | 0 |
| allergies | 14 | |
| isMenu | 0 | 0 |
| shouldAppearInMenuList | 0 | 0 |
| isOpen | 0 | 0 |
| order | 1 | 2 |
| barcode | 84123456 | 84123457 |
| tax_id | 1 | 1 |
| printer_id | 2 | |
| printer_group_id | 1 | |
| modifier_group_id | 4 | |
| modifier_category_id | 5 | |
| photo | cafe_new.jpg | colaz.jpg |
| info | Nuevo | Zero |
| buttonName | Intenso | Coca Z |
| nameKitchen | CAFE INTENSO | COCA ZERO |
| dish_order_id | 0 | 0 |
| unit_id | 2 | 2 |
| extra_id | EX-001 | EX-002 |
| useAverageCostPrice | 0 | 1 |
| cookDuration | 120 | 0 |
| minQuantity | 1 | 1 |
| extra_attributes | 0 | 0 |
6ContenedoresCONTAINERS
Importador CSV antiguoCabeceras estrictas
category_id;name;photoLos contenedores son carpetas donde puedes agrupar productos. Son un "cuarto nivel" tras Grupos, Categorías y Productos.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| category_id | Obligatorio | ID de la categoría donde residirá la carpeta. | ID numérico. |
| name | Obligatorio | Nombre visual del contenedor/carpeta. | Texto libre. |
| photo | Opcional | Nombre de archivo de la foto de portada. | Nombre de archivo e imagen. |
Ejemplo CSV · Contenedores
| category_id | 10 | 15 | 17 |
| name | CAFÉS | AGUAS | VINOS TINTOS |
| photo | carpeta_cafes.jpg | carpeta_aguas.jpg | carpeta_vinos.jpg |
7Productos de contenedorCONTAINER ITEMS
Importador CSV antiguoCabeceras estrictas
order;active;item_id;main_item_id;dish_order_idAsocia productos a un contenedor existente.
Puedes obtener los IDs colocando el cursor sobre el icono del lápiz en el back-office.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| main_item_id | Obligatorio | ID del contenedor madre (carpeta). | ID numérico. |
| item_id | Obligatorio | ID de los productos que vas a meter dentro. | ID numérico. |
| order | Opcional | Orden de visualización dentro del contenedor. | Valor numérico. |
| dish_order_id | Opcional | Orden de plato por defecto aplicado en esta carpeta. | ID numérico. |
| active | Opcional | Estado del producto dentro de la vista de carpeta. | 0 (Inactivo), 1 (Activo). |
Ejemplo CSV · Productos de Contenedor
| main_item_id | 15 | 15 | 15 |
| item_id | 140 | 141 | 142 |
| order | 1 | 2 | 3 |
| dish_order_id | 0 | 0 | 0 |
| active | 1 | 1 | 1 |
8Formatos de ventaITEM SELLING FORMATS
Importador CSV antiguoCabeceras estrictas
active;quantity;price;order;format_id;item_id;combination_group_id;unit_idImporta productos con formatos de venta (combinado, solo, chupito, etc.).
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| item_id | Obligatorio | ID del producto base. | ID numérico. |
| format_id | Obligatorio | ID del formato de venta configurado. | ID numérico. |
| price | Obligatorio | Precio de venta para este formato. | Usar punto para decimales. |
| quantity | Obligatorio | Cantidad exacta a descontar del stock general. | Usar decimales según unidad. |
| unit_id | Obligatorio | ID de la unidad de medida de stock. | ID numérico. |
| order | Obligatorio | Orden de visualización en el desplegable. | Valor numérico. |
| combination_group_id | Obligatorio | ID del grupo de combinados forzado (si aplica). | Poner 0 si no aplica. |
Ejemplo CSV · Formatos de Venta
| item_id | 196 | 196 | 196 |
| format_id | 3 | 4 | 5 |
| price | 12.00 | 11.00 | 3.00 |
| quantity | 1.00 | 1.00 | 0.20 |
| unit_id | 7 | 7 | 7 |
| order | 1 | 2 | 3 |
| combination_group_id | 2 | 0 | 0 |
Inventario
Ajusta el stock de tus almacenes
Añade stock, fija el stock exacto tras un recuento o muévelo entre almacenes.
Inventario
9Añadir inventarioINVENTORY ADD
Importador CSV antiguoCabeceras estrictas
item_id;quantity;warehouse_idAñade stock a tus productos, especialmente útil la primera vez.
Si tienes varios almacenes, repite el ID del producto con distintos warehouse_id.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| item_id | Obligatorio | ID de los productos a aprovisionar. | ID numérico. |
| quantity | Obligatorio | Cantidad que deseas SUMAR al stock. | Valor numérico positivo. |
| warehouse_id | Obligatorio | ID del almacén donde entra el stock. | ID numérico. |
Ejemplo CSV · Añadir Inventario
| A | B | C | |
|---|---|---|---|
| 1 | item_id | quantity | warehouse_id |
| 2 | 100 | 150 | 1 |
| 3 | 102 | 150 | 1 |
| 4 | 100 | 500 | 2 |
10Establecer/hacer inventarioINVENTORY SET
Importador CSV antiguoCabeceras estrictas
item_id;quantity;warehouse_id;defaultQuantity;alertEstablece el stock exacto de tus productos. Ideal tras un recuento de inventario.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| item_id | Obligatorio | ID de los productos. | ID numérico. |
| quantity | Obligatorio | Cantidad física exacta a establecer. | Valor numérico que sobrescribirá el anterior. |
| warehouse_id | Obligatorio | ID del almacén. | ID numérico. |
| defaultQuantity | Opcional | Cantidad de stock de referencia / ideal. | Valor numérico. |
| alert | Opcional | Mínimo de stock para recibir alerta de pedido. | Valor numérico. |
Ejemplo CSV · Establecer Inventario
| item_id | 100 | 110 |
| quantity | 100 | 232 |
| warehouse_id | 1 | 1 |
| defaultQuantity | 200 | 400 |
| alert | 10 | 20 |
11Mover inventarioINVENTORY MOVE
Importador CSV antiguoCabeceras estrictas
item_id;quantity;warehouse_id;to_warehouse_idTraslada stock entre almacenes.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| item_id | Obligatorio | ID de los productos a trasladar. | ID numérico. |
| quantity | Obligatorio | Cantidad exacta a mover. | Valor numérico. |
| warehouse_id | Obligatorio | ID del almacén de origen. | Almacén que resta (ID numérico). |
| to_warehouse_id | Obligatorio | ID del almacén de destino. | Almacén que suma (ID numérico). |
Ejemplo CSV · Mover Inventario
| item_id | 100 | 102 |
| quantity | 100 | 100 |
| warehouse_id | 1 | 1 |
| to_warehouse_id | 2 | 2 |
Proveedores
Prepara el módulo de compras
Importa proveedores y relaciónalos con tus productos.
Proveedores
12Importar proveedoresVENDORS
Importador CSV antiguoCabeceras estrictas
Importa proveedores en masa para usar el módulo de compras.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| name | Obligatorio | Nombre del proveedor. | Texto libre (mínimo 3 caracteres). |
| address | Obligatorio | Dirección principal de facturación/entrega. | Texto libre. |
| nif | Obligatorio | NIF o identificador fiscal. | CIF, DNI, etc. |
| city | Opcional | Ciudad o localidad. | Texto libre. |
| state | Opcional | Provincia o Estado. | Texto libre. |
| country | Opcional | País sede del proveedor. | Texto libre. |
| postalCode | Opcional | Código postal. | Alfanumérico. |
| web | Opcional | Página web corporativa. | Formato URL. |
| Opcional | Correo electrónico para pedidos. | Email válido. | |
| phone | Opcional | Teléfono de contacto. | Numérico. |
| notes | Opcional | Notas y observaciones internas. | Texto libre. |
| shouldBeNotified | Opcional | Notificar al proveedor ante cambios de estado. | 1 (Notificar), 0 (No notificar). |
Ejemplo CSV · Importar Proveedores
| name | Proveedor 1 | Proveedor 2 |
| address | Gran Via, 30 | Via Laietana, 222 |
| nif | A58818501 | B54416504 |
| city | Madrid | Barcelona |
| state | Madrid | Barcelona |
| country | España | España |
| postalCode | 28010 | 08010 |
| web | www.prov1.es | www.prov2.com |
| pedidos@prov1.es | info@prov2.es | |
| phone | +34 912345678 | +34 931234567 |
| notes | Alimentación | Refrescos |
| shouldBeNotified | 1 | 0 |
13Productos de proveedoresVENDORS ITEMS
Importador CSV antiguoCabeceras estrictas
Asocia productos a tus proveedores para usar el módulo de compras.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| vendor_id | Obligatorio | ID del proveedor creado en el sistema. | ID numérico. |
| item_id | Obligatorio | ID del producto en REVO que provee. | ID numérico. |
| reference | Opcional | Código de referencia del producto en el catálogo del proveedor. | Alfanumérico. |
| pack | Opcional | Unidades que contiene cada pack/caja de compra. | Valor numérico. |
| costPrice | Opcional | Precio de coste pactado. | Usar punto para decimales. |
| unit_id | Opcional | ID de la unidad de medida en compra. | ID numérico. |
| tax_id | Opcional | ID del impuesto soportado en compra. | ID numérico. |
Ejemplo CSV · Productos de Proveedores
| vendor_id | 1 | 1 |
| item_id | 100 | 102 |
| reference | REF-01 | REF-02 |
| pack | 24 | 24 |
| costPrice | 0.25 | 0.30 |
| unit_id | 1 | 1 |
| tax_id | 2 | 2 |
Clientes y tarjetas regalo
Carga clientes y tarjetas regalo
Importa clientes y tarjetas regalo, o recarga saldo en tarjetas existentes.
Clientes y tarjetas regalo
14Importar clientesCUSTOMERS
Importador CSV antiguoCabeceras estrictas
active;name;last_name;nif;email;phone;language;photo;level;nationality;birth_date;gender;allergies;promotions_accepted;web;notes;extra_id;extra_attributes;remember_token;prevent_deletion;vat_validation;address_name;address_address_line_2;address_street_address;address_postal_code;address_city;address_state;address_country;address_geolocation;address_notesImporta clientes en masa.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| name | Obligatorio | Nombre del cliente o razón social. | Texto libre (mínimo 3 caracteres). |
| address_country | Condicional | País. | Obligatorio si se introduce el NIF o cualquier otro campo de dirección. Código ISO 3166-1 alfa-2 (ejemplo: ES). |
| address_street_address | Condicional | Dirección de la calle. | Obligatorio si se introduce el NIF u otro campo de dirección. |
| address_postal_code | Condicional | Código postal. | Obligatorio si se introduce el NIF u otro campo de dirección. |
| address_city | Condicional | Ciudad o localidad. | Obligatorio si se introduce el NIF u otro campo de dirección. |
| address_state | Condicional | Provincia o Estado. | Obligatorio si se introduce el NIF u otro campo de dirección. |
| nif | Opcional | NIF o identificador fiscal. | Si se introduce, la dirección pasa a ser obligatoria. |
| active | Opcional | Estado del cliente. | 0 (Inactivo), 1 (Activo). |
| Opcional | Correo electrónico. | Formato de email válido. | |
| phone | Opcional | Teléfono de contacto. | Debe incluir el prefijo internacional para ser válido (Ej: +34644847774 OK, 644847774 NO OK). |
| language | Opcional | Idioma preferido para comunicaciones. | Código ISO (es, en, fr...). |
| nationality | Opcional | Nacionalidad. | Texto libre. |
| birth_date | Opcional | Fecha de nacimiento del cliente. | Formato estricto: AAAA-MM-DD. |
| gender | Opcional | Género. | Male, Female o Other. |
| allergies | Opcional | Alergias que sufre el cliente. | IDs separados por punto y coma (Ej: 1;5;14). |
| web | Opcional | Página web de la empresa. | URL. |
| notes | Opcional | Notas o preferencias del cliente. | Texto libre. |
| extra_id | Opcional | Asignación a un Grupo de Clientes. | ID numérico. |
| address_notes | Opcional | Notas de entrega en domicilio. | Texto libre. |
Ejemplo CSV · Importar Clientes
| name | Hugo Reyes | Maggie Greene |
| address_country | ES | ES |
| address_street_address | Gran Via, 30 | Calle de La Paz, 11 |
| address_postal_code | 28010 | 46003 |
| address_city | Madrid | Valencia |
| address_state | Madrid | Valencia |
| nif | A58818501 | V51218667 |
| active | 1 | 1 |
| hugo@mail.com | maggie@mail.com | |
| phone | +34600123456 | +34600654321 |
| language | es | en |
| nationality | Española | Británica |
| birth_date | 1980-05-15 | 1992-10-22 |
| gender | Male | Female |
| allergies | 14 | |
| web | www.hugo.es | |
| notes | Plato especial | Mesa con vistas |
| extra_id | 1 | 2 |
| address_notes | Dejar en recepcion | Llamar al timbre |
15Tarjetas regaloGIFT CARDS
Importador CSV antiguoCabeceras estrictas
campaign_id;customer_id;active;uuid;total;balance;extra_attributesImporta tarjetas regalo en masa al back-office.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| uuid | Obligatorio | Código identificativo único de la tarjeta. | Puede ser texto y números. |
| total | Obligatorio | Saldo inicial generado. | Debe ser numérico. |
| active | Opcional | Define si la tarjeta está ya operativa. | 0 (Inactiva), 1 (Activa). |
| balance | Opcional | Saldo restante real. | Rellenar solo si es diferente al total. |
| campaign_id | Opcional | Campaña promocional asociada. | ID numérico de la campaña. |
| customer_id | Opcional | Cliente asociado de forma nominal. | ID numérico del cliente. |
Ejemplo CSV · Tarjetas Regalo
| uuid | 00000123456 | TR1234567 | Pedro Gonzalez |
| total | 100.00 | 50.00 | 75.00 |
| active | 1 | 1 | 1 |
| balance | 100.00 | 25.00 | 75.00 |
| campaign_id | 1 | 1 | 2 |
| customer_id | 405 |
16Recargar tarjetas regaloGIFT CARDS RELOAD
Importador CSV antiguoCabeceras estrictas
uuid;reloadAmountImporta recargas en las tarjetas regalo.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| uuid | Obligatorio | Código exacto de la tarjeta regalo existente. | Alfanumérico. |
| reloadAmount | Obligatorio | Saldo a inyectar al balance actual. | Numérico usando punto decimal. |
Ejemplo CSV · Recargar Tarjetas
| A | B | |
|---|---|---|
| 1 | uuid | reloadAmount |
| 2 | 00000123456 | 100.00 |
| 3 | 00000789100 | 100.00 |
Tarifas y empleados
Importa tarifas y empleados
Asigna precios por tarifa y crea o actualiza empleados.
Tarifas y empleados
17TarifasPRICE RATES
Importador CSV antiguoCabeceras estrictas
Para importar tarifas, accede a: https://revoxef.works/thrust/prices/import
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| ID | Obligatorio | Identificador del producto base. | ID numérico. |
| priceable_id | Obligatorio | Identificador del precio dentro del producto al que se hace referencia. | ID numérico. |
| table_price_id | Obligatorio | Identificador de la tarifa a la que se aplica el precio. | ID numérico. |
| price | Obligatorio | Importe que quieres establecer para la tarifa indicada. | Precio con punto para decimales. |
| priceable_type | Obligatorio | Tipo de elemento base. | Utilizar exactamente el valor de la tabla inferior. |
Valores para priceable_type:
| Tipo | Valor que hay que escribir en la columna |
|---|---|
| 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 CSV · Tarifas
| ID | 100 | 101 | 102 |
| priceable_id | 902 | 870 | 331 |
| table_price_id | 2 | 2 | 2 |
| price | 4.00 | 3.00 | 1.50 |
| priceable_type | App\Models\Menu\MenuItem | App\Models\Menu\MenuMenuPivot | App\Models\Menu\Modifier |
18EmpleadosEMPLOYEES
Importador CSV antiguoCabeceras estrictas
name;active;surname;pin;username;email;nif;phone;notes;password;photo;identifier;permission_id;cashier_id;back_permission_id;extra_id;config;profile_idImporta empleados en masa.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| name | Obligatorio | Nombre del empleado. | Texto libre. |
| pin | Obligatorio | PIN de acceso para el TPV iPad. | Valor numérico. |
| permission_id | Obligatorio | Privilegio de seguridad de la App. | ID numérico. |
| active | Opcional | Estado del empleado en plantilla. | 0 (Inactivo), 1 (Activo). |
| surname | Opcional | Apellido. | Texto libre. |
| username | Opcional | Usuario de acceso al back-office web. | Texto corto sin espacios. |
| password | Opcional | Contraseña secreta para el back-office. | Alfanumérico. |
| Opcional | Correo electrónico. | Email válido. | |
| phone | Opcional | Teléfono de contacto. | Numérico. |
| notes | Opcional | Notas internas. | Texto libre. |
| profile_id | Opcional | Perfil de empleado predeterminado. | ID numérico. |
| photo | Opcional | Avatar visual. | Nombre del archivo y extensión. |
| cashier_id | Opcional | Cajero por defecto asignado. | ID numérico. |
| identifier | Opcional | Identificador de llave de seguridad TPV. | Valor hexadecimal (NFC, QR...). |
| back_permission_id | Opcional | Nivel de privilegios del back-office. | ID numérico. |
| nif | Opcional | DNI del empleado. | Alfanumérico. |
Ejemplo CSV · Empleados
| name | Fran | Lucía |
| pin | 1111 | 2222 |
| permission_id | 1 | 2 |
| active | 1 | 1 |
| surname | Marjolaine | Kailey |
| username | Fran | Lucia |
| password | pass123 | pass456 |
| fran@mail.com | lucia@mail.com | |
| phone | 600111222 | 600333444 |
| notes | Encargado | Camarera |
| profile_id | 2 | 1 |
| photo | fran.jpg | lucia.jpg |
| cashier_id | 0 | 0 |
| identifier | 1A2B3C | 4D5E6F |
| back_permission_id | 2 | 1 |
| nif | 12345678A | 87654321B |
19Actualizar empleadosUPDATE EMPLOYEES
Importador CSV antiguoCabeceras estrictas
Actualiza información de empleados existentes. Parte de la lista de empleados exportada en CSV.
| Cabecera exacta | Requisito | Descripción | Información adicional |
|---|---|---|---|
| id | Obligatorio | Identificador único interno del empleado. | ID numérico generado por REVO. |
Ejemplo CSV · Actualizar Empleados
| id | 2 | 3 |
| name | Maria | Pedro |
| pin | 1122 | 3344 |
| permission_id | 1 | 2 |
| active | 1 | 0 |
| surname | Garcia | Lopez |
| username | maria | pedro |
| password | marIa24! | pEdro24! |
| maria@mail.com | pedro@mail.com | |
| phone | 600999888 | 600777666 |
| notes | Baja | |
| profile_id | 2 | 1 |
| photo | maria.jpg | pedro.jpg |
| cashier_id | 0 | 0 |
| identifier | 7G8H9I | 0J1K2L |
| back_permission_id | 1 | 3 |
| nif | 11111111C | 22222222D |
