Интеграция
Подключение
Для передачи информации по данным билетной системы или СКУД, необходимо отправить запрос в RabbitMQ используя свои учетные данные (логин,пароль,токен) от системы в роут вида capital.instance.{instance_key}.
Ip для подключения к RabbitMQ– 213.159.207.2
Порт – 5672
Exchange name для передачи данных – income
Routing key – capital.instance.instance_key, где instance_key равен ключу инстанса.
Шаблон входящих данных:
{
"time":"2018-06-14 11:31:34", // Дата события
"data": { }, // Данные
"token":"XXXXXXXXXXXXXXXXXXX", // Токен
"event_name":"YYYYYYY" // название события
}
События и формат данных для билетных систем
1.Клиенты: event.ticket.client_update
Функция event.ticket.client_update предназначена для создания и изменения клиента системы.
Таблица 1 – Формат данных функции event.ticket.client_update
Параметр | Тип | Описание | Значение |
id | int | Идентификатор клиента во внешней системе. Параметр обязательный для заполнения. | —— |
first_name | string | Имя клиента. | —— |
last_name | string | Фамилия клиента. | —— |
middle_name | string | Отчество клиента. | —— |
telephone* | string | Номер телефона клиента. Телефон должен начинаться с префикса «7». Параметр обязательный для заполнения в случае если не указан Email. | —— |
birthday | string | Дата рождения. Формат даты: «гггг-мм-дд». | —— |
Email* | string | Электронная почта клиента. Параметр обязательный для заполнения в случае если не указан Телефон. | —— |
gender | bool | Пол клиента. | True – Муж; False – Жен. |
Рекомендуется заполнять максимальное количество полей в карточках клиентов, так как это влияет на эффективность работы Системы.
telephone*, Email* - для создания клиента “Неизвестный” (для офлайн продаж), поля telephone и email необходимо оставить пустыми (не "null"), то есть в сообщении данные поля должны присутствовать, но не иметь значения. Пример сообщения:
{
"id": 100000,
"first_name": null,
"last_name": "Неизвестный",
"middle_name": null,
"telephone": "",
"birthday": "1980-10-10",
"email": "",
"gender": false
}
2. Участники событий
2.1. Клубы: event.ticket.club_change
Функция event.ticket.club_change предназначена для создания и изменения данных о командах и клубах в соответствующих справочниках системы.
Таблица 2 – Формат данных функции event.ticket.club_change
Параметр | Тип | Описание |
id | int | Идентификатор команды или клуба во внешней системе. Параметр обязательный для заполнения. |
name | string | Наименование команды или клуба. Параметр обязательный для заполнения. |
description | string | Дополнительное описание. |
2.2. Сборные: event.ticket.national_team_change
Функция event.ticket.national_team_change предназначена для создания и изменения данных о сборных командах в соответствующем справочнике системы.
Таблица 3 – Формат данных функции event.ticket.national_team_change
Параметр | Тип | Описание | Значение |
id | int | Идентификатор сборной команды во внешней системе. Параметр обязательный для заполнения. | —— |
sport_id | int | Идентификатор вида спорта. Параметр обязательный для заполнения. | Возможные значения параметра представлены в Приложении №1 |
country_id | int | Идентификатор страны сборной. Параметр обязательный для заполнения. | Возможные значения параметра представлены в Приложении №2 |
gender | bool | Пол сборной. Параметр обязательный для заполнения. | True – Муж; False – Жен. |
3. Объекты: event.ticket.object_update
Функция event.ticket.object_update предназначена для создания и изменения данных об объектах и стадионах в соответствующих справочниках системы.
Таблица 4 – Формат данных функции event.ticket.object_update
Параметр | Тип | Описание |
id | int | Идентификатор объекта или стадиона во внешней системе. Параметр обязательный для заполнения. |
name | string | Наименование объекта. Параметр обязательный для заполнения. |
coord_lat | float | Координаты объекта по широте. |
coord_lon | float | Координаты объекта по долготе. |
scheme | string | Схема объекта в используемом формате БС/СКУД (xml,json). |
4. Кассы: cashbox.update
Функция cashbox.update предназначена для создания и изменения данных справочника кассы.
Таблица 5 – Формат данных функции cashbox.update
Параметр | Тип | Описание |
id | int | Идентификатор кассы во внешней системе. Параметр обязательный для заполнения. |
name | string | Наименование кассы. Параметр обязательный для заполнения. |
5. Юридические лица: event.ticket.partner_update
Функция cashbox.update предназначена для создания и изменения данных справочника кассы.
Таблица 6 – Формат данных функции event.ticket.partner_update
Параметр | Тип | Описание |
id | int | Идентификатор юридического лица во внешней системе. Параметр обязательный для заполнения. |
name | string | Наименование юридического лица. Параметр обязательный для заполнения. |
full_name | string | Полное наименование юридического лица. |
telephone | string | Номер телефона юридического лица. Телефон должен начинаться с префикса «7». |
string | Электронная почта клиента юридического лица. | |
site | string | Сайт организации. |
inn | string | ИНН код организации. |
kpp | string | КПП код организации. |
ogrn | string | ОГРН код организации. |
okved | string | Вид деятельности организации. Если значений несколько, они должны быть записаны через запятую. |
address_full | string | Полный адрес организации. |
coord_lat | float | Координаты организации по широте. |
coord_lon | float | Координаты организации по долготе. |
6. События: event.ticket.event_update
Функция event.ticket.event_update предназначена для создания и изменения данных о событиях в системе.
Таблица 7 – Формат данных функции event.ticket.event_update
Параметр | Тип | Описание | Значение |
id | int | Идентификатор события во внешней системе. Параметр обязательный для заполнения. | —— |
name | string | Наименование события. | |
begin_datetime | string | Дата и время начала события. Формат даты: «гггг-мм-дд чч:мм:сс». Параметр обязательный для заполнения. | —— |
end_datetime | string | Дата и время окончания события. Формат даты: «гггг-мм-дд чч:мм:сс».Параметр обязательный для заполнения. | —— |
begin_pass_datetime | string | Дата и время начала разрешенного прохода на событие. Формат даты: «гггг-мм-дд чч:мм:сс». Параметр обязательный для заполнения. | —— |
end_pass_datetime | string | Дата и время окончания разрешенного прохода на событие. Формат даты: «гггг-мм-дд чч:мм:сс». | —— |
object_id | int | Идентификатор объекта внешней системы. Параметр обязательный для заполнения. | —— |
organizer | int | Идентификатор организатора во внешней системе. Параметр обязательный для заполнения. | —— |
event_type_id | int | Тип события. Параметр обязательный для заполнения. | 1 – обычное; 2 – групповое; (для абонементов) 3 – пакетное |
participations | array | Массив объектов участников. Описание объектов массива представлено в таблице 8. | —— |
Таблица 8 – Описание объектов массива participations
Параметр | Тип | Описание | Значение |
participation_type_id | int | Тип участника. Параметр обязательный для заполнения. | 1 – домашний клуб; 2 – гостевой клуб; 3 – первая сборная; 4 – вторая сборная. |
participation_id | int | Идентификатор клуба или сборной. Идентификатор присваивается в зависимости от типа участника.Параметр обязательный для заполнения. | —— |
7. Связь между обычным событием и групповым
7.1 Проставление связи между обычным событием и групповым
Функция event.ticket.link_event_create предназначена для объединения информации между групповыми мероприятиями и обычными.
Таблица 9 – Формат данных функции event.ticket.link_event_create
Параметр | Тип | Описание | Значение |
real_event_id | int | Идентификатор события с типом обычное (event_type_id=1). Параметр обязательный для заполнения. | —— |
abon_event_id | int | Идентификатор события с типом групповое (event_type_id=2). Параметр обязательный для заполнения. | —— |
7.2 Удаление связи между обычным событием и групповым
Функция event.ticket.link_event_delete предназначена для отмены объединения информации между групповыми мероприятиями и обычными.
Таблица 10 – Формат данных функции event.ticket.link_event_delete
Параметр | Тип | Описание | Значение |
real_event_id | int | Идентификатор события с типом обычное (event_type_id=1). Параметр обязательный для заполнения. | —— |
abon_event_id | int | Идентификатор события с типом групповое (event_type_id=2). Параметр обязательный для заполнения. | —— |
8. Билеты и абонементы: event.ticket.ticket_update
Функция event.ticket.ticket_update предназначена для получения и просмотра информации об изменениях в проданных билетах и абонементах.
Таблица 11 – Формат данных функции event.ticket.ticket_update
Параметр | Тип | Описание | Значение |
id | int | Идентификатор билета во внешней системе. Параметр обязательный для заполнения. | —— |
datetime | string | Дата и время продажи билета. Формат даты: «гггг-мм-дд чч:мм:сс». Параметр обязательный для заполнения. | |
ticket_type | int | Тип проданного билета. Параметр обязательный для заполнения. | 1 – обычный билет; 2 – абонемент. |
cost | numeric(10,3) | Итоговая цена билета. Параметр обязательный для заполнения. | |
discount | numeric(10,3) | Итоговая скидка на покупку билета. Параметр обязательный для заполнения. | —— |
event_id | int | Идентификатор события во внешней системе. Параметр обязательный для заполнения. | —— |
cashbox_id | int | Идентификатор кассы во внешней системе. Параметр обязательный для заполнения. | —— |
sector_name | string | Наименование сектора. Параметр обязательный для заполнения. | —— |
seat_row | string | Ряд. Параметр обязательный для заполнения. | —— |
seat_num | string | Место. Параметр обязательный для заполнения. | —— |
barcode | string | Номер штрихкода купленного билета или milfare абонемента. Параметр обязательный для заполнения. | —— |
ticket_status_id | int | Текущий статус билета. Параметр обязательный для заполнения. | 1 – новый; 2 – продан; 3 – возвращен. |
sell_id | int | Идентификатор продажи из внешней системы. Параметр обязательный для заполнения. | —— |
client_id | int | Идентификатор клиента из внешней системы (покупатель). Параметр обязателен для заполнения в случае если не указан partner_id. | —— |
partner_id | int | Идентификатор юридического лица из внешней системы. Параметр обязателен для заполнения в случае если не указан client_id. | —— |
e_ticket_type | int | Тип покупки билета. Параметр обязательный для заполнения. | 1 – онлайн; 0 – оффлайн. |
9. События СКУД (проходы): event.ticket.action_create
Функция event.ticket.action_create предназначена для получения и просмотра информации о событиях СКУД.
Таблица 12 – Формат данных функции event.ticket.action_create
Параметр | Тип | Описание | Значение |
id | int | Идентификатор прохода во внешней системе. Параметр обязательный для заполнения. | —— |
event_id | int | Идентификатор события во внешней системе. Параметр обязательный для заполнения. | —— |
datetime | string | Дата и время события билета . Формат даты: «гггг-мм-дд чч:мм:сс». Параметр обязательный для заполнения. | —— |
action_type_id | int | Идентификатор типа события. Параметр обязательный для заполнения. | 1 – считывание и анализ штрихкода; 3 – одно событие входа; 31 – одно событие выхода. |
ticket_id | int | Идентификатор билета во внешней системе. Данный параметр записывается только в случае распознанного штрихкода билета. Параметр обязательный для заполнения. | —— |
barcode | string | Код прочитанного штрихкода. Параметр обязательный для заполнения. | —— |
has_error | string||null | Наличие ошибки | да – текст ошибки; нет – null. |
10. Сервис промобилетов
10.1 Промобилеты: promoticket_update
Функция promoticket_update предназначена для создания и изменения данных о промобилетах в системе.
Таблица 13 – Формат данных функции promoticket_update
Параметр | Тип | Описание | Значение |
id | int | Идентификатор промобилета во внешней системе. Параметр обязательный для заполнения. | |
event_id | int | Идентификатор события во внешней системе. Параметр обязательный для заполнения. | |
sector_name | string | Наименование сектора | |
barcode | string | Штрихкод промобилета. Параметр обязательный для заполнения. | |
ticket_number | int | Номер билета. Параметр обязательный для заполнения. | |
pincode | int | PIN-код билета | |
partner_id | int | Идентификатор партнера во внешней системе. |
10.2 Активация промобилета: promoticket_activation
Функция promoticket_activation предназначена для активации промобилетов.
Таблица 14 – Формат данных функции имя функции
Параметр | Тип | Описание | Значение |
id | int | Идентификатор промобилета во внешней системе. Параметр обязательный для заполнения. | |
client_id | int | Идентификатор клиента. Параметр обязательный для заполнения. | |
activation_datetime | string | Дата и время активации промобилета. Формат даты: «гггг-мм-дд чч:мм:сс». Параметр обязательный для заполнения. | |
activation_type | int | Тип активации промобилета. Параметр обязательный для заполнения. | 1 – анкетирование; 2 – СМС; 3 – неизвестный. |
11. Промогруппы и промокоды
11.1 Группы промокодов: promogroup.update
Функция promogroup.update предназначена для создания групп промокодов в системе.
Таблица 15 – Формат данных функции promogroup.update
Параметр | Тип | Описание | Значение |
promogroup_id | int | Идентификатор группы промокодов во внешней системе. Параметр обязательный для заполнения. | |
promogroup_type_id | int | Тип промогруппы. Параметр обязательный для заполнения. | 1 – программа лояльности; 2 – билеты и абонементы. |
begin_datetime | string | Дата и время старта действия промокода Формат даты: «гггг-мм-дд чч:мм:сс». Параметр обязательный для заполнения. |
11.2 Промокод: promocode.update
Функция promocode.update предназначена создания и изменения данных о промокодах в системе.
Таблица 16 – Формат данных функции promocode.update
Параметр | Тип | Описание | Значение |
id | int | Идентификатор промокода во внешней системе. Параметр обязательный для заполнения. | |
code | int | Код промокода. Параметр обязательный для заполнения. | |
status | int | Сатус промокода. Параметр обязательный для заполнения. | 1 – новый; 2 – использован; 3 – выгружен; |
cost | int | Номинал промокода. Параметр обязательный для заполнения. | |
promogroup_id | int | Идентификатор группы промокодов во внешней системе. Параметр обязательный для заполнения. | |
client_id | int | Идентификатор клиента. | |
activation_datetime | string | Дата и время активации промокода. Формат даты: «гггг-мм-дд чч:мм:сс». |
События и формат данных для интернет магазинов
1.Клиенты: public.client.update
Функция public.client.update предназначена для создания и изменения клиента в системе .
Таблица 1 – Формат данных функции public.client.update
Параметр | Тип | Описание | Значение |
id | int | Идентификатор клиента во внешней системе. Параметр обязательный для заполнения. | —— |
first_name | string | Имя клиента. | —— |
last_name | string | Фамилия клиента. | —— |
middle_name | string | Отчество клиента. | —— |
telephone* | string | Номер телефона клиента. Телефон должен начинаться с префикса «7». Параметр обязательный для заполнения в случае если не указан Email. | —— |
email* | string | Электронная почта клиента. Параметр обязательный для заполнения в случае если не указан Телефон. | —— |
country_id | integer | Страна клиента | |
region_id | integer | Регион клиента | |
city_id | integer | Город клиента | |
clothing_size_id | integer | Размер одежды клиента | |
shoe_size_id | integer | Размер обуви клиента | |
data_processing | boolean | Согласие на обработку персональных данных | true \ false |
subscription | boolean | Согласие на рассылку | true \ false |
Приложение №1: Виды спорта
Таблица 1 – Идентификаторы видов спорта
Идентификатор вида спорта | Виды спорта |
1 | Футбол |
2 | Волейбол |
97 | Баскетбол |
98 | Бейсбол |
99 | Биатлон |
100 | Водное поло |
101 | Гандбол |
102 | Керлинг |
103 | Прыжки в воду |
104 | Регби |
105 | Синхронное плавание |
106 | Спортивная гимнастика |
107 | Теннис |
108 | Фигурное катание на коньках |
109 | Хоккей |
110 | Хоккей на траве |
111 | Художественная гимнастика |
112 | Другое |
114 | Легкая атлетика |
Приложение №2: Страны
С полным списком стран можно ознакомиться здесь
| RUS | ENG | ID |
| Абхазия | Abkhazia | 681 |
| Австралия | Australia | 469 |
| Австрия | Austria | 470 |
| Азербайджан | Azerbaijan | 471 |
| Аландские острова | Aland islands | 234 |
| Албания | Albania | 472 |
| Алжир | Algeria | 473 |
| Американское Самоа | American samoa | 230 |
| Ангилья | Anguilla | 474 |
| Ангола | Angola | 475 |
| Андорра | Andorra | 476 |
| Антарктика | Antarctica | 228 |
| Антигуа и Барбуда | Antigua and barbuda | 477 |
| Аргентина | Argentina | 478 |
| Армения | Armenia | 479 |
| Аруба | Aruba | 233 |
| Афганистан | Afghanistan | 480 |
| Багамы | Bahamas | 481 |
| Бангладеш | Bangladesh | 482 |
Приложение №3: Регион
С полным списком регионов можно ознакомиться здесь
| RUS | ENG | ID |
| Oguz | 1631 | |
| Ordubad | 1632 | |
| Q?b?l? | 1633 | |
| Qax | 1634 | |
| Qazax | 1635 | |
| Quba | 1636 | |
| Qubadli | 1637 | |
| Qobustan | 1638 | |
| Qusar | 1639 | |
| S?ki | 1640 | |
| Sabirabad | 1641 | |
| S?d?r?k | 1642 | |
| Sahbuz | 1643 | |
| S?ki | 1644 | |
| Salyan | 1645 | |
| S?rur | 1646 | |
| Saatli | 1647 | |
| Sabran | 1648 | |
| Siy?z?n | 1649 | |
| S?mkir | 1650 | |
| Sumqayit | 1651 | |
| Samaxi | 1652 | |
| Samux | 1653 | |
| Sirvan | 1654 |
Приложение №4: Город
С полным списком городов можно ознакомиться здесь
| RUS | ENG | ID |
| Escas | 204620 | |
| Абу Даби | Abu Dhabi | 204621 |
| Ахмед бин Рашид Порт | Ahmed Bin Rashid Port | 204622 |
| Al Barsha | 204623 | |
| Аль-Фуджейра | Al Fujayrah | 204624 |
| Al Jazeera Port | 204625 | |
| Al Jeer Port | 204626 | |
| Al Mafraq | 204627 | |
| Al Quoz | 204628 | |
| Al Sufouh | 204629 | |
| Deira | 204630 |
|
Размер
одежды |
ID |
|
XXS |
66 |
|
XS |
67 |
|
S |
68 |
|
M |
69 |
|
L |
70 |
|
XL |
71 |
|
XXL |
72 |
|
XXXL |
73 |
|
Размер
обуви |
ID |
|
34 |
1 |
|
35 |
2 |
|
35.5 |
3 |
|
36 |
4 |
|
36.5 |
5 |
|
37 |
6 |
|
37.5 |
7 |
|
38 |
8 |
|
39 |
9 |
|
39.5 |
10 |
|
40 |
11 |