Публичный API Marketplace создано для синхронизации данных между серверами Wildberries и серверами продавцов.
Вы загружаете данные на свои носители, работаете с ними на своих мощностях и синхронизируетесь с нашими серверами по мере необходимости.
Ограничения по запросам:
Метод PATCH api/v3/supplies/{supplyId}/orders/{orderId} "Добавить сборочное задание к поставке" - 1 000 запросов в минуту.
Методы
PUT /api/v3/orders/{orderId}/meta/uin "Закрепить за сборочным заданием УИН"
PUT /api/v3/orders/{orderId}/meta/imei "Закрепить за сборочным заданием IMEI"
PUT /api/v3/orders/{orderId}/meta/gtin "Закрепить за сборочным заданием GTIN"
PUT /api/v3/orders/{orderId}/meta/sgtin "Закрепить за сборочным заданием КиЗ (маркировку Честного знака)"
- суммарно 1 000 запросов в минуту.
Остальные методы - 300 запросов в минуту, в целом.
Не допускается использование API Marketplace в качестве внешней базы данных.
Описание основных ошибок в Marketplace:
| Код | Описание |
| StatusNotAcceptable | Обновление остатков заблокировано в связи с баном поставщика |
| UinIsNotFilled | Перевод в статус 'в доставке' невозможен. Введите УИНы для всех сборочных заданий, где это необходимо. |
| InternalServerError | Внутренняя ошибка сервера |
| Unauthorized | Пользователь не авторизован |
| AccessDenied | Доступ запрещён |
| IncorrectRequestBody | Некорректное тело запроса |
| IncorrectRequest | Переданы некорректные данные |
| NotFound | Не найдено |
| UploadDataLimit | Превышен лимит загружаемых данных |
| SubjectDBSRestriction | Категория товара недоступна для продажи по схеме 'Везу на склад Wildberries' |
| SubjectFBSRestriction | Категория товара недоступна для продажи по схеме 'Везу самостоятельно до покупателя' |
| CargoWarehouseRestriction | Выбранный склад не предназначен для крупногабаритных товаров. Добавьте их на соответствующий склад |
| IncorrectParameter | Передан некорректный параметр |
| SupplyHasOrders | Не удалось обработать поставку. Убедитесь, что за ней не осталось закреплённых сборочных заданий |
| SupplyHasZeroOrders | Не удалось обработать поставку. Убедитесь, что за ней закреплено хотя бы одно сборочное задание |
| SupplyHasEmptyTrbx | В поставке есть пустые короба. Удалите их или вернитесь к распределению товаров |
| FailedToAddSupplyOrder | Не удалось закрепить сборочное задание за поставкой. Убедитесь, что сборочное задание и поставка удовлетворяют всем необходимым требованиям |
| StatusChangeNotAllowed | Задание перейдёт в завершенные после сканирования на ПВЗ |
| StatusMismatch | Несоответствие статусов, проверьте их правильность |
| SupplyNotClosed | Поставка не передана в доставку |
| PassValidationError | *причина* |
| SupplierBanned | Пользователь заблокирован: *причина* |
Возвращает список всех новых сборочных заданий у продавца на данный момент.
Array of objects (OrderNew) Список новых сборочных заданий |
{- "orders": [
- {
- "address": {
- "fullAddress": "Челябинская область, г. Челябинск, 51-я улица Арабкира, д. 10А, кв. 42",
- "province": "",
- "area": "",
- "city": "",
- "street": "",
- "home": "",
- "flat": "",
- "entrance": "",
- "longitude": 44.519068,
- "latitude": 40.20192
}, - "ddate": "17.05.2024",
- "dTimeFrom": "15:00",
- "dTimeTo": "16:00",
- "requiredMeta": [
- "uin"
], - "deliveryType": "dbs",
- "scanPrice": null,
- "orderUid": "165918930_629fbc924b984618a44354475ca58675",
- "article": "one-ring-7548",
- "colorCode": "RAL 3017",
- "rid": "f884001e44e511edb8780242ac120002",
- "createdAt": "2022-05-04T07:56:29Z",
- "offices": [
- "Калуга"
], - "skus": [
- "6665956397512"
], - "id": 13833711,
- "warehouseId": 658434,
- "nmId": 123456789,
- "chrtId": 987654321,
- "price": 1014,
- "convertedPrice": 28322,
- "currencyCode": 933,
- "convertedCurrencyCode": 643,
- "cargoType": 1,
- "isZeroOrder": false
}
]
}Возвращает информацию по сборочным заданиям без их актуального статуса.
Можно выгрузить данные за конкретный период, максимум 30 календарных дней
| limit required | integer [ 1 .. 1000 ] Параметр пагинации. Устанавливает предельное количество возвращаемых данных. |
| next required | integer <int64> Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен 0 в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе. |
| dateFrom | integer Дата начала периода в формате Unix timestamp. По умолчанию — дата за 30 дней до запроса |
| dateTo | integer Дата конца периода в формате Unix timestamp |
| next | integer <int64> (Next) Параметр пагинации. Содержит значение, которое необходимо указать в запросе для получения следующего пакета данных |
Array of objects (Order) |
{- "next": 13833711,
- "orders": [
- {
- "address": {
- "fullAddress": "Челябинская область, г. Челябинск, 51-я улица Арабкира, д. 10А, кв. 42",
- "province": "Челябинская область",
- "area": "Челябинск",
- "city": "Город",
- "street": "51-я улица Арабкира",
- "home": "10А",
- "flat": "42",
- "entrance": "3",
- "longitude": 44.519068,
- "latitude": 40.20192
}, - "scanPrice": 1500,
- "deliveryType": "dbs",
- "supplyId": "WB-GI-92937123",
- "orderUid": "165918930_629fbc924b984618a44354475ca58675",
- "article": "one-ring-7548",
- "colorCode": "RAL 3017",
- "rid": "f884001e44e511edb8780242ac120002",
- "createdAt": "2022-05-04T07:56:29Z",
- "offices": [
- "Калуга"
], - "skus": [
- "6665956397512"
], - "id": 13833711,
- "warehouseId": 658434,
- "nmId": 12345678,
- "chrtId": 987654321,
- "price": 1014,
- "convertedPrice": 28322,
- "currencyCode": 933,
- "convertedCurrencyCode": 643,
- "cargoType": 1,
- "isZeroOrder": false
}
]
}Возвращает статусы сборочных заданий по переданному списку идентификаторов сборочных заданий.
supplierStatus - статус сборочного задания, триггером изменения которого является сам продавец.
Возможны следующие значения данного поля:
| Статус | Описание | Как перевести сборочное задание в данный статус |
|---|---|---|
| new | Новое сборочное задание | |
| confirm | На сборке | При добавлении сборочного задания к поставке PATCH /api/v3/supplies/{supplyId}/orders/{orderId} |
| complete | В доставке | При переводе в доставку соответствующей поставки PATCH /api/v3/supplies/{supplyId}/deliver |
| cancel | Отменено продавцом | PATCH /api/v3/orders/{orderId}/cancel |
| cancel_missed_call | Отмена заказа по причине недозвона. Для схемы "Доставка силами продавца (DBS)" |
Статус меняется автоматически |
wbStatus - статус сборочного задания в системе Wildberries.
Возможны следующие значения данного поля:
| orders required | Array of integers <int64> [ 1 .. 1000 ] items [ items <int64 > ] Список идентификаторов сборочных заданий |
Array of objects |
{- "orders": [
- 5632423
]
}{- "orders": [
- {
- "id": 5632423,
- "supplierStatus": "new",
- "wbStatus": "waiting"
}
]
}Возвращает все сборочные задания, требующие повторной отгрузки
Array of objects Список заказов |
{- "orders": [
- {
- "supplyID": "WB-GI-1234567",
- "orderID": 5632423
}
]
}Переводит сборочное задание в статус cancel ("Отменено продавцом").
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Метод позволяет закрепить за сборочным заданием КиЗ (маркировку Честного знака).
Закрепление КиЗ за сборочным заданием возможно только в случае, если это поле возвращается в ответе метода Получить метаданные сборочного задания, а сборочное задание находится в статусе confirm.
Получить загруженные КиЗ можно методом Получить метаданные сборочного задания
С правилами работы с КиЗ можно ознакомиться тут: https://честныйзнак.рф
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
| sgtins | Array of strings [ 1 .. 24 ] items Массив КиЗов. Допускается от 16 до 135 символов для кода одной маркировки. |
{- "sgtins": [
- "1234567890123456"
]
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Возвращает список этикеток по переданному массиву сборочных заданий. Можно запросить этикетку в формате svg, zplv (вертикальный), zplh (горизонтальный), png.
Ограничения при работе с методом:
| type required | string Enum: "svg" "zplv" "zplh" "png" Тип этикетки |
| width required | integer Enum: 58 40 Ширина этикетки |
| height required | integer Enum: 40 30 Высота этикетки |
| orders | Array of integers <int64> [ 1 .. 100 ] items [ items <int64 > ] Массив идентификаторов сборочных заданий |
Array of objects |
{- "orders": [
- 5346346
]
}{- "stickers": [
- {
- "orderId": 5346346,
- "partA": 231648,
- "partB": 9753,
- "barcode": "!uKEtQZVx",
- "file": "PD94bWwgdmVyc2lvbj0iMS4wIj8+CjwhLS0gR2VuZXJhdGVkIGJ5IFNWR28gLS0+Cjxzdmcgd2lkdGg9IjQwMCIgaGVpZ2h0PSIzMDAiCiAgICAgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIgogICAgIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIj4KPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjQwMCIgaGVpZQiIGhlaWdodD0iMTcwIiBzdHlsZT0iZmlsbDpibGFjayIgLz4KPHJlY3QgeD0iMzE4IiB5PSIyMCIgd2lkdGg9IjYiIGhlaWdodD0iMTcwIiBzdHlsZT0iZmlsbDpibGFjayIgLz4KPHJlY3QgeD0iMzI2IiB5PSIyMCIgd2lkdGg9IjIiIGhlaWdodD0iMTcwIiBzdHlsZT0iZmlsbDpibGFjayIgLz4KPHJlY3QgeD0iMzMwIiB5PSIyMCIgd2lkdGg9IjQiIGhlaWdodD0iMTcwIiBzdHlsZT0iZmlsbDpibGFjayIgLz4KPHJlY3QgeD0iMjAiIHk9IjIwMCIgd2lkdGg9IjM1MCIgaGVpZ2h0PSI5MCIgc3R5bGU9ImZpbGw6YmxhY2siIC8+Cjx0ZXh0IHg9IjMwIiB5PSIyNDAiIHN0eWxlPSJmaWxsOndoaXRlO2ZvbnQtc2l6ZTozMHB0O3RleHQtYW5jaG9yOnN0YXJ0IiA+MjMxNjQ4PC90ZXh0Pgo8dGV4dCB4PSIzNTAiIHk9IjI3MCIgc3R5bGU9ImZpbGw6d2hpdGU7Zm9udC1zaXplOjUwcHQ7dGV4dC1hbmNob3I6ZW5kIiA+OTc1MzwvdGV4dD4KPC9zdmc+Cg=="
}
]
}Возвращает метаданные заказа.
Возможные метаданные:
imei
uin
gtin
sgtin
В ответе метода возвращаются метаданные, доступные для сборочного задания. Если ответ вернулся с пустой структурой meta, значит у сборочного задания нет метаданных, и добавление их не доступно.
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
object (Meta) Метаданные заказа |
{- "meta": {
- "imei": 123456789012345,
- "uin": 1234567890123456,
- "gtin": 1234567890123,
- "sgtin": 1234567890123456
}
}Удаляет значение метаданных заказа для переданного ключа.
Возможные метаданные:
imei
uin
gtin
sgtin
Передается только одно значение.
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
| key | string Название метаданных для удаления (imei, uin, gtin, sgtin). Передается только одно значение. |
{- "code": "IncorrectRequest",
- "message": "Переданы некорректные данные"
}Обновляет УИН сборочного задания. У одного сборочного задания может быть только один УИН. Добавлять маркировку можно только для заказов в статусе confirm и доставка которых осуществляется силами Wildberries.
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
| uin required | string = 16 characters УИН |
{- "uin": "1234567890123456"
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Обновляет IMEI сборочного задания. У одного сборочного задания может быть только один IMEI. Добавлять маркировку можно только для заказов в статусе confirm и доставка которых осуществляется силами Wildberries.
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
| imei required | string = 15 characters IMEI |
{- "imei": "123456789012345"
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Обновляет GTIN (уникальный идентификатор товара в Беларуси) сборочного задания. У одного сборочного задания может быть только один GTIN. Добавлять маркировку можно только для заказов в статусе confirm и доставка которых осуществляется силами Wildberries.
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
| gtin required | string = 13 characters GTIN |
{- "gtin": "1234567890123"
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Возвращает список ссылок на этикетки для сборочных заданий, которые требуются при кроссбордере.
Ограничения при работе с методом:
| orders | Array of integers <int64> [ 1 .. 100 ] items [ items <int64 > ] Массив идентификаторов сборочных заданий |
Array of objects |
{- "orders": [
- 5346346
]
}{
}Возвращает историю статусов для сборочных заданий кроссбордера
| orders | Array of integers [ 1 .. 100 ] items ID сборочных заданий |
Array of objects Сборочные задания |
{- "orders": [
- 123456789,
- 987654321
]
}{- "orders": [
- {
- "deliveryDate": "string",
- "statuses": [
- {
- "date": null,
- "code": "SORTED"
}
], - "orderID": 123456789
}
]
}Метод позволяет получать информацию о клиенте по ID заказа.
Только для dbs (доставка силами продавца) и кроссбордера из Турции
| orders | Array of integers Список заказов |
Array of objects (DbsClientInfo) Информация по клиенту для dbs-заказа (доставка силами продавца) |
{- "orders": [
- 0
]
}{- "orders": [
- {
- "firstName": "string",
- "fullName": "Иван Иван Иванович",
- "orderID": 134567,
- "phone": 79871234567,
- "phoneCode": 1234567
}
]
}Порядок работы:
1. Создайте новую поставку с помощью метода POST /api/v3/supplies. В ответ вернется идентификатор созданной поставки в формате "WB-GI-1234567".
2. В текущую новую поставку нужно добавить сборочные задания, которые вы повезёте на склад или ПВЗ, методом PATCH /api/v3/supplies/{supplyId}/orders/{orderId}. Обратите внимание, что при добавлении сборочных заданий к поставке они будут переведены в статус confirm ("На сборке").
Примечание: пункты 3 - 8 обязательны к выполнению при доставке поставки на ПВЗ.
3. В поставке создайте короб методом POST /api/v3/supplies/{supplyId}/trbx.
4. Добавьте заказы в короб методом PATCH /api/v3/supplies/{supplyId}/trbx/{trbxId}.
5. Список коробов с заказами можно получить методом GET /api/v3/supplies/{supplyId}/trbx.
6. Получите стикеры коробов методом POST /api/v3/supplies/{supplyId}/trbx/stickers, распечатайте и наклейте стикеры на короба согласно распределённым в них заказам.
7. Вы можете удалить короба из поставки методом DELETE /api/v3/supplies/{supplyId}/trbx. Обратите внимание, что удалить короба из поставки можно, только пока поставка находится на сборке.
8. Вы можете удалить заказы из короба методом DELETE /api/v3/supplies/{supplyId}/trbx/{trbxId}/orders/{orderId}. Обратите внимание, что удалить заказы из короба можно, только пока поставка находится на сборке.
9. После того как поставка будет укомплектована нужными сборочными заданиями, необходимо ее передать в доставку с помощью метода PATCH /api/v3/supplies/{supplyId}/deliver. Если поставка не была передана в доставку, то при сканировании её штрихкода или приёмке первого товара поставка автоматически закроется. Обратите внимание, что при передаче сборочных заданий в доставку они будут автоматически собраны, т.е. переведены в статус complete ("В доставке").
10. Список сборочных заданий, добавленных к поставке, можно получить методом GET /api/v3/supplies/{supplyId}/orders.
11. Все поставки, имеющиеся у продавца, можно получить методом GET /api/v3/supplies.
12. Детализацию конкретной поставки можно получить методом GET /api/v3/supplies/{supplyId}.
13. С помощью метода DELETE /api/v3/supplies/{supplyId} можно удалить поставку при условии, что она активна и за ней не закреплено ни одно сборочное задание.
14. Если поставка была отсканирована в пункте приёмки, но при этом в ней имеются ещё неотсканированные товары, то спустя определенное время необходимо доставить их повторно. Все сборочные задания, требующие повторной отгрузки на данный момент, можно получить с помощью метода GET /api/v3/supplies/orders/reshipment. При помощи метода PATCH /api/v3/supplies/{id поставки}/orders/{id сборочного задания} данные сборочные задания можно перевести в другую активную поставку (сборочное задание также будет переведено в статус confirm ("На сборке")).
15. Метод PATCH /api/v3/supplies/{supplyId}/orders/{orderId} также позволяет перемещать сборочные задания между активными поставками. Обратите внимание, что нельзя перемещать сборочное задание из уже закрытой поставки, только если оно не требует повторной отгрузки.
16. QR-код поставки можно получить методом GET /api/v3/supplies/{supplyId}/barcode в формате svg, zpl или png. Доступно только после передачи поставки в доставку.
Ограничения работы с поставками:
| name | string [ 1 .. 128 ] characters Наименование поставки |
| id | string Идентификатор поставки |
{- "name": "Тестовая поставка"
}{- "id": "WB-GI-1234567"
}Возвращает список поставок.
| limit required | integer [ 1 .. 1000 ] Параметр пагинации. Устанавливает предельное количество возвращаемых данных. |
| next required | integer <int64> Параметр пагинации. Устанавливает значение, с которого надо получить следующий пакет данных. Для получения полного списка данных должен быть равен 0 в первом запросе. Для следующих запросов необходимо брать значения из одноимённого поля в ответе. |
| next | integer <int64> (Next) Параметр пагинации. Содержит значение, которое необходимо указать в запросе для получения следующего пакета данных |
Array of objects (Supply) Список поставок |
{- "next": 13833711,
- "supplies": [
- {
- "id": "WB-GI-1234567",
- "done": true,
- "createdAt": "2022-05-04T07:56:29Z",
- "closedAt": "2022-05-04T07:56:29Z",
- "scanDt": "2022-05-04T07:56:29Z",
- "name": "Тестовая поставка",
- "cargoType": 0
}
]
}Добавляет к поставке сборочное задание и переводит его в статус confirm ("На сборке").
Также может перемещать сборочное задание между активными поставками, либо из закрытой в активную при условии, что сборочное задание требует повторной отгрузки.
Важно!
В пустую поставку можно добавить сборочное задание любого габаритного типа.
После добавления первого задания поставка приобретает габаритный тип этого задания, см. значение поля cargoType в ответе метода "Получить информацию о поставке".
После этого добавить в поставку можно только те задания, габаритный тип которых соответствует таковому у поставки.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Возвращает информацию о поставке.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| id | string Идентификатор поставки |
| done | boolean Флаг закрытия поставки |
| createdAt | string <date-time> Дата создания поставки (RFC3339) |
| closedAt | string <date-time> Дата закрытия поставки (RFC3339) |
| scanDt | string <date-time> Дата скана поставки (RFC3339) |
| name | string Наименование поставки |
| cargoType | integer Enum: 0 1 2 3
|
{- "id": "WB-GI-1234567",
- "done": true,
- "createdAt": "2022-05-04T07:56:29Z",
- "closedAt": "2022-05-04T07:56:29Z",
- "scanDt": "2022-05-04T07:56:29Z",
- "name": "Тестовая поставка",
- "cargoType": 0
}Удаляет поставку, если она активна и за ней не закреплено ни одно сборочное задание.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Возвращает сборочные задания, закреплённые за поставкой.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
Array of objects (SupplyOrder) |
{- "orders": [
- {
- "scanPrice": null,
- "orderUid": "165918930_629fbc924b984618a44354475ca58675",
- "article": "one-ring-7548",
- "colorCode": "RAL 3017",
- "rid": "f884001e44e511edb8780242ac120002",
- "createdAt": "2022-05-04T07:56:29Z",
- "offices": [
- "Калуга"
], - "skus": [
- "6665956397512"
], - "id": 13833711,
- "warehouseId": 658434,
- "nmId": 123456789,
- "chrtId": 987654321,
- "price": 1014,
- "convertedPrice": 28322,
- "currencyCode": 933,
- "convertedCurrencyCode": 643,
- "cargoType": 1,
- "isZeroOrder": false
}
]
}Закрывает поставку и переводит все сборочные задания в ней в статус complete ("В доставке"). После закрытия поставки новые сборочные задания к ней добавить будет невозможно.
Если поставка не была передана в доставку, то при сканировании её штрихкода или приёмке первого товара поставка автоматически закроется.
Передать поставку в доставку можно только при наличии в ней хотя бы одного сборочного задания и отсутствии пустых коробов.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Возвращает QR в svg, zplv (вертикальный), zplh (горизонтальный), png.
Можно получить, только если поставка передана в доставку.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| type required | string Enum: "svg" "zplv" "zplh" "png" Тип этикетки |
| barcode | string Закодированное значение этикетки (идентификатор поставки) |
| file | string <byte> Полное представление этикетки в заданном формате. (кодировка base64) |
{- "barcode": "WB-GI-12345678",
- "file": "U3dhZ2dlciByb2Nrcw=="
}Возвращает список коробов и идентификаторы заказов, входящих в них.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
Array of objects (SupplyTrbx) |
{- "trbxes": [
- {
- "id": "WB-TRBX-1234567",
- "orders": [
- 1234567
]
}
]
}Добавляет требуемое количество коробов в поставку. Можно добавить, только пока поставка на сборке.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| amount required | integer [ 1 .. 1000 ] Количество коробов, которые необходимо добавить к поставке. |
| trbxIds | Array of strings non-empty Список ID коробов, которые были созданы. |
{- "amount": 4
}{- "trbxIds": [
- "WB-TRBX-1234567"
]
}Убирает заказы из перечисленных коробов поставки и удаляет короба. Можно удалить, только пока поставка на сборке.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| trbxIds required | Array of strings Список ID коробов, которые необходимо удалить. |
{- "trbxIds": [
- "WB-TRBX-1234567"
]
}{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Добавляет заказы в короб для выбранной поставки. Можно добавить, только пока поставка на сборке.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| trbxId required | string Example: WB-TRBX-1234567 ID короба |
| orderIds required | Array of integers Список заказов, которые необходимо добавить в короб. |
{- "orderIds": [
- 1234567
]
}{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Удаляет заказ из короба выбранной поставки. Можно удалить, только пока поставка на сборке.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| trbxId required | string Example: WB-TRBX-1234567 ID короба |
| orderId required | integer <int64> Example: 5632423 ID сборочного задания |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Возвращает стикеры QR в svg, zplv (вертикальный), zplh (горизонтальный), png.
Можно получить, только если в коробе есть заказы.
| supplyId required | string Example: WB-GI-1234567 ID поставки |
| type required | string Enum: "svg" "zplv" "zplh" "png" Тип этикетки |
| trbxIds required | Array of strings Список ID коробов, по которым необходимо вернуть стикеры. |
Array of objects (TrbxStickers) non-empty |
{- "trbxIds": [
- "WB-TRBX-1234567"
]
}{- "stickers": [
- {
- "barcode": "$WBMP:1:123:1234567",
- "file": "U3dhZ2dlciByb2Nrcw=="
}
]
}Обновляет остатки товаров.
Важно! Имена параметров запроса не валидируются. При отправке некорректных имен Вы получите успешный ответ(204), но остатки не обновятся.
Тщательнее проверяйте данные перед отправкой.
| warehouseId required | integer <int64> Example: 1 ID склада продавца |
required | Array of objects [ 1 .. 1000 ] items Массив баркодов товаров и их остатков |
{- "stocks": [
- {
- "sku": "BarcodeTest123",
- "amount": 10
}
]
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Удаляет остатки товаров. Внимание! Действие необратимо. Удаленный остаток будет необходимо загрузить повторно для возобновления продаж.
| warehouseId required | integer <int64> Example: 1 ID склада продавца |
| skus | Array of strings [ 1 .. 1000 ] items Массив баркодов |
{- "skus": [
- "BarcodeTest123"
]
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Возвращает остатки товаров.
| warehouseId required | integer <int64> Example: 1 ID склада продавца |
| skus | Array of strings [ 1 .. 1000 ] items Массив баркодов |
Array of objects |
{- "skus": [
- "BarcodeTest123"
]
}{- "stocks": [
- {
- "sku": "BarcodeTest123",
- "amount": 10
}
]
}Возвращает список всех складов WB для привязки к складам продавца.
| address | string Адрес |
| name | string Название |
| city | string Город |
| id | integer <int64> ID |
| longitude | number <float64> Долгота |
| latitude | number <float64> Широта |
| cargoType | integer Enum: 1 2 3
|
| deliveryType | integer Enum: 1 2 3
|
| selected | boolean Признак того, что склад уже выбран продавцом |
[- {
- "address": "ул. Троицкая, Подольск, Московская обл.",
- "name": "Москва (Коледино)",
- "city": "Москва",
- "id": 15,
- "longitude": 55.386871,
- "latitude": 37.588898,
- "cargoType": 1,
- "deliveryType": 1,
- "selected": true
}
]Возвращает список всех складов продавца.
| name | string Название склада продавца |
| officeId | integer <int64> ID склада WB |
| id | integer <int64> ID склада продавца |
| cargoType | integer Enum: 1 2 3
|
| deliveryType | integer Enum: 1 2 3
|
[- {
- "name": "ул. Троицкая, Подольск, Московская обл.",
- "officeId": 15,
- "id": 1,
- "cargoType": 1,
- "deliveryType": 1
}
]Создает склад продавца. Нельзя привязывать склад WB, который уже используется.
| name required | string [ 1 .. 200 ] characters Имя склада продавца |
| officeId required | integer >= 1 ID склада WB |
| id | integer ID склада продавца |
{- "name": "Склад Коледино",
- "officeId": 15
}{- "id": 2
}Обновляет склад продавца. Изменение выбранного склада WB допустимо раз в сутки. Нельзя привязывать склад WB, который уже используется.
| warehouseId required | integer <int64> Example: 1 ID склада продавца |
| name required | string [ 1 .. 200 ] characters Имя склада продавца |
| officeId required | integer >= 1 Идентификатор склада WB |
{- "name": "Склад Коледино",
- "officeId": 15
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Удаляет склад продавца.
| warehouseId required | integer <int64> Example: 1 ID склада продавца |
{- "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": "s2sauth-ca",
- "status": 401,
- "statusText": "Unauthorized"
}Возвращает список складов для привязки к пропуску продавца.
Обратите внимание: данные, которые возвращает метод, могут меняться. Рекомендуем периодически синхронизировать список.
| name | string Название |
| address | string Адрес |
| id | integer <int64> ID |
[- {
- "name": "Коледино",
- "address": "г. Подольск, д. Коледино, ул. Троицкая",
- "id": 1
}
]Возвращает список всех пропусков продавца.
| firstName | string Имя водителя |
| dateEnd | string Дата окончания действия пропуска |
| lastName | string Фамилия водителя |
| carModel | string Марка машины |
| carNumber | string Номер машины |
| officeName | string Название склада |
| officeAddress | string Адрес склада |
| officeId | integer <int64> ID склада |
| id | integer <int64> ID пропуска |
[- {
- "firstName": "Александр",
- "dateEnd": "2022-07-31 17:53:13+00:00",
- "lastName": "Петров",
- "carModel": "Lamborghini",
- "carNumber": "A456BC123",
- "officeName": "Коледино",
- "officeAddress": "г. Подольск, д. Коледино, ул. Троицкая",
- "officeId": 15,
- "id": 1
}
]Создает пропуск продавца.
Пропуск действует 48 часов со времени создания. Метод ограничен одним вызовом в 10 минут.
Общая длина ФИО ограничена от 6 до 100 символов. В номере машины могут быть только буквы и цифры.
| firstName required | string non-empty Имя водителя |
| lastName required | string non-empty Фамилия водителя |
| carModel required | string [ 1 .. 100 ] characters Марка машины |
| carNumber required | string [ 6 .. 9 ] characters Номер машины |
| officeId required | integer <int64> >= 1 ID склада |
| id | integer ID пропуска продавца |
{- "firstName": "Александр",
- "lastName": "Петров",
- "carModel": "Lamborghini",
- "carNumber": "A456BC123",
- "officeId": 15
}{- "id": 2
}Обновляет данные пропуска продавца.
| passId required | integer <int64> Example: 45 ID пропуска |
Общая длина ФИО ограничена от 6 до 100 символов. В номере машины могут быть только буквы и цифры.
| firstName required | string non-empty Имя водителя |
| lastName required | string >= 6 characters Фамилия водителя |
| carModel required | string [ 1 .. 100 ] characters Марка машины |
| carNumber required | string [ 6 .. 9 ] characters Номер машины |
| officeId required | integer <int64> >= 1 ID склада |
{- "firstName": "Александр",
- "lastName": "Петров",
- "carModel": "Lamborghini",
- "carNumber": "A456BC123",
- "officeId": 15
}{- "code": "IncorrectRequestBody",
- "message": "Некорректное тело запроса"
}Удаляет пропуск продавца.
| passId required | integer <int64> Example: 45 ID пропуска |
{- "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": "s2sauth-ca",
- "status": 401,
- "statusText": "Unauthorized"
}
Порядок работы:
"deliveryType": "dbs"Переводит сборочное задание в статус confirm ("На сборке").
| order required | integer <int64> Example: 5632423 Идентификатор сборочного задания |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Переводит сборочное задание в статус deliver ("В доставке").
| order required | integer <int64> Example: 5632423 Идентификатор сборочного задания |
{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Переводит сборочное задание в статус receive ("Получено клиентом").
| order required | integer <int64> Example: 5632423 Идентификатор сборочного задания |
| code | string Код клиентской доставки |
{- "code": "string"
}{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}Перевести в статус reject ("Отказ при получении").
| order required | integer <int64> Example: 5632423 Идентификатор сборочного задания |
| code | string Код клиентской доставки |
{- "code": "string"
}{- "code": "IncorrectParameter",
- "message": "Передан некорректный параметр"
}