Avec Revo XEF, vous pouvez importer des fichiers CSV séparés par « ; ». La première ligne doit contenir l'en-tête avec les noms des champs exactement comme décrits ci-dessous.
Vérifiez lequel utiliser pour chaque type de données.
Avant de commencer : il existe deux importateurs
Il sert pour les Groupes et les Catégories. On y accède depuis Catalogue → Groupes. Pour importer des groupes, appuyez sur Importer. Pour importer des catégories, ouvrez d'abord le groupe dans lequel vous voulez les ajouter puis, à l'intérieur, appuyez sur Importer. Le système permet de mapper les colonnes : le CSV n'a donc pas besoin d'en-têtes aux noms exacts.
Il est également utilisé pour les catégories de modificateurs, depuis Catalogue → Modificateurs.
Il sert pour toutes les autres importations. On y accède depuis revoxef.works/tools/import. Dans cet importateur, les en-têtes doivent correspondre exactement à ceux indiqués dans chaque section. Tarifs utilise son URL spécifique.
Si vous partez du modèle de l'importateur, supprimez les lignes d'instructions situées avant l'en-tête : la première ligne doit être l'en-tête, avec les champs séparés par ;. Vous pouvez supprimer les colonnes facultatives dont vous n’avez pas besoin.
Importez groupes, catégories, produits, conteneurs et formats de vente.
Catalogue
1Importer des groupes
En-têtes libres : lors du chargement du CSV, associez chaque colonne à son champ dans Mapper les champs.
Pour créer ou mettre à jour des groupes en masse, accédez à Catalogue → Groupes et appuyez sur Importer. Le nouvel importateur de groupes s'ouvre.
Le nouvel importateur
Avec le nouvel importateur, les colonnes de votre fichier CSV n'ont pas besoin de noms spécifiques. Lors de l'envoi du fichier, le système vous permet de Mapper les champs, en associant chaque colonne de votre fichier au champ REVO correspondant.
Champs disponibles pour le mappage :
| Champ à mapper | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| Nombre | Obligatoire | Le nom principal du groupe. | Texte libre. |
| Traductions | Critique | Traductions pour le multilingue. | Indispensable : Le mapper avec la colonne du nom. Sinon, il sera créé avec le nom générique « New Item ». |
| Id | Facultatif | Identifiant du groupe dans le système. | À remplir uniquement pour les mises à jour. |
| Activo | Facultatif | Indique si le groupe est actif ou non. | 0 (Inactif), 1 (Actif). |
| Impuesto | Facultatif | La taxe associée au groupe. | Saisir l'ID numérique interne de la taxe. |
| Groupe analytique | Facultatif | Le groupe analytique correspondant. | Saisir l'ID numérique. |
| Impresora | Facultatif | L'imprimante de bons attribuée. | Saisir l'ID numérique. |
| Groupe d'imprimantes | Facultatif | Le groupe d'imprimantes attribué. | Saisir l'ID numérique. |
| Flux d'états | Facultatif | Le flux d'états de cuisine (KDS). | Saisir l'ID numérique. |
| Extra ID | Facultatif | Champ supplémentaire pour les identifiants d'intégration. | Texte alphanumérique libre. |
| 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 |
2Importer des catégories
En-têtes libres : lors du chargement du CSV, associez chaque colonne à son champ dans Mapper les champs.
Pour importer des catégories en masse, accédez à Catalogue → Groupes, ouvrez le groupe dans lequel vous voulez ajouter les catégories puis, depuis ce groupe, appuyez sur Importer. Le nouvel importateur de catégories s'ouvre.
Le nouvel importateur
Le fonctionnement est identique à celui des groupes : vous pouvez envoyer n'importe quel CSV et mapper les colonnes manuellement.
Champs disponibles pour le mappage :
| Champ à mapper | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| Grupo | Obligatoire | Le groupe auquel appartient la catégorie. | Saisir l'ID numérique ou le nom exact du groupe parent. |
| Nombre | Obligatoire | Le nom de la catégorie. | Texte libre. |
| Traductions | Critique | Traductions pour le multilingue. | Indispensable : Le mapper avec la colonne du nom. Sinon, il sera créé avec le nom générique « New Item ». |
| Id | Facultatif | Identifiant interne de la catégorie. | À remplir uniquement pour les mises à jour. |
| Activo | Facultatif | Indique si la catégorie est active ou non. | 0 (Inactif), 1 (Actif). |
| Impuesto | Facultatif | La taxe associée à la catégorie. | Saisir l'ID numérique. |
| Groupe analytique | Facultatif | Le groupe analytique correspondant. | Saisir l'ID numérique. |
| Impresora | Facultatif | L'imprimante de bons attribuée. | Saisir l'ID numérique. |
| Groupe d'imprimantes | Facultatif | Le groupe d'imprimantes attribué. | Saisir l'ID numérique. |
| Flux d'états | Facultatif | Le flux d'états de cuisine. | Saisir l'ID numérique. |
| Extra ID | Facultatif | Champ supplémentaire pour les intégrations externes. | Texte alphanumérique libre. |
| 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 |
3Importer des catégories de modificateurs
En-têtes libres : lors du chargement du CSV, associez chaque colonne à son champ dans Mapper les champs.
Pour importer des catégories de modificateurs en masse, accédez à Catalogue → Modificateurs et appuyez sur Importer. Le nouvel importateur de catégories de modificateurs s'ouvrira.
Le nouvel importateur
Le fonctionnement est identique à celui des groupes : vous pouvez envoyer n'importe quel CSV et mapper les colonnes manuellement.
Champs disponibles pour le mappage :
| Champ à mapper | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| Nombre | Obligatoire | Le nom de la catégorie de modificateurs. | Texte d'au moins 3 caractères. Exemple : Punto de cocción. |
| Min | Obligatoire | Minimum du réglage minimum et maximum des modificateurs. | Nombre entier supérieur ou égal à 1 et non supérieur à Max. Exemple : 1. |
| Max | Obligatoire | Maximum du réglage minimum et maximum des modificateurs. | Nombre entier entre 1 et 1000, supérieur ou égal à Min. Exemple : 1. |
| Id | Facultatif | Identifiant de la catégorie de modificateurs. | ID numérique. |
| Activo | Facultatif | Indique si la catégorie de modificateurs est active ou non. | 0 (Inactif), 1 (Actif). |
| Oculto | Facultatif | Indique si la catégorie de modificateurs est masquée ou non. | 0 (Visible), 1 (Masqué). |
| Traductions | Facultatif | Traductions pour le multilingue. | |
| Selección | Facultatif | Ancien réglage : s'il y a une sélection. | 0 (Sans sélection), 1 (Avec sélection). Obsolète. |
| Dernier champ, sans nom | Facultatif | Ancien réglage : si la sélection est obligatoire ou facultative. | 0 (Obligatoire), 1 (Facultatif). Obsolète. |
| Nombre | Punto de cocción | Salsas | Guarnición |
| Activo | 1 | 1 | 1 |
| Oculto | 0 | 0 | 0 |
| Min | 1 | 1 | 1 |
| Max | 1 | 3 | 1 |
Dans l'importateur, les champs obligatoires ont un astérisque (*). Selección et le dernier champ sans nom sont obsolètes : ils sont remplacés par Min et les Max, qui nécessitent l'app 4.3 ou supérieure.
4Importer des produitsPRODUCTS
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_idOption pour importer des produits et les configurer à 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 l'en-tête avec les noms des champs exactement comme décrits ci-dessous.
Correct :
category_idIncorrect :
Category_id / CATEGORY_ID / category id| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| category_id | Obligatoire | ID de la catégorie. Avant l'import, créez manuellement la structure pour obtenir cet ID. | Saisir un 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. | Saisir un ID numérique. |
| price | Facultatif | Prix de vente public. | Utiliser le point pour les décimales. Exemple : 10.20 |
| costPrice | Facultatif | Prix de revient interne. | Utiliser le point pour les décimales. Exemple : 8.20 |
| type | Facultatif | Définit la nature opérationnelle 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). S'il est omis, tous sont activés. |
| hasInventory | Facultatif | Contrôle des unités et du stock. | 0 (Sans contrôle), 1 (Avec contrôle). |
| displayInventory | Facultatif | Affiche les unités restantes dans l'app. | 0 (N'affiche pas), 1 (Affiche le stock). |
| usesWeight | Facultatif | Lien avec la balance. | 0 (N'utilise pas le poids), 1 (Utilise le poids). |
| allergies | Facultatif | Allergènes associés au produit. | Saisir les IDs numériques séparés par des points-virgules (ex. : 1;5;14). |
IDS DES ALLERGÈNES0Sans allergènes (null)1Œufs2Sésame3Lupin4Moutarde5Poisson6Céleri7Crustacés8Arachides9Mollusques10Soja11Fruits à coque12Sulfites13Produits laitiers14Gluten | |||
| isMenu | Facultatif | Indique s'il sert de regroupement de menu. | 0 (Pas un menu), 1 (Produit de type menu). |
| shouldAppearInMenuList | Facultatif | S'il peut être sélectionné dans d'autres menus. | 0 (Désactivé), 1 (Activé). |
| isOpen | Facultatif | Oblige à saisir un prix manuellement lors de la vente. | 0 (Prix fixe), 1 (Produit ouvert). |
| order | Facultatif | Ordre d'affichage dans la catégorie. | Utiliser 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 directe par défaut du produit. | ID numérique. |
| printer_group_id | Facultatif | Groupe d'imprimantes direct 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 modificateurs 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 court. | Pour l'afficher sur les boutons de l'app. |
| nameKitchen | Facultatif | Nom différent pour les tickets de préparation. | Texte libre. |
| dish_order_id | Facultatif | Ordre de service 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 (Désactivé), 1 (Activé). |
| cookDuration | Facultatif | Temps de préparation estimé. | Valeur en secondes (pour le KDS). |
| minQuantity | Facultatif | Quantité minimale lors de l'ajout du produit. | Valeur numérique. |
| extra_attributes | Facultatif | Attributs spéciaux. | ID numérique. |
| 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 |
5Mettre à jour des produitsPRODUCTS UPDATE
Même en-tête que le modèle de Importer des produits, avec id comme première colonne.
Option pour mettre à jour ou compléter des produits existants à l'aide d'un fichier CSV.
L'ID étant obligatoire, il est recommandé de partir de la liste des produits REVO exportée au préalable.
| En-tête exact | Exigence | Description | Informations supplé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. | Saisir un ID numérique. |
| 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 |
6ConteneursCONTAINERS
category_id;name;photoLes conteneurs sont des dossiers dans lesquels vous pouvez regrouper des produits. Ils constituent un « quatrième niveau » après Groupes, Catégories et Produits.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| category_id | Obligatoire | ID de la catégorie où se trouvera le dossier. | ID numérique. |
| name | Obligatoire | Nom affiché du conteneur/dossier. | Texte libre. |
| photo | Facultatif | Nom du fichier de la photo de couverture. | Nom du fichier et image. |
| category_id | 10 | 15 | 17 |
| name | CAFÉS | AGUAS | VINOS TINTOS |
| photo | carpeta_cafes.jpg | carpeta_aguas.jpg | carpeta_vinos.jpg |
7Produits de conteneurCONTAINER ITEMS
order;active;item_id;main_item_id;dish_order_idAssocie 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 supplémentaires |
|---|---|---|---|
| main_item_id | Obligatoire | ID du conteneur parent (dossier). | ID numérique. |
| item_id | Obligatoire | ID des produits à y placer. | ID numérique. |
| order | Facultatif | Ordre d'affichage dans le conteneur. | Valeur numérique. |
| dish_order_id | Facultatif | Ordre de service par défaut appliqué dans ce dossier. | ID numérique. |
| active | Facultatif | État du produit dans la vue du dossier. | 0 (Inactif), 1 (Actif). |
| 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 venteITEM SELLING FORMATS
active;quantity;price;order;format_id;item_id;combination_group_id;unit_idImportez des produits avec des formats de vente (cocktail, sec, shot, etc.).
| En-tête exact | Exigence | Description | Informations supplé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 pour ce format. | Utiliser le point pour les décimales. |
| quantity | Obligatoire | Quantité exacte à déduire du stock général. | Utiliser 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 cocktails imposé (le cas échéant). | Indiquer 0 si non applicable. |
| 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 |
Ajoutez du stock, fixez le stock exact après un comptage ou déplacez-le entre entrepôts.
Inventaire
9Ajouter de l'inventaireINVENTORY ADD
item_id;quantity;warehouse_idAjoute du stock à vos produits, particulièrement utile la première fois.
Si vous avez plusieurs entrepôts, répétez l'ID du produit avec un autre warehouse_id.
| En-tête exact | Exigence | Description | Informations supplé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 qui reçoit le stock. | ID numérique. |
| A | B | C | |
|---|---|---|---|
| 1 | item_id | quantity | warehouse_id |
| 2 | 100 | 150 | 1 |
| 3 | 102 | 150 | 1 |
| 4 | 100 | 500 | 2 |
10Établir/faire l'inventaireINVENTORY SET
item_id;quantity;warehouse_id;defaultQuantity;alertÉtablit le stock exact de vos produits. Idéal après un comptage d'inventaire.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| item_id | Obligatoire | ID des produits. | ID numérique. |
| quantity | Obligatoire | Quantité physique exacte à établir. | Valeur numérique qui remplacera la précédente. |
| warehouse_id | Obligatoire | ID de l'entrepôt. | ID numérique. |
| defaultQuantity | Facultatif | Quantité de stock de référence / idéale. | Valeur numérique. |
| alert | Facultatif | Stock minimum pour recevoir une alerte de commande. | Valeur numérique. |
| item_id | 100 | 110 |
| quantity | 100 | 232 |
| warehouse_id | 1 | 1 |
| defaultQuantity | 200 | 400 |
| alert | 10 | 20 |
11Déplacer l'inventaireINVENTORY MOVE
item_id;quantity;warehouse_id;to_warehouse_idDéplace du stock entre entrepôts.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| item_id | Obligatoire | ID des produits à déplacer. | ID numérique. |
| quantity | Obligatoire | Quantité exacte à déplacer. | Valeur numérique. |
| warehouse_id | Obligatoire | ID de l'entrepôt d'origine. | Entrepôt qui soustrait (ID numérique). |
| to_warehouse_id | Obligatoire | ID de l'entrepôt de destination. | Entrepôt qui ajoute (ID numérique). |
| item_id | 100 | 102 |
| quantity | 100 | 100 |
| warehouse_id | 1 | 1 |
| to_warehouse_id | 2 | 2 |
Importez des fournisseurs et associez-les à vos produits.
Fournisseurs
12Importer des fournisseursVENDORS
Importez des fournisseurs en masse pour utiliser le module d'achats.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| name | Obligatoire | Nom du fournisseur. | Texte libre (3 caractères minimum). |
| address | Obligatoire | Adresse principale de facturation/livraison. | Texte libre. |
| nif | Obligatoire | Numéro fiscal. | SIRET, numéro de TVA, 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 | E-mail pour les commandes. | E-mail valide. | |
| phone | Facultatif | Téléphone de contact. | Numérique. |
| notes | Facultatif | Notes et observations internes. | Texte libre. |
| shouldBeNotified | Facultatif | Notifier le fournisseur en cas de changement d'état. | 1 (Notifier), 0 (Ne pas notifier). |
| 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 |
13Produits des fournisseursVENDORS ITEMS
Associe des produits à vos fournisseurs pour utiliser le module d'achats.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| vendor_id | Obligatoire | ID du fournisseur créé dans le système. | ID numérique. |
| item_id | Obligatoire | ID du produit REVO qu'il fournit. | 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 pack/carton d'achat. | Valeur numérique. |
| costPrice | Facultatif | Prix de revient convenu. | Utiliser le point pour les décimales. |
| unit_id | Facultatif | ID de l'unité de mesure d'achat. | ID numérique. |
| tax_id | Facultatif | ID de la taxe sur les achats. | ID numérique. |
| 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 |
Importez des clients et des cartes cadeaux, ou rechargez le solde de cartes existantes.
Clients et cartes cadeaux
14Importer des clientsCUSTOMERS
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_notesImportez des clients en masse.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| name | Obligatoire | Nom du client ou raison sociale. | Texte libre (3 caractères minimum). |
| address_country | Conditionnel | Pays. | Obligatoire si le numéro fiscal ou tout autre champ d'adresse est saisi. Code ISO 3166-1 alpha-2 (exemple : ES). |
| address_street_address | Conditionnel | Adresse (rue). | Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi. |
| address_postal_code | Conditionnel | Code postal. | Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi. |
| address_city | Conditionnel | Ville ou localité. | Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi. |
| address_state | Conditionnel | Province ou État. | Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi. |
| nif | Facultatif | Numéro fiscal. | S'il est saisi, l'adresse devient obligatoire. |
| active | Facultatif | État du client. | 0 (Inactif), 1 (Actif). |
| Facultatif | E-mail. | Format d'e-mail valide. | |
| phone | Facultatif | Téléphone de contact. | Doit inclure l'indicatif international pour être valide (ex. : +34644847774 OK, 644847774 NON OK). |
| 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 | Attribution à un groupe de clients. | ID numérique. |
| address_notes | Facultatif | Notes de livraison à domicile. | Texte libre. |
| 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 |
15Cartes cadeauxGIFT CARDS
campaign_id;customer_id;active;uuid;total;balance;extra_attributesImportez des cartes cadeaux en masse dans le back-office.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| uuid | Obligatoire | Code d'identification unique de la carte. | Peut contenir du texte et des chiffres. |
| total | Obligatoire | Solde initial. | 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. | À remplir uniquement s'il diffère 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. |
| 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 |
16Recharger des cartes cadeauxGIFT CARDS RELOAD
uuid;reloadAmountImportez des recharges sur les cartes cadeaux.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| uuid | Obligatoire | Code exact de la carte cadeau existante. | Alphanumérique. |
| reloadAmount | Obligatoire | Montant à ajouter au solde actuel. | Numérique avec point décimal. |
| A | B | |
|---|---|---|
| 1 | uuid | reloadAmount |
| 2 | 00000123456 | 100.00 |
| 3 | 00000789100 | 100.00 |
Attribuez des prix par tarif et créez ou mettez à jour des employés.
Tarifs et employés
17TarifsPRICE RATES
Pour importer des tarifs, accédez à : https://revoxef.works/thrust/prices/import
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| ID | Obligatoire | Identifiant du produit de base. | ID numérique. |
| priceable_id | Obligatoire | Identifiant du prix dans le 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 à établir pour le tarif indiqué. | Prix avec le point pour les décimales. |
| priceable_type | Obligatoire | Type d'élément de base. | Utiliser exactement la valeur du tableau ci-dessous. |
Valeurs pour 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 |
| Cocktails | App\Models\Menu\Combination |
| 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 |
18EmployésEMPLOYEES
name;active;surname;pin;username;email;nif;phone;notes;password;photo;identifier;permission_id;cashier_id;back_permission_id;extra_id;config;profile_idImportez des employés en masse.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| name | Obligatoire | Nom de l'employé. | Texte libre. |
| pin | Obligatoire | PIN d'accès au TPV iPad. | Valeur numérique. |
| permission_id | Obligatoire | Privilège de sécurité de l'app. | ID numérique. |
| active | Facultatif | Statut de l'employé dans l'effectif. | 0 (Inactif), 1 (Actif). |
| surname | Facultatif | Nom de famille. | Texte libre. |
| username | Facultatif | Identifiant d'accès au back-office web. | Texte court sans espaces. |
| password | Facultatif | Mot de passe secret pour le back-office. | Alphanumérique. |
| Facultatif | E-mail. | E-mail valide. | |
| phone | Facultatif | 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. | Nom du fichier et extension. |
| cashier_id | Facultatif | Caissier attribué par défaut. | ID numérique. |
| identifier | Facultatif | Identifiant de 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 | Pièce d'identité de l'employé. | Alphanumérique. |
| 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 |
19Mettre à jour des employésUPDATE EMPLOYEES
Met à jour les informations d'employés existants. Partez de la liste des employés exportée en CSV.
| En-tête exact | Exigence | Description | Informations supplémentaires |
|---|---|---|---|
| id | Obligatoire | Identifiant unique interne de l'employé. | ID numérique généré par REVO. |
| 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 |
