Работа с откликами перевозчиков

Этот раздел описывает, как грузоотправитель или экспедитор получает отклики перевозчиков и выбирает исполнителя.

---

1. Где смотреть отклики

Отклики возвращаются в деталях заказа:

GET /api/Orders/GetInfo?Id={order_id}

Основное поле:

{
  "matchingCars": []
}

Каждый элемент matchingCars содержит:

• id — ID отклика;
• truckOrganizationName — организация перевозчика;
• truckOrganizationId — ID организации перевозчика;
• truckNumber — номер ТС;
• trailerNumber — номер прицепа;
• driverFullName — водитель;
• logistFullName, logistPhoneNumber — контакт перевозчика;
• price — ставка;
• status — статус отклика;
• gpsEnabled — наличие GPS.

---

2. Особенности разных типов цены

Фиксированная стоимость (Static, код 10)

Стоимость задана в заказе. Отклики перевозчиков находятся в matchingCars.

Аукцион (Auction, код 20)

Данные аукциона находятся в объекте auction. Список организаций-участников может возвращаться в auction.offerOrganizationNames.

Предложение цены (Offer, код 30)

Отклики перевозчиков и предложенные ставки находятся в matchingCars.

---

3. Принятие отклика

Для принятия отклика владельцем заказа используется:

POST /api/OrderTruckMatchings/Accept

В запрос передается ID отклика из matchingCars[].id.

После успешного принятия:

• отклик получает статус AcceptedInOrderOwner;
• заказ переходит дальше по жизненному циклу;
• в заказе появляется выбранный перевозчик;
• остальные отклики считаются невыбранными или становятся недоступны в зависимости от бизнес-логики заказа.

---

4. Статусы откликов

Код	Значение	Описание
10	AcceptedInTruckOwner	Перевозчик отправил или подтвердил отклик
20	DeclinedInTruckOwner	Перевозчик отклонил
30	AcceptedInOrderOwner	Владелец заказа принял отклик
40	DeclinedInOrderOwner	Владелец заказа отклонил
50	Awaiting	Ожидает решения

---

5. Ручное назначение перевозчика

Если перевозчик не отправлял отклик, владелец заказа может использовать ручное назначение:

• POST /api/Orders/MatchManually;
• POST /api/Orders/MatchManuallyExtended;
• POST /api/Orders/MatchManuallyForCargorun.

Эти методы не являются основным сценарием принятия уже созданного отклика. Их нужно использовать только в сценариях ручного назначения.

---

6. Отличие от API перевозчика

Методы TransporterOrderTruckMatchings/* используются со стороны перевозчика:

• создать отклик;
• изменить ставку;
• удалить отклик;
• отклонить заказ.

Метод OrderTruckMatchings/Accept используется со стороны владельца заказа.