Информация о покупателе — юридическом лице
Возвращает информацию о покупателе по идентификатору заказа.
Чтобы получить информацию о покупателе, который является физическим лицом, воспользуйтесь запросом GET campaigns/{campaignId}/orders/{orderId}/buyer.
Получить данные можно, только если заказ находится в статусе DELIVERY, PICKUP или DELIVERED.
| ⚙️ Лимит: 3 000 запросов в час |
|---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/orders/{orderId}/business-buyer
Path parameters
|
Name |
Type |
Description |
|
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
|
orderId* |
integer<int64> |
Идентификатор заказа. |
Responses
200 OK
Информация о покупателе.
Body
{
"status": "OK",
"result": {
"inn": "string",
"kpp": "string",
"organizationName": "string",
"organizationJurAddress": "string"
}
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
result |
Информация о покупателе. |
OrderBusinessBuyerDTO
Информация о покупателе.
|
Name |
Type |
Description |
|
inn |
string |
ИНН. |
|
kpp |
string |
КПП. |
|
organizationName |
string |
Наименование юридического лица. |
|
organizationJurAddress |
string |
Юридический адрес. |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
|
Name |
Type |
Description |
|
code* |
string |
Код ошибки. |
|
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Type |
Description |
|
status |
Тип ответа.
|
|
|
errors |
Список ошибок. |