Общение с покупателями (communication)
В методах общения с покупателем вы можете работать с:
- Вопросами и отзывами покупателей
- Шаблонами ответов на вопросы и отзывы
- Чатами с покупателями
- Заявками покупателей на возврат
В методах общения с покупателем вы можете работать с:
- Вопросами и отзывами покупателей
- Шаблонами ответов на вопросы и отзывы
- Чатами с покупателями
- Заявками покупателей на возврат
Методы для получения вопросов:
- Непросмотренные отзывы и вопросы
- Неотвеченные вопросы
- Количество вопросов
- Список вопросов
- Получить вопросы в формате XLSX
Вы можете получить один вопрос по его ID и работать с полученными вопросами.
Непросмотренные отзывы и вопросы{{ /api/v1/new-feedbacks-questions }}
Метод проверяет наличие непросмотренных вопросов и отзывов от покупателей. Если у продавца есть непросмотренные вопросы или отзывы, возвращает true
.
Если превысить лимит в 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
}
Методы для получения отзывов:
- Непросмотренные отзывы и вопросы
- Необработанные отзывы
- Количество отзывов
- Список отзывов
- Получить отзывы в формате XLSX
- Список архивных отзывов
Вы можете получить товар один отзыв по его ID и работать с полученными вопросами через методы:
Необработанные отзывы{{ /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/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 }}
Метод позволяет:
- подать жалобу на отзыв
- сообщить о проблеме с товаром из отзыва
Если превысить лимит в 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 }}
Метод позволяет ответить на отзыв покупателя.
Если превысить лимит в 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 дней c момента отправки.
Если превысить лимит в 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
}
Получить шаблоны ответов на вопросы и отзывы{{ /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 }}
Метод предоставляет список событий всех чатов с покупателями.
Чтобы получить все события:
- Сделайте первый запрос без параметра
next
. - Повторяйте запрос со значением параметра
next
из ответа на предыдущий запрос, покаtotalEvents
не станет равным0
. Это будет означать, что вы получили все события.
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",
- "srid": "v5o_7143225816503318733.0.0"
}
], - "total": 31
}
Ответ на заявку покупателя{{ /api/v1/claim }}
Метод отправляет ответ на заявку покупателя на возврат товаров.
Authorizations:
Request Body schema: application/jsonrequired
Ответ на заявку
id required | string <UUID> ID заявки |
action required | 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"
}