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

invoice (счёт)

Данный запрос получает выписанный ранее счёт, по его идентификатору.

Название Описание
HTTP Метод GET
Шаблон http://login:password@api.t2t.in.ua/invoice/$language/$invoice_id
Пример http://api.t2t.in.ua/invoice/en/123456789012

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

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

  • ru
  • ua
  • en
ru
2 invoice_id Идентификатор инвойса. 12-ти символьный код полученный из invoice.id 123456789012

Пример ответа:

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

Название Описание
id Идентификатор инвойса
sale_point_name Идентификатор пункта продажи, который создал данный инвойс
asps_code Идентификатор транзакции в системе поставщика
asps_code_2 Код билета. Данный код должен быть выдан пассажиру вместе с остальной информацией о поездке. Данный идентификатор должен сохраняться в секрете от посторонних лиц, поскольку именно по нему пассажир получит проездной документ в кассе вокзала.
state Состояние счёта. Может иметь одно из таких значений:

  • 0 — создан
  • 1 — выполняется резервировании мест
  • 2 — ошибка при резервировании мест
  • 3 — места зарезервированы, инвойс ожидает оплаты
  • 4 — инвойс оплачен
  • 5 — время ожидания оплаты истекло
  • 6 — распечатан проездной документ в кассе
  • 8 — аннулирован
  • остальное — внутренние технические состояния инвойса.
is_electronic Только для ЖД. Признак электронности документа. 1 — документ электронный. Т.е. такой по которому можно получить или сгенерировать посадочный бланк.
boarding_pass Существует ли посадочный документ для данного счёта. (0 — не существует, 1 — существует). Если 1 — то можно воспользоваться методом boarding_pass для получения посадочного документа
creation_time Дата и время создания счёта
owner_email Почтовый адрес владельца счёта
owner_phone Телефон владельца счёта
payment_gateway Ссылка на которую необходимо перенаправить пользователя для того чтобы он мог выполнить оплату. Время жизни ссылки — 15 минут. Доступны для оплаты Visa/Master, monexy, webmoney.
counterparts Информация о контрагентах зайдействованных в поездке
counterparts.transporter Информация о перевозчике
counterparts.insurer Информация о страховщике
travel Информация о приобретённой поездке в прямом направлении. См. описание варианта проезда из запроса variants
travel_return Информация о приобретённой поездке в обратном направлении. См. описание варианта проезда из запроса variants. Отсутствует при покупке билета в один конец.
price Информация о цене счёта
price.total Цена проезда на данном месте
price.tax НДС
price.articles Составляющие цены проезда
article[i] Одна из составляющих
article[i].code Код составляющей
article[i].name Название составляющей
article[i].price Цена
sold_seats Информация о приобретённых местах
sold_seats[i] Информация об одном из приобретённых мест
[i].id Номер места
[i].car_id Номер вагона (только в ЖД)
[i].passenger Информация о пассажире (имя, фамилия, льготность)
[i].price Информация о цене проезда на данном места
price.total Цена проезда на данном месте
price.tax НДС
price.articles Составляющие цены проезда на данном месте
article[i] Одна из составляющих цены проезда
article[i].code Код составляющей
article[i].name Название составляющей
article[i].price Цена