Uticket API
Прикладной программный интерфейс для продажи билетов.
Документация

bill (выписка счёта)

Данный запрос резервирует места по требованиям пользователя и формирует счёт для оплаты.

Важно! В запросе должен быть передан заголовок content-type: application/json; charset=utf-8

Название Описание
HTTP Метод POST
Шаблон http://login:password@api.t2t.in.ua/bill/$language/$variant_guididx/$car_id/$seats_list
или для авиации:
http://login:password@api.t2t.in.ua/bill/$language/$variant_guididx/$return_variant_guididx
Пример http://api.t2t.in.ua/bill/en/c1912101-b121-6d07-00ca-00303039d800/10/12,13,14,15
Шаблон тела запроса {seats:[{person:{privilege:’$privilege’,birth_date:’$birth_date’,name:’$name’,surname:’$surname’}},{},{},{}],options:{}}
Пример тела запроса

Параметры запроса:

Название Описание Пример
1 language Язык, на котором должен быть ответ системы. Одно значение из списка:

  • ru
  • ua
  • en
ru
2 variant_guididx Идентификатор варианта проезда (полученного ранее путём выполнения запроса variants) по которому необходимо купить перелёт c1912101-b121-6d07-00ca-00303039d800
3 return_variant_guididx Идентификатор варианта проезда (полученного ранее путём выполнения запроса variants) по которому необходимо купить перелёт в обратном направлении (только в авиации). c1912101-b121-6d07-00ca-00303039d800
4 car_id Идентификатор вагона по которому необходимо получить карту. Для автобуса должно быть всегда 0 10
5 seats_list Список мест через запятую. Не более 4х мест. 10,12,03
6 Тело запроса json объект с информацией о местах и опциях бронирования. См. таблицу “Структура тела запроса”

Структура тела запроса:

Название Описание
seats[] Массив с информацией о местах. Допускается бронирование:

  • Для жд не более чем 4х мест в одном запросе
  • Для авиа устанавливается перевозчиком
  • Для авто — устанавливается перевозчиком
seats[i].person Информация о пассажире
seats[i].person.name Имя пассажира, обязательно заполняется для ЖД и Авиа
seats[i].person.surname Фамилия пассажира, обязательно заполняется для ЖД и Авиа
seats[i].person.privilege Льгота. Только для ЖД.child — детский билет. student — студенческий билет
seats[i].person.type Для самолётов, тип пассажира:

  • inf — младенец
  • child — ребёнок
  • adult — взрослый
seats[i].person.birth_date Дата рождения человека. Для ЖД только в случае ребёнка. Для самолётов всегда необходимо
seats[i].person.gender (для самолетов) Пол пассажира:

  • MR — мужской
  • MIS, MRS — женский
seats[i].person.passport Информация о паспорте пассажира
seats[i].person.passport.number Серия и номер загран-паспорта: ‘MER1234’, …
seats[i].person.passport.citizenship Гражданство пассажира: ‘UA’, ‘RU’, …
seats[i].person.passport.end_date Срок годности паспорта: ‘2014-11-11’, …
seats[i].luggage.equipment Если 1 то билет с багажом
seats[i].luggage.animal Если 1 то билет с животным
seats[i].luggage.carryon Если 1 то билет с аппаратурой
options Дополнительные параметры запроса
options.owner_email Емейл покупателя
options.owner_phone Телефон покупателя
options.render_pdf Для электронных ЖД билетов система может сформировать pdf. Если 1 то после оплаты инвойса можно получить посадочный бланк по инвойсу.
options.need_bar_code Если 1 то система формирует картинку со штрихкодом, клиент может получить для оплаченного инвойса по запросу
options.need_electronic Если 1 то клиент готов к работе с электронными документами. При возможности система будет отдавать клиенту электронные документы вместо бланков заказа…

Внимание! Система не гарантирует возврат ел. билета при need_electronic = 1.

options.joined_boarding_pass Если 1 то все бланки посадочных документов будут объеденены на одном листе. Если 0 то на каждом листе будет 1 бланк посадочного документа.
options.need_payment_url Если 1 то созданный инвойс будет зарегистрирован в платёжном гейте, что даст возможность оплатить его средствами этого гейта. В данный момент платёжный гейт поддерживают visa/master, webmoney, monexy. Также в инвойс будет добавлен url, на который надо перенаправить браузер пользователя для выполнения оплаты.

Внимание! Поле owner_email должно быть обязательно заполнено и содержать email пользователя. Платёжный гейт исползует емейл пользователя для создания учётной записи с которой свяжет счёт. Кроме того, по факту оплаты, бланк будет доставлен на указанный емейл в виде pdf документа.

options.type reservation — означает что заказ идет на резервирование при этом багаж не должен быть указан. В случае покупки, не указывать параметр.

options.type = «reservation» — означает что заказ идет на резервирование при этом багаж не должен быть указан.

Структура ответа:

Ответ аналогичен ответу на запрос invoice