Skip to content
ru
en

Installation Manual

Web Service User Manual Software "MixVel (Миксвел) e-commerce platform"

Date: 30.01.2023

System Requirements

Minimum system requirements:

  • The official developer-supported version of the Windows or MacOS operating systems with installed updates.

  • The web browser from the specified list with the installed updates:

    • Google Chrome;
    • Yandex Browser;
    • Mozilla Firefox;
    • Safari;
    • Microsoft Edge;
    • Opera.

  • Screen Resolution at least 1366х768 px.

  • Processor:

    • Intel Pentium Celeron 1.8 GHz and above;

    • Intel Core 2 Duo or Arm 2,4 GHz and above for MacOS.

  • Random Access Memory - at least 2 GB.

  • Internet access at a rate of at least 2 Mbit/s.

Connection to "MixVel (Миксвел) e-commerce platform"

The following options for connecting to the Software «MixVel e-commerce platform» are possible:

After registration the users will get accesses to the MixVel Agency online Account and to the MixVel API.

Description of the workflow:

NuGet packages for API MixVel

NuGet is a package manager for .NET. NuGet client tools provide the ability to create and consume packages. The NuGet Gallery is a central package repository used by all package authors and consumers.

NuGet packages for the MixVel API are updated when the product version changes at the PROD stand and are available at the following link: artifacts.mixvel.com/#browse/browse:nuget-public

After the release of 1.3.8, the MixVel Platform will no longer support NuGet packages.

Please consider this change when planning your integrations.

Getting Access to the DEMO-environment

To get access to the DEMO-environment it’s necessary to take the following steps:

1) Conclude an Agreement with «TCH» JSC, receive the Agency code. Consultation at TCH can be obtained by phone number: +7 (495) 788-12-15 or by email: sales@tch.ru.

2) Conclude an Agreement with «Mixvel» LLC. Consultation can be obtained by email: agents@mixvel.com.

3) Submit an application for accreditation to the accreditation department of «TCH» JSC (After acceptance of the application, the accreditation department assigns a test ERSP (Electronic Reservation Services Provider)). Consultation can be obtained by email: oaa@tch.ru.

4) Send an application letter (in free form) to describe the virtual Operator and Terminal for the demo-environment by email mkrtumova@tch.ru or kaub@tch.ru.

(!) Operator and terminal numbers are described as new ones, not previously used in any session. We recommend choosing the virtual operator value corresponding to the terminal number.

5) Submit a request to the MixVel Platform support service at: support@mixvel.com to receive a test ClientID.

Application form:

  • Agency code –

  • Number and date of the Agreement - Indicate the number of the agreement with Mixvel –

  • Legal name of the customer –

  • Site URL and/or name and type of web services –

  • Working environment – demo

  • Session (ATSS/TCP or direct, if the session is direct, then the airline must be specified) –

  • City –

  • Currency –

  • POS (Point of sales) –

  • ERSP (for ATSS/TCP session only) –

  • Range of Terminals –

  • Range of Operators –

    (!) The test ClientID will not be assigned without concluding an Agreement with «Mixvel» LLC.

To get access to the DEMO-environment it’s necessary to take the following steps:

1) To configure the agency details, you must register in your MixVel Boss Personal Account:

  • follow the link lk-test.mixvel.com;

  • on the authorization page click «Registration»;

  • as a login, enter the email address of the manager or employee authorized to manage the agency’s details;

  • choose the language (russian / english);

  • read the terms of the MixVel Boss Personal Account and tick the parameter «I agree with the Terms of the MixVel Boss Personal Account usage»;

  • click the button «To Register».

2) A message from the MixVel Platform will be sent to the specified email address about the need to create a password. Follow the link. Create a password.

(!) The password should contain at least one number ('0'-'9') and at least one capital letter ('A'-'Z').
Press the button «Set up the password».

3) On the authorization page lk-test.mixvel.com enter your login (email address) and password. Then click the «Login» button.

4) On the opened page fill in the agency questionnaire.

(!) The questionnaire is confirmed by the support service (support@mixvel.com) only if there is a signed NDA with Mixvel LLC, correctly filled in details and a current agency code.

For more details, see the «User Guide for the MixVel Boss Agency Account».

5) After confirming your application, you will be able to work in your MixVel Boss Personal Account for demo version.

(!) The questionnaire is confirmed by the support service (support@mixvel.com) only if there is a signed NDA with «Mixvel» LLC, correctly filled in details and a current agency code.

6) After receiving your own test ClientID, fill in the Agency data in your personal account. Create «Point of sales», «Application/URL», «Credentials». When filling in the Credentials, select in the «Session Type» field - TCH (neutral), in the «Working Method» field - Application.

7) After creating the «Application/URL», the details for authentication in the test MixVel API will be sent to the email address specified during registration: api-test.mixvel.com

8) Send an application letter (in free form) to TCH to the address: mkrtumova@tch.ru or kaub@tch.ru for a description of the 12-digit alphanumeric Application Code to the operator. The application code can be copied in the «Applications/URL» tab.

For questions about working in personal account and for consultations, please contact: support@mixvel.com.

Getting Access to the PROD-environment

Preliminary terms for getting access to the PROD-environment:

  • TCH accreditation, if the Agency works in a neutral session, obtaining work details (POS/ERSP);
  • having agreements with airlines in case the Agency is going to work in direct sessions (obtaining POS);
  • conclusion of an agency agreement with «Mixvel» LLC.

Connecting to the PROD environment:

1) To work in a neutral session (TCP session), submit standard applications through the TCH Personal Account for the provision of free (new) terminals, as well as operator logins linked to the existing details of the TCH POS and TCH ERSP:

  • «Application for description/exclusion of virtual technological address of terminal».

  • «Application for a description of virtual cashiers/operators in domestic ABS».

Applications are located in the «Sales Organization» tab, in the «Applications in the TCH»/«Description/re-description/exclusion of cashiers, operators and terminals» section.

Consultation with TCH can be obtained by sending a request to: info@tch.ru or by phone +7 (495) 660-19-72.

2) Submit a request to the MixVel Platform support service to receive a ClientID at: support@mixvel.com.

Application form:

  • Agency code –

  • Number and date of the Agreement - Indicate the number of the agreement with Mixvel –

  • Legal name of the customer –

  • Site URL and/or name and type of web services –

  • Working environment – prod

  • Session – TCH

  • City –

  • Currency –

  • POS (Point of sales) –

  • ERSP (for ATSS/TCH session only) –

  • Range of Terminals –

  • Range of Operators –

3) Register and fill out your MixVel Boss Personal Account at: lk.mixvel.com. Consultation can be obtained by sending a request to: support@mixvel.com.

4) After confirming the questionnaire, create in your personal account on the MixVel Platform: «Point of sales», «Application/URL», «Credentials». When filling in the Credentials, select in the «Session Type» field - TCH (neutral), in the «Working Method» field - Application. For more details, see the «User Guide for the MixVel Boss Agency Account».

5) After creating the «Application», a login and password for authentication to the MixVel API will be sent to the email address specified during registration: api.mixvel.com.

6) To ensure work in a neutral session and obtain sales rights, submit standard applications in the Personal Account of the TCH, the «Sales Organization» tab, the «Applications to the TCH» / «Connection to Mixvel» section:

  • «Application for connection/disconnection of the POS to System 15».

  • «An application for a description of a virtual operator (only one!) in the Mixvel (System 15)».

The operator’s login is the 12-digit application code from the personal account of the MixVel Platform.

Consultation can be obtained by sending a request to: support@mixvel.com.

Connect to a direct airline session:

1) Conclude an Agreement with the airline and receive a POS to work in the session of this airline.

2) Inform the airline of the ranges of terminals and virtual operators ranges on which the agency will work in its session.

(!) Airlines are provided with free, previously unused terminals and virtual operators.
(!) We recommend choosing the value of virtual operators that corresponds to the terminal numbers, for example: ABCD45 terminal – operator 0045).

3) Contact the airline so that it sends an application to «Mixvel» LLC, which indicates the point of sales (POS), terminals and virtual operators through which the agency will carry out work.

4) Submit an application to Support MixVel at: support@mixvel.com to receive a ClientID for a direct session with a specific airline (for each airline you must receive new ClientID).

Application form:

  • Agency code –

  • Number and date of the Agreement - Indicate the number of the agreement with Mixvel –

  • Legal customer name –

  • Site URL and/or name and type of web services –

  • Working environment – prod

  • Session – direct, (specify airline) –

  • City –

  • Currency –

  • POS –

  • ERSP (only for TCH session) –

  • Range of Terminals –

  • Range of Operators –

    «Mixvel» LLC will not fulfill the agency’s request without the airline’s request.

5) Register and fill out your MixVel Personal Account at: lk.mixvel.com.

6) After the questionnaire is confirmed by the support service, create in your personal account on the MixVel Platform: «Point of sales», «Application/URL», «Credentials». When filling in the Credentials, select in the «Session Type» field - TCH (neutral), in the «Working Method» field - Application. For more details, see the «User Guide for the MixVel Boss Agency Account».

7) After creating the «Application», the connection details will be sent to the email address specified during registration, and a request for access to a direct session of the airline will be automatically sent to the MixVel technical support service.

8) Once the direct session connection has been confirmed by MixVel support, you can start working in the MixVel API: api.mixvel.com

Getting Access to the Cashier module

Preliminary terms for getting access to the Cashier module:

  • TCH accreditation, if the Agency works in a neutral session, obtaining work details (POS/ERSP);
  • having agreements with airlines in case the Agency is going to work in direct sessions (obtaining POS);
  • conclusion of an agency agreement with «Mixvel» LLC.

The Cashier module is located at link: cashier.mixvel.com

To use the module, you must complete the following steps.

Connecting to the Cashier module, TCH session

(!) To work in a neutral session (TCH session), the cashier/operator must have a Certificate of completion of personnel training for ATSS.

1) To work in a neutral session (TCH session), submit an application through the TCH Personal Account:

  • «Application for connection/disconnection of POS to system 15»

The application is located in the «Sales Organization» tab, in the «Applications in TCH/Connection to MixVel» section.

POS should be selected from the drop-down list.

Consultation with TCH can be obtained by sending a request to: info@tch.ru or by phone +7 (495) 660-19-72.

2) If you do not have a MixVel Boss Personal Account yet, register and fill out a form in the MixVel Boss Personal Account at link: lk.mixvel.com. For more details, see the «User Guide for the MixVel Boss Agency Account».

After confirmation of the questionnaire by the MixVel support service, in your MixVel Boss Agency Account you should create:

  • Point of sales;

  • Employee (Cashier). When creating an Employee (Cashier), he is assigned a unique «Code» – CashierID;

    After creating an Employee (Cashier), a link to create a password will be sent to the created employee’s email. The employee needs to follow the link and create a password.

  • Credentials.

When filling out the Credentials tab, in the «Operator Code» field, the operator code (cashier’s personal number, 4 digits) must be specified.

(!) The operator code (personal number of the cashier, 4 digits) for each cashier (operator) must be specified as new, not previously used anywhere (in any session).

After creating the «Credentials», a request for a description of the created employee (cashier) will be automatically sent to the email of the technical support department: support@mixvel.com.

3) To ensure work in a neutral session (TCH Session) and obtain sales rights, submit an application in your TCH Personal Account:

  • «Application for a description of cashiers/operators in Mixvel»

The application is located in the «Organization of sales / Applications in TCH / Connection to Mixvel» section.

In the application, you must describe the unique code (CashierID) received in the MixVel Boss account when creating an «Employee» for the full name of your employee (cashier) with the corresponding operator code (cashier’s personal number, 4 digits).

In the subject of the application, you must indicate «for Mixvel.Cashier», in the «Status» field, select «Mixvel Cashier».

If the head of the Agency gives the right to an employee (cashier) to work at different accredited points of sale (POS), then for such an employee it is necessary to create several accounts in the TCH Personal Account and access details in the MixVel Boss Personal Account.

When entering the «Cashier» module, when selecting a specific point of sale, the corresponding combination of details will be installed.

Connection to the Cashier module, direct airline session

1) To work in a direct airline session, obtain (or use a previously received) airline POS.

2) If you do not have a MixVel Boss Personal Account yet, register and fill out a form in the MixVel Boss Personal Account at link: lk.mixvel.com. For more details, see the «User Guide for the MixVel Boss Agency Account».

After confirmation of the questionnaire by the MixVel support service, in your MixVel Boss Agency Account you should create:

  • Point of sales;

  • Employee (Cashier). When creating an Employee (Cashier), he is assigned a unique «Code» – CashierID;

    After creating an «Employee», a link to create a password will be sent to the created employee’s email. The employee needs to follow the link and create a password.

  • Credentials.

When filling out the Credentials tab, in the «Operator Code» field, the operator code (cashier’s personal number, 4 digits) must be specified.

(!) The operator code (personal number of the cashier, 4 digits) for each cashier (operator) must be specified as new, not previously used anywhere (in any session).

After creating the «Credentials», a request for a description of the created employee (cashier) will be automatically sent to the email of the technical support department: support@mixvel.com.

In response to your request, the MixVel technical support department will assign and notify you of a terminal for your employee to work in the airline’s direct session.

3) Contact the airline, provide the terminal assigned to the employee and the operator number (cashier’s personal number, 4 digits) specified by you in the MixVel Boss account when creating Credentials for the employee.

4) Ask the airline to send a «Company’s POS» application to the application processing system (APS). The application must indicate: the point of sale (POS), the terminal and the operator number assigned to the employee.

(!) MixVel LLC will not fulfill the agency’s request without the airline’s request.

5) After completing the application and providing access to the airline’s direct session, the administrator of the MixVel Boss personal account and the employee for whom access was issued will be informed by the MixVel technical support service.

If the head of the Agency gives the right to an employee (cashier) to work in sessions of several airlines, then for such an employee it is necessary to create several accounts in the TCH Personal Account and access details in the MixVel Boss Personal Account (one access for working in a session of one airline).

When entering the «Cashier» module, when selecting a specific point of sale, the corresponding combination of details will be installed.

For questions about working in MixVel Boss Personal Account and for consultations, please contact: support@mixvel.com.