Skip to main content

Beauty Advisor - mass imports

Screenshot_2020-04-29_at_19.12.41.png Getting started

Using the administration panel, you can perform:

  • mass update of BA clients
  • mass import of new BA clients
  • mass import of new BA consultants
  • mass update of BA consultants
  • mass customer anonymization

You can perform all types of imports in the Import / Export> Import section Dedicated descriptions are included in the following chapters of the article.

info2.svg  RememberMass import – an operation that allows the to collective add new data to the administration panel as well as modify and delete the existing data. The operation is initiated by loading one import file or a set of appropriately constructed import files in the indicated location in the administration panel.

info2.svg  RememberFor basic information on BA commerce, see the article Beauty Advisor - getting started.

POWERPNT_zgpJM48J3S.png

Import / Export> Import section

Table of Contents:

 


 

Screenshot_2020-04-29_at_19.12.41.png Description of “Import” tab

Below you will find a description of the possible actions in the Import tab.

Import_tab_in_the_Import___Export__Import_section.png

Import tab in the Import / Export> Import section

 

  • File – option to choose an import file from the local disk. The file format
    depends on the type of import performed.
  • Type – specification of the type of import performed.

  • Options – option to perform a test import. The operation will not end with data import, but you will receive a report that allows to verify whether the import result is correct.

  • Import file – click the button to start mass import. Selecting this button and confirming the form will start data processing.

All types of imports described in the current article can be performed by following these steps:

  1. Select the import file from the local disk.
  2. Indicate the type of import.
  3. Press the Import file button.

 


 

Screenshot_2020-04-29_at_19.12.41.png Mass update of BA clients

Due to the current limitations in the import of Excel files, you can perform two types of import (full version import and lite import). Each type is described in the following section. The current import is limited to approximately 100,000 rows. This limit will be extended with further updates.

info2.svg  RememberImport is possible only for users of the administration panel assigned to one of the following groups:
- Administrator
- Super Administrator
- Root
More information on the administration panel user groups is available in the article User groups in the administrative panel

Full import version

The full import version (import type: “Customer contact database for Consultant update”) contains all the updateable data about the BA customer. Below you will find descriptions of the columns in the import file.
 

Widok_zawartos_ci_pliku_importowego__Customer_contact_database_for_Consultant_update_.jpg

Import file content (file type) : „Customer contact database for Consultant update”

info2.svg  RememberThe fields marked with an asterisk (*) are mandatory fields. If the field remains empty, the import of the given record will return an error.

info2.svg  RememberEmpty values in the optional fields will delete the currently existing data in the administration panel, leaving the field empty.

info2.svg  RememberIf the system detects a row with a new BA client in the imported file during import, the import of the given record will return an error.

All the parameters described below modify the data in the tab Customer Data, located in the customer data preview. For details about the view, see Beauty Advisor > Contacts - viewing and managing BA clients.

  • LAST_CUSTOMER_CODE - customer’s FIDEN2 card number.
  • FIRST_NAME * - BA customer first name.
  • NAME * - BA customer's last name.
  • PHONE * - BA customer’s phone number with country code (configuration is described in the article Beauty Advisor - system settings).
  • ACTUAL_SHOP * - POS store number assigned to the BA customer. For more information about stores, see the article Beauty Advisor > POS retail – store management.
  • RANKING * - A range of BA customers ranking (1-999999). You can find a description of this parameter in Beauty Advisor > Contacts - viewing and managing BA clients.
  • CITY - city.
  • POSTAL_CODE - customer's postal code.
  • STREET1 - street.
  • HOUSE_NUMBER - house number.
  • BOX_NUMBER - premises number.
  • EMAIL - BA customer email address.
  • DATE_BIRTH - date of birth of BA customer.
  • LPD_BA - date of the last purchase made through BA channel.
  • LPD_ECOMMERCE - date of the last purchase from Yves Rocher online store.
  • LPD_RETAIL - date of the last purchase made at Yves Rocher store using the customer’s loyalty card.
  • LA - the value of the Last activity filter. For details on the filter, see Beauty Advisor - getting started.
  • ID - unique BA customer identification number. Application generated parameter.

All the parameters below contain information on customer orders made in stationary stores.
Values are created and overwritten only during mass import of BA customers, which represents information stored in the
Retail shopping stats tab (details about the tab are available in the article Beauty Advisor > Contacts - viewing and managing BA clients. All fields are optional.

  • TOP1_TO_PRODUCT
  • TOP1_TO_PRODUCT_LABEL
  • TOP1_TO_LPD_TXT
  • TOP1_TO_PRODUCT_PRICE
  • TOP1_TO_TO
  • TOP1_TO_QT

caution.svg  NoteThe value of the "ID" column cannot be modified. "ID" is a key parameter to identify the client.
Based on this parameter, the application performs appropriate operations on data.

Specification of the import file

  • file format: .xlsx
  • file name: any name

Lite version

Import in lite version (import type: “Customer contact database for Consultant
update (lite version) “) allows for update of four BA client data. Below you will find descriptions of the columns in the import file.

Widok_zawartos_ci_pliku_importowego__Customer_contact_database_for_Consultant_update__lite_version__.png

Import file content (file type): "Customer contact database for Consultant update (lite version)"

info2.svg  RememberThe fields marked with an asterisk (*) are mandatory fields. If the field remains empty, the import of the given record will return an error.

info2.svg   RememberEmpty values in the optional fields will delete the currently existing data in the administration panel, leaving the field empty.

info2.svg   RememberIf the system detects a row with a new BA client in the imported file during import, the import of the given record will return an error.

caution.svg  NoteThe value of “ID” column cannot be modified. “ID” is a key parameter to identify the client. Based on this parameter, the application performs appropriate operations on data.

Specification of the import file

  • file format: .xlsx
  • file name: any name

 


 

Screenshot_2020-04-29_at_19.12.41.png Import of new BA clients

With the type of import: “Customer contact database for Consultants – import XLSX” you can import new BA clients that do not exist in the admin panel.

info2.svg  RememberImport is possible only for users of the administration panel assigned to one of the following groups:
- Administrator
- Super Administrator
- Root
More information on the administration panel user groups is available in the article User groups in the administrative panel.

info2.svg   RememberIf, during import, the system detects a row in the imported file containing the BA client that exists in the administration panel, then the import of a given record will return an error.

The content of the imported file is identical to the mass update of BA clients in the w Full import version.

caution.svg  NoteThe import file cannot contain a column named ID, because it is a parameter generated automatically by the application when performing import. 

Specification of the import file

    • file format: .xlsx
    • file name: any name

 


 

Screenshot_2020-04-29_at_19.12.41.png Mass update of BA consultants

Import type: “POS Users” allows modification of data of BA consultants, who are in the administration panel. Below you will find descriptions of the columns in the import file.

info2.svg   RememberImport is possible only for users of the administration panel assigned to one of the following groups:
- Super Administrator
- Root
More information on the administration panel user group is available in the article User groups in the administrative panel

info2.svg   RememberIf, during import, the system detects a row in the imported file containing a new BA consultant, then the import of a given record will return an error.

 

Widok_zawartos_ci_pliku_importowego__typ_pliku__POS_Users.jpg

Import file content (file type): “POS Users”
  • id - A unique customer identification number generated by the application.
  • first_name - BA consultant first name.
  • last_name - BA consultant last name.
  • email - BA consultant e-mail address.
  • mobile - BA consultant phone number.
  • active - a field defining the activity of the BA consultant’s account in the administration panel. The value “1” means an active account, and the value “0” - inactive.
  • last_login_date - the last date and time when the BA consultant logged in to the administration panel. The parameter value is generated by the application. Import does not overwrite the values in the administration panel.
  • group_name - group to which the BA consultant is assigned in the administration panel. More information on the administration panel user groups is available in the article User groups in the administrative panel
  • pos_reports_number - POS store number assigned to the BA consultant, used for reporting purposes.
  • ba_pos_number - POS number assigned to the BA consultant in the administration panel.
  • default_altshop_id - unique identification number of the default altshop, assigned in the administration panel to the BA consultant. For more information on altshop, see Alt shops - Introduction

caution.svg   NoteThe value of “ID” column cannot be modified. “ID” is a key parameter to identify the client. Based on this parameter, the application performs appropriate operations on data.

Specification of the import file

  • file format: .xlsx
  • file name: any name


 

Screenshot_2020-04-29_at_19.12.41.png Import of new BA consultants

Type of import: “Admin user import XLSX” allows to import of new BA consultants. The description of the imported data contained in the file is presented below.

info2.svg   RememberImport is possible only for users of the administrator panel who have been assigned to the group: “Root”. More information on the administration panel user groups is available in the article User groups in the administrative panel


Widok_zawartos_ci_pliku_importowego__Consultant_import__.png

Import file content (file type): "Admin user import XLSX"
  • NAME - BA consultant first name.
  • SURNAME - BA consultant last name.
  • SHOP_ID - shop to which the consultant is assigned.
  • EMAIL_ADRES - BA consultant email.
  • MOBILE_NUMBER - BA consultant telephone number with country code telephone.
  • LANGUAGE - language in which the BA consultant will use the administration panel.
  • BA_GROUP - group to which the consultant is assigned. Type of import: “Admin user import XLSX” allows to assign only one of the following groups:
    • Beauty Advisor
    • Beauty Advisor CC
    • Beauty Assistant Franchise
    • Super Beauty Advisor
    • Super Beauty Assistant Franchise
      The administration panel user groups are described in the article
      User groups in the administrative panel.
  • DEFAULT_ALTSHOP - default altshop assigned to the customer.  More information on altshops is available in the article Alt shops - Introduction

info2.svg   RememberIf, during import, the system detects a row in the imported file containing a BA consultant that exists in the administration panel, the import of a given record will return an error.

info2.svg   RememberImport type: "Admin user import XLSX" only allows you to import employees who are assigned to one of the following groups:
- Administrator
- Super administrator
- Root

Specification of the import file

  • file format: .xlsx
  • file name: any name

 

Screenshot_2020-04-29_at_19.12.41.png Import of BA customer anonymization

Import type "Anonymization of the customer contact database for Consultants" allows to import of customer internal IDs located in the .xlsx file and anonymizes all of them in the BA platform. This import triggers the BA customer anonymization, which also can be done manually in the:

BA customer profile > GDPR > Anonymize account (forget customer)

The reason for the anonymization in the BA > Anonymized contacts after the import is set to "Anonymization import".

info2.svg   RememberImport type: "Anonymization of the customer contact database for Consultants" can be used by users who are assigned to one of the following groups:
- MC business admin
- Administrator
- Super Administrator
- Root
The import is not limited to the users assigned POS, so users having one of the above-mentioned groups will be able to anonymize all BA users without any restrictions.

POWERPNT_cQf9DchS5k.png
Visualization of the example BA customer anonymization xlsx file

caution.svg  NoteThe anonymization process cannot be undone after the initiation. Please make sure that the imported file has the correct customers.

Specification of the import file

  • file format:
    • .xlsx
    • .csv, delimiter: ; and enclosure: " , encoding: UTF-8.
  • file name: any name