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

Возвращает данные, подтверждающие доставку.

В ответе можно получить идентификаторы точек на маршруте, фотографии, сделанные курьером на этих точках, и имена получателей

Request

POST

b2b.taxi.yandex.net/b2b/cargo/integration/v2/claims/proof-of-delivery/info

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

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

Responses

200 OK

OK

Body

application/json
{
    "proof_of_delivery_info": [
        {
            "claim_point_id": 372036854775807,
            "photos": [
                {
                    "id": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b",
                    "claim_point_id": 372036854775807,
                    "url": "string",
                    "status": "initiated",
                    "external_id": "string"
                }
            ],
            "recipient_info": {
                "recipient_name": "string",
                "recipient_type": "string",
                "document_id": "string"
            }
        }
    ]
}

Name

Description

proof_of_delivery_info*

Type: ProofOfDeliveryInfo[]

ProofOfDeliveryInfo

Name

Description

claim_point_id*

Type: integer<int64>

Целочисленный идентификатор точки (int64), генерируемый
на стороне Яндекс Доставки.
Содержится в поле route_points[].id. Применимо к точкам с типом
source, destination, return.

Example: 372036854775807

photos

Type: Photo[]

Фотографии, подтверждающие доставку

recipient_info

Type: RecipientInfo

Информация о получателе товара

Photo

Фотографии, подтверждающие доставку

Name

Description

claim_point_id*

Type: integer<int64>

Целочисленный идентификатор точки (int64), генерируемый
на стороне Яндекс Доставки.
Содержится в поле route_points[].id. Применимо к точкам с типом
source, destination, return.

Example: 372036854775807

id*

Type: string<uuid>

Уникальный идентификатор фотографии.

status*

Type: UploadStatusType

Статус загрузки

Enum: initiated, uploaded, mds_failed, validated, validation_failed

url*

Type: string

URL для загрузки фотографий

external_id

Type: string

внешний ID

RecipientInfo

Информация о получателе товара

Name

Description

recipient_name*

Type: string

Имя получателя

recipient_type*

Type: string

Кем является фактический получатель
по отношению к получателю, указанному в заявке

document_id

Type: string

Номер документа, подтверждающего доставку

UploadStatusType

Статус загрузки

Type

Description

UploadStatusType

Enum: initiated, uploaded, mds_failed, validated, validation_failed

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: Заявка не найдена