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.

Avant de commencer : il existe deux importateurs

Nouvel importateurEn-têtes libres · mappage des colonnes

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.

Ancien importateur CSVEn-têtes stricts

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.

Inventaire

9Ajouter de l'inventaireINVENTORY ADD
Ancien importateur CSVEn-têtes strictsitem_id;quantity;warehouse_id

Ajoute 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 exactExigenceDescriptionInformations supplémentaires
item_idObligatoireID des produits à approvisionner.ID numérique.
quantityObligatoireQuantité à AJOUTER au stock.Valeur numérique positive.
warehouse_idObligatoireID de l'entrepôt qui reçoit le stock.ID numérique.
Exemple CSV · Ajouter de l'inventaire
ABC
1item_idquantitywarehouse_id
21001501
31021501
41005002
10Établir/faire l'inventaireINVENTORY SET
Ancien importateur CSVEn-têtes strictsitem_id;quantity;warehouse_id;defaultQuantity;alert

Établit le stock exact de vos produits. Idéal après un comptage d'inventaire.

En-tête exactExigenceDescriptionInformations supplémentaires
item_idObligatoireID des produits.ID numérique.
quantityObligatoireQuantité physique exacte à établir.Valeur numérique qui remplacera la précédente.
warehouse_idObligatoireID de l'entrepôt.ID numérique.
defaultQuantityFacultatifQuantité de stock de référence / idéale.Valeur numérique.
alertFacultatifStock minimum pour recevoir une alerte de commande.Valeur numérique.
Exemple CSV · Établir l'inventaire
item_id100110
quantity100232
warehouse_id11
defaultQuantity200400
alert1020
11Déplacer l'inventaireINVENTORY MOVE
Ancien importateur CSVEn-têtes strictsitem_id;quantity;warehouse_id;to_warehouse_id

Déplace du stock entre entrepôts.

En-tête exactExigenceDescriptionInformations supplémentaires
item_idObligatoireID des produits à déplacer.ID numérique.
quantityObligatoireQuantité exacte à déplacer.Valeur numérique.
warehouse_idObligatoireID de l'entrepôt d'origine.Entrepôt qui soustrait (ID numérique).
to_warehouse_idObligatoireID de l'entrepôt de destination.Entrepôt qui ajoute (ID numérique).
Exemple CSV · Déplacer l'inventaire
item_id100102
quantity100100
warehouse_id11
to_warehouse_id22

Fournisseurs

12Importer des fournisseursVENDORS
Ancien importateur CSVEn-têtes stricts

Importez des fournisseurs en masse pour utiliser le module d'achats.

En-tête exactExigenceDescriptionInformations supplémentaires
nameObligatoireNom du fournisseur.Texte libre (3 caractères minimum).
addressObligatoireAdresse principale de facturation/livraison.Texte libre.
nifObligatoireNuméro fiscal.SIRET, numéro de TVA, etc.
cityFacultatifVille ou localité.Texte libre.
stateFacultatifProvince ou État.Texte libre.
countryFacultatifPays du siège du fournisseur.Texte libre.
postalCodeFacultatifCode postal.Alphanumérique.
webFacultatifSite web de l'entreprise.Format URL.
emailFacultatifE-mail pour les commandes.E-mail valide.
phoneFacultatifTéléphone de contact.Numérique.
notesFacultatifNotes et observations internes.Texte libre.
shouldBeNotifiedFacultatifNotifier le fournisseur en cas de changement d'état.1 (Notifier), 0 (Ne pas notifier).
Exemple CSV · Importer des fournisseurs
nameProveedor 1Proveedor 2
addressGran Via, 30Via Laietana, 222
nifA58818501B54416504
cityMadridBarcelona
stateMadridBarcelona
countryEspañaEspaña
postalCode2801008010
webwww.prov1.eswww.prov2.com
emailpedidos@prov1.esinfo@prov2.es
phone+34 912345678+34 931234567
notesAlimentaciónRefrescos
shouldBeNotified10
13Produits des fournisseursVENDORS ITEMS
Ancien importateur CSVEn-têtes stricts

Associe des produits à vos fournisseurs pour utiliser le module d'achats.

En-tête exactExigenceDescriptionInformations supplémentaires
vendor_idObligatoireID du fournisseur créé dans le système.ID numérique.
item_idObligatoireID du produit REVO qu'il fournit.ID numérique.
referenceFacultatifCode de référence du produit dans le catalogue du fournisseur.Alphanumérique.
packFacultatifUnités contenues dans chaque pack/carton d'achat.Valeur numérique.
costPriceFacultatifPrix de revient convenu.Utiliser le point pour les décimales.
unit_idFacultatifID de l'unité de mesure d'achat.ID numérique.
tax_idFacultatifID de la taxe sur les achats.ID numérique.
Exemple CSV · Produits des fournisseurs
vendor_id11
item_id100102
referenceREF-01REF-02
pack2424
costPrice0.250.30
unit_id11
tax_id22

Clients et cartes cadeaux

14Importer des clientsCUSTOMERS
Ancien importateur CSVEn-têtes strictsactive;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_notes

Importez des clients en masse.

En-tête exactExigenceDescriptionInformations supplémentaires
nameObligatoireNom du client ou raison sociale.Texte libre (3 caractères minimum).
address_countryConditionnelPays.Obligatoire si le numéro fiscal ou tout autre champ d'adresse est saisi. Code ISO 3166-1 alpha-2 (exemple : ES).
address_street_addressConditionnelAdresse (rue).Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi.
address_postal_codeConditionnelCode postal.Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi.
address_cityConditionnelVille ou localité.Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi.
address_stateConditionnelProvince ou État.Obligatoire si le numéro fiscal ou un autre champ d'adresse est saisi.
nifFacultatifNuméro fiscal.S'il est saisi, l'adresse devient obligatoire.
activeFacultatifÉtat du client.0 (Inactif), 1 (Actif).
emailFacultatifE-mail.Format d'e-mail valide.
phoneFacultatifTéléphone de contact.Doit inclure l'indicatif international pour être valide (ex. : +34644847774 OK, 644847774 NON OK).
languageFacultatifLangue préférée pour les communications.Code ISO (es, en, fr...).
nationalityFacultatifNationalité.Texte libre.
birth_dateFacultatifDate de naissance du client.Format strict : AAAA-MM-JJ.
genderFacultatifGenre.Male, Female ou Other.
allergiesFacultatifAllergies du client.IDs séparés par des points-virgules (ex. : 1;5;14).
webFacultatifSite web de l'entreprise.URL.
notesFacultatifNotes ou préférences du client.Texte libre.
extra_idFacultatifAttribution à un groupe de clients.ID numérique.
address_notesFacultatifNotes de livraison à domicile.Texte libre.
Exemple CSV · Importer des clients
nameHugo ReyesMaggie Greene
address_countryESES
address_street_addressGran Via, 30Calle de La Paz, 11
address_postal_code2801046003
address_cityMadridValencia
address_stateMadridValencia
nifA58818501V51218667
active11
emailhugo@mail.commaggie@mail.com
phone+34600123456+34600654321
languageesen
nationalityEspañolaBritánica
birth_date1980-05-151992-10-22
genderMaleFemale
allergies14
webwww.hugo.es
notesPlato especialMesa con vistas
extra_id12
address_notesDejar en recepcionLlamar al timbre
15Cartes cadeauxGIFT CARDS
Ancien importateur CSVEn-têtes strictscampaign_id;customer_id;active;uuid;total;balance;extra_attributes

Importez des cartes cadeaux en masse dans le back-office.

En-tête exactExigenceDescriptionInformations supplémentaires
uuidObligatoireCode d'identification unique de la carte.Peut contenir du texte et des chiffres.
totalObligatoireSolde initial.Doit être numérique.
activeFacultatifIndique si la carte est déjà opérationnelle.0 (Inactive), 1 (Active).
balanceFacultatifSolde restant réel.À remplir uniquement s'il diffère du total.
campaign_idFacultatifCampagne promotionnelle associée.ID numérique de la campagne.
customer_idFacultatifClient associé nominativement.ID numérique du client.
Exemple CSV · Cartes cadeaux
uuid00000123456TR1234567Pedro Gonzalez
total100.0050.0075.00
active111
balance100.0025.0075.00
campaign_id112
customer_id405
16Recharger des cartes cadeauxGIFT CARDS RELOAD
Ancien importateur CSVEn-têtes strictsuuid;reloadAmount

Importez des recharges sur les cartes cadeaux.

En-tête exactExigenceDescriptionInformations supplémentaires
uuidObligatoireCode exact de la carte cadeau existante.Alphanumérique.
reloadAmountObligatoireMontant à ajouter au solde actuel.Numérique avec point décimal.
Exemple CSV · Recharger des cartes
AB
1uuidreloadAmount
200000123456100.00
300000789100100.00

Tarifs et employés

17TarifsPRICE RATES
Ancien importateur CSVEn-têtes stricts

Pour importer des tarifs, accédez à : https://revoxef.works/thrust/prices/import

En-tête exactExigenceDescriptionInformations supplémentaires
IDObligatoireIdentifiant du produit de base.ID numérique.
priceable_idObligatoireIdentifiant du prix dans le produit référencé.ID numérique.
table_price_idObligatoireIdentifiant du tarif auquel le prix s'applique.ID numérique.
priceObligatoireMontant à établir pour le tarif indiqué.Prix avec le point pour les décimales.
priceable_typeObligatoireType d'élément de base.Utiliser exactement la valeur du tableau ci-dessous.

Valeurs pour priceable_type :

TypeValeur à saisir dans la colonne
ProduitsApp\Models\Menu\MenuItem
Produits de menuApp\Models\Menu\MenuMenuPivot
ModificateursApp\Models\Menu\Modifier
Format de venteApp\Models\Menu\ItemSellingFormatPivot
CocktailsApp\Models\Menu\Combination
Exemple CSV · Tarifs
ID100101102
priceable_id902870331
table_price_id222
price4.003.001.50
priceable_typeApp\Models\Menu\MenuItemApp\Models\Menu\MenuMenuPivotApp\Models\Menu\Modifier
18EmployésEMPLOYEES
Ancien importateur CSVEn-têtes strictsname;active;surname;pin;username;email;nif;phone;notes;password;photo;identifier;permission_id;cashier_id;back_permission_id;extra_id;config;profile_id

Importez des employés en masse.

En-tête exactExigenceDescriptionInformations supplémentaires
nameObligatoireNom de l'employé.Texte libre.
pinObligatoirePIN d'accès au TPV iPad.Valeur numérique.
permission_idObligatoirePrivilège de sécurité de l'app.ID numérique.
activeFacultatifStatut de l'employé dans l'effectif.0 (Inactif), 1 (Actif).
surnameFacultatifNom de famille.Texte libre.
usernameFacultatifIdentifiant d'accès au back-office web.Texte court sans espaces.
passwordFacultatifMot de passe secret pour le back-office.Alphanumérique.
emailFacultatifE-mail.E-mail valide.
phoneFacultatifTéléphone de contact.Numérique.
notesFacultatifNotes internes.Texte libre.
profile_idFacultatifProfil d'employé par défaut.ID numérique.
photoFacultatifAvatar.Nom du fichier et extension.
cashier_idFacultatifCaissier attribué par défaut.ID numérique.
identifierFacultatifIdentifiant de clé de sécurité du TPV.Valeur hexadécimale (NFC, QR...).
back_permission_idFacultatifNiveau de privilèges du back-office.ID numérique.
nifFacultatifPièce d'identité de l'employé.Alphanumérique.
Exemple CSV · Employés
nameFranLucía
pin11112222
permission_id12
active11
surnameMarjolaineKailey
usernameFranLucia
passwordpass123pass456
emailfran@mail.comlucia@mail.com
phone600111222600333444
notesEncargadoCamarera
profile_id21
photofran.jpglucia.jpg
cashier_id00
identifier1A2B3C4D5E6F
back_permission_id21
nif12345678A87654321B
19Mettre à jour des employésUPDATE EMPLOYEES
Ancien importateur CSVEn-têtes stricts

Met à jour les informations d'employés existants. Partez de la liste des employés exportée en CSV.

En-tête exactExigenceDescriptionInformations supplémentaires
idObligatoireIdentifiant unique interne de l'employé.ID numérique généré par REVO.
Exemple CSV · Mettre à jour des employés
id23
nameMariaPedro
pin11223344
permission_id12
active10
surnameGarciaLopez
usernamemariapedro
passwordmarIa24!pEdro24!
emailmaria@mail.compedro@mail.com
phone600999888600777666
notesBaja
profile_id21
photomaria.jpgpedro.jpg
cashier_id00
identifier7G8H9I0J1K2L
back_permission_id13
nif11111111C22222222D