Общение с покупателями (communication)
Управление вопросами и отзывами покупателей, шаблонами ответов, чатами, обработка возвратов
Управление вопросами и отзывами покупателей, шаблонами ответов, чатами, обработка возвратов
Непросмотренные отзывы и вопросы{{ /api/v1/new-feedbacks-questions }}
Возвращает информацию о наличии непросмотренных отзывов и вопросов у продавца
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Responses
Response samples
- 200
- 401
- 403
- 429
{- "data": {
- "hasNewQuestions": true,
- "hasNewFeedbacks": false
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Неотвеченные вопросы{{ /api/v1/questions/count-unanswered }}
Возвращает количество неотвеченных вопросов за сегодня и за всё время
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Responses
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "countUnanswered": 24,
- "countUnansweredToday": 0
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Количество вопросов{{ /api/v1/questions/count }}
Возвращает количество вопросов за заданный период
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
dateFrom | integer Example: dateFrom=1688465092 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1688465092 Дата конца периода в формате Unix timestamp |
isAnswered | boolean Example: isAnswered=false Обработанные вопросы ( |
Responses
Response samples
- 200
- 401
- 403
- 429
{- "data": 77,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Список вопросов{{ /api/v1/questions }}
Возвращает список вопросов по заданным параметрам с пагинацией и сортировкой
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
isAnswered required | boolean Отвеченные вопросы ( |
nmId | integer Артикул WB |
take required | integer Количество запрашиваемых вопросов (максимально допустимое значение для параметра - 10 000, при этом сумма значений параметров |
skip required | integer Количество вопросов для пропуска (максимально допустимое значение для параметра - 10 000, при этом сумма значений параметров |
order | string Сортировка вопросов по дате ( |
dateFrom | integer Example: dateFrom=1688465092 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1688465092 Дата конца периода в формате Unix timestamp |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "countUnanswered": 24,
- "countArchive": 508,
- "questions": [
- {
- "id": "2ncBtX4B9I0UHoornoqG",
- "text": "Question text",
- "createdDate": "2022-02-01T11:18:08.769513469Z",
- "state": "suppliersPortalSynch",
- "answer": null,
- "productDetails": {
- "imtId": 11157265,
- "nmId": 14917842,
- "productName": "Coffee",
- "supplierArticle": "123401",
- "supplierName": " ГП Реклама и услуги",
- "brandName": "Nescafe"
}, - "wasViewed": false,
- "isWarned": false
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Работа с вопросами{{ /api/v1/questions }}
В зависимости от тела запроса позволяет:
- Просмотреть вопрос
- Отклонить вопрос
- Ответить на вопрос или отредактировать ответ
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
id required | string Id вопроса |
wasViewed required | boolean Просмотрен ( |
Responses
Request samples
- Payload
Просмотреть вопрос
{- "id": "n5um6IUBQOOSTxXoo0gV",
- "wasViewed": true
}
Response samples
- 200
- 400
- 401
- 403
- 404
- 429
{- "data": null,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получить вопрос по ID{{ /api/v1/question }}
Возвращает вопрос по его ID
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
id required | string Example: id=ljAVapEBL38RyMdRln61 ID вопроса |
Responses
Response samples
- 200
- 401
- 429
{- "data": {
- "countUnanswered": 24,
- "countArchive": 508,
- "questions": [
- {
- "id": "2ncBtX4B9I0UHoornoqG",
- "text": "Question text",
- "createdDate": "2022-02-01T11:18:08.769513469Z",
- "state": "suppliersPortalSynch",
- "answer": null,
- "productDetails": {
- "imtId": 11157265,
- "nmId": 14917842,
- "productName": "Coffee",
- "supplierArticle": "123401",
- "supplierName": " ГП Реклама и услуги",
- "brandName": "Nescafe"
}, - "wasViewed": false,
- "isWarned": false
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получение вопросов в формате XLSX{{ /api/v1/questions/report }}
Возвращает файл с вопросами в формате XLSX в кодировке base64
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
isAnswered required | boolean Example: isAnswered=false Обработанные вопросы ( |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "fileName": "report.xlsx",
- "file": "UEsDBBQAC ... CAADMdQAAAAA=",
- "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Часто спрашиваемые товары{{ /api/v1/questions/products/rating }} Deprecated
Метод будет отключён 28 ноября.
Возвращает товары, про которые спрашивают чаще всего
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
size required | integer Example: size=1 Количество запрашиваемых товаров (max. 100) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "products": [
- {
- "nmId": 21573649,
- "imtId": 15384080,
- "productName": "Чехол для телефона iPhone 11",
- "brandName": "Case",
- "questionsCount": 11
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Необработанные отзывы{{ /api/v1/feedbacks/count-unanswered }}
Возвращает среднюю оценку всех отзывов и количество необработанных отзывов за сегодня и за всё время
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Responses
Response samples
- 200
- 400
- 401
- 429
{- "data": {
- "countUnanswered": 1,
- "countUnansweredToday": 0,
- "valuation": "4.7"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Количество отзывов{{ /api/v1/feedbacks/count }}
Возвращает количество отзывов
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
dateFrom | integer Example: dateFrom=1688465092 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1688465092 Дата конца периода в формате Unix timestamp |
isAnswered | boolean Example: isAnswered=false Обработанные отзывы( |
Responses
Response samples
- 200
- 401
- 403
- 429
{- "data": 724583,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Список отзывов{{ /api/v1/feedbacks }}
Возвращает список отзывов по заданным параметрам с пагинацией и сортировкой
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
isAnswered required | boolean Example: isAnswered=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
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "countUnanswered": 52,
- "countArchive": 1000,
- "feedbacks": [
- {
- "id": "YX52RZEBhH9mrcYdEJuD",
- "text": "Спасибо, всё подошло",
- "pros": "Удобный",
- "cons": "Нет",
- "productValuation": 5,
- "createdDate": "2024-09-26T10:20:48+03:00",
- "answer": {
- "text": "Пожалуйста. Ждём вас снова!",
- "state": "wbRu",
- "editable": false
}, - "state": "wbRu",
- "productDetails": {
- "imtId": 123456789,
- "nmId": 987654321,
- "productName": "ВАЗ",
- "supplierArticle": "DP02/черный",
- "supplierName": "ГП Реклама и услуги",
- "brandName": "Бест Трикотаж",
- "size": "0"
}, - "video": {
- "durationSec": 10
}, - "wasViewed": true,
- "photoLinks": [
], - "userName": "Николай",
- "matchingSize": "ok",
- "isAbleSupplierFeedbackValuation": false,
- "supplierFeedbackValuation": 1,
- "isAbleSupplierProductValuation": false,
- "supplierProductValuation": 2,
- "isAbleReturnProductOrders": false,
- "returnProductOrdersDate": "2024-08-20T16:39:49Z",
- "bables": [
- "цена"
], - "lastOrderShkId": 123456789,
- "lastOrderCreatedAt": "2024-08-12T10:20:48+03:00",
- "color": "colorless",
- "subjectId": 219,
- "subjectName": "Футболки-поло",
- "parentFeedbackId": null,
- "childFeedbackId": "bIjTCZDvJni7NGnLbUlf"
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Работа с отзывом{{ /api/v1/feedbacks }} Deprecated
Метод будет отключён 11 декабря.
В зависимости от тела запроса позволяет:
- Просмотреть отзыв
- Ответить на отзыв или отредактировать ответ
- Оценить отзыв и/или товар
Отредактировать ответ на отзыв можно 1 раз в течение 2 месяцев (60 дней) после отправки ответа
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
id required | string Id отзыва |
wasViewed required | boolean Просмотрен ( |
Responses
Request samples
- Payload
Просмотреть отзыв
{- "id": "n5um6IUBQOOSTxXoo0gV",
- "wasViewed": true
}
Response samples
- 400
- 401
- 403
- 404
- 422
- 429
Неправильный запрос
{- "data": null,
- "error": true,
- "errorText": "Something went wrong",
- "additionalErrors": null,
- "requestId": "734c9ea8-39e5-45c9-8cad-f03c13f733e9"
}
Получить списки причин жалоб на отзыв и проблем с товаром{{ /api/v1/supplier-valuations }}
Возвращает списки причин жалоб и проблем с товаром.
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
header Parameters
X-Locale | string Example: ru Выбор языка значений полей ответа ( |
Responses
Response samples
- 200
- 401
- 429
{- "data": {
- "feedbackValuations": {
- "1": "Отзыв не относится к товару",
- "2": "Отзыв оставили конкуренты",
- "3": "Спам",
- "4": "Нецензурное содержимое в фото",
- "5": "Нецензурная лексика",
- "6": "Фото не имеет отношения к товару",
- "7": "Отзыв с политическим контекстом"
}, - "productValuations": {
- "1": "Повредили при доставке",
- "2": "Товар подменили",
- "3": "Случайно отправил не тот товар и хочу его вернуть",
- "4": "Товар вернули после эксплуатации"
}
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Пожаловаться на отзыв, сообщить о проблеме с товаром{{ /api/v1/feedbacks/actions }}
Позволяет подать жалобу на отзыв и/или сообщить о проблеме с товаром из отзыва.
Валидация по ID отзыва отсутствует: если в запросе передано некорректное значение, вы не получите ошибку.
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
id required | string ID отзыва |
supplierFeedbackValuation | integer Причина жалобы на отзыв |
supplierProductValuation | integer Описание проблемы товара |
Responses
Request samples
- Payload
{- "id": "J2FMRjUj6hwvwCElqssz",
- "supplierFeedbackValuation": 1,
- "supplierProductValuation": 1
}
Ответить на отзыв{{ /api/v1/feedbacks/answer }}
Позволяет ответить на отзыв.
Валидация по ID отзыва отсутствует: если в запросе передано некорректное значение, вы не получите ошибку.
Максимум 1 запрос в секунду для всех методов категории Вопросы и отзывы на один аккаунт продавца.
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
id required | string ID отзыва |
text required | string [ 2 .. 5000 ] Текст ответа |
Responses
Request samples
- Payload
{- "id": "J2FMRjUj6hwvwCElqssz",
- "text": "Спасибо за Ваш отзыв!"
}
Отредактировать ответ на отзыв{{ /api/v1/feedbacks/answer }}
Позволяет отредактировать уже отправленный ответ на отзыв.
Отредактировать ответ можно только один раз в течение 60 дней.
Валидация по ID отзыва отсутствует: если в запросе передано некорректное значение, вы не получите ошибку.
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
id required | string ID отзыва |
text required | string [ 2 .. 5000 ] Текст ответа |
Responses
Request samples
- Payload
{- "id": "J2FMRjUj6hwvwCElqssz",
- "text": "Спасибо за Ваш отзыв, он очень важен для нас!"
}
Возврат товара по ID отзыва{{ /api/v1/feedbacks/order/return }}
Запрашивает на возврат товар, по которому оставлен отзыв.
Возврат доступен для отзывов с "isAbleReturnProductOrders": true
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/jsonrequired
feedbackId | string ID отзыва |
Responses
Request samples
- Payload
{- "feedbackId": "absdfgerrrfff1234"
}
Response samples
- 200
- 400
- 401
- 422
- 429
{- "data": { },
- "error": true,
- "errorText": "string",
- "additionalErrors": [
- "string"
]
}
Получить отзыв по ID{{ /api/v1/feedback }}
Возвращает отзыв по его ID
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
id required | string Example: id=G7Y9Y1kBAtKOitoBT_lV ID отзыва |
Responses
Response samples
- 200
- 401
- 429
{- "data": {
- "id": "YX52RZEBhH9mrcYdEJuD",
- "text": "Спасибо, всё подошло",
- "pros": "Удобный",
- "cons": "Нет",
- "productValuation": 5,
- "createdDate": "2024-09-26T10:20:48+03:00",
- "answer": {
- "text": "Пожалуйста. Ждём вас снова!",
- "state": "wbRu",
- "editable": false
}, - "state": "wbRu",
- "productDetails": {
- "imtId": 123456789,
- "nmId": 987654321,
- "productName": "ВАЗ",
- "supplierArticle": "DP02/черный",
- "supplierName": "ГП Реклама и услуги",
- "brandName": "Бест Трикотаж",
- "size": "0"
}, - "video": {
- "durationSec": 10
}, - "wasViewed": true,
- "photoLinks": [
], - "userName": "Николай",
- "matchingSize": "ok",
- "isAbleSupplierFeedbackValuation": false,
- "supplierFeedbackValuation": 1,
- "isAbleSupplierProductValuation": false,
- "supplierProductValuation": 2,
- "isAbleReturnProductOrders": false,
- "returnProductOrdersDate": "2024-08-20T16:39:49Z",
- "bables": [
- "цена"
], - "lastOrderShkId": 123456789,
- "lastOrderCreatedAt": "2024-08-12T10:20:48+03:00",
- "color": "colorless",
- "subjectId": 219,
- "subjectName": "Футболки-поло",
- "parentFeedbackId": null,
- "childFeedbackId": "bIjTCZDvJni7NGnLbUlf"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получение отзывов в формате XLSX{{ /api/v1/feedbacks/report }}
Возвращает файл с отзывами в формате XLSX в кодировке base64 Можно получить максимум 5000 отзывов в одном ответе
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
isAnswered required | boolean Enum: true false Необработанный( |
skip | integer Example: skip=1 Параметр пагинации, указывает сколько отзывов пропустить (max. 20 000) |
dateFrom | integer Example: dateFrom=1696226971 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1698916171 Дата конца периода в формате Unix timestamp |
order | string Example: order=dateDesc Сортировка отзывов по дате (dateAsc/dateDesc) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "fileName": "report.xlsx",
- "file": "UEsDBBQA ... ACAADxGgAAAAA=",
- "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Список архивных отзывов{{ /api/v1/feedbacks/archive }}
Возвращает список архивных отзывов. Отзыв становится архивным, если:
- На отзыв получен ответ
- Ответ на отзыв не получен в течение 30 дней
- В отзыве нет текста и фото
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
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
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "feedbacks": [
- {
- "id": "YX52RZEBhH9mrcYdEJuD",
- "text": "Спасибо, всё подошло",
- "pros": "Удобный",
- "cons": "Нет",
- "productValuation": 5,
- "createdDate": "2024-09-26T10:20:48+03:00",
- "answer": {
- "text": "Пожалуйста. Ждём вас снова!",
- "state": "wbRu",
- "editable": false
}, - "state": "wbRu",
- "productDetails": {
- "imtId": 123456789,
- "nmId": 987654321,
- "productName": "ВАЗ",
- "supplierArticle": "DP02/черный",
- "supplierName": "ГП Реклама и услуги",
- "brandName": "Бест Трикотаж",
- "size": "0"
}, - "video": {
- "durationSec": 10
}, - "wasViewed": true,
- "photoLinks": [
], - "userName": "Николай",
- "matchingSize": "ok",
- "isAbleSupplierFeedbackValuation": false,
- "supplierFeedbackValuation": 1,
- "isAbleSupplierProductValuation": false,
- "supplierProductValuation": 2,
- "isAbleReturnProductOrders": false,
- "returnProductOrdersDate": "2024-08-20T16:39:49Z",
- "bables": [
- "цена"
], - "lastOrderShkId": 123456789,
- "lastOrderCreatedAt": "2024-08-12T10:20:48+03:00",
- "color": "colorless",
- "subjectId": 219,
- "subjectName": "Футболки-поло",
- "parentFeedbackId": null,
- "childFeedbackId": "bIjTCZDvJni7NGnLbUlf"
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Средняя оценка товара по артикулу WB{{ /api/v1/feedbacks/products/rating/nmid }} Deprecated
Метод будет отключён 28 ноября.
Возвращает среднюю оценку товара по его артикулу WB
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
nmId required | integer Example: nmId=14917842 Артикул WB |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "valuation": "4.3",
- "feedbacksCount": 16
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Родительские категории товаров{{ /api/v1/parent-subjects }} Deprecated
Метод будет отключён 28 ноября.
Возвращает список родительских категорий товаров продавца
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "subjectId": 1162,
- "subjectName": "Строительные инструменты"
}
], - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Товары с наибольшей и наименьшей средней оценкой по родительской категории{{ /api/v1/feedbacks/products/rating/top }} Deprecated
Метод будет отключён 28 ноября.
Возвращает список из двух товаров: с наибольшей и наименьшей средней оценкой по родительской категории
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
subjectId required | integer Example: subjectId=3109 id категории товара |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "productMaxRating": {
- "nmId": 14917842,
- "imtId": 11157265,
- "subjectId": 5135,
- "valuationsSum": 1260,
- "feedbacksCount": 252,
- "valuation": 5,
- "productName": "Кофе",
- "supplierArticle": "123401",
- "brandName": "Nescafe"
}, - "productMinRating": {
- "nmId": 14917846,
- "imtId": 11157269,
- "subjectId": 5134,
- "valuationsSum": 4,
- "feedbacksCount": 2,
- "valuation": 2,
- "productName": "Кофе",
- "supplierArticle": "425501",
- "brandName": "Nescafe"
}
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Средняя оценка товаров по родительской категории{{ /api/v1/feedbacks/products/rating }} Deprecated
Метод будет отключён 28 ноября.
Возвращает среднюю оценку товаров по родительской категории
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
subjectId required | integer Example: subjectId=3109 ID категории товара |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "valuation": "4.8",
- "feedbacksCount": 277
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
На некорректный запрос вы получите ответ со статус-кодом
200
и описанием ошибки.
Получить шаблоны ответов для вопросов и отзывов{{ /api/v1/templates }}
Возвращает шаблоны ответов для вопросов и отзывов
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
query Parameters
templateType required | integer Example: templateType=1
|
Responses
Response samples
- 200
- 401
- 429
Успешно
{- "data": {
- "templates": [
- {
- "id": "id",
- "name": "name",
- "text": "text"
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Создать шаблон{{ /api/v1/templates }}
Добавляет шаблон ответа на отзыв/вопрос. Можно создать максимум 20 шаблонов: 10 для отзывов и 10 для вопросов. Допустимы любые символы
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
name required | string Название шаблона (от 1 до 100 символов) |
templateType required | integer Тип шаблона |
text required | string Текст шаблона (от 2 до 1000 символов) |
Responses
Request samples
- Payload
{- "name": "name",
- "templateType": 1,
- "text": "text"
}
Response samples
- 200
- 401
- 429
Успешно
{- "data": {
- "id": "1234"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Редактировать шаблон{{ /api/v1/templates }}
Редактирует шаблон ответа на отзыв/вопрос. Допустимы любые символы
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
name required | string Название шаблона (от 1 до 100 символов) |
templateID required | string ID шаблона |
text required | string Текст шаблона (от 2 до 1000 символов) |
Responses
Request samples
- Payload
{- "name": "newname",
- "templateID": "1234fhbf34ew2",
- "text": "newtext"
}
Response samples
- 200
- 401
- 429
Успешно
{- "data": true,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Удалить шаблон{{ /api/v1/templates }}
Удаляет шаблон ответа на отзыв/вопрос
Если превысить лимит в 3 запроса в секунду, отправка запросов будет заблокирована на 60 секунд
Authorizations:
Request Body schema: application/json
templateID required | string ID шаблона (max. 1) |
Responses
Request samples
- Payload
{- "templateID": "1234fhbf34ew2"
}
Response samples
- 200
- 401
- 429
Успешно
{- "data": true,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Покупатели могут обращаться с вопросами по товарам или претензиями. Рекомендуем отвечать на сообщения в чате в течение 10 дней.
Чат всегда начинает покупатель. В одном чате можно общаться только с одним покупателем.
Работа с чатами:
- Получите список чатов. Сохраните ID чатов в своей базе данных — это позволит обновлять информацию о чатах при получении событий.
- Получите события чатов: сообщения и возвраты. У новых чатов значение поля
isNewChat
будетtrue
. - Отправляйте сообщения в чат
Список чатов{{ /api/v1/seller/chats }}
Возвращает список всех чатов продавца.
Authorizations:
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "result": [
- {
- "chatID": "1:361b656c-5c0e-295b-db03-3d5b4d454c32",
- "replySign": "1:361b656c-5c0e-295b-db03-3d5b4d454c32:45734505:238d4d4925998ce295632034545f2fdf88892414c0f24bb48ac5d89f7866cff95022ef33d6563575d656bce676e4d36b48ed6084997347e55601646af6b37d96",
- "clientID": "12345",
- "clientName": "Иван"
}, - {
- "chatID": "1:578903a4-c140-b95b-9d51-896c58ab22dc",
- "replySign": "1:578903a4-c140-b95b-9d51-896c58ab22dc:60012000:8b42800e4be81b56071bfac84a01b1da5a79f7b7eea2a08c3a7efe7e5d63face7240b9036d4a21ce9fe1eeeda1d7cfe27d241edced755267304922f3eb935467",
- "clientID": "987654",
- "clientName": "Владислав"
}
], - "errors": null
}
События чатов{{ /api/v1/seller/events }}
Возвращает список событий всех чатов.
Чтобы получить все события:
1. Сделайте первый запрос без параметра next
.
2. Повторяйте запрос со значением параметра next
из ответа на предыдущий запрос, пока totalEvents
не станет равным 0
. Это будет означать, что вы получили все события.
Чтобы получать только новые события, укажите параметр next
со значением поля addTimestamp
из последнего полученного события.
Authorizations:
query Parameters
next | integer Пагинатор. С какого момента получить следующий пакет данных. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "result": {
- "next": 1698045576000,
- "newestEventTime": "2023-10-23T07:19:36Z",
- "oldestEventTime": "2023-10-23T05:02:20Z",
- "totalEvents": 4,
- "events": [
- {
- "chatID": "1:1e265a58-a120-b178-008c-60af2460207c",
- "eventID": "55adee45-11f0-33b6-a847-6ccc7c78b2ec",
- "eventType": "message",
- "isNewChat": true,
- "message": {
- "attachments": {
- "goodCard": {
- "date": "2023-10-18T11:46:01.528526Z",
- "needRefund": false,
- "nmID": 12345678,
- "price": 500,
- "priceCurrency": "RUB",
- "rid": "2fb52cd9e25e52538a5f05994e688ae5",
- "size": "0",
- "statusID": 11
}, - "files": [
- {
- "contentType": "application/pdf",
- "date": "2023-10-23T08:02:19.594Z",
- "name": "Чек.pdf",
- "size": 1046143
}
], - "images": [
- {
- "date": "2023-10-23T08:02:20.717Z",
}
]
}, - "text": "Здравствуйте! У меня вопрос по товару \"Альбом, бренд Эконом, артикул 13480414, товар получен 18.10.2023\""
}, - "source": "rusite",
- "addTimestamp": 1698037340000,
- "addTime": "2023-10-23T05:02:20Z",
- "replySign": "1:1e265a58-a120-b178-008c-60af2460207c:66f136e919a8207e136757754f253189bfb9ae1ad9da9170c9d5c478626663908888c370216525bef51c0ca8d77952e05c9c17f9b63ab00374c5555b42efc07d",
- "sender": "client",
- "clientID": "186132",
- "clientName": "Алёна"
}, - {
- "chatID": "1:1e265a58-a120-b178-008c-60af2460207c",
- "eventID": "cef95d3c-0345-4dc9-b6df-4c8c57a176a9",
- "eventType": "message",
- "message": {
- "text": "Здравствуйте! Пришёл не тот цвет. Можно вернуть и заказать другой товар?"
}, - "source": "rusite",
- "addTimestamp": 1698037387000,
- "addTime": "2023-10-23T05:03:07Z",
- "sender": "client",
- "clientID": "186132",
- "clientName": "Алёна"
}, - {
- "chatID": "1:1e265a58-a120-b178-008c-60af2460207c",
- "eventID": "fd22e5bf-64fd-43f7-b3a0-ad29uu027f97",
- "eventType": "message",
- "message": {
- "text": "Здравствуйте. Да, сейчас оформим возврат."
}, - "source": "seller-public-api",
- "addTimestamp": 1698038124000,
- "addTime": "2023-10-23T05:15:24Z",
- "sender": "seller"
}, - {
- "chatID": "1:1e265a58-a120-b178-008c-60af2460207c",
- "eventID": "cef95d3c-0345-4dc9-b6df-4c8c75a176a7",
- "eventType": "refund",
- "refund": {
- "actionType": "sellerRequestRefund",
- "price": 500,
- "priceCurrency": "RUB",
- "rid": "2fb52cd9e25e52538a5f05994e688ae5"
}, - "addTimestamp": 1698045576000,
- "addTime": "2023-10-23T07:19:36Z",
- "sender": "seller"
}
]
}, - "errors": null
}
Отправить сообщение{{ /api/v1/seller/message }}
Отправляет сообщения покупателю
Authorizations:
Request Body schema: multipart/form-datarequired
replySign required | string <= 255 characters Подпись чата. Можно получить из информации по чату или данных события, если в событии есть поле |
message | string <= 1000 characters Текст сообщения. Максимум 1000 символов. |
file | Array of strings <binary> [ items <binary > ] Файлы, формат JPEG, PDF или PNG, максимальный размер — 5 Мб каждый. Максимальный суммарный размер файлов — 30 Мб. |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "result": {
- "addTime": 1712848270018,
- "chatID": "1:641b623c-5c0e-295b-db03-3d5b4d484c32"
}, - "errors": [ ]
}
Заявки покупателей на возврат{{ /api/v1/claims }}
Возвращает заявки покупателей на возврат товаров за текущие 14 дней
Authorizations:
query Parameters
is_archive required | boolean Example: is_archive=true Состояние заявки:
|
id | string <UUID> Example: id=fe3e9337-e9f9-423c-8930-946a8ebef80 ID заявки |
limit | integer <uint> [ 1 .. 200 ] Example: limit=50 Количество заявок в ответе. По умолчанию |
offset | integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные. По умолчанию |
nm_id | integer Example: nm_id=196320101 Артикул WB |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "claims": [
- {
- "id": "fe3e9337-e9f9-423c-8930-946a8ebef80",
- "claim_type": 1,
- "status": 2,
- "status_ex": 8,
- "nm_id": 196320101,
- "user_comment": "Длина провода не соответствует описанию",
- "wb_comment": "Продавец одобрил вашу заявку на возврат. В течение 14 дней принесите товар в определённый пункт выдачи — всё зависит от того, как вы получали заказ:\r\n\r\n∙ В пункте выдачи. Тогда нужно будет вернуть в тот же пункт по тому же адресу. \r\n∙ Курьером. Зайдите в раздел «Покупки» на сайте — там будет адрес пункта, в который нужно принести товар.\r\n\r\nВозьмите с собой пакет со штрих-кодом, в котором был товар. Если вы его потеряли или выбросили — ничего страшного, мы всё равно сможем провести возврат. Но в будущем, пожалуйста, сохраняйте этот пакет. \r\n\r\nДеньги придут на вашу карту или счёт в течение 10 дней после возврата товара на склад.\r\n\r\nЕсли у вас крупногабаритный товар, то для его возврата вызовите курьера через раздел «Доставки».",
- "dt": "2024-03-26T17:06:12.245611",
- "imt_name": "Кабель 0.5 м, 3797",
- "order_dt": "2020-10-27T05:18:56",
- "dt_update": "2024-05-10T18:01:06.999613",
- "photos": [
- "//photos.wbstatic.net/claim/fe3e9337-e9f9-423c-8930-946a8ebef80/1.webp",
- "//photos.wbstatic.net/claim/fe3e9337-e9f9-423c-8930-946a8ebef80/2.webp"
], - "video_paths": [
- "//video.wbstatic.net/claim/fe3e9337-e9f9-423c-8930-946a8ebef80/1.mp4"
], - "actions": [
- "autorefund1",
- "approve1"
], - "price": 157,
- "currency_code": "643"
}
], - "total": 31
}
Ответ на заявку покупателя{{ /api/v1/claim }}
Отправляет ответ на заявку покупателя на возврат.
Authorizations:
Request Body schema: application/jsonrequired
Ответ на заявку
id | string <UUID> ID заявки |
action | string Действие с заявкой. |
comment | string [ 10 .. 1000 ] characters Комментарий. Только при |
Responses
Request samples
- Payload
{- "id": "fe3e9337-e9f9-423c-8930-946a8ebef80",
- "action": "rejectcustom",
- "comment": "Фото не имеет отношения к товару в заявке"
}
Response samples
- 400
- 401
- 429
{- "title": "Validation error",
- "detail": "Input model is not valid; Details: The Action field is required.",
- "requestId": "0HN3PI6JUGFSL:00000004"
}