Подтверждение заявки

Метод подтверждает заявку, если она успешно прошла оценку. После подтверждения заявка перейдет в статус accepted, и сервис запустит процесс поиска исполнителя.


Предложение pricing.offer действительно в течение ограниченного времени (10 минут).
По истечении этого времени, при попытке подтверждения заказ перейдет в статус failed.

Request

POST

b2b.taxi.yandex.net/b2b/cargo/integration/v2/claims/accept

Адрес сервиса

Query parameters

Name

Description

claim_id*

Type: string

ID заявки, полученный на этапе создания заявки

Min length: 32

Max length: 64

Headers

Name

Description

Accept-Language*

Type: string

Предпочитаемый язык ответа

Например:
ru — русский
en — английский

Example: ru

Body

application/json
{
    "version": 1
}

Name

Description

version*

Type: integer<int64>

Версия заявки. Изменяется после редактирования заявки (int64)

Example: 1

Responses

200 OK

Заявка подтверждена

Body

application/json
{
    "id": "741cedf82cd464fa6fa16d87155c636",
    "status": "new",
    "version": 1,
    "user_request_revision": "string",
    "skip_client_notify": false
}

Name

Description

id*

Type: string

Идентификатор(ID) заявки, полученный на этапе создания заявки

Example: 741cedf82cd464fa6fa16d87155c636

Min length: 32

Max length: 64

skip_client_notify*

Type: boolean

status*

Type: ClaimStatus

Статус заявки. Подробнее см. в разделе Статусная модель

Example: new

Enum: new, estimating, estimating_failed, ready_for_approval, accepted, performer_lookup, performer_draft, performer_found, performer_not_found, pickup_arrived, ready_for_pickup_confirmation, pickuped, delivery_arrived, ready_for_delivery_confirmation, delivered, delivered_finish, returning, return_arrived, ready_for_return_confirmation, returned, returned_finish, failed, cancelled, cancelled_with_payment, cancelled_by_taxi, cancelled_with_items_on_hands

user_request_revision*

Type: string

Текущая версия изменений в заявке, переданная пользователем

version*

Type: integer<int64>

Версия заявки из запроса (int64)

Example: 1

ClaimStatus

Статус заявки. Подробнее см. в разделе Статусная модель

Type

Description

ClaimStatus

Example: new

Enum: new, estimating, estimating_failed, ready_for_approval, accepted, performer_lookup, performer_draft, performer_found, performer_not_found, pickup_arrived, ready_for_pickup_confirmation, pickuped, delivery_arrived, ready_for_delivery_confirmation, delivered, delivered_finish, returning, return_arrived, ready_for_return_confirmation, returned, returned_finish, failed, cancelled, cancelled_with_payment, cancelled_by_taxi, cancelled_with_items_on_hands

404 Not Found

Заявка не найдена

Body

application/json
{
    "code": "not_found",
    "message": "Заявка не найдена"
}

Name

Description

code*

Type: string

Код ошибки

Example: not_found

Enum: unknown_error, not_found

message*

Type: string

Описание ошибки

Example: Заявка не найдена

409 Conflict

Попытка подтвердить заявку, которая не прошла оценку

Body

application/json
{
    "code": "inappropriate_status",
    "message": "Недопустимое действие над заявкой"
}

Name

Description

code*

Type: string

Код ошибки

Example: inappropriate_status

Enum: unknown_error, inappropriate_status, invalid_post_payment, old_version, offer_expired, state_mismatch, offer_already_used

message*

Type: string

Описание ошибки

Example: Недопустимое действие над заявкой

429 Too Many Requests

Слишком много запросов

Body

application/json
{
    "code": "too_many_requests",
    "message": "Слишком много запросов"
}

Name

Description

code*

Type: string

Код ошибки

Example: too_many_requests

Enum: unknown_error, too_many_requests

message*

Type: string

Описание ошибки

Example: Слишком много запросов
Предыдущая
2. Создание заявки
Следующая
4. Информация по заявке