Amb Revo XEF, pots importar fitxers CSV separats per ";". La primera fila ha de tenir la capçalera amb els noms dels camps exactament com es descriuen a continuació.
Abans de començar
Hi ha dos importadors
Comprova quin has d'utilitzar per a cada tipus de dades.
Abans de començar: hi ha dos importadors
Nou importadorCapçaleres lliures · mapatge de columnes
S'utilitza per a Grups i Categories. S'hi accedeix des de Catàleg → Grups. Per importar grups, prem Importar. Per importar categories, entra primer al grup on les vulguis afegir i, des de dins, prem Importar. El sistema permet mapar les columnes, de manera que el CSV no ha d'utilitzar capçaleres amb noms exactes.
També es fa servir per a les categories de modificador, des de Catàleg → Modificadors.
Importador CSV anticCapçaleres estrictes
S'utilitza per a la resta d'importacions. S'hi accedeix des de revoxef.works/tools/import. En aquest importador, les capçaleres han de coincidir exactament amb les indicades a cada apartat. Tarifes utilitza la seva URL específica.
Si parteixes de la plantilla de l'importador, elimina les línies d'instruccions que hi ha abans de la capçalera: la primera fila ha de ser la capçalera, amb els camps separats per ;. Pots eliminar les columnes opcionals que no necessitis.
Catàleg
Crea i actualitza el teu catàleg
Importa grups, categories, productes, contenidors i formats de venda.
Catàleg
1Importar grups
Nou importador
Capçaleres lliures: en pujar el CSV, relaciona cada columna amb el seu camp a Mapar els camps.
Per crear o actualitzar grups de manera massiva, accedeix a Catàleg → Grups i prem Importar. S'obrirà el nou importador de grups.
El nou importador
Amb el nou importador no cal que les columnes del teu fitxer CSV tinguin noms específics. En pujar el fitxer, el sistema et permetrà Mapar els camps, relacionant cada columna del teu fitxer amb el camp corresponent de REVO.
Camps disponibles per mapar:
| Camp per mapar | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| Nombre | Obligatori | El nom principal del grup. | Text lliure. |
| Traduccions | Crític | Traduccions per al multiidioma. | Imprescindible: Mapar-lo amb la columna del nom. Si no, es crearà amb el nom genèric "New Item". |
| Id | Opcional | Identificador del grup al sistema. | Només s'omple per a actualitzacions. |
| Activo | Opcional | Defineix si el grup està actiu o no. | 0 (Inactiu), 1 (Actiu). |
| Impuesto | Opcional | L'impost associat al grup. | Introduir l'ID numèric intern de l'impost. |
| Grup analític | Opcional | El grup analític corresponent. | Introduir l'ID numèric. |
| Impresora | Opcional | La impressora de comandes assignada. | Introduir l'ID numèric. |
| Grup d'impressores | Opcional | El grup d'impressores assignat. | Introduir l'ID numèric. |
| Flux d'estats | Opcional | El flux d'estats de cuina (KDS). | Introduir l'ID numèric. |
| Extra ID | Opcional | Camp addicional per a identificadors d'integració. | Text alfanumèric lliure. |
Exemple CSV · Importar grups
| 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 categories
Nou importador
Capçaleres lliures: en pujar el CSV, relaciona cada columna amb el seu camp a Mapar els camps.
Per importar categories de manera massiva, accedeix a Catàleg → Grups, entra al grup on vulguis afegir les categories i, des de dins del grup, prem Importar. S'obrirà el nou importador de categories.
El nou importador
El funcionament és idèntic al dels grups: permet pujar qualsevol CSV i fer el mapatge de columnes manualment.
Camps disponibles per mapar:
| Camp per mapar | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| Grupo | Obligatori | El grup al qual pertany la categoria. | Introduir l'ID numèric o el nom exacte del grup pare. |
| Nombre | Obligatori | El nom de la categoria. | Text lliure. |
| Traduccions | Crític | Traduccions per al multiidioma. | Imprescindible: Mapar-lo amb la columna del nom. Si no, es crearà amb el nom genèric "New Item". |
| Id | Opcional | Identificador intern de la categoria. | Només s'omple per a actualitzacions. |
| Activo | Opcional | Defineix si la categoria està activa o no. | 0 (Inactiu), 1 (Actiu). |
| Impuesto | Opcional | L'impost associat a la categoria. | Introduir l'ID numèric. |
| Grup analític | Opcional | El grup analític corresponent. | Introduir l'ID numèric. |
| Impresora | Opcional | La impressora de comandes assignada. | Introduir l'ID numèric. |
| Grup d'impressores | Opcional | El grup d'impressores assignat. | Introduir l'ID numèric. |
| Flux d'estats | Opcional | El flux d'estats de cuina. | Introduir l'ID numèric. |
| Extra ID | Opcional | Camp addicional per a integracions externes. | Text alfanumèric lliure. |
Exemple CSV · Importar categories
| 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 categories de modificador
Nou importador
Capçaleres lliures: en pujar el CSV, relaciona cada columna amb el seu camp a Mapar els camps.
Per importar categories de modificador de manera massiva, accedeix a Catàleg → Modificadors i prem Importar. S'obrirà el nou importador de categories de modificador.
El nou importador
El funcionament és idèntic al dels grups: permet pujar qualsevol CSV i fer el mapatge de columnes manualment.
Camps disponibles per mapar:
| Camp per mapar | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| Nombre | Obligatori | El nom de la categoria de modificador. | Text d'almenys 3 caràcters. Exemple: Punt de cocció. |
| Min | Obligatori | Mínim de la configuració de mínim i màxim de modificadors. | Nombre enter igual o superior a 1 i no superior a Max. Exemple: 1. |
| Max | Obligatori | Màxim de la configuració de mínim i màxim de modificadors. | Nombre enter entre 1 i 1000, igual o superior a Min. Exemple: 1. |
| Id | Opcional | Identificador de la categoria de modificador. | ID numèric. |
| Activo | Opcional | Defineix si la categoria de modificador està activa o no. | 0 (Inactiu), 1 (Actiu). |
| Oculto | Opcional | Defineix si la categoria de modificador està oculta o no. | 0 (Visible), 1 (Ocult). |
| Traduccions | Opcional | Traduccions per al multiidioma. | |
| Selección | Opcional | Configuració anterior: si hi ha selecció. | 0 (Sense selecció), 1 (Amb selecció). Obsolet. |
| Últim camp, sense nom | Opcional | Configuració anterior: si la selecció és obligatòria o opcional. | 0 (Obligatori), 1 (Opcional). Obsolet. |
Exemple CSV · Importar Categories 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 |
A l'importador, els obligatoris porten asterisc (*). Selección i l'últim camp sense nom estan obsolets: els substitueixen Min i Max, que requereixen l'app 4.3 o superior.
4Importar productesPRODUCTS
Importador CSV anticCapçaleres estrictes
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ó per importar productes i configurar-los amb un fitxer CSV.
Amb Revo XEF, pots importar fitxers CSV separats per ";". La primera fila ha de tenir la capçalera amb els noms dels camps exactament com es descriuen a continuació.
ImportantEl nom dels camps de la capçalera ha de ser exactament igual al que hi ha escrit aquí. Sense majúscules al principi, sense espais, sense el símbol ":".
Correcte:
Incorrecte:
Correcte:
category_idIncorrecte:
Category_id / CATEGORY_ID / category id| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| category_id | Obligatori | ID de la categoria. Abans d'importar, crea manualment l'estructura per obtenir aquest ID. | Introduir un ID numèric. |
| name | Obligatori | Nom del producte. | Text lliure (mínim 3 caràcters). |
| super_group_id | Opcional | ID del grup analític assignat al producte. | Introduir un ID numèric. |
| price | Opcional | Preu de venda al públic. | Utilitzar punt per als decimals. Exemple: 10.20 |
| costPrice | Opcional | Preu de cost intern. | Utilitzar punt per als decimals. Exemple: 8.20 |
| type | Opcional | Defineix la naturalesa operativa del producte. | 0: Producte, 1: Menú, 2: Contenidor, 3: Entrada, 4: Format, 5: Targeta regal, 6: Només gestió, 7: Kit. |
| active | Opcional | Estat de visibilitat al TPV. | 0 (Inactiu), 1 (Actiu). Si s'omet, s'activen tots. |
| hasInventory | Opcional | Control d'unitats i estoc. | 0 (Sense control), 1 (Amb control). |
| displayInventory | Opcional | Mostra les unitats restants a l'app. | 0 (No ho mostra), 1 (Mostra l'estoc). |
| usesWeight | Opcional | Enllaça amb la balança. | 0 (No utilitza pes), 1 (Utilitza pes). |
| allergies | Opcional | Al·lèrgies associades al producte. | Introduir els IDs numèrics separats per punt i coma (p. ex.: 1;5;14). |
IDS D'AL·LÈRGENS0Sense al·lèrgens (null)1Ous2Sèsam3Tramussos4Mostassa5Peix6Api7Crustacis8Cacauets9Mol·luscs10Soja11Fruits de closca12Sulfits13Lactis14Gluten | |||
| isMenu | Opcional | Defineix si actua com a agrupador de menú. | 0 (No és menú), 1 (Producte de tipus menú). |
| shouldAppearInMenuList | Opcional | Si es pot seleccionar dins d'altres menús. | 0 (No activada), 1 (Activada). |
| isOpen | Opcional | Obliga a introduir un preu manualment en vendre. | 0 (Preu tancat), 1 (Producte obert). |
| order | Opcional | Ordre de visualització dins de la categoria. | Utilitzar números: 1, 2, 3, etc. |
| barcode | Opcional | Codi de barres del producte. | Valor numèric o EAN. |
| tax_id | Opcional | Impost per defecte del producte. | ID numèric. |
| printer_id | Opcional | Impressora directa per defecte del producte. | ID numèric. |
| printer_group_id | Opcional | Grup d'impressores directe per defecte. | ID numèric. |
| modifier_group_id | Opcional | Grup de modificadors específics del producte. | ID numèric. |
| modifier_category_id | Opcional | Categoria de modificador assignada al producte. | ID numèric. |
| photo | Opcional | Imatge del producte. | Nom del fitxer i extensió. |
| info | Opcional | Descripció ampliada del producte. | Text lliure. |
| buttonName | Opcional | Nom alternatiu reduït. | Per mostrar-lo a la botonera de l'app. |
| nameKitchen | Opcional | Nom diferent per als tiquets de preparació. | Text lliure. |
| dish_order_id | Opcional | Ordre de sortida dels plats. | ID numèric. |
| unit_id | Opcional | ID de la unitat de venda. | ID numèric. |
| extra_id | Opcional | Codi extern o Nielsen, si escau. | Text alfanumèric. |
| useAverageCostPrice | Opcional | Càlcul del cost mitjà. | 0 (No actiu), 1 (Activat). |
| cookDuration | Opcional | Temps d'elaboració estimat. | Valor en segons (per al KDS). |
| minQuantity | Opcional | Quantitat mínima en afegir el producte. | Valor numèric. |
| extra_attributes | Opcional | Atributs especials. | ID numèric. |
ImportantCal destacar que configurar la impressora o els modificadors directament als productes pot causar problemes en el futur. Si està configurat per producte, l'hauràs de canviar o treure un per un. Si la configuració és a la categoria o al grup, es pot modificar amb pocs clics.
Exemple CSV · Importar productes
| 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 |
5Actualitzar productesPRODUCTS UPDATE
Importador CSV anticCapçaleres estrictes
Mateixa capçalera que la plantilla de Importar productes, amb id com a primera columna.
Opció per actualitzar o afegir informació a productes existents amb un fitxer CSV.
Com que l'ID és obligatori, es recomana partir de la llista de productes de REVO exportada prèviament.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| id | Obligatori | Identificador únic del producte a la base de dades. | ID numèric intern de REVO. |
| super_group_id | Opcional | ID del grup analític assignat al producte. | Introduir un ID numèric. |
Exemple CSV · Actualitzar productes
| 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 |
6ContenidorsCONTAINERS
Importador CSV anticCapçaleres estrictes
category_id;name;photoEls contenidors són carpetes on pots agrupar productes. Són un "quart nivell" després de Grups, Categories i Productes.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| category_id | Obligatori | ID de la categoria on hi haurà la carpeta. | ID numèric. |
| name | Obligatori | Nom visual del contenidor/carpeta. | Text lliure. |
| photo | Opcional | Nom de fitxer de la foto de portada. | Nom de fitxer i imatge. |
Exemple CSV · Contenidors
| category_id | 10 | 15 | 17 |
| name | CAFÉS | AGUAS | VINOS TINTOS |
| photo | carpeta_cafes.jpg | carpeta_aguas.jpg | carpeta_vinos.jpg |
7Productes de contenidorCONTAINER ITEMS
Importador CSV anticCapçaleres estrictes
order;active;item_id;main_item_id;dish_order_idAssocia productes a un contenidor existent.
Pots obtenir els IDs posant el cursor sobre la icona del llapis al back-office.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| main_item_id | Obligatori | ID del contenidor mare (carpeta). | ID numèric. |
| item_id | Obligatori | ID dels productes que hi vols posar. | ID numèric. |
| order | Opcional | Ordre de visualització dins del contenidor. | Valor numèric. |
| dish_order_id | Opcional | Ordre de plat per defecte aplicat en aquesta carpeta. | ID numèric. |
| active | Opcional | Estat del producte dins de la vista de carpeta. | 0 (Inactiu), 1 (Actiu). |
Exemple CSV · Productes de contenidor
| 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 |
8Formats de vendaITEM SELLING FORMATS
Importador CSV anticCapçaleres estrictes
active;quantity;price;order;format_id;item_id;combination_group_id;unit_idImporta productes amb formats de venda (combinat, sol, xopet, etc.).
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| item_id | Obligatori | ID del producte base. | ID numèric. |
| format_id | Obligatori | ID del format de venda configurat. | ID numèric. |
| price | Obligatori | Preu de venda per a aquest format. | Utilitzar punt per als decimals. |
| quantity | Obligatori | Quantitat exacta que es descomptarà de l'estoc general. | Utilitzar decimals segons la unitat. |
| unit_id | Obligatori | ID de la unitat de mesura d'estoc. | ID numèric. |
| order | Obligatori | Ordre de visualització al desplegable. | Valor numèric. |
| combination_group_id | Obligatori | ID del grup de combinats forçat (si escau). | Posar 0 si no escau. |
Exemple CSV · Formats de venda
| 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 |
Inventari
Ajusta l'estoc dels teus magatzems
Afegeix estoc, fixa l'estoc exacte després d'un recompte o mou-lo entre magatzems.
Inventari
9Afegir inventariINVENTORY ADD
Importador CSV anticCapçaleres estrictes
item_id;quantity;warehouse_idAfegeix estoc als teus productes, especialment útil la primera vegada.
Si tens diversos magatzems, repeteix l'ID del producte amb diferents warehouse_id.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| item_id | Obligatori | ID dels productes que cal aprovisionar. | ID numèric. |
| quantity | Obligatori | Quantitat que vols SUMAR a l'estoc. | Valor numèric positiu. |
| warehouse_id | Obligatori | ID del magatzem on entra l'estoc. | ID numèric. |
Exemple CSV · Afegir inventari
| A | B | C | |
|---|---|---|---|
| 1 | item_id | quantity | warehouse_id |
| 2 | 100 | 150 | 1 |
| 3 | 102 | 150 | 1 |
| 4 | 100 | 500 | 2 |
10Establir/fer inventariINVENTORY SET
Importador CSV anticCapçaleres estrictes
item_id;quantity;warehouse_id;defaultQuantity;alertEstableix l'estoc exacte dels teus productes. Ideal després d'un recompte d'inventari.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| item_id | Obligatori | ID dels productes. | ID numèric. |
| quantity | Obligatori | Quantitat física exacta que s'establirà. | Valor numèric que sobreescriurà l'anterior. |
| warehouse_id | Obligatori | ID del magatzem. | ID numèric. |
| defaultQuantity | Opcional | Quantitat d'estoc de referència / ideal. | Valor numèric. |
| alert | Opcional | Estoc mínim per rebre una alerta de comanda. | Valor numèric. |
Exemple CSV · Establir inventari
| item_id | 100 | 110 |
| quantity | 100 | 232 |
| warehouse_id | 1 | 1 |
| defaultQuantity | 200 | 400 |
| alert | 10 | 20 |
11Moure inventariINVENTORY MOVE
Importador CSV anticCapçaleres estrictes
item_id;quantity;warehouse_id;to_warehouse_idTrasllada estoc entre magatzems.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| item_id | Obligatori | ID dels productes que cal traslladar. | ID numèric. |
| quantity | Obligatori | Quantitat exacta que es mourà. | Valor numèric. |
| warehouse_id | Obligatori | ID del magatzem d'origen. | Magatzem que resta (ID numèric). |
| to_warehouse_id | Obligatori | ID del magatzem de destinació. | Magatzem que suma (ID numèric). |
Exemple CSV · Moure inventari
| item_id | 100 | 102 |
| quantity | 100 | 100 |
| warehouse_id | 1 | 1 |
| to_warehouse_id | 2 | 2 |
Proveïdors
Prepara el mòdul de compres
Importa proveïdors i relaciona'ls amb els teus productes.
Proveïdors
12Importar proveïdorsVENDORS
Importador CSV anticCapçaleres estrictes
Importa proveïdors de manera massiva per utilitzar el mòdul de compres.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| name | Obligatori | Nom del proveïdor. | Text lliure (mínim 3 caràcters). |
| address | Obligatori | Adreça principal de facturació/lliurament. | Text lliure. |
| nif | Obligatori | NIF o identificador fiscal. | CIF, DNI, etc. |
| city | Opcional | Ciutat o localitat. | Text lliure. |
| state | Opcional | Província o estat. | Text lliure. |
| country | Opcional | País de la seu del proveïdor. | Text lliure. |
| postalCode | Opcional | Codi postal. | Alfanumèric. |
| web | Opcional | Pàgina web corporativa. | Format URL. |
| Opcional | Correu electrònic per a comandes. | Correu electrònic vàlid. | |
| phone | Opcional | Telèfon de contacte. | Numèric. |
| notes | Opcional | Notes i observacions internes. | Text lliure. |
| shouldBeNotified | Opcional | Notificar el proveïdor quan hi hagi canvis d'estat. | 1 (Notificar), 0 (No notificar). |
Exemple CSV · Importar proveïdors
| 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 |
13Productes de proveïdorsVENDORS ITEMS
Importador CSV anticCapçaleres estrictes
Associa productes als teus proveïdors per utilitzar el mòdul de compres.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| vendor_id | Obligatori | ID del proveïdor creat al sistema. | ID numèric. |
| item_id | Obligatori | ID del producte de REVO que proveeix. | ID numèric. |
| reference | Opcional | Codi de referència del producte al catàleg del proveïdor. | Alfanumèric. |
| pack | Opcional | Unitats que conté cada pack/caixa de compra. | Valor numèric. |
| costPrice | Opcional | Preu de cost pactat. | Utilitzar punt per als decimals. |
| unit_id | Opcional | ID de la unitat de mesura de compra. | ID numèric. |
| tax_id | Opcional | ID de l'impost suportat en la compra. | ID numèric. |
Exemple CSV · Productes de proveïdors
| 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 |
Clients i targetes regal
Carrega clients i targetes regal
Importa clients i targetes regal, o recarrega saldo a targetes existents.
Clients i targetes regal
14Importar clientsCUSTOMERS
Importador CSV anticCapçaleres estrictes
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 clients de manera massiva.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| name | Obligatori | Nom del client o raó social. | Text lliure (mínim 3 caràcters). |
| address_country | Condicional | País. | Obligatori si s'introdueix el NIF o qualsevol altre camp d'adreça. Codi ISO 3166-1 alfa-2 (exemple: ES). |
| address_street_address | Condicional | Adreça del carrer. | Obligatori si s'introdueix el NIF o un altre camp d'adreça. |
| address_postal_code | Condicional | Codi postal. | Obligatori si s'introdueix el NIF o un altre camp d'adreça. |
| address_city | Condicional | Ciutat o localitat. | Obligatori si s'introdueix el NIF o un altre camp d'adreça. |
| address_state | Condicional | Província o estat. | Obligatori si s'introdueix el NIF o un altre camp d'adreça. |
| nif | Opcional | NIF o identificador fiscal. | Si s'introdueix, l'adreça passa a ser obligatòria. |
| active | Opcional | Estat del client. | 0 (Inactiu), 1 (Actiu). |
| Opcional | Correu electrònic. | Format de correu electrònic vàlid. | |
| phone | Opcional | Telèfon de contacte. | Ha d'incloure el prefix internacional per ser vàlid (p. ex.: +34644847774 OK, 644847774 NO OK). |
| language | Opcional | Idioma preferit per a les comunicacions. | Codi ISO (es, en, fr...). |
| nationality | Opcional | Nacionalitat. | Text lliure. |
| birth_date | Opcional | Data de naixement del client. | Format estricte: AAAA-MM-DD. |
| gender | Opcional | Gènere. | Male, Female o Other. |
| allergies | Opcional | Al·lèrgies que té el client. | IDs separats per punt i coma (p. ex.: 1;5;14). |
| web | Opcional | Pàgina web de l'empresa. | URL. |
| notes | Opcional | Notes o preferències del client. | Text lliure. |
| extra_id | Opcional | Assignació a un grup de clients. | ID numèric. |
| address_notes | Opcional | Notes de lliurament a domicili. | Text lliure. |
Exemple CSV · Importar clients
| 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 |
15Targetes regalGIFT CARDS
Importador CSV anticCapçaleres estrictes
campaign_id;customer_id;active;uuid;total;balance;extra_attributesImporta targetes regal de manera massiva al back-office.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| uuid | Obligatori | Codi identificatiu únic de la targeta. | Pot contenir text i números. |
| total | Obligatori | Saldo inicial generat. | Ha de ser numèric. |
| active | Opcional | Defineix si la targeta ja està operativa. | 0 (Inactiva), 1 (Activa). |
| balance | Opcional | Saldo restant real. | Omplir-lo només si és diferent del total. |
| campaign_id | Opcional | Campanya promocional associada. | ID numèric de la campanya. |
| customer_id | Opcional | Client associat de manera nominal. | ID numèric del client. |
Exemple CSV · Targetes regal
| 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 |
16Recarregar targetes regalGIFT CARDS RELOAD
Importador CSV anticCapçaleres estrictes
uuid;reloadAmountImporta recàrregues a les targetes regal.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| uuid | Obligatori | Codi exacte de la targeta regal existent. | Alfanumèric. |
| reloadAmount | Obligatori | Saldo que s'afegirà al saldo actual. | Numèric amb punt decimal. |
Exemple CSV · Recarregar targetes
| A | B | |
|---|---|---|
| 1 | uuid | reloadAmount |
| 2 | 00000123456 | 100.00 |
| 3 | 00000789100 | 100.00 |
Tarifes i empleats
Importa tarifes i empleats
Assigna preus per tarifa i crea o actualitza empleats.
Tarifes i empleats
17TarifesPRICE RATES
Importador CSV anticCapçaleres estrictes
Per importar tarifes, accedeix a: https://revoxef.works/thrust/prices/import
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| ID | Obligatori | Identificador del producte base. | ID numèric. |
| priceable_id | Obligatori | Identificador del preu dins del producte al qual es fa referència. | ID numèric. |
| table_price_id | Obligatori | Identificador de la tarifa a la qual s'aplica el preu. | ID numèric. |
| price | Obligatori | Import que vols establir per a la tarifa indicada. | Preu amb punt per als decimals. |
| priceable_type | Obligatori | Tipus d'element base. | Utilitzar exactament el valor de la taula inferior. |
Valors per a priceable_type:
| Tipus | Valor que cal escriure a la columna |
|---|---|
| Productes | App\Models\Menu\MenuItem |
| Productes de menú | App\Models\Menu\MenuMenuPivot |
| Modificadors | App\Models\Menu\Modifier |
| Format de venda | App\Models\Menu\ItemSellingFormatPivot |
| Combinats | App\Models\Menu\Combination |
Exemple CSV · Tarifes
| 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 |
18EmpleatsEMPLOYEES
Importador CSV anticCapçaleres estrictes
name;active;surname;pin;username;email;nif;phone;notes;password;photo;identifier;permission_id;cashier_id;back_permission_id;extra_id;config;profile_idImporta empleats de manera massiva.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| name | Obligatori | Nom de l'empleat. | Text lliure. |
| pin | Obligatori | PIN d'accés per al TPV iPad. | Valor numèric. |
| permission_id | Obligatori | Privilegi de seguretat de l'app. | ID numèric. |
| active | Opcional | Estat de l'empleat a la plantilla. | 0 (Inactiu), 1 (Actiu). |
| surname | Opcional | Cognom. | Text lliure. |
| username | Opcional | Usuari d'accés al back-office web. | Text curt sense espais. |
| password | Opcional | Contrasenya secreta per al back-office. | Alfanumèric. |
| Opcional | Correu electrònic. | Correu electrònic vàlid. | |
| phone | Opcional | Telèfon de contacte. | Numèric. |
| notes | Opcional | Notes internes. | Text lliure. |
| profile_id | Opcional | Perfil d'empleat predeterminat. | ID numèric. |
| photo | Opcional | Avatar visual. | Nom del fitxer i extensió. |
| cashier_id | Opcional | Caixer per defecte assignat. | ID numèric. |
| identifier | Opcional | Identificador de clau de seguretat del TPV. | Valor hexadecimal (NFC, QR...). |
| back_permission_id | Opcional | Nivell de privilegis del back-office. | ID numèric. |
| nif | Opcional | DNI de l'empleat. | Alfanumèric. |
Exemple CSV · Empleats
| 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 |
19Actualitzar empleatsUPDATE EMPLOYEES
Importador CSV anticCapçaleres estrictes
Actualitza la informació d'empleats existents. Parteix de la llista d'empleats exportada en CSV.
| Capçalera exacta | Requisit | Descripció | Informació addicional |
|---|---|---|---|
| id | Obligatori | Identificador únic intern de l'empleat. | ID numèric generat per REVO. |
Exemple CSV · Actualitzar empleats
| 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 |
