Поиск
API docs by Redocly

Общение с покупателями (communication)

Узнать больше об общении с покупателями можно в справочном центре

С помощью методов общения с покупателями вы можете работать с:

  1. Вопросами и отзывами покупателей
  2. Закреплёнными отзывами
  3. Чатами с покупателями
  4. Заявками покупателей на возврат

Общение с покупателями

Узнать больше об общении с покупателями можно в справочном центре

С помощью методов общения с покупателями вы можете работать с:

  1. Вопросами и отзывами покупателей
  2. Закреплёнными отзывами
  3. Чатами с покупателями
  4. Заявками покупателей на возврат

Вопросы

Для доступа к методам используйте токен для категории Вопросы и отзывы
Узнать больше о вопросах можно в справочном центре

Методы для получения вопросов:

  1. Непросмотренные отзывы и вопросы
  2. Неотвеченные вопросы
  3. Количество вопросов
  4. Список вопросов

Вы можете получить один вопрос по его ID и работать с полученными вопросами.

Непросмотренные отзывы и вопросы{{ /api/v1/new-feedbacks-questions }}

Описание метода

Метод проверяет наличие непросмотренных вопросов и отзывов от покупателей. Если у продавца есть непросмотренные вопросы или отзывы, возвращает true.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Неотвеченные вопросы{{ /api/v1/questions/count-unanswered }}

Описание метода

Метод возвращает общее количество неотвеченных вопросов и количество неотвеченных вопросов за сегодня.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Количество вопросов{{ /api/v1/questions/count }}

Описание метода

Метод возвращает количество отвеченных или неотвеченных вопросов за заданный период.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
dateFrom
integer
Example: dateFrom=1688465092

Дата начала периода в формате Unix timestamp

dateTo
integer
Example: dateTo=1688465092

Дата конца периода в формате Unix timestamp

isAnswered
boolean
Example: isAnswered=false

Есть ли ответ на вопрос:

  • true — да, по умолчанию
  • false — нет

Responses

Response samples

Content type
application/json
{
  • "data": 77,
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Список вопросов{{ /api/v1/questions }}

Описание метода

Метод возвращает список вопросов по заданным фильтрам. Вы можете:

  • получить данные отвеченных и неотвеченных вопросов
  • сортировать вопросы по дате
  • настроить пагинацию и количество вопросов в ответе
Можно получить максимум 10 000 вопросов в одном ответе
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
isAnswered
required
boolean

Есть ли ответ на вопрос:

  • true — да, по умолчанию
  • false — нет
nmId
integer

Артикул WB

take
required
integer

Количество запрашиваемых вопросов (максимально допустимое значение для параметра - 10 000, при этом сумма значений параметров take и skip не должна превышать 10 000)

skip
required
integer

Количество вопросов для пропуска (максимально допустимое значение для параметра - 10 000, при этом сумма значений параметров take и skip не должна превышать 10 000)

order
string

Сортировка вопросов по дате (dateAsc/dateDesc)

dateFrom
integer
Example: dateFrom=1688465092

Дата начала периода в формате Unix timestamp

dateTo
integer
Example: dateTo=1688465092

Дата конца периода в формате Unix timestamp

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Работа с вопросами{{ /api/v1/questions }}

Описание метода

В зависимости от тела запроса, метод позволяет:

  • отметить вопрос как просмотренный
  • отклонить вопрос
  • ответить на вопрос или отредактировать ответ
Отредактировать ответ на вопрос можно 1 раз в течение 60 дней после отправки ответа
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
One of
id
required
string

Id вопроса

wasViewed
required
boolean

Просмотрен ли вопрос

Responses

Request samples

Content type
application/json
Example

Просмотреть вопрос

{
  • "id": "n5um6IUBQOOSTxXoo0gV",
  • "wasViewed": true
}

Response samples

Content type
application/json
{
  • "data": null,
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Получить вопрос по ID{{ /api/v1/question }}

Описание метода

Метод возвращает данные вопроса по его ID. Далее вы можете работать с этим вопросом.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
id
required
string
Example: id=ljAVapEBL38RyMdRln61

ID вопроса

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Отзывы

Для доступа к методам используйте токен для категории Вопросы и отзывы
Узнать больше об отзывах можно в справочном центре

Методы для получения отзывов:

  1. Непросмотренные отзывы и вопросы
  2. Необработанные отзывы
  3. Количество отзывов
  4. Список отзывов
  5. Список архивных отзывов

Вы можете получить товар один отзыв по его ID и работать с полученными вопросами через методы:

  1. Ответить на отзыв
  2. Отредактировать ответ на отзыв
  3. Возврат товара по ID отзыва

Необработанные отзывы{{ /api/v1/feedbacks/count-unanswered }}

Описание метода

Метод возвращает:

  • количество необработанных отзывов за сегодня и за всё время
  • среднюю оценку всех отзывов
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Количество отзывов{{ /api/v1/feedbacks/count }}

Описание метода

Метод возвращает количество обработанных или необработанных отзывов за заданный период.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
dateFrom
integer
Example: dateFrom=1688465092

Дата начала периода в формате Unix timestamp

dateTo
integer
Example: dateTo=1688465092

Дата конца периода в формате Unix timestamp

isAnswered
boolean
Example: isAnswered=false

Обработан ли отзыв:

  • true — да, по умолчанию
  • false — нет

Responses

Response samples

Content type
application/json
{
  • "data": 724583,
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

Список отзывов{{ /api/v1/feedbacks }}

Описание метода

Метод возвращает список отзывов по заданным фильтрам. Вы можете:

  • получить данные обработанных и необработанных отзывов
  • сортировать отзывы по дате
  • настроить пагинацию и количество отзывов в ответе
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
isAnswered
required
boolean
Example: isAnswered=false

Обработан ли отзыв:

  • true — да, по умолчанию
  • false — нет
nmId
integer
Example: nmId=5870243

Артикул WB

take
required
integer
Example: take=1

Количество отзывов (max. 5 000)

skip
required
integer
Example: skip=0

Количество отзывов для пропуска (max. 199990)

order
string
Enum: "dateAsc" "dateDesc"

Сортировка отзывов по дате (dateAsc/dateDesc)

dateFrom
integer
Example: dateFrom=1688465092

Дата начала периода в формате Unix timestamp

dateTo
integer
Example: dateTo=1688465092

Дата конца периода в формате Unix timestamp

Responses

Response samples

Content type
application/json
{}

Ответить на отзыв{{ /api/v1/feedbacks/answer }}

Описание метода

Метод позволяет ответить на отзыв покупателя.

ID отзыва не валидируется. Если в запросе вы передали некорректный ID, вы не получите ошибку.
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
id
required
string

ID отзыва

text
required
string [ 2 .. 5000 ]

Текст ответа

Responses

Request samples

Content type
application/json
{
  • "id": "J2FMRjUj6hwvwCElqssz",
  • "text": "Спасибо за Ваш отзыв!"
}

Response samples

Content type
application/json
Example

Не указан заголовок Content-Type

{
  • "title": "bad request",
  • "requestId": "e6c4100223db8bf5818b2e5f12705891",
  • "origin": "fbapi",
  • "detail": "content-type header not specified"
}

Отредактировать ответ на отзыв{{ /api/v1/feedbacks/answer }}

Описание метода

Метод позволяет отредактировать уже отправленный ответ на отзыв покупателя.

Отредактировать ответ можно только один раз в течение 60 дней c момента отправки.

ID отзыва не валидируется. Если в запросе вы передали некорректный ID, вы не получите ошибку.
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
id
required
string

ID отзыва

text
required
string [ 2 .. 5000 ]

Текст ответа

Responses

Request samples

Content type
application/json
{
  • "id": "J2FMRjUj6hwvwCElqssz",
  • "text": "Спасибо за Ваш отзыв, он очень важен для нас!"
}

Response samples

Content type
application/json
{
  • "title": "unauthorized",
  • "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
  • "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
  • "requestId": "7b80742415072fe8b6b7f7761f1d1211",
  • "origin": "s2s-api-auth-catalog",
  • "status": 401,
  • "statusText": "Unauthorized",
  • "timestamp": "2024-09-30T06:52:38Z"
}

Возврат товара по ID отзыва{{ /api/v1/feedbacks/order/return }}

Описание метода

Метод запрашивает возврат товара, по которому оставлен отзыв.

Возврат доступен для отзывов с полем "isAbleReturnProductOrders": true.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
feedbackId
string

ID отзыва

Responses

Request samples

Content type
application/json
{
  • "feedbackId": "absdfgerrrfff1234"
}

Response samples

Content type
application/json
{
  • "data": { },
  • "error": true,
  • "errorText": "string",
  • "additionalErrors": [
    ]
}

Получить отзыв по ID{{ /api/v1/feedback }}

Описание метода

Метод возвращает данные отзыва по его ID.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
id
required
string
Example: id=G7Y9Y1kBAtKOitoBT_lV

ID отзыва

Responses

Response samples

Content type
application/json
{}

Список архивных отзывов{{ /api/v1/feedbacks/archive }}

Описание метода

Метод возвращает список архивных отзывов.

Отзыв становится архивным, если:

  • на отзыв получен ответ
  • на отзыв не получен ответ в течение 30 дней
  • в отзыве нет текста и фото
Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
nmId
integer
Example: nmId=14917842

Артикул WB

take
required
integer
Example: take=1

Количество отзывов (max. 5 000)

skip
required
integer
Example: skip=0

Количество отзывов для пропуска

order
string
Enum: "dateAsc" "dateDesc"

Сортировка отзывов по дате (dateAsc/dateDesc)

Responses

Response samples

Content type
application/json
{}

Закреплённые отзывы

Для доступа к методам используйте токен для категории Вопросы и отзывы
Узнать больше о закреплённых отзывах можно в справочном центре

С помощью этих методов вы можете:

  1. Получить список закреплённых и откреплённых отзывов
  2. Закрепить отзывы. Метод доступен по подписке Джем или c тарифной опцией Закрепление отзыва
  3. Открепить отзывы
  4. Получить количество закреплённых и откреплённых отзывов
  5. Получить лимиты закреплённых отзывов по подписке и тарифной опции

Список закреплённых и откреплённых отзывов{{ /api/feedbacks/v1/pins }}

Описание метода

Метод предоставляет список закреплённых и откреплённых отзывов.
Откреплёнными считаются только отзывы, которые были откреплены автоматически по причинам, указанным в ответе в поле unpinnedCause.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
state
string
Enum: "pinned" "unpinned"
Example: state=pinned

Закреплён ли отзыв:

  • pinned — да
  • unpinned — нет
pinOn
string
Enum: "nm" "imt"
Example: pinOn=nm

Место закрепления отзыва:

  • nm — карточка товара
  • imt — объединённая карточка
imtId
integer
Example: imtId=256972151

ID объединённой карточки товара.
Все артикулы WB объединённой карточки товара имеют один и тот же imtId.
У каждой карточки товара есть imtId, даже если она не объединена с другими карточками

nmId
integer
Example: nmId=177974151

Артикул WB

feedbackId
integer
Example: feedbackId=789

ID отзыва

dateFrom
string <date-time>
Example: dateFrom=2020-01-01T15:04:05Z

Дата закрепления первого отзыва в списке

dateTo
string <date-time>
Example: dateTo=2020-02-01T15:04:05Z

Дата закрепления последнего отзыва в списке

next
integer
Example: next=741

ID последней операции закрепления (пагинатор)

limit
integer <= 500
Default: 500
Example: limit=100

Количество отзывов на одной странице (пагинация)

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "next": 200
}

Закрепить отзывы{{ /api/feedbacks/v1/pins }}

Описание метода

Метод позволяет закрепить отзывы в карточке товара или в объединённой карточке.
Чтобы получить ID отзывов, используйте метод Список закреплённых и откреплённых отзывов.

Метод доступен по подписке Джем или c тарифной опцией Закрепление отзыва.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
Array (<= 500 items)
pinMethod
required
string
Enum: "tariff" "subscription"

Метод закрепления:

  • subscription — подписка Джем
  • tariff — тарифная опция
pinOn
required
string
Enum: "nm" "imt"

Место закрепления отзыва:

  • nm — карточка товара
  • imt — объединённая карточка
feedbackId
required
string

ID отзыва

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Открепить отзывы{{ /api/feedbacks/v1/pins }}

Описание метода

Метод позволяет открепить отзывы в карточке товара или в объединённой карточке.
Чтобы получить pinId — ID операций закрепления, используйте метод Список закреплённых и откреплённых отзывов.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
required

Список pinId — ID операций закрепления отзывов

Array (<= 500 items)
integer

Responses

Request samples

Content type
application/json
[
  • 123456,
  • 234567,
  • 345678
]

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Количество закреплённых и откреплённых отзывов{{ /api/feedbacks/v1/pins/count }}

Описание метода

Метод возвращает количество закреплённых и откреплённых отзывов за заданный период.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey
query Parameters
state
string
Enum: "pinned" "unpinned"
Example: state=pinned

Закреплён ли отзыв:

  • pinned — да
  • unpinned — нет
pinOn
string
Enum: "nm" "imt"
Example: pinOn=nm

Место закрепления отзыва:

  • nm — карточка товара
  • imt — объединённая карточка
imtId
integer
Example: imtId=256971531

ID объединённой карточки товара.
Все артикулы WB объединённой карточки товара имеют один и тот же imtId.
У каждой карточки товара есть imtId, даже если она не объединена с другими карточками

nmId
integer
Example: nmId=177974151

Артикул WB

feedbackId
integer
Example: feedbackId=789

ID отзыва

dateFrom
string <date-time>
Example: dateFrom=2020-01-01T15:04:05Z

Дата закрепления первого отзыва в списке

dateTo
string <date-time>
Example: dateTo=2020-02-01T15:04:05Z

Дата закрепления последнего отзыва в списке

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

Лимиты закреплённых отзывов{{ /api/feedbacks/v1/pins/limits }}

Описание метода

Метод возвращает лимиты закреплённых отзывов по тарифу и подписке.

Лимит запросов на один аккаунт продавца для всех методов категории Вопросы и отзывы:
Период Лимит Интервал Всплеск
1 секунда 3 запроса 333 миллисекунды 6 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "data": {
    }
}

Чат с покупателями

Для доступа к методам используйте токен для категории Чат с покупателями
Узнать больше о чате с покупателями можно в справочном центре

Чат позволяет продавцам и покупателям общаться напрямую.
Покупатели могут обращаться с вопросами по товарам или претензиями. Рекомендуем отвечать на сообщения в чате в течение 10 дней.



Чат всегда начинает покупатель. В одном чате можно общаться только с одним покупателем.

Обработка заявок на возврат товара доступна только в веб-версии чатов с покупателями.

Работа с чатами:

  1. Получите список чатов. Сохраните ID чатов в своей базе данных — это позволит обновлять информацию о чатах при получении событий.
  2. Получите события чатов: сообщения. У новых чатов значение поля isNewChat будет true.
  3. Отправляйте сообщения в чат

Список чатов{{ /api/v1/seller/chats }}

Описание метода

Метод возвращает список всех чатов продавца. По этим данным можно получить события чатов или отправить сообщение покупателю.

Лимит запросов на один аккаунт продавца:
Период Лимит Интервал Всплеск
10 секунд 10 запросов 1 секунда 10 запросов
Authorizations:
HeaderApiKey

Responses

Response samples

Content type
application/json
{
  • "result": [
    ],
  • "errors": null
}

События чатов{{ /api/v1/seller/events }}

Описание метода

Метод возвращает список событий всех чатов с покупателями.

Чтобы получить все события:

  1. Сделайте первый запрос без параметра next.
  2. Повторяйте запрос со значением параметра next из ответа на предыдущий запрос, пока totalEvents не станет равным 0. Это будет означать, что вы получили все события.
Лимит запросов на один аккаунт продавца:
Период Лимит Интервал Всплеск
10 секунд 10 запросов 1 секунда 10 запросов
Authorizations:
HeaderApiKey
query Parameters
next
integer

Пагинатор. С какого момента получить следующий пакет данных.
Формат Unix timestamp с миллисекундами

Responses

Response samples

Content type
application/json
{
  • "result": {
    },
  • "errors": null
}

Отправить сообщение{{ /api/v1/seller/message }}

Описание метода

Метод отправляет сообщения в чат с покупателем.

Лимит запросов на один аккаунт продавца:
Период Лимит Интервал Всплеск
10 секунд 10 запросов 1 секунда 10 запросов
Authorizations:
HeaderApiKey
Request Body schema: multipart/form-data
required
replySign
required
string <= 255 characters

Подпись чата. Можно получить из информации по чату или данных события, если в событии есть поле "isNewChat": true.

message
string <= 1000 characters

Текст сообщения. Максимум 1000 символов.

file
Array of strings <binary> [ items <binary > ]

Файлы, формат JPEG, PDF или PNG, максимальный размер — 5 Мб каждый. Максимальный суммарный размер файлов — 30 Мб.

Responses

Response samples

Content type
application/json
{
  • "result": {
    },
  • "errors": [ ]
}

Получить файл из сообщения{{ /api/v1/seller/download/{id} }}

Описание метода

Метод возвращает файл или изображение из сообщения по его ID.

Лимит запросов на один аккаунт продавца:
Период Лимит Интервал Всплеск
10 секунд 10 запросов 1 секунда 10 запросов
Authorizations:
HeaderApiKey
path Parameters
id
required
string

ID файла, см. значение поля downloadID в методе События чатов

Responses

Response samples

Content type
application/json

Недействительный ID файла

{
  • "status": 400,
  • "title": "invalid fileID",
  • "origin": "proxy-chats",
  • "detail": "invalid fileID",
  • "requestId": "62f59a4ce21064f20b1bbc28c85f38d8",
  • "error": "invalid fileID"
}

Возвраты покупателями

Для доступа к методам используйте токен для категории Возвраты покупателями
Узнать больше о возвратах покупателями можно в справочном центре

С помощью этих методов вы можете:

  1. Отслеживать заявки покупателей на возврат
  2. Отвечать на заявки

Заявки покупателей на возврат{{ /api/v1/claims }}

Описание метода

Метод возвращает заявки покупателей на возврат товаров за последние 14 дней. Вы можете отвечать на эти заявки.

Лимит запросов на один аккаунт продавца:
Период Лимит Интервал Всплеск
1 минута 20 запросов 3 секунды 10 запросов
Authorizations:
HeaderApiKey
query Parameters
is_archive
required
boolean
Example: is_archive=true

Состояние заявки:

  • false — на рассмотрении
  • true — в архиве
id
string <UUID>
Example: id=fe3e9337-e9f9-423c-8930-946a8ebef80

ID заявки

limit
integer <uint> [ 1 .. 200 ]
Example: limit=50

Количество заявок в ответе. По умолчанию 50

offset
integer <uint> >= 0
Example: offset=0

После какого элемента выдавать данные. По умолчанию 0

nm_id
integer
Example: nm_id=196320101

Артикул WB

Responses

Response samples

Content type
application/json
{
  • "claims": [
    ],
  • "total": 31
}

Ответ на заявку покупателя{{ /api/v1/claim }}

Описание метода

Метод отправляет ответ на заявку покупателя на возврат товаров.

Лимит запросов на один аккаунт продавца:
Период Лимит Интервал Всплеск
1 минута 20 запросов 3 секунды 10 запросов
Authorizations:
HeaderApiKey
Request Body schema: application/json
required

Ответ на заявку

id
required
string <UUID>

ID заявки

action
required
string

Действие с заявкой.
Используйте одно из значений массива actions — ответа метода получения заявок

comment
string [ 10 .. 1000 ] characters

Комментарий.
Применимо только при "action":"rejectcustom" или "action":"approvecc1". При "action":"rejectcustom" параметр обязателен

Responses

Request samples

Content type
application/json
{
  • "id": "fe3e9337-e9f9-423c-8930-946a8ebef80",
  • "action": "rejectcustom",
  • "comment": "Фото не имеет отношения к товару в заявке"
}

Response samples

Content type
application/json; charset=utf-8
{
  • "title": "Validation error",
  • "detail": "Input model is not valid; Details: The Action field is required.",
  • "requestId": "0HN3PI6JUGFSL:00000004"
}