Общие положения
Для использования API 2.0 в Corteos Platform необходимо создать отдельный личный кабинет в b2b go, который будет использоваться строго для API, использование общего кабинета вашей компании, который используется для оффлайн заказов, невозможно. Для каждого клиента должен быть заведен отдельный кабинет в GO, единый кабинет(например, из-под доступа агента) для нескольких различных компаний недопустим.
Документация по API: https://taxi__business-api.docs-viewer.yandex.ru/ru/concepts/request-index-api20
Настройки стороны агентства
Агентство не видит заказы Go и не обрабатывает их, поэтому настроек со стороны агента нет: услуги к договору подключать не нужно, для активации возможности использования такси нужно просто активировать мод под тревел менеджером клиента.
Настройка личного кабинета b2b go
Существует две настройки, которые необходимо сделать в b2b go для корректной работы с Кортеос, одну из них должен выполнить ваш менеджер на стороне go, а другую вы сами. Важный момент, что без этих настроек система не будет работать корректно, вы должны сделать это до того, как начнете совершать заказы через Кортеос(и до подключения мода).
Что должен настроить менеджер в Go?
Название компании в личном кабинете администратора Go будет использовано в качестве формы оплаты, это системное ограничение на стороне Go и его нельзя поменять. Поэтому нужно настроить название компании, в которой будут создаваться командировки так, чтобы было понятно, что это именно командировки. Например, в нашем демо примере доступ называется Тест-API и это же пользователь увидит у себя в приложении, вот так:
Мы рекомендуем назвать личный кабинет в b2b go в следующем формате: Командировки “Название Компании”, например, если ваша компания называется ООО “Кортеос”, то оптимальное название - Командировки ООО “Кортеос”. Также допустимо название ООО “Кортеос” командировки, но следует учитывать, что если вы также используете такси не в командировках, пользователю должно быть удобно выбрать нужный способ оплаты в приложении, поэтому мы и рекомендуем начинать его название со слова “Командировка”.
Данную настройку должен сделать ваш менеджер на стороне Go, пожалуйста, проверьте корректность наименования вашего личного кабинета и свяжитесь с менеджером при необходимости.
Что должен сделать Тревел Менеджер в личном кабинете Go?
Необходимо иметь кост-центр на стороне Go, который будет называться “номер заказа” - именно так и никак иначе, маленькими буквами.
Для этого в разделе “Сотрудники и доступы” - “Центры затрат” мы должны переименовать центр затрат по умолчанию:
Также обратите внимание на настройки дополнительных параметров:
Способ отображения - скрытый(надо нажать на глаз, он должен быть перечеркнут)
Название - номер заказа
Сотруднику нужно заполнять обязательно - галочка снята
Выбран тип услуги “такси”
Тип поля - свободный ввод
Пример корректного заполнения ниже:
Внесение 1000 рублей
Важный момент, что b2b go требует первоначально пополнить счет хотя бы на 1000 рублей для начала работы, без выполнения этого действия перед началом работы лимиты и пользователи будут создаваться, Кортеос будет корректно работать с backend b2b go и не получать ошибок, при этом пользователи не будут получать лимит у себя в приложении.
Кроме того, надо учитывать, что при отсутствии средств на балансе предоплатного аккаунта могут происходить те же самые проблемы у пользователей, в связи с чем мы рекомендуем работать с go на постаплате или внимательно следить за состоянием баланса.
Настройка личного кабинета Сorteos
Для настройки прежде всего необходимо зайти в личный кабинет b2b go и получить OAuth token:
Далее необходимо скопировать значение токена, которое будет использовано в настройках мода:
Данный токен вносится в систему из-под аккаунта тревел менеджера в разделе “B2B GO: настройки сервиса” в меню “Расширения” - доступен после активации мода Яндекс.Такси
И далее указываем значение в поле административного интерфейса:
Кроме того, нам нужен будет идентификатор клиента, который можно взять также в ЛК b2b go:
Его тоже переносим в тот же административный интерфейс Corteos:
Полезные замечания для администратора
Привязка лимитов
К пользователю всегда должен быть привязан персональный лимит в такси:
При этом идентификатор лимита совпадает с идентификатором персоны в Corteos, посмотреть её можно в редакторе персон:
Настройки системы
Настройки системы доступны в разделе “B2B: настройки сервиса” в разделе “Расширения”.
В этом разделе присутствуют следующие настройки:
Разберем их более детально:
Название личного кабинета - должно совпадать с тем, что указано в настройках вашей компании в личном кабинете b2b go, используется для инструкции в письме пользователю о назначении лимита:
OAuth Token - токен для работы с api b2b go, процедура получения описана выше.
Идентификатор клиента- также берется из личного кабинета go
Отправлять ежедневные уведомления по лимиту - при активации этой настройки, пассажир будет один раз в сутки получать сводное информационное письмо, в котором будет написано, сколько лимита у него осталось, а также историю поездок, из которой можно узнать детально о расходовании лимита.
Информационный текст для пользователя при бронировании - кастомизированное для вашей компании предупреждение о том, что пользователь должен делать, если лимит ему не начислился(обычно нужно указать, что надо связаться с Тревел Менеджером и его контактный номер телефона). Отображается на стартовой форме и в письме о назначении лимита.
Частота синхронизации - с какой периодичностью мы переопрашиваем b2b go для того, чтобы выгрузить выполненные заказы по переданному лимиту.
Разрешенное отклонение от дат контейнера - имеет смысл только при использовании совместно с модом "Первичный контейнер командировки" (ModComplexReserveContainer) - в этом случае на стартовой форме можно выбирать не произвольные будущие даты, а только даты в рамках, обозначенных датами контейнера и правилами отклонения от этих дат.
Пошаговое описание бизнес-процесса
Бронирование услуги b2b go похоже на заказ любой другой услуги и работает с модами, меняющими бизнес-процесс тем или иным образом(например, как контейнер командировки или согласование).
Для перехода к началу процесса необходимо выбрать услугу из меню “Бронирование”
После этого пользователь попадает на стартовую форму, где он выбирает:
дату начала предоставления лимита(считается с 00:00 по Москве, поэтому следует самостоятельно учитывать отклонения по часовым поясам, например, брать дату с запасом на сутки)
дату окончания предоставления лимита(до 23:59 по Москве)
общую сумму лимита, которую можно будет потратить в командировках
В будущем планируется реализовать политику по ограничению классов перевозки на основании структурного или структурного-меняемого кода пассажира, это произойдет после пилотирования мода.
Нажимая кнопку “Перейти к созданию заказа”, мы попадаем на страницу с выбором участников поездки:
Для создания заказа необходимы следующие данные по пассажиру:
мобильный телефон(тот, который используется пассажиром в его личном приложении Яндекс.Go)
электронная почта - нужна для отправки инструкции об использовании предоставленного лимита пассажиру
Если мы добавляем нескольких пассажиров на этом шаге, то на каждого из них создастся отдельный заказ с одинаковым лимитом на такси, поэтому если нам нужно дать разные лимиты разным участником, нужно провести процесс заказа несколько раз. Это же касается и разных дат лимитов для участников командировки.
В деталях командировки лимит будет выглядеть таким образом:
Так как данная услуга не привязана к агентству, а только к корпоративному клиенту, то чат заказа недоступен, а также ваш агент не увидит этот заказ в своих очередях на обработку.
При создании заказа его стоимостью будет величина лимита, при совершении поездок стоимость станет суммой всех отъезженных заказов.
В день активации лимита пользователю приходит уведомление на почту следующего вида:
После чего для него открывается возможность оплаты за счет компании в приложении Яндекс.Go:
По факту совершения заказов, они будут в указанной в настройках частотой синхронизации обновляться в деталях заказа:
При использовании мода "Настраиваемые командировочные документы" (ModTripDocuments) поездки такси также будут попадать в таблицу TransportTable, при этом одной поездке на такси будет соответствовать одна запись в таблице транспортных услуг.
В дату завершения лимита способ оплаты пропадает из списка доступных в приложении пользователя.
После завершения действия лимита, в деталях заказа будет такой вид информации о лимите:
Дополнительные возможности управления заказом
Принудительная синхронизации
Обновляет список поездок и остаток по лимиту. Следует использовать в том случае, если автоматический таймер по каким-то причинам не сработал, а нам нужно актуализировать заказ в b2b go:
Остановить предоставление лимита
Данная кнопка блокирует лимит в приложении у пользователя, однако заказ все так же остается в статусе “выполнен” и его цена будет складываться из суммы отъезженных услуг.
Важный момент, что если у вас две командировки в один день, то нужно сперва принудительно остановить предоставление лимита по первой и только потом начинать поездки в рамках второй командировки, иначе все эти поездки будут отнесены на бюджет первой.
Взаимодействие с модом согласования командировок
Заказ b2b go добавляется в письмо на согласование командировку в таком виде:
