Общие положения
Для использования 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, который будет называться “номер заказа” - именно так и никак иначе, маленькими буквами.
Для этого в разделе “Сотрудники и доступы” - “Центры затрат” мы должны переименовать центр затрат по умолчанию:
Также обратите внимание на настройки дополнительных параметров:
Способ отображения - скрытый(надо нажать на глаз, он должен быть перечеркнут)
Название - номер заказа
Сотруднику нужно заполнять обязательно - галочка снята
Выбран тип услуги “такси”
Тип поля - свободный ввод
Пример корректного заполнения ниже:
Настройка личного кабинета Сorteos
Для настройки прежде всего необходимо зайти в личный кабинет b2b go и получить OAuth token:
Далее необходимо скопировать значение токена, которое будет использовано в настройках мода:
Данный токен вносится в систему из-под аккаунта тревел менеджера в разделе “B2B GO: настройки сервиса” в меню “Расширения” - доступен после активации мода Яндекс.Такси
И далее указываем значение в поле административного интерфейса:
Кроме того, нам нужен будет идентификатор клиента, который можно взять также в ЛК b2b go:
Его тоже переносим в тот же административный интерфейс Corteos:
