Функциональная карта Перевозчика

Авторизация

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

1. Получить токен - используйте метод </auth/token POST>. 

Участие в торгах

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

Ограничения: 

• Доступные типы торга - Кто быстрее, Аукцион
• Объект торга - Разовая заявка

Рассмотрим последовательность действий и то, какие методы должны быть использованы:

1. Получить перечень разовых заявок в торге - используйте метод </request_view GET>. 
   
   1. Если в ответ получен непустой список, то по каждой заявке требуется принятия решения:
      1. Бронировать заявку с типом торга Кто Быстрее - используйте метод </shipping_requests/{shipping_request_id}/reserve POST>.
      2. Принять участие в торге по заявке с типом торга Аукцион (используйте метод </shipping_requests/{shipping_request_id}/bids POST>.
         1. Получить перечень торгов, с активной ставкой - используйте метод </shipping_requests/{shipping_request_id}/bids GET>
            
            1. Отменить ставку - используйте метод </shipping_requests/{shipping_request_id}/bids/{bid_id}/archive PUT>
            2. Изменить ставку - используйте метод </shipping_requests/{shipping_request_id}/bids POST>.
2. Получить перечень заявок, по которым торг завершён успешно - используйте метод </shippings GET>.
3. Получить заявку по ID  - используйте метод </request_view/{id} GET>

Назначение ресурсов

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

Рассмотрим последовательность действий и то, какие методы должны быть использованы:

1. Получить перечень заявок в статусе На оформлении используйте метод </shippings GET> status = "resources_waiting"
   1. Если в ответ получен непустой список, то по каждой заявке требуется принятия решения:
      1. Получить перечень подходящих Водителей- используйте метод </resources/drivers&suitable_for_shipping=UUID GET>
      2. Получить перечень подходящих ТС - используйте метод </resources/cars&suitable_for_shipping=UUID GET>
      3. Получить перечень подходящих Прицепов- используйте метод </resources/trailers&suitable_for_shipping=UUID GET>
      4. Назначить ресурсы на заявку - используйте метод </shippings/{shipping_id}/assign_resources POST>

Функциональная карта Грузовладельца

Авторизация

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

1. Получить токен - используйте метод </auth/token POST>. 

Работа с партнёрами

Ниже представлен сокращённый перечень методов по работе с партнёрами.

Ограничения: 

• Отправка запросов и отзыв запросов - в ЛК
• Настройка групп (создание, редактирование, удаление) - в ЛК
• Управление ЧС - в ЛК 

Рассмотрим последовательность действий и то, какие методы должны быть использованы:

1. Получить список партнёров - используйте метод <partnerships GET>.  
   1. Если в ответ получен непустой список, то по каждому партнёру можно отдельно получить всю информацию:
      1. Получить информацию по конкретному партнёру - используйте метод <partnerships GET>, в параметре q указать Человекочитаемый ID партнёра, название компании партнёра или ИНН партнёра
2. Получить список групп партнёров тип торга Кто быстрее - используйте метод <partnerships/groups GET>. 
1. в ответ получен непустой список, то по каждому партнёру можно отдельно получить всю информацию:
   1. Получить информацию по конкретному партнёру - используйте метод <partnerships/groups GET>, в параметре q указать Человекочитаемый ID партнёра, название компании партнёра или ИНН партнёра

Создание Заказа

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

Ограничения: 

• Доступные типы торга - Кто быстрее, Аукцион (3 типа)
• Объект торга - Разовая заявка
• Создание черновиков - не доступно

Рассмотрим последовательность действий и то, какие методы должны быть использованы:

1. Создать Заказ - используйте метод <shipping_orders GET>.  
   1. Настройка этапов торга:
      1. в параметре auction_stages требуется передать массив из этапов торгов
   2. Настройка типа торга 
      1. тип торга Кто быстрее - в параметре auction_stages, в переданном значении этапа торга указать в параметре auction_type значение "instant_reservation"
      2. тип торга Аукцион (Открытый)- в параметре auction_stages, в переданном значении этапа торга указать в параметре auction_type значение "auction"
      3. тип торга Аукцион (Закрытый) - в параметре auction_stages, в переданном значении этапа торга указать в параметре auction_type значение "blind_auction"
      4. тип торга Аукцион (На понижение)- в параметре auction_stages, в переданном значении этапа торга указать в параметре auction_type значение "descending_price_auction"
      5. Для аукционов - в параметре auction_stages, в переданном значении этапа торга указать в параметре winner_selection_type значение "automatically" (значение по умолчанию)
   3. Настройка получателей -
      1. Публикация Все исполнители - в параметре auction_stages, в переданном значении этапа торга указать в параметре visibility значение "all"
      2. Публикация Все партнёры - в параметре auction_stages, в переданном значении этапа торга указать в параметре visibility значение "partners"
      3. Публикация Выбранные партнёры - в параметре auction_stages, в переданном значении этапа торга указать в параметре visibility значение "exclusive",
         1. Перечисление Партнёров: в параметре companies_ids в массиве передать список из ID компаний, среди которых будет виден заказ
         2. Перечисление Групп Партнёров: в параметре groups_ids в массиве передать список из ID групп, среди которых будет виден заказ

Работа с Заказом

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

Рассмотрим последовательность действий и то, какие методы должны быть использованы:

1. Получить перечень Заказов в статусе В торге - используйте метод <shipping_orders GET> в параметре status передать значение "in_auction"
   1. Если в ответ получен непустой список, то по каждой заявке требуется принятия решения:
      1. Получить информацию по конкретной заявке - используйте метод <shipping_orders/{shipping_order_id} GET> в запросе необходимо передавать параметр shipping_order_id - uuid Заказа
2. Получить перечень заявок в статусе На исполнении используйте метод <shipping_orders GET> в параметре status передать значение "in_trip" (в Пути) или "trip_waiting" (Предстоящая перевозка)
   1. Если в ответ получен непустой список, то по каждой заявке требуется принятия решения:
      1. Получить информацию по конкретной заявке - используйте метод <shipping_orders/{shipping_order_id} GET> в запросе необходимо передавать параметр shipping_order_id - uuid Заказа
3. Утверждение заявки - используйте метод <...>
   1. На данном этапе требуется указать данные, которые были не обязательными для торга, но обязательны для выполнения заявки:
      1. Данные о Грузоотправителе (данные о компании и контактное лицо)
      2. Данные о Грузополучателе (данные о компании и контактное лицо)
      3. Точные адреса по точкам
4. Подписание заявки ПЭП - происходит автоматически при утверждении заявки
5. Подтверждение выполнения - используйте метод </shipping_orders/{shipping_order_id}/accept_shipping POST>
   1. В запросе необходимо передавать параметр shipping_order_id - uuid Заказа
6. Отмена заявки - используйте метод <cancel POST>
7. Получить перечень заявок в статусе В архиве - используйте метод <shipping_orders GET> в параметре status передать значение "in_auction"
   1. Если в ответ получен непустой список, то по каждой заявке требуется принятия решения:
      1. Получить информацию по конкретной заявке - используйте метод <shipping_orders/{shipping_order_id} GET> в запросе необходимо передавать параметр shipping_order_id - uuid Заказа

К началу

Остались вопросы?

1. Посмотри раздел  Вопросы и ответы
2. Позвони 8(800)707-007-1
3. Напиши вопрос на info@traffic.online
4. Сообщи о проблеме на support@traffic.online