Информация о документах

Возвращает информацию о документах по идентификатору заказа.

⚙️ Лимит: 3 000 запросов в час

Request

POST

https://api.partner.market.yandex.ru/campaigns/{campaignId}/orders/{orderId}/documents

Path parameters

Name

Type

Description

campaignId*

integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

orderId*

integer<int64>

Идентификатор заказа.

Responses

200 OK

Информация о документах.

Body

application/json
{
    "status": "OK",
    "result": {
        "upd": {
            "status": "READY",
            "number": "string",
            "date": "string"
        },
        "ukd": {
            "status": "READY",
            "number": "string",
            "date": "string"
        },
        "torgTwelve": {
            "status": "READY",
            "number": "string",
            "date": "string"
        },
        "sf": {
            "status": "READY",
            "number": "string",
            "date": "string"
        },
        "ksf": {
            "status": "READY",
            "number": "string",
            "date": "string"
        }
    }
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

result

OrderBusinessDocumentsDTO

Информация о документах.

ApiResponseStatusType

Тип ответа.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

OrderBusinessDocumentsDTO

Информация о документах.

Name

Type

Description

upd

DocumentDTO

Информация об УПД-1 или УПД-2.

ukd

DocumentDTO

Информация об УКД-1 или УКД-2.

torgTwelve

DocumentDTO

Информация о товарной накладной.

sf

DocumentDTO

Информация о счете-фактуре.

ksf

DocumentDTO

Информация о корректировочном счете-фактуре.

DocumentDTO

Информация о документе.

Name

Type

Description

status

OrderDocumentStatusType

Статус документа.
Enum: READY, NOT_READY

number

string

Номер документа.

date

string<date>

Дата создания документа.

OrderDocumentStatusType

Статус документа:

  • READY — готов;
  • NOT_READY — не готов.

Type

Description

OrderDocumentStatusType

Enum: READY, NOT_READY

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

ApiErrorDTO

Общий формат ошибки.

Name

Type

Description

code*

string

Код ошибки.

message

string

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

401 Unauthorized

В запросе не указаны данные для авторизации.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

420 Method Failure

Превышено ограничение на доступ к ресурсу.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Type

Description

status

ApiResponseStatusType

Тип ответа.
Enum: OK, ERROR

errors

ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.