Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Общие положения

Для использования API 2.0 в Corteos Platform необходимо создать отдельный личный кабинет в b2b go, который будет использоваться строго для API, использование общего кабинета вашей компании, который используется для оффлайн заказов, невозможно. Для каждого клиента должен быть заведен отдельный кабинет в GO, единый кабинет(например, из-под доступа агента) для нескольких различных компаний недопустим.

...

Существует две настройки, которые необходимо сделать в b2b go для корректной работы с Кортеос, одну из них должен выполнить ваш менеджер на стороне go, а другую вы сами. Важный момент, что без этих настроек система не будет работать корректно, вы должны сделать это до того, как начнете совершать заказы через Кортеос(и до подключения мода).

Что должен настроить менеджер в Go?

...

Пример корректного заполнения ниже:

...

Внесение 1000 рублей

Важный момент, что b2b go требует первоначально пополнить счет хотя бы на 1000 рублей для начала работы, без выполнения этого действия перед началом работы лимиты и пользователи будут создаваться, Кортеос будет корректно работать с backend b2b go и не получать ошибок, при этом пользователи не будут получать лимит у себя в приложении.

...

Кроме того, надо учитывать, что при отсутствии средств на балансе предоплатного аккаунта могут происходить те же самые проблемы у пользователей, в связи с чем мы рекомендуем работать с go на постаплате или внимательно следить за состоянием баланса.

Настройка личного кабинета Сorteos

...

Info

В дату завершения лимита способ оплаты пропадает из списка доступных в приложении пользователя.

После завершения действия лимита, в деталях заказа будет такой вид информации о лимите:

...

Дополнительные возможности управления заказом

...

Обновляет список поездок и остаток по лимиту. Следует использовать в том случае, если автоматический таймер по каким-то причинам не сработал, а нам нужно актуализировать заказ в b2b go:

...

Остановить предоставление лимита

Данная кнопка блокирует лимит в приложении у пользователя, однако заказ все так же остается в статусе “выполнен” и его цена будет складываться из суммы отъезженных услуг.

...

Note

Важный момент, что если у вас две командировки в один день, то нужно сперва принудительно остановить предоставление лимита по первой и только потом начинать поездки в рамках второй командировки, иначе все эти поездки будут отнесены на бюджет первой.

Взаимодействие с модом согласования командировок

Заказ b2b go добавляется в письмо на согласование командировку в таком виде:

...

Настройка разрешенных тарифов для пассажиров.

В том случае, если нужно настроить определенные категории машин для сотрудников компании, следует создать структурный код со следующим специальным поведением:

...

В b2b go поддерживаются следующие классы тарифов:

https://taxi__business-api.docs-viewer.yandex.ru/ru/concepts/api20/limit-list

"child_tariff",
"cargo",
"business", – на самом деле так называется Комфорт
"courier",
"express",
"premium_van",
"comfortplus",
"ultimate",
"minivan",
"vip", - на самом деле так называется Бизнес
"maybach",
"econom"

Соответственно, в качестве значения кода следует передавать коды из справочника Яндекс Go, разделенные запятыми, примеры:

  • all - разрешить все классы бронирования

  • econom,business - разрешить эконом и комфорт

  • business,comfotplus,vip - комфорт, комфорт плюс и бизнес

  • econom - только эконом

Пусть в нашем примере коды выглядят так:

...

Далее мы привязываем в редакторе персон код к нужным персонам(можно также через импорт это сделать или через API):

...

Например, в данном примере мы привязываем к персоне доступный тариф - эконом класс, привязанный класс мы можем увидеть в деталях командировки в разделе “Коды”.

...

Далее мы оформляем командировку на эту персону и видим такую картину в приложении Яндекс Go после активации нашего лимита:

...

Как видно, нельзя заказать любой другой класс, кроме эконома, при оплате с корпоративного счета.

Установка разрешенных классов в момент создания заказа

Альтернативный режим работы - установка разрешенных классов в процессе создания заказа. Для того, чтобы этот функционал заработал, необходимо зайти в настройки сервиса b2b go и активировать следующий флаг:

...

После этого на стартовой форме появляется набор чекбоксов, которыми инициатор может отметить разрешенные пользователю классы. Если не выбран ни один класс тарифа, система не даст продолжить создание заказа и выдаст соответствующее уведомление об этом. Также реализовано автопроставление галочек у более низших классов. Например, пользователь проставил галочку у Бизнес, при этом автоматически проставились галочки у Эконом, Комфорт и Комфорт+. При этом сохранена возможность снять галочки у более низких классов руками.

...

Далее(при включенном флаге “Показывать выбор тарифа на стартовой форме”) эта информация будет доступна на:

  • пребукинге

    Image Added
  • на таймлайне командировки

    Image Added
  • в деталях заказа b2b go

    Image Added
  • в письме о состоянии лимита, которое получает пассажир по правилам отправки уведомлений.

Доступ к заказам GO для агентства

Иногда клиент может захотеть, чтобы агент также видел заказы, сделанные через сервис GO, для этого нужно:

  1. На стороне клиента в административном интерфейсе в явном виде указать, в какое агентство нужно передавать заказ

    Image Added
  2. На стороне агентства активировать услугу b2b go в договоре для данного клиента.
    Если все сделано верно, то Агент в списке Заказов сможет увидеть заказы B2B Go.
    Без активации этой опции в настройках мода данный тип заказа отображается только под доступами Клиента.

    Image Added