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

Метод подтверждает заявку, если она успешно прошла оценку. После подтверждения заявка перейдет в статус 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

Example: ``

Headers

Name

Description

Accept-Language

Type: string

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

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

Example: ru

Body

application/json

{
  "version": 1
}

Name

Description

version

Type: integer

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

Responses

200 OK

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

Body

application/json

{
  "id": "741cedf82cd464fa6fa16d87155c636",
  "status": "new",
  "version": 1,
  "user_request_revision": "example",
  "skip_client_notify": true
}

Name	Description
id	Type: ClaimId Идентификатор(ID) заявки, полученный на этапе создания заявки Min length: `32` Max length: `64` Example: `741cedf82cd464fa6fa16d87155c636`
skip_client_notify	Type: boolean
status	Type: ClaimStatus Статус заявки. Подробнее см. в разделе Статусная модель 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 Текущая версия изменений в заявке, переданная пользователем Example: `example`
version	Type: integer Версия заявки из запроса (int64)

ClaimId

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

Type: string

Min length: 32

Max length: 64

Example: 741cedf82cd464fa6fa16d87155c636

ClaimStatus

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

Type: string

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

Код ошибки

Enum: unknown_error, not_found

message

Type: string

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

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

409 Conflict

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

Body

application/json

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

Name

Description

code

Type: string

Код ошибки

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

Код ошибки

Enum: unknown_error, too_many_requests

message

Type: string

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

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

Была ли статья полезна?

2. Создание заявки

4. Информация по заявке