With Revo XEF, you can import CSV files separated by ";". The first row must contain the header with the field names exactly as described below.

Before you start: there are two importers

New importerFree headers · column mapping

Used for Groups and Categories. Access it from Catalogue → Groups. To import groups, press Import. To import categories, first open the group you want to add them to and, from inside it, press Import. The system lets you map the columns, so the CSV does not need headers with exact names.

It is also used for modifier categories, from Catalogue → Modifiers.

Legacy CSV importerStrict headers

Used for all other imports. Access it from revoxef.works/tools/import. In this importer, the headers must match exactly the ones shown in each section. Price rates use their own URL.

If you start from the importer's template, delete the instruction lines before the header: the first row must be the header, with the fields separated by ;. You can delete any optional columns you do not need.

Inventory

9Add inventoryINVENTORY ADD
Legacy CSV importerStrict headersitem_id;quantity;warehouse_id

Adds stock to your products, especially useful the first time.

If you have several warehouses, repeat the product ID with different warehouse_id.

Exact headerRequirementDescriptionAdditional information
item_idRequiredIDs of the products to stock.Numeric ID.
quantityRequiredQuantity you want to ADD to stock.Positive numeric value.
warehouse_idRequiredID of the warehouse receiving the stock.Numeric ID.
CSV example · Add inventory
ABC
1item_idquantitywarehouse_id
21001501
31021501
41005002
10Set/count inventoryINVENTORY SET
Legacy CSV importerStrict headersitem_id;quantity;warehouse_id;defaultQuantity;alert

Sets the exact stock of your products. Ideal after an inventory count.

Exact headerRequirementDescriptionAdditional information
item_idRequiredProduct IDs.Numeric ID.
quantityRequiredExact physical quantity to set.Numeric value that overwrites the previous one.
warehouse_idRequiredWarehouse ID.Numeric ID.
defaultQuantityOptionalReference / ideal stock quantity.Numeric value.
alertOptionalMinimum stock to receive an order alert.Numeric value.
CSV example · Set inventory
item_id100110
quantity100232
warehouse_id11
defaultQuantity200400
alert1020
11Move inventoryINVENTORY MOVE
Legacy CSV importerStrict headersitem_id;quantity;warehouse_id;to_warehouse_id

Moves stock between warehouses.

Exact headerRequirementDescriptionAdditional information
item_idRequiredIDs of the products to move.Numeric ID.
quantityRequiredExact quantity to move.Numeric value.
warehouse_idRequiredSource warehouse ID.Warehouse that subtracts (numeric ID).
to_warehouse_idRequiredDestination warehouse ID.Warehouse that adds (numeric ID).
CSV example · Move inventory
item_id100102
quantity100100
warehouse_id11
to_warehouse_id22

Vendors

12Import vendorsVENDORS
Legacy CSV importerStrict headers

Import vendors in bulk to use the purchasing module.

Exact headerRequirementDescriptionAdditional information
nameRequiredVendor name.Free text (minimum 3 characters).
addressRequiredMain billing/delivery address.Free text.
nifRequiredTax ID.Company or personal tax ID, etc.
cityOptionalCity or town.Free text.
stateOptionalProvince or state.Free text.
countryOptionalVendor's country.Free text.
postalCodeOptionalPostal code.Alphanumeric.
webOptionalCorporate website.URL format.
emailOptionalEmail address for orders.Valid email.
phoneOptionalContact phone.Numeric.
notesOptionalInternal notes and remarks.Free text.
shouldBeNotifiedOptionalNotify the vendor of status changes.1 (Notify), 0 (Do not notify).
CSV example · Import vendors
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
13Vendor productsVENDORS ITEMS
Legacy CSV importerStrict headers

Links products to your vendors to use the purchasing module.

Exact headerRequirementDescriptionAdditional information
vendor_idRequiredID of the vendor created in the system.Numeric ID.
item_idRequiredID of the REVO product it supplies.Numeric ID.
referenceOptionalProduct reference code in the vendor's catalogue.Alphanumeric.
packOptionalUnits in each purchase pack/box.Numeric value.
costPriceOptionalAgreed cost price.Use a dot for decimals.
unit_idOptionalPurchase unit of measure ID.Numeric ID.
tax_idOptionalID of the purchase tax.Numeric ID.
CSV example · Vendor products
vendor_id11
item_id100102
referenceREF-01REF-02
pack2424
costPrice0.250.30
unit_id11
tax_id22

Customers and gift cards

14Import customersCUSTOMERS
Legacy CSV importerStrict headersactive;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

Import customers in bulk.

Exact headerRequirementDescriptionAdditional information
nameRequiredCustomer or company name.Free text (minimum 3 characters).
address_countryConditionalCountry.Required if the tax ID or any other address field is entered. ISO 3166-1 alpha-2 code (example: ES).
address_street_addressConditionalStreet address.Required if the tax ID or any other address field is entered.
address_postal_codeConditionalPostal code.Required if the tax ID or any other address field is entered.
address_cityConditionalCity or town.Required if the tax ID or any other address field is entered.
address_stateConditionalProvince or state.Required if the tax ID or any other address field is entered.
nifOptionalTax ID.If entered, the address becomes required.
activeOptionalCustomer status.0 (Inactive), 1 (Active).
emailOptionalEmail address.Valid email format.
phoneOptionalContact phone.Must include the international prefix to be valid (e.g. +34644847774 OK, 644847774 NOT OK).
languageOptionalPreferred language for communications.ISO code (es, en, fr...).
nationalityOptionalNationality.Free text.
birth_dateOptionalCustomer's date of birth.Strict format: YYYY-MM-DD.
genderOptionalGender.Male, Female or Other.
allergiesOptionalCustomer's allergies.IDs separated by semicolons (e.g. 1;5;14).
webOptionalCompany website.URL.
notesOptionalCustomer notes or preferences.Free text.
extra_idOptionalAssignment to a Customer Group.Numeric ID.
address_notesOptionalHome delivery notes.Free text.
CSV example · Import customers
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
15Gift cardsGIFT CARDS
Legacy CSV importerStrict headerscampaign_id;customer_id;active;uuid;total;balance;extra_attributes

Import gift cards in bulk into the back-office.

Exact headerRequirementDescriptionAdditional information
uuidRequiredUnique identification code of the card.Can contain text and numbers.
totalRequiredInitial balance.Must be numeric.
activeOptionalDefines whether the card is already active.0 (Inactive), 1 (Active).
balanceOptionalActual remaining balance.Fill in only if it differs from the total.
campaign_idOptionalLinked promotional campaign.Numeric campaign ID.
customer_idOptionalCustomer linked by name.Numeric customer ID.
CSV example · Gift cards
uuid00000123456TR1234567Pedro Gonzalez
total100.0050.0075.00
active111
balance100.0025.0075.00
campaign_id112
customer_id405
16Reload gift cardsGIFT CARDS RELOAD
Legacy CSV importerStrict headersuuid;reloadAmount

Import top-ups to gift cards.

Exact headerRequirementDescriptionAdditional information
uuidRequiredExact code of the existing gift card.Alphanumeric.
reloadAmountRequiredAmount to add to the current balance.Numeric, using a decimal point.
CSV example · Reload cards
AB
1uuidreloadAmount
200000123456100.00
300000789100100.00

Price rates and employees

17Price ratesPRICE RATES
Legacy CSV importerStrict headers

To import price rates, go to: https://revoxef.works/thrust/prices/import

Exact headerRequirementDescriptionAdditional information
IDRequiredBase product identifier.Numeric ID.
priceable_idRequiredIdentifier of the price within the referenced product.Numeric ID.
table_price_idRequiredIdentifier of the rate the price applies to.Numeric ID.
priceRequiredAmount you want to set for the indicated rate.Price with a dot for decimals.
priceable_typeRequiredBase item type.Use exactly the value in the table below.

Values for priceable_type:

TypeValue to enter in the column
ProductsApp\Models\Menu\MenuItem
Menu productsApp\Models\Menu\MenuMenuPivot
ModifiersApp\Models\Menu\Modifier
Selling formatApp\Models\Menu\ItemSellingFormatPivot
Mixed drinksApp\Models\Menu\Combination
CSV example · Price rates
ID100101102
priceable_id902870331
table_price_id222
price4.003.001.50
priceable_typeApp\Models\Menu\MenuItemApp\Models\Menu\MenuMenuPivotApp\Models\Menu\Modifier
18EmployeesEMPLOYEES
Legacy CSV importerStrict headersname;active;surname;pin;username;email;nif;phone;notes;password;photo;identifier;permission_id;cashier_id;back_permission_id;extra_id;config;profile_id

Import employees in bulk.

Exact headerRequirementDescriptionAdditional information
nameRequiredEmployee name.Free text.
pinRequiredAccess PIN for the iPad POS.Numeric value.
permission_idRequiredApp security permission.Numeric ID.
activeOptionalEmployee status on staff.0 (Inactive), 1 (Active).
surnameOptionalSurname.Free text.
usernameOptionalUsername for the web back-office.Short text without spaces.
passwordOptionalSecret password for the back-office.Alphanumeric.
emailOptionalEmail address.Valid email.
phoneOptionalContact phone.Numeric.
notesOptionalInternal notes.Free text.
profile_idOptionalDefault employee profile.Numeric ID.
photoOptionalAvatar.File name and extension.
cashier_idOptionalDefault assigned cashier.Numeric ID.
identifierOptionalPOS security key identifier.Hexadecimal value (NFC, QR...).
back_permission_idOptionalBack-office permission level.Numeric ID.
nifOptionalEmployee ID number.Alphanumeric.
CSV example · Employees
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
19Update employeesUPDATE EMPLOYEES
Legacy CSV importerStrict headers

Updates the information of existing employees. Start from the employee list exported as CSV.

Exact headerRequirementDescriptionAdditional information
idRequiredUnique internal identifier of the employee.Numeric ID generated by REVO.
CSV example · Update employees
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