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

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. The agent chooses the operator number independently from the range of received Terminals.

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.

<div style='color:red;font-weight:bolder;margin:20px;'>(!) The password should contain at least one number ('0'-'9') and at least one capital letter ('A'-'Z').</div> 
Press the button «Set up the password».

3) On the opened authorization page insert the login (the e-mail address) and the password. Then press the button «Enter».

4) On the opened page fill in the questionnaire.

(!) In the field «Agency code in TCH/ATSS» enter the TCH Agency code – 2 numbers, 3 letters in Cyrillic or Latin. E.g., «12АБВ».

Press the button «Send». A window for the confirmation code will pop up. A message from the MixVel Platform with a confirmation code will be sent to the specified email address.

5) Open the e-mail and copy the confirmation code. Insert the code into the window, which popped up after the 4th step. Then click the button «Send». The Questionaire will be added and it will be sent to the manager for confirmation. 

<div style='color:red;font-weight:bolder;margin:20px;'>(!) 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.</div>

6) After the Questionnaire confirmation, general test details for connecting the test MixVel API will be sent to the email specified during registration: api-test.mixvel.com and work in your personal account will be available.

7) After receiving your own test ClientID, fill in the Agency data in your personal account. Create «Point of sales», «Application», «Credentials».

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

9) 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» tab, in the upper right corner. 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 in domestic ABS».

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

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, Credentials (selecting the neutral session «TCH» and 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 your TCH Personal Account:

  • «Application for connecting POS to System 15 (MixVel)» - in the «Connection to MixVel» section.

  • «An application for a description of a virtual operator» (only one!) in the Mixvel system» in the «Connecting to Mixvel» section. 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.

Application form:

  • Airline name –

  • IATA code, home city –

  • Agency code –

  • Actual address of the point of sales –

  • Name of point of sales –

  • Point of sales code –

  • List of terminals –

  • List of virtual operators (4 digits) –

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 confirmation of the form by the support service, create a Structure Unit, Credential in the MixVel account (when filling out, select «Direct») and Application. For more details, see the «User Guide for the MixVel Boss Agency Account».

7) After confirming the «Direct session» by the MixVel support service and creating the «Application», the details for connecting to the direct session of the AK in the MixVel API will be sent to the email address specified during registration: 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.

Connecting to the Cashier module

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

  • «Application for connection/disconnection of POS to system 15» in the section «Organization of sales/applications in TCH/Connecting to Mixvel», by selecting POS (point of sales) from the drop-down list.

  • «Application for a description of cashiers/operators in domestic CRSs» in the section «Organization of sales / Applications to TCH / Description / redescription / exclusion of cashiers, operators and terminals», with a new personal number of an employee (cashier) in the Agency who will work in MixVel. In the subject of the application you must indicate «for Mixvel.Cashier», in the «Status» field select «Virtual booking».

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

2) Register and fill out a form in your MixVel Boss Personal Account at: lk.mixvel.com. For more details, see the «User Guide for the MixVel Boss Agency Account».

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

  • Point of sales;

  • Employee (Cashier);

    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. Each employee (cashier) is assigned a unique CashierID code.

  • Credentials.

    (!) When filling out the «Credentials» tab in the «Operator Code» field, you must indicate the same operator code (4 digits) that is indicated in the application for a description of the operator (cashier) at TCH.

4) 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.

5) To ensure work in a neutral session and obtain sales rights, submit an application in your TCH Personal Account: «Application for a description of cashiers/operators in Mixvel (system code 15)» in the section «Organization of sales / Applications in TCH / Connection to Mixvel». In the application, you must describe the unique code (CashierID) received when creating the «Employee» for the full name of your employee (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 pulled up.

6) To ensure a direct session and receive sales rights, wait for confirmation of the session from MixVel support.

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