Skip to content
ru
en

Work in the MixVel Environment

Work in the MixVel Environment

Requirements and Restrictions of Work in the MixVel Environment

At the current stage the agency should meet the following criteria to work in the MixVel environment:

  • The agency should be an active customer of JSC “Sirena-Travel” or should sign an agency service agreement with JSC “Sirena-Travel”;
  • To provide work in the Neutral Session (TCH Session) via MixVel, the agency should be accredited as an agency in TCH and have an accredited Internet Point of Sale (IPOS / ERSP). The agency should have an up-to-date description of the terminals and operators for performing secondary operations.

Registration in MixVel

Registration in MixVel is made via 3 steps:

  1. To get access to the MixVel Web Agency Online Account with limited functionality, and to fill out the MixVel questionnaire;

  2. Validation of the questionnaire by MixVel technologists and signing agreement for MixVel use;

  3. To get full access to the MixVel Web Agency Online Account.

To register in the MixVel environment the manager or another authorized employee on the agency’s side should go to https://mixvel.com and choose the option of registering their MixVel Web Agency Online Account in the section “Personal Account”. For registration it is enough to enter the e-mail, which will be later used as login for the MixVel Web Agency Online Account. After entering the email address, a link to specify the password will be sent.

The Agency gets access to the MixVel Web Agency Online Account with limited functionality. In this mode the manager or another authorized employee fills in the MixVel Web Agency Online Account questionnaire, which contains the legal entity data. After completing the questionnaire the data is sent to the MixVel technologists for review.

While waiting for the questionnaire validation, the manager or the authorized employee of the agency can read the documentation on MixVel API, а также оценить функциональные возможности MixVel API and can discover the MixVel API functionality through Swagger (the User Interface for sending requests) which is connected to the DEMO Environment.

After validation of the data which was provided by the agency in the questionnaire, MixVel managers will contact the manager or the authorized employee of the agency to sign the agreement for MixVel access, and full access to the MixVel Web Agency Online Account will be provided.

Export of the Agency’s Questionnaire

In order simplify switch from DEMO to PROD environments (and vice versa), it’s possible to export the data from the questionnaire to the particular stand.

Picture 2. Page "My profile”

Export of the questionnaire is available from the page “My profile” (the button in the screen’s upper right corner with the profile name on it) by the button (1) “Export data” (“Экспортировать данные”) - see the picture 2. After clicking the button, the Agency questionnaire data will be copied to the clipboard.

While exporting the questionnaire data from the DEMO Environment to the Production Environment, it’s necessary to press the button “Import the Data” (“Импортировать данные”) as shown in the picture 3 below.

Picture 3. The Questionnaire

MixVel Web Agency Online Account

Main Page and Main Menu

The work with MixVel Web Agency Online Account starts after authorizing at the Main Page.

The Main Page consists of 2 tabs:

  1. Product Release Notes;

  2. Documentation.

The “Product Release Notes” tab – “Релизы продукта” (see Picture 4) contains information on the previous and current MixVel Web Agency Online Account releases with information on the implemented functionality.

The “Product Release Notes” tab

The “Documentation” tab (see Picture 5) contains all documents related to the MixVel environment:

  • user Manuals,

  • XSD Schemas,

  • reference to the request sending interface (Swagger).

This documentation is updated on a regular basis.

Picture 5. The “Documentation” tab

To access the MixVel Web Agency Online Account functionality, we use the Application Main Menu (see Picture 6). For this reason, one needs to press the button in the left upper part of the screen.

Picture 6. The Application Main Menu

The following features are available in the current release:

  1. Sales Network – Management of the Agency’s structure in the MixVel environment: creation of Structure Units, Credentials, Applications and Users;

  2. Support – a form of appeal to the technical support of the MixVel Team in case of any problems in work;

  3. Language Switch Button – (Switch to English / Переключиться на русский) is used to switch the MixVel Web Agency localization. When working in the Russian version of the Application, the user can switch to English, and when working in the English version - to the Russian one.

Sales Network

To work in the MixVel environment, the Agency sets its structure within the “Sales Network” functionality, which describes its Structure Units, session Credentials, Applications and Users.

In order to set up the Sales Network, it’s necessary to perform the following steps:

Step 1. Creation of Structure Units;

Step 2. Creation of Credentials;

Step 3. Creation of Applications.

After performing these steps, the Login and the Password for work with MixVel API will be delivered to the e-mail address, which was indicated by the User at registration.

Structure Units Creation

Structure Units are the basic structural element in the MixVel environment. They allow the agency to run different sessions within one entity.

Picture 7. The «Structure Unit» tab

To set up a new Structure unit one needs to click the tab “Structure Units” (“Подразделения”) of the “Sales Network” page, then – to click “Create” button (see Picture 7) on the “Structure Units” tab. After clicking the “Create” button the window for creating a new Structure Unit will appear.

Data Tab

Picture 8. The Tab «Data» (Structure Unit)

To set up a new Structure Unit one needs to specify the following data on the “Data” tab (see Picture 8):

  1. Structure Unit name in the MixVel environment (free text; up to 70 characters); this field is obligatory.

  2. Structure Unit Code – it’s created automatically.

  3. Address. If the agency is a Russian Federation resident, then the address is collected from the drop-down list. The drop-down list opens at entering the first letters of the region name, city / town name, house number etc. If the agency is a non-resident, then one needs to tick “Address outside RF” (“Адрес за пределами РФ”) and fill in the address as a free text.

  4. Office number (if available).

  5. Contact phone. If “the Russian Federation” is ticked in the questionnaire (see Picture 3), then masked input automatically contains 11 symbols for the contact phone. Otherwise – one can fill in up to 30 symbols including letters, “space”, “-”, “*” and round brackets.

  6. E-mail address; regular verification of the e-mail address correctness is done; this field is obligatory.

  7. Authorized currencies (selection from different currencies); it’s possible to point out “All” currencies.

  8. The default currency (one currency should be chosen out of all the authorized currencies).

When setting up a new Structure Unit, the MixVel Web Agency Online Account will automatically appoint the Structure Unit Code for the new Structure Unit. If necessary, the agency can redefine the last 5 characters of the code (the valid format – 5 Latin characters (letters and numbers, without “O” and without special symbols).

It’s necessary to choose the currencies which will be authorized for the Structure Unit, and it should be ticked as a default one. If there is no request for particular currency from the User or from the Application, the default currency will be applied for the Structure Unit.

After filling in all the fields it’s necessary to press the button “Create Structure Unit”.

Applications tab

In the current version of the MixVel Web Agency Online Account the description of Applications is available at the tab Sales Network/Applications (see the step Creation of Applications).

If you want to add the Application to an existing Structure Unit, then step 1 can be omitted.

The Users tab

The current version of the MixVel Web Agency Online Account does not support the function to update data about the Users.

To delete the record of a particular Structure Unit one needs to click the trash bin icon on the tab “Structure Unit” (see picture 7). The trash bin icon is located on the right of the chosen Structure Unit name and location.

It’s impossible to delete a Structure Unit if any Application is attached to it (see the step Creation of Applications).

Session Credentials Creation

Picture 9. The Tab «Session Credentials»

The way to set up the Credentials (step 2) is the following: from the tab “Sales Network” one needs to switch to the tab “Session Credentials” (see pictire 9) and to click the button “Add”, that’s how the window for entering the credentials will open (see picture 10).

Picture 10. The Tab «Creation of a Session Credentials»

In the current version of the MixVel Web Agency Online Account the agency can connect to both Neutral and Direct Sessions of the airlines.

Creation of a Neutral Session Credentials

Picture 11. Creation of a Neutral Session Credentials

To set up Credentials for a Neutral Session (see picture 11) one needs to take the following steps:

  1. To enter the name for the Session (information for internal use within the agency).

  2. To choose the session type from the drop-down list (in this case it’s TCH Session). In the field “Session Type” it’s attached automatically.

  3. To enter the agency code. The agency code should consist of two Arabic numerals and three Cyrillic letters. The use of the letters of the Latin alphabet in this version is not allowed. You start with numbers, and then you start with letters.

  4. To enter Sirena Client ID (it’s provided by JSC “Sirena-Travel”).

  5. To choose the POS and Internet POS codes from the drop-down menu. In the current version the POS and Internet POS codes are provided by the TCH.

  6. After filling in the fields one needs to click the button “Add the Credentials”.

Creation of a Direct Session Credentials

Picture 12. Creation of a Direct Session Credentials

ДTo set up Credentials for a Direct Session (see picture 12) one needs to take the following steps:

  1. To enter the name for the Session (information for internal use within the agency).

  2. To choose the session type from the drop-down list (in this case it’s a Direct Session).

  3. To enter the agency code. The agency code should consist of two Arabic numerals and three Cyrillic letters. The use of the letters of the Latin alphabet in this version is not allowed. You start with numbers, and then you start with letters.

  4. To choose the code and the airline name from the offered in the drop-down menu within the field “Choose the Session”. The list will drop down after entering the first letter of the airline code (a Latin letter) or the first letter of the airline company name (a Russian letter for Russian airlines, and a Latin letter – for foreign airlines). The field will appear after ticking the Session type as “Direct”.

  5. To enter Sirena Client ID (it’s provided by JSC “Sirena-Travel”).

  6. To choose the POS code from the drop-down menu. In the current version the field Internet POS code is omitted.

  7. After filling in the fields one needs to click the button “Add the Credentials”.

After clicking the button “Add the Credentials” the session will be sent to the MixVel Technical support for validation.

The Direct Session status can be noticed by the element’s color (as seen in the pictures below).

Picture 13. The Session is on Validation

The element’s grey color points out that the added Direct Session is being validated.

Picture 14. The Session is Declined

If any mistake is detected in the Session Credentials, then the element will be colored red. It means that validation is not passed, and the Session is declined. The agency needs to double check the Session Credentials and to send a new request for validation. One can pass to the Session Credentials by clicking the name of the declined session.

Picture 15. The Session is Approved

If Validation was passed successfully, then the element will be colored green.

It’s not possible to update any Credentials of an approved Session except the name. In order to delete a Session, one needs to click the trash bin icon which is located on the right from the name of the Session Credentials (see Picture 9).

It’s impossible to delete a Session if there is any Application attached to it (see Application Creation).

Application Creation

Picture 16. The Tab «Applications»

To set up the Credentials (Step 3) one needs to pass from the tab “Sales Network” to the tab “Applications” (see picture 16), and to click “Add”. Afterwards the tab for entering the data will open (see picture 17).

Picture 17. The Tab «Data» (Attachment)

To set up Application one needs to fill in the following attributes in the window “Data”:

  1. The name of the application which will be used within MixVel (up to 70 symbols). It’s not possible to apply any other special symbols except "-".

  2. The agency’s application name (in free form, up to 50 symbols).

  3. Application Type (is chosen from the drop-down list).

  4. If the application type is a web site, then the Application URL is filled in (free text, up to 50 alpha-numeric symbols).

  5. Session type. It’s chosen from the drop-down list. The TCH Session is chosen by default. If a TCH session is chosen, then one needs to settle the description of the Application by passing to the User Account in TCH by the link “Describe the application in TCP”.

  6. The Name of the Session which was indicated at the 2d step (see – Creation of Session Credentials). To choose one from the drop-down list.

  7. The name of the structure unit settled at the step 1 (see – Creation of Structure Units). To choose one from the drop-down list.

  8. The Application Code – automatically generated text. It should comprise only Latin letters and numbers (up to 12 symbols). The application code is unique in the MixVel environment.

The other fields are not obligatory.

The Application is created by click to the button “Add an Application”. The newly-created Application gets the Application Code (see above) and appears in the general list of Applications.

A quick link to the portal TCH Connect is available for the agency to describe the Application for a Neutral Session usage. The agency needs to click the button “Describe Application in TCH”.

After the Applications created, the entry login and password are sent to the e-mail which was indicated at creation of the MixVel Web Agency Online Account. They are used for entry to the MixVel API.

Picture 18

For further password reset one needs to go to the tab “access” (see picture 18) and click “Password reset”, and then copy it to the clipboard.

Disclaimer! The logins and the passwords are available for being copied before the form is closed. After the form is closed, it’s only possible to reset the current password and to obtain a new one.
It’s important!

  • Only one Session can be attached to one Application.

  • One structure unit may have several Applications.

  • One Application may be linked to an only one unit.

An existing Application may be removed / deleted from the Agency unit at any time.

To update the data for the Application one should click first to the corresponding line in the list of applications, and then – click to the castle icon in the lower left corner of the opened window. And after it one should click the button “update the application”.

To delete the application one needs to click on the icon with a trash bin to the right of the Application in the general list.

The Users

The User is the MixVel entity, which ensures work of the MixVel Web Operator (Cashier Account) for the agency.

A separate account should be created for each employee who will use the MixVel Web Operator (Cashier Account).

In the current version of the MixVel Web Agency Online Account the function to add Users and update of data on the Users is not available.

Technical support

In case of difficulties whille using the MixVel Web Agency, any problems with MixVel API or any other questions about the MixVel environment, the User can apply to the Support.

The MixVel Support Interface Page is designed as an application form with the option to attach files.

Picture 19. The Tab for Support Requests

Further contacts to the Support are done via email.