Revo Support

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 importador

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.

Camp	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.

Nombre	Traduccion	ID	Activo	Impuesto	Grupo_Analitico	Impresora	Grp_Impresoras	Flujo_Estados	Extra_ID
Bebidas	Bebidas		1	1	3	2	0	1	EXT-001
Comida	Comida		1	2	4	4	2	1	EXT-002
Postres	Postres	15	1	2	5	4	0	2	EXT-003

Camp	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.

Nombre	Grupo	Traduccion	ID	Activo	Impuesto	Grupo_Analitico	Impresora	Grp_Impresoras	Flujo_Estados	Extra_ID
Refrescos	Bebidas	Refrescos		1	1	6	2	0	1	EXT-010
Cervezas	Bebidas	Cervezas		1	1	6	3	0	1	EXT-011
Tapas	Comida	Tapas	32	1	2	7	5	2	2	EXT-012

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ÈRGENS: 1: Ous 2: Sèsam 3: Tramussos 4: Mostassa 5: Peix 6: Api 7: Crustacis 8: Cacauets 9: Mol·luscs 10: Soja 11: Fruits de closca 12: Sulfits 13: Lactis 14: Gluten
`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.

category_id	super_group_id	name	price	costPrice	type	active	hasInventory	allergies	isMenu	shouldAppearInMenuList	order	barcode	tax_id	printer_id	printer_group_id	modifier_group_id	modifier_category_id	photo	info	buttonName	nameKitchen	unit_id	extra_id	useAverageCostPrice	cookDuration	minQuantity
10	3	Café Solo	1.30	0.20	0	1	1		0	0	1	84123456	1	2	1	4	5	cafe.jpg	Arábica	Café S	CAFE SOLO	2	EX-001	0	120	1
15		Coca Cola	1.80	0.50	0	1	1		0	0	2	84123457	1					cola.jpg	Refresco	Coca C	COCA COLA	2	EX-002	1	0	1
25		Menú Diario	12.50	4.00	1	1	0	1;5;14	1	1	3		2					menu.jpg	Completo	Menu Dia	MENU DIARIO	1	EX-003	0	0	1

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.

id	category_id	super_group_id	name	price	costPrice	type	active	hasInventory	displayInventory	usesWeight	allergies	isMenu	shouldAppearInMenuList	isOpen	order	barcode	tax_id	printer_id	printer_group_id	modifier_group_id	modifier_category_id	photo	info	buttonName	nameKitchen	dish_order_id	unit_id	extra_id	useAverageCostPrice	cookDuration	minQuantity	extra_attributes
100	10	3	Café Solo Intenso	1.40	0.22	0	1	1	0	0	14	0	0	0	1	84123456	1	2	1	4	5	cafe_new.jpg	Nuevo	Intenso	CAFE INTENSO	0	2	EX-001	0	120	1	0
101	15		Coca Cola Zero	1.90	0.55	0	1	1	0	0		0	0	0	2	84123457	1					colaz.jpg	Zero	Coca Z	COCA ZERO	0	2	EX-002	1	0	1	0

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.

category_id	name	photo
10	CAFÉS	carpeta_cafes.jpg
15	AGUAS	carpeta_aguas.jpg
17	VINOS TINTOS	carpeta_vinos.jpg

main_item_id	item_id	order	active
15	140	1	1
15	141	2	1
15	142	3	1

item_id	format_id	price	quantity	unit_id	order	combination_group_id
196	3	12.00	1.00	7	1	2
196	4	11.00	1.00	7	2	0
196	5	3.00	0.20	7	3	0

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

item_id	quantity	warehouse_id	defaultQuantity	alert
100	100	1	200	10
110	232	1	400	20

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).

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.

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.

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.

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).

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.
`email`	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).

name	address	nif	city	state	country	postalCode	web	email	phone	notes	shouldBeNotified
Proveedor 1	Gran Via, 30	A58818501	Madrid	Madrid	España	28010	www.prov1.es	pedidos@prov1.es	+34 912345678	Alimentación	1
Proveedor 2	Via Laietana, 222	B54416504	Barcelona	Barcelona	España	08010	www.prov2.com	info@prov2.es	+34 931234567	Refrescos	0

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.

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.
`address_postal_code`	Condicional	Codi postal.	Obligatori si s'introdueix el NIF.
`address_city`	Condicional	Ciutat o localitat.	Obligatori si s'introdueix el NIF.
`address_state`	Condicional	Província o estat.	Obligatori si s'introdueix el NIF.
`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).
`email`	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.

name	address_country	address_street_address	address_postal_code	address_city	address_state	nif	active	email	phone	language	nationality	birth_date	gender	allergies	web	notes	extra_id	address_notes
Hugo Reyes	ES	Gran Via, 30	28010	Madrid	Madrid	A58818501	1	hugo@mail.com	+34600123456	es	Española	1980-05-15	Male	14	www.hugo.es	Plato especial	1	Dejar en recepcion
Maggie Greene	ES	Calle de La Paz, 11	46003	Valencia	Valencia	V51218667	1	maggie@mail.com	+34600654321	en	Británica	1992-10-22	Female			Mesa con vistas	2	Llamar al timbre

Importar XEF

Abans de començar: hi ha dos importadors

Catàleg

El nou importador

El nou importador

Inventari

Proveïdors

Clients i targetes regal

Tarifes i empleats

Contacte

Suport

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.

uuid	total	active	balance	campaign_id	customer_id
00000123456	100.00	1	100.00	1
TR1234567	50.00	1	25.00	1
Pedro Gonzalez	75.00	1	75.00	2	405

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.

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.

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`

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

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.
`email`	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.

name	pin	permission_id	active	surname	username	password	email	phone	notes	profile_id	photo	cashier_id	identifier	back_permission_id	nif
Fran	1111	1	1	Marjolaine	Fran	pass123	fran@mail.com	600111222	Encargado	2	fran.jpg	0	1A2B3C	2	12345678A
Lucía	2222	2	1	Kailey	Lucia	pass456	lucia@mail.com	600333444	Camarera	1	lucia.jpg	0	4D5E6F	1	87654321B

id	name	pin	permission_id	active	surname	username	password	email	phone	notes	profile_id	photo	cashier_id	identifier	back_permission_id	nif
2	Maria	1122	1	1	Garcia	maria	marIa24!	maria@mail.com	600999888		2	maria.jpg	0	7G8H9I	1	11111111C
3	Pedro	3344	2	0	Lopez	pedro	pEdro24!	pedro@mail.com	600777666	Baja	1	pedro.jpg	0	0J1K2L	3	22222222D