Avec Revo XEF, vous pouvez importer des fichiers CSV séparés par ";". La première ligne doit contenir les en-têtes avec les noms des champs exactement comme décrits ci-dessous.
AVANT DE COMMENCER : DEUX OUTILS D'IMPORTATION
NOUVEL OUTIL D'IMPORTATION
Utilisé pour les Groupes et les Catégories. Accédez-y depuis Catalogue → Groupes. Pour importer des groupes, cliquez sur Importer. Pour importer des catégories, ouvrez d'abord le groupe auquel vous souhaitez les ajouter, puis cliquez sur Importer. Le système permet d'associer les colonnes : les en-têtes du CSV ne doivent donc pas nécessairement porter des noms exacts.
IMPORTATEUR CSV
Utilisé pour les autres importations. Accédez-y depuis revoxef.works/tools/import. Dans cet outil, les en-têtes doivent correspondre exactement à ceux indiqués dans chaque section. Tarifs utilise son URL spécifique.
CATALOGUE
1. IMPORTER DES GROUPES
NOUVEL OUTIL D'IMPORTATION
Pour créer ou mettre à jour des groupes en masse, accédez à Catalogue → Groupes et cliquez sur Importer. Le nouvel outil d'importation des groupes s'ouvre.
LE NOUVEL OUTIL D'IMPORTATION
Avec le nouvel outil d'importation, les colonnes de votre fichier CSV ne nécessitent pas de noms spécifiques. Lors du chargement du fichier, le système permet de Associer les champs, en reliant chaque colonne du fichier au champ REVO correspondant.
Champs disponibles pour l'association :
| CHAMP | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| Nom | Obligatoire | Nom principal du groupe. | Texte libre. |
| Traductions | Critique | Traductions pour plusieurs langues. | Indispensable : Associez ce champ à la colonne du nom. Sinon, l'élément sera créé avec le nom générique "New Item". |
| Id | Facultatif | Identifiant du groupe dans le système. | À renseigner uniquement pour les mises à jour. |
| Actif | Facultatif | Indique si le groupe est actif. | 0 (Inactif), 1 (Actif). |
| Taxe | Facultatif | Taxe associée au groupe. | Saisissez l'ID numérique interne de la taxe. |
| Groupe analytique | Facultatif | Groupe analytique correspondant. | Saisissez l'ID numérique. |
| Imprimante | Facultatif | Imprimante de commandes attribuée. | Saisissez l'ID numérique. |
| Groupe d'imprimantes | Facultatif | Groupe d'imprimantes attribué. | Saisissez l'ID numérique. |
| Flux d'états | Facultatif | Flux d'états de cuisine (KDS). | Saisissez l'ID numérique. |
| Extra ID | Facultatif | Champ supplémentaire pour les identifiants d'intégration. | Texte alphanumérique libre. |
Exemple CSV - Importer des groupes
| 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. IMPORTER DES CATÉGORIES
NOUVEL OUTIL D'IMPORTATION
Pour importer des catégories en masse, accédez à Catalogue → Groupes, ouvrez le groupe auquel vous souhaitez ajouter les catégories, puis cliquez sur Importer. Le nouvel outil d'importation des catégories s'ouvre.
LE NOUVEL OUTIL D'IMPORTATION
Le fonctionnement est identique à celui des groupes : chargez un CSV et associez les colonnes manuellement.
Champs disponibles pour l'association :
| CHAMP | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| Groupe | Obligatoire | Groupe auquel appartient la catégorie. | Saisissez l'ID numérique ou le nom exact du groupe parent. |
| Nom | Obligatoire | Nom de la catégorie. | Texte libre. |
| Traductions | Critique | Traductions pour plusieurs langues. | Indispensable : Associez ce champ à la colonne du nom. Sinon, l'élément sera créé avec le nom générique "New Item". |
| Id | Facultatif | Identifiant interne de la catégorie. | À renseigner uniquement pour les mises à jour. |
| Actif | Facultatif | Indique si la catégorie est active. | 0 (Inactif), 1 (Actif). |
| Taxe | Facultatif | Taxe associée à la catégorie. | Saisissez l'ID numérique. |
| Groupe analytique | Facultatif | Groupe analytique correspondant. | Saisissez l'ID numérique. |
| Imprimante | Facultatif | Imprimante de commandes attribuée. | Saisissez l'ID numérique. |
| Groupe d'imprimantes | Facultatif | Groupe d'imprimantes attribué. | Saisissez l'ID numérique. |
| Flux d'états | Facultatif | Flux d'états de cuisine. | Saisissez l'ID numérique. |
| Extra ID | Facultatif | Champ supplémentaire pour les intégrations externes. | Texte alphanumérique libre. |
Exemple CSV - Importer des catégories
| 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. IMPORTER DES PRODUITS (PRODUCTS)
IMPORTATEUR CSV
Importez des produits et configurez-les à l'aide d'un fichier CSV.
Avec Revo XEF, vous pouvez importer des fichiers CSV séparés par ";". La première ligne doit contenir les en-têtes avec les noms des champs exactement comme décrits ci-dessous.
IMPORTANT : Les noms des champs dans l'en-tête doivent être exactement identiques à ceux indiqués ici. Sans majuscule initiale, sans espace et sans le symbole « : ».
Correct :
Incorrect :
Correct :
category_idIncorrect :
Category_id / CATEGORY_ID / category id| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| category_id | Obligatoire | ID de la catégorie. Avant l'importation, créez manuellement la structure pour obtenir cet ID. | Saisissez l'ID numérique. |
| name | Obligatoire | Nom du produit. | Texte libre (3 caractères minimum). |
| super_group_id | Facultatif | ID du groupe analytique attribué au produit. | Saisissez l'ID numérique. |
| price | Facultatif | Prix de vente au public. | Utilisez un point comme séparateur décimal.Exemple : 10.20 |
| costPrice | Facultatif | Prix de revient interne. | Utilisez un point comme séparateur décimal.Exemple : 8.20 |
| type | Facultatif | Définit le type opérationnel du produit. | 0 : Produit, 1 : Menu, 2 : Conteneur, 3 : Entrée, 4 : Format, 5 : Carte cadeau, 6 : Gestion uniquement, 7 : Kit. |
| active | Facultatif | État de visibilité sur le TPV. | 0 (Inactif), 1 (Actif).Si omis, tous sont activés. |
| hasInventory | Facultatif | Suivi des unités et du stock. | 0 (Sans suivi), 1 (Avec suivi). |
| displayInventory | Facultatif | Affiche les unités restantes dans l'application. | 0 (Masqué), 1 (Afficher le stock). |
| usesWeight | Facultatif | Associe une balance. | 0 (Sans pesée), 1 (Avec pesée). |
| allergies | Facultatif | Allergènes associés au produit. | Saisissez les IDs numériques séparés par des points-virgules (ex. : 1;5;14). IDs DES ALLERGÈNES : 1 : Œufs 2 : Sésame 3 : Lupin 4 : Moutarde 5 : Poisson 6 : Céleri 7 : Crustacés 8 : Arachides 9 : Mollusques 10 : Soja 11 : Fruits à coque 12 : Sulfites 13 : Produits laitiers 14 : Gluten |
| isMenu | Facultatif | Indique s'il sert à regrouper les éléments d'un menu. | 0 (Pas un menu), 1 (Produit de type menu). |
| shouldAppearInMenuList | Facultatif | Indique s'il peut être sélectionné dans d'autres menus. | 0 (Désactivée), 1 (Activée). |
| isOpen | Facultatif | Impose la saisie manuelle d'un prix lors de la vente. | 0 (Prix fixe), 1 (Produit ouvert). |
| order | Facultatif | Ordre d'affichage dans la catégorie. | Utilisez des nombres : 1, 2, 3, etc. |
| barcode | Facultatif | Code-barres du produit. | Valeur numérique ou EAN. |
| tax_id | Facultatif | Taxe par défaut du produit. | ID numérique. |
| printer_id | Facultatif | Imprimante par défaut attribuée directement au produit. | ID numérique. |
| printer_group_id | Facultatif | Groupe d'imprimantes attribué directement par défaut. | ID numérique. |
| modifier_group_id | Facultatif | Groupe de modificateurs propre au produit. | ID numérique. |
| modifier_category_id | Facultatif | Catégorie de modificateur attribuée au produit. | ID numérique. |
| photo | Facultatif | Image du produit. | Nom du fichier et extension. |
| info | Facultatif | Description détaillée du produit. | Texte libre. |
| buttonName | Facultatif | Nom alternatif abrégé. | À afficher sur les boutons de l'application. |
| nameKitchen | Facultatif | Nom différent pour les tickets de préparation. | Texte libre. |
| dish_order_id | Facultatif | Ordre d'envoi des plats. | ID numérique. |
| unit_id | Facultatif | ID de l'unité de vente. | ID numérique. |
| extra_id | Facultatif | Code externe ou Nielsen, le cas échéant. | Texte alphanumérique. |
| useAverageCostPrice | Facultatif | Calcul du coût moyen. | 0 (Inactif), 1 (Activé). |
| cookDuration | Facultatif | Temps de préparation estimé. | Valeur en secondes (pour KDS). |
| minQuantity | Facultatif | Quantité minimale lors de l'ajout d'un produit. | Valeur numérique. |
| extra_attributes | Facultatif | Attributs spéciaux. | ID numérique. |
IMPORTANT : Configurer l'imprimante ou les modificateurs directement sur les produits peut poser des problèmes ultérieurement. Vous devrez alors les modifier ou les supprimer un par un. Une configuration au niveau de la catégorie ou du groupe se modifie en quelques clics.
Exemple CSV - Importer des produits
| 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. METTRE À JOUR DES PRODUITS (PRODUCTS UPDATE)
IMPORTATEUR CSV
Mettez à jour ou ajoutez des informations aux produits existants à l'aide d'un fichier CSV.
L'ID étant obligatoire, il est recommandé de partir d'une liste de produits REVO préalablement exportée.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| id | Obligatoire | Identifiant unique du produit dans la base de données. | ID numérique interne de REVO. |
| super_group_id | Facultatif | ID du groupe analytique attribué au produit. | Saisissez l'ID numérique. |
Exemple CSV - Mettre à jour des produits
| 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. CONTENEURS (CONTAINERS)
IMPORTATEUR CSV
Les conteneurs sont des dossiers permettant de regrouper des produits. Ils constituent un « quatrième niveau » après Groupes, Catégories et Produits.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| category_id | Obligatoire | ID de la catégorie dans laquelle se trouvera le dossier. | ID numérique. |
| name | Obligatoire | Nom affiché du conteneur ou du dossier. | Texte libre. |
| photo | Facultatif | Nom du fichier de l'image de couverture. | Nom du fichier image. |
Exemple CSV - Conteneurs
| category_id | name | photo |
|---|---|---|
| 10 | CAFÉS | carpeta_cafes.jpg |
| 15 | AGUAS | carpeta_aguas.jpg |
| 17 | VINOS TINTOS | carpeta_vinos.jpg |
6. PRODUITS DE CONTENEUR (CONTAINER ITEMS)
IMPORTATEUR CSV
Associez des produits à un conteneur existant.
Vous pouvez obtenir les IDs en plaçant le curseur sur l'icône du crayon dans le back-office.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| main_item_id | Obligatoire | ID du conteneur parent (dossier). | ID numérique. |
| item_id | Obligatoire | ID des produits à ajouter à l'intérieur. | ID numérique. |
| order | Facultatif | Ordre d'affichage dans le conteneur. | Valeur numérique. |
| dish_order_id | Facultatif | Ordre des plats par défaut appliqué à ce dossier. | ID numérique. |
| active | Facultatif | État du produit dans la vue du dossier. | 0 (Inactif), 1 (Actif). |
Exemple CSV - Produits de conteneur
| 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 VENTE (ITEM SELLING FORMATS)
IMPORTATEUR CSV
Importez des produits avec des formats de vente (boisson mélangée, pur, shot, etc.).
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| item_id | Obligatoire | ID du produit de base. | ID numérique. |
| format_id | Obligatoire | ID du format de vente configuré. | ID numérique. |
| price | Obligatoire | Prix de vente de ce format. | Utilisez un point comme séparateur décimal. |
| quantity | Obligatoire | Quantité exacte à déduire du stock général. | Utilisez des décimales selon l'unité. |
| unit_id | Obligatoire | ID de l'unité de mesure du stock. | ID numérique. |
| order | Obligatoire | Ordre d'affichage dans la liste déroulante. | Valeur numérique. |
| combination_group_id | Obligatoire | ID du groupe de combinaisons imposé (le cas échéant). | Saisissez 0 si non applicable. |
Exemple CSV - Formats de vente
| 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 |
STOCK
8. AJOUTER DU STOCK (INVENTORY ADD)
IMPORTATEUR CSV
Ajoutez du stock à vos produits, notamment lors de la première saisie.
Si vous disposez de plusieurs entrepôts, répétez l'ID du produit avec différentes valeurs de warehouse_id.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| item_id | Obligatoire | ID des produits à approvisionner. | ID numérique. |
| quantity | Obligatoire | Quantité à AJOUTER au stock. | Valeur numérique positive. |
| warehouse_id | Obligatoire | ID de l'entrepôt recevant le stock. | ID numérique. |
Exemple CSV - Ajouter du stock
| item_id | quantity | warehouse_id |
|---|---|---|
| 100 | 150 | 1 |
| 102 | 150 | 1 |
| 100 | 500 | 2 |
9. DÉFINIR LE STOCK (INVENTORY SET)
IMPORTATEUR CSV
Définissez le stock exact de vos produits. Idéal après un inventaire physique.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| item_id | Obligatoire | IDs des produits. | ID numérique. |
| quantity | Obligatoire | Quantité physique exacte à définir. | Valeur numérique qui remplace la précédente. |
| warehouse_id | Obligatoire | ID de l'entrepôt. | ID numérique. |
| defaultQuantity | Facultatif | Quantité de stock de référence ou idéale. | Valeur numérique. |
| alert | Facultatif | Stock minimal déclenchant une alerte de commande. | Valeur numérique. |
Exemple CSV - Définir le stock
| item_id | quantity | warehouse_id | defaultQuantity | alert |
|---|---|---|---|---|
| 100 | 100 | 1 | 200 | 10 |
| 110 | 232 | 1 | 400 | 20 |
10. TRANSFÉRER DU STOCK (INVENTORY MOVE)
IMPORTATEUR CSV
Transférez du stock entre entrepôts.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| item_id | Obligatoire | ID des produits à transférer. | ID numérique. |
| quantity | Obligatoire | Quantité exacte à transférer. | Valeur numérique. |
| warehouse_id | Obligatoire | ID de l'entrepôt d'origine. | Entrepôt dont le stock est déduit (ID numérique). |
| to_warehouse_id | Obligatoire | ID de l'entrepôt de destination. | Entrepôt auquel le stock est ajouté (ID numérique). |
Exemple CSV - Transférer du stock
| item_id | quantity | warehouse_id | to_warehouse_id |
|---|---|---|---|
| 100 | 100 | 1 | 2 |
| 102 | 100 | 1 | 2 |
FOURNISSEURS
11. IMPORTER DES FOURNISSEURS (VENDORS)
IMPORTATEUR CSV
Importez des fournisseurs en masse pour utiliser le module d'achats.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| name | Obligatoire | Nom du fournisseur. | Texte libre (3 caractères minimum). |
| address | Obligatoire | Adresse principale de facturation ou de livraison. | Texte libre. |
| nif | Obligatoire | NIF ou identifiant fiscal. | CIF, DNI, etc. |
| city | Facultatif | Ville ou localité. | Texte libre. |
| state | Facultatif | Province ou État. | Texte libre. |
| country | Facultatif | Pays du siège du fournisseur. | Texte libre. |
| postalCode | Facultatif | Code postal. | Alphanumérique. |
| web | Facultatif | Site web de l'entreprise. | Format URL. |
| Facultatif | Adresse e-mail pour les commandes. | Adresse e-mail valide. | |
| phone | Facultatif | Numéro de téléphone de contact. | Numérique. |
| notes | Facultatif | Notes et observations internes. | Texte libre. |
| shouldBeNotified | Facultatif | Notifier au fournisseur les changements d'état. | 1 (Notifier), 0 (Ne pas notifier). |
Exemple CSV - Importer des fournisseurs
| 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. PRODUITS DES FOURNISSEURS (VENDORS ITEMS)
IMPORTATEUR CSV
Associez des produits à vos fournisseurs pour utiliser le module d'achats.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| vendor_id | Obligatoire | ID du fournisseur créé dans le système. | ID numérique. |
| item_id | Obligatoire | ID du produit REVO fourni par le fournisseur. | ID numérique. |
| reference | Facultatif | Code de référence du produit dans le catalogue du fournisseur. | Alphanumérique. |
| pack | Facultatif | Unités contenues dans chaque lot ou boîte d'achat. | Valeur numérique. |
| costPrice | Facultatif | Prix de revient convenu. | Utilisez un point comme séparateur décimal. |
| unit_id | Facultatif | ID de l'unité de mesure d'achat. | ID numérique. |
| tax_id | Facultatif | ID de la taxe déductible sur les achats. | ID numérique. |
Exemple CSV - Produits des fournisseurs
| 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 ET CARTES CADEAUX
13. IMPORTER DES CLIENTS (CUSTOMERS)
IMPORTATEUR CSV
Importez des clients en masse.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| name | Obligatoire | Nom du client ou raison sociale. | Texte libre (3 caractères minimum). |
| address_country | Conditionnel | Pays. | Obligatoire si le NIF ou tout autre champ d'adresse est renseigné. Code ISO 3166-1 alpha-2 (exemple : ES). |
| address_street_address | Conditionnel | Adresse postale. | Obligatoire si le NIF est renseigné. |
| address_postal_code | Conditionnel | Code postal. | Obligatoire si le NIF est renseigné. |
| address_city | Conditionnel | Ville ou localité. | Obligatoire si le NIF est renseigné. |
| address_state | Conditionnel | Province ou État. | Obligatoire si le NIF est renseigné. |
| nif | Facultatif | NIF ou identifiant fiscal. | Si renseigné, l'adresse devient obligatoire. |
| active | Facultatif | État du client. | 0 (Inactif), 1 (Actif). |
| Facultatif | Adresse e-mail. | Format d'e-mail valide. | |
| phone | Facultatif | Numéro de téléphone de contact. | Doit inclure l'indicatif international pour être valide (ex. : +34644847774 valide, 644847774 non valide). |
| language | Facultatif | Langue préférée pour les communications. | Code ISO (es, en, fr...). |
| nationality | Facultatif | Nationalité. | Texte libre. |
| birth_date | Facultatif | Date de naissance du client. | Format strict : AAAA-MM-JJ. |
| gender | Facultatif | Genre. | Male, Female ou Other. |
| allergies | Facultatif | Allergies du client. | IDs séparés par des points-virgules (ex. : 1;5;14). |
| web | Facultatif | Site web de l'entreprise. | URL. |
| notes | Facultatif | Notes ou préférences du client. | Texte libre. |
| extra_id | Facultatif | Affectation à un groupe de clients. | ID numérique. |
| address_notes | Facultatif | Notes de livraison à domicile. | Texte libre. |
Exemple CSV - Importer des 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. CARTES CADEAUX (GIFT CARDS)
IMPORTATEUR CSV
Importez des cartes cadeaux en masse dans le back-office.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| uuid | Obligatoire | Code d'identification unique de la carte. | Peut contenir du texte et des chiffres. |
| total | Obligatoire | Solde initial généré. | Doit être numérique. |
| active | Facultatif | Indique si la carte est déjà opérationnelle. | 0 (Inactive), 1 (Active). |
| balance | Facultatif | Solde restant réel. | À renseigner uniquement si différent du total. |
| campaign_id | Facultatif | Campagne promotionnelle associée. | ID numérique de la campagne. |
| customer_id | Facultatif | Client associé nominativement. | ID numérique du client. |
Exemple CSV - Cartes cadeaux
| 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. RECHARGER DES CARTES CADEAUX (GIFT CARDS RELOAD)
IMPORTATEUR CSV
Importez des recharges de cartes cadeaux.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| uuid | Obligatoire | Code exact de la carte cadeau existante. | Alphanumérique. |
| reloadAmount | Obligatoire | Montant à ajouter au solde actuel. | Numérique, avec un point comme séparateur décimal. |
Exemple CSV - Recharger des cartes
| uuid | reloadAmount |
|---|---|
| 00000123456 | 100.00 |
| 00000789100 | 100.00 |
TARIFS ET EMPLOYÉS
16. TARIFS (PRICE RATES)
IMPORTATEUR CSV
Pour importer des tarifs, accédez à : https://revoxef.works/thrust/prices/import
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| ID | Obligatoire | Identifiant du produit de base. | ID numérique. |
| priceable_id | Obligatoire | Identifiant du prix au sein du produit référencé. | ID numérique. |
| table_price_id | Obligatoire | Identifiant du tarif auquel le prix s'applique. | ID numérique. |
| price | Obligatoire | Montant à définir pour le tarif indiqué. | Prix avec un point comme séparateur décimal. |
| priceable_type | Obligatoire | Type d'élément de base. | Utilisez exactement la valeur du tableau ci-dessous. |
Valeurs de priceable_type :
| TYPE | VALEUR À SAISIR DANS LA COLONNE |
|---|---|
| Produits | App\Models\Menu\MenuItem |
| Produits de menu | App\Models\Menu\MenuMenuPivot |
| Modificateurs | App\Models\Menu\Modifier |
| Format de vente | App\Models\Menu\ItemSellingFormatPivot |
| Combinaisons | App\Models\Menu\Combination |
Exemple CSV - Tarifs
| 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 |
17. EMPLOYÉS (EMPLOYEES)
IMPORTATEUR CSV
Importez des employés en masse.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| name | Obligatoire | Nom de l'employé. | Texte libre. |
| pin | Obligatoire | Code PIN d'accès au TPV sur iPad. | Valeur numérique. |
| permission_id | Obligatoire | Privilège de sécurité de l'application. | ID numérique. |
| active | Facultatif | État de l'employé dans les effectifs. | 0 (Inactif), 1 (Actif). |
| surname | Facultatif | Nom de famille. | Texte libre. |
| username | Facultatif | Identifiant de connexion au back-office web. | Texte court sans espaces. |
| password | Facultatif | Mot de passe du back-office. | Alphanumérique. |
| Facultatif | Adresse e-mail. | Adresse e-mail valide. | |
| phone | Facultatif | Numéro de téléphone de contact. | Numérique. |
| notes | Facultatif | Notes internes. | Texte libre. |
| profile_id | Facultatif | Profil d'employé par défaut. | ID numérique. |
| photo | Facultatif | Avatar visuel. | Nom du fichier et extension. |
| cashier_id | Facultatif | Caisse par défaut attribuée. | ID numérique. |
| identifier | Facultatif | Identifiant de la clé de sécurité du TPV. | Valeur hexadécimale (NFC, QR...). |
| back_permission_id | Facultatif | Niveau de privilèges du back-office. | ID numérique. |
| nif | Facultatif | Numéro d'identité de l'employé (DNI). | Alphanumérique. |
Exemple CSV - Employés
| 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. METTRE À JOUR DES EMPLOYÉS (UPDATE EMPLOYEES)
IMPORTATEUR CSV
Mettez à jour les informations des employés existants. Partez de la liste des employés exportée au format CSV.
| EN-TÊTE EXACT | EXIGENCE | DESCRIPTION | INFORMATIONS COMPLÉMENTAIRES |
|---|---|---|---|
| id | Obligatoire | Identifiant interne unique de l'employé. | ID numérique généré par REVO. |
Exemple CSV - Mettre à jour des employés
| 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 |
