Amb Revo XEF, pots importar fitxers CSV separats per ";". La primera fila ha de contenir la capçalera amb els noms dels camps exactament com es descriuen a continuació.
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 al qual les vulguis afegir i, des de dins, prem Importar. El sistema permet mapar les columnes, de manera que el CSV no necessita utilitzar capçaleres amb noms exactes.
IMPORTADOR CSV
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.
CATÀLEG
1. IMPORTAR GRUPS
NOU IMPORTADOR
Per crear o actualitzar grups de forma 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 fitxer CSV tinguin noms específics. En pujar el fitxer, el sistema et permetrà Mapar els camps, relacionant cada columna del fitxer amb el camp corresponent de REVO.
Camps disponibles per mapar:
| CAMP | REQUISIT | DESCRIPCIÓ | INFORMACIÓ ADDICIONAL |
|---|---|---|---|
| Nom | Obligatori | El nom principal del grup. | Text lliure. |
| Traduccions | Crític | Traduccions per al multiidioma. | Imprescindible: Mapa’l 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. |
| Actiu | Opcional | Defineix si el grup està actiu o no. | 0 (Inactiu), 1 (Actiu). |
| Impost | Opcional | L’impost associat al grup. | Introdueix l’ID numèric intern de l’impost. |
| Grup analític | Opcional | El grup analític corresponent. | Introdueix l’ID numèric. |
| Impressora | Opcional | La impressora de comandes assignada. | Introdueix l’ID numèric. |
| Grup d’impressores | Opcional | El grup d’impressores assignat. | Introdueix l’ID numèric. |
| Flux d’estats | Opcional | El flux d’estats de cuina (KDS). | Introdueix l’ID numèric. |
| ID extra | Opcional | Camp addicional per a identificadors d’integració. | Text alfanumèric lliure. |
Exemple CSV - Importar grups
| 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 |
2. IMPORTAR CATEGORIES
NOU IMPORTADOR
Per importar categories de forma massiva, accedeix a Catàleg → Grups, entra al grup al qual 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: pots pujar qualsevol CSV i mapar les columnes manualment.
Camps disponibles per mapar:
| CAMP | REQUISIT | DESCRIPCIÓ | INFORMACIÓ ADDICIONAL |
|---|---|---|---|
| Grup | Obligatori | El grup al qual pertany la categoria. | Introdueix l’ID numèric o el nom exacte del grup pare. |
| Nom | Obligatori | El nom de la categoria. | Text lliure. |
| Traduccions | Crític | Traduccions per al multiidioma. | Imprescindible: Mapa’l 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. |
| Actiu | Opcional | Defineix si la categoria està activa o no. | 0 (Inactiu), 1 (Actiu). |
| Impost | Opcional | L’impost associat a la categoria. | Introdueix l’ID numèric. |
| Grup analític | Opcional | El grup analític corresponent. | Introdueix l’ID numèric. |
| Impressora | Opcional | La impressora de comandes assignada. | Introdueix l’ID numèric. |
| Grup d’impressores | Opcional | El grup d’impressores assignat. | Introdueix l’ID numèric. |
| Flux d’estats | Opcional | El flux d’estats de cuina. | Introdueix l’ID numèric. |
| ID extra | Opcional | Camp addicional per a integracions externes. | Text alfanumèric lliure. |
Exemple CSV - Importar categories
| 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 |
3. IMPORTAR PRODUCTES (PRODUCTS)
IMPORTADOR CSV
Opció per importar productes i configurar-los mitjançant un fitxer CSV.
Amb Revo XEF, pots importar fitxers CSV separats per ";". La primera fila ha de contenir la capçalera amb els noms dels camps exactament com es descriuen a continuació.
IMPORTANT: Els noms dels camps de la capçalera han de ser exactament iguals als que s’indiquen aquí. Sense majúscules inicials, sense espais i 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. | Introdueix 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. | Introdueix un ID numèric. |
| price | Opcional | Preu de venda al públic. | Utilitza un punt per als decimals.Exemple: 10.20 |
| costPrice | Opcional | Preu de cost intern. | Utilitza un 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 mostra), 1 (Mostra estoc). |
| usesWeight | Opcional | Enllaça amb una balança. | 0 (No utilitza pes), 1 (Utilitza pes). |
| allergies | Opcional | Al·lèrgens associats al producte. | Introdueix els ID numèrics separats per punt i coma (Ex.: 1;5;14). ID 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 menú), 1 (Producte tipus menú). |
| shouldAppearInMenuList | Opcional | Si es pot seleccionar dins d’altres menús. | 0 (Desactivada), 1 (Activada). |
| isOpen | Opcional | Exigeix introduir un preu manualment en vendre. | 0 (Preu tancat), 1 (Producte obert). |
| order | Opcional | Ordre de visualització dins de la categoria. | Utilitza números: 1, 2, 3, etc. |
| barcode | Opcional | Codi de barres del producte. | Valor numèric o EAN. |
| tax_id | Opcional | Impost predeterminat del producte. | ID numèric. |
| printer_id | Opcional | Impressora directa predeterminada del producte. | ID numèric. |
| printer_group_id | Opcional | Grup d’impressores directe predeterminat. | 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 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 de cost mitjà. | 0 (No actiu), 1 (Activat). |
| cookDuration | Opcional | Temps d’elaboració estimat. | Valor en segons (per a KDS). |
| minQuantity | Opcional | Quantitat mínima en afegir el producte. | Valor numèric. |
| extra_attributes | Opcional | Atributs especials. | ID numèric. |
IMPORTANT: Cal destacar que configurar la impressora o els modificadors directament als productes pot causar problemes en el futur. Si està configurat per producte, hauràs de canviar-ho o eliminar-ho 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 | 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 10 | 3 | Café Solo | 1.30 | 0.20 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 1 | 84123456 | 1 | 2 | 1 | 4 | 5 | cafe.jpg | Arábica | Café S | CAFE SOLO | 0 | 2 | EX-001 | 0 | 120 | 1 | 0 | |
| 15 | Coca Cola | 1.80 | 0.50 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 2 | 84123457 | 1 | cola.jpg | Refresco | Coca C | COCA COLA | 0 | 2 | EX-002 | 1 | 0 | 1 | 0 | ||||||
| 25 | Menú Diario | 12.50 | 4.00 | 1 | 1 | 0 | 0 | 0 | 1;5;14 | 1 | 1 | 0 | 3 | 2 | menu.jpg | Completo | Menu Dia | MENU DIARIO | 0 | 1 | EX-003 | 0 | 0 | 1 | 0 |
4. ACTUALITZAR PRODUCTES (PRODUCTS UPDATE)
IMPORTADOR CSV
Opció per actualitzar o afegir informació a productes existents mitjançant 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. | Introdueix un ID numèric. |
Exemple CSV - Actualitzar productes
| 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 |
5. CONTENIDORS (CONTAINERS)
IMPORTADOR CSV
Els 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 estarà la carpeta. | ID numèric. |
| name | Obligatori | Nom visible del contenidor/carpeta. | Text lliure. |
| photo | Opcional | Nom del fitxer de la imatge de portada. | Nom del fitxer i imatge. |
Exemple CSV - Contenidors
| category_id | name | photo |
|---|---|---|
| 10 | CAFÉS | carpeta_cafes.jpg |
| 15 | AGUAS | carpeta_aguas.jpg |
| 17 | VINOS TINTOS | carpeta_vinos.jpg |
6. PRODUCTES DE CONTENIDOR (CONTAINER ITEMS)
IMPORTADOR CSV
Associa productes a un contenidor existent.
Pots obtenir els ID situant el cursor sobre la icona del llapis al back-office.
| CAPÇALERA EXACTA | REQUISIT | DESCRIPCIÓ | INFORMACIÓ ADDICIONAL |
|---|---|---|---|
| main_item_id | Obligatori | ID del contenidor pare (carpeta). | ID numèric. |
| item_id | Obligatori | ID dels productes que hi vols afegir. | ID numèric. |
| order | Opcional | Ordre de visualització dins del contenidor. | Valor numèric. |
| dish_order_id | Opcional | Ordre de plat predeterminat 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 | item_id | order | dish_order_id | active |
|---|---|---|---|---|
| 15 | 140 | 1 | 0 | 1 |
| 15 | 141 | 2 | 0 | 1 |
| 15 | 142 | 3 | 0 | 1 |
7. FORMATS DE VENDA (ITEM SELLING FORMATS)
IMPORTADOR CSV
Importa productes amb formats de venda (combinat, sol, xarrup, 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. | Utilitza un punt per als decimals. |
| quantity | Obligatori | Quantitat exacta a descomptar de l’estoc general. | Utilitza 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). | Posa 0 si no s’aplica. |
Exemple CSV - Formats de venda
| 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 |
INVENTARI
8. AFEGIR INVENTARI (INVENTORY ADD)
IMPORTADOR CSV
Afegeix 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 a 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
| item_id | quantity | warehouse_id |
|---|---|---|
| 100 | 150 | 1 |
| 102 | 150 | 1 |
| 100 | 500 | 2 |
9. ESTABLIR/FER INVENTARI (INVENTORY SET)
IMPORTADOR CSV
Estableix 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 cal 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 | quantity | warehouse_id | defaultQuantity | alert |
|---|---|---|---|---|
| 100 | 100 | 1 | 200 | 10 |
| 110 | 232 | 1 | 400 | 20 |
10. MOURE INVENTARI (INVENTORY MOVE)
IMPORTADOR CSV
Trasllada 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 cal moure. | Valor numèric. |
| warehouse_id | Obligatori | ID del magatzem d’origen. | Magatzem del qual es resta l’estoc (ID numèric). |
| to_warehouse_id | Obligatori | ID del magatzem de destinació. | Magatzem al qual se suma l’estoc (ID numèric). |
Exemple CSV - Moure inventari
| item_id | quantity | warehouse_id | to_warehouse_id |
|---|---|---|---|
| 100 | 100 | 1 | 2 |
| 102 | 100 | 1 | 2 |
PROVEÏDORS
11. IMPORTAR PROVEÏDORS (VENDORS)
IMPORTADOR CSV
Importa proveïdors de forma 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 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 | Notifica el proveïdor davant de canvis d’estat. | 1 (Notificar), 0 (No notificar). |
Exemple CSV - Importar proveïdors
| name | address | nif | city | state | country | postalCode | web | 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 |
12. PRODUCTES DE PROVEÏDORS (VENDORS ITEMS)
IMPORTADOR CSV
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 subministra. | 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 acordat. | Utilitza un 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 compra. | ID numèric. |
Exemple CSV - Productes de proveïdors
| vendor_id | item_id | reference | pack | costPrice | unit_id | tax_id |
|---|---|---|---|---|---|---|
| 1 | 100 | REF-01 | 24 | 0.25 | 1 | 2 |
| 1 | 102 | REF-02 | 24 | 0.30 | 1 | 2 |
CLIENTS I TARGETES REGAL
13. IMPORTAR CLIENTS (CUSTOMERS)
IMPORTADOR CSV
Importa clients de forma 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. |
| 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). |
| 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 (Ex.: +34644847774 OK, 644847774 NO OK). |
| language | Opcional | Idioma preferit per a 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 del client. | ID separats per punt i coma (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 | address_country | address_street_address | address_postal_code | address_city | address_state | nif | active | 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 |
14. TARGETES REGAL (GIFT CARDS)
IMPORTADOR CSV
Importa targetes regal de forma 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. | Omple’l només si és diferent del total. |
| campaign_id | Opcional | Campanya promocional associada. | ID numèric de la campanya. |
| customer_id | Opcional | Client associat nominalment. | ID numèric del client. |
Exemple CSV - Targetes regal
| 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 |
15. RECARREGAR TARGETES REGAL (GIFT CARDS RELOAD)
IMPORTADOR CSV
Importa 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 cal afegir al balanç actual. | Numèric, utilitzant punt decimal. |
Exemple CSV - Recarregar targetes
| uuid | reloadAmount |
|---|---|
| 00000123456 | 100.00 |
| 00000789100 | 100.00 |
TARIFES I EMPLEATS
16. TARIFES (PRICE RATES)
IMPORTADOR CSV
Per importar tarifes, accedeix a: https://revoxef.works/thrust/prices/import
| CAPÇALERA EXACTA | REQUISIT | DESCRIPCIÓ | INFORMACIÓ ADDICIONAL |
|---|---|---|---|
| priceable_id | Obligatori | ID de l’element base al qual s’associa la tarifa. | ID numèric. |
| table_price_id | Obligatori | ID de la tarifa creada a Configuració. | ID numèric. |
| price | Obligatori | Preu establert per a la combinació de tots dos. | Preu amb punt per als decimals. |
| priceable_type | Obligatori | Tipus d’element base. | Utilitza 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
| 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. EMPLEATS (EMPLOYEES)
IMPORTADOR CSV
Importa empleats de forma 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 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 predeterminat 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 | pin | permission_id | active | surname | username | password | 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 |
18. ACTUALITZAR EMPLEATS (UPDATE EMPLOYEES)
IMPORTADOR CSV
Actualitza informació d’empleats existents. Parteix de la llista d’empleats exportada en CSV.
| CAPÇALERA EXACTA | REQUISIT | DESCRIPCIÓ | INFORMACIÓ ADDICIONAL |
|---|---|---|---|
| id | Obligatori | Identificador intern únic de l’empleat. | ID numèric generat per REVO. |
Exemple CSV - Actualitzar empleats
| id | name | pin | permission_id | active | surname | username | password | 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 |
