Самовывоз

API вы можете получить списки сборочных заданий и информацию по каждому из них:

• Получить список новых сборочных заданий — GET /api/v3/click-collect/orders/new.
  Метод возвращает список сборочных заданий в статусе new — новое. Сборочные задания в этом статусе еще не были взяты в работу. Метод позволяет получить информацию за период до 30 календарных дней. Список новых сборочных заданий может понадобиться при сборке новых заказов и подготовке товаров к выдаче. 
• Получить список завершенных сборочных заданий — GET /api/v3/click-collect/orders.
  Метод возвращает список сборочных заданий, завершенных после получения или отмены заказа, за заданный период до 30 календарных дней. Список завершенных сборочных заданий может понадобиться, например для анализа выполненных заданий. 

Методы списков сборочных заданий не возвращают статусы сборочных заданий в явном виде. Чтобы получить текущий статус сборочного задания, используйте метод POST /api/marketplace/v3/click-collect/orders/status/info. Метод позволяет получить:

• supplierStatus — статусы, которые меняет сам продавец.
• wbStatus — статусы в системе Wildberries.

В параметре запроса ordersIds передайте ID сборочного задания. Вы можете передать до 1000 ID сборочных заданий в одном запросе. ID сборочных заданий можно получить с помощью методов списков новых и завершенных сборочных заданий.

Полезные ссылки в справочном центре:

• Сборочные задания

Управление статусами сборочных заданий

С помощью WB API вы можете автоматизировать изменение статуса сборочного задания:

• Перевести сборочные задания на сборку — POST /api/marketplace/v3/click-collect/orders/status/confirm.
  Перед тем, как начать сборку заказа, переведите сборочное задание в статус confirm — на сборке.
• Сообщить, что сборочные задания готовы к выдаче — POST /api/marketplace/v3/click-collect/orders/status/prepare.
  Когда заказ собран и готов к выдаче, переведите его в статус prepare — готов к выдаче.
• Отменить сборочные задания — POST /api/marketplace/v3/click-collect/orders/status/cancel.
  Если произошел форс-мажор и заказанного товара не оказалось в магазине, вы можете отменить заказ. Для этого переведите сборочное задание в статус cancel — отменено продавцом.
• Завершить обработку сборочных заданий:
  • Покупатель получил заказ — POST /api/marketplace/v3/click-collect/orders/status/receive.
    Переведите сборочное задание в статус receive — получено покупателем.
  • Покупатель отказался от заказа — POST /api/marketplace/v3/click-collect/orders/status/reject.
    Переведите сборочное задание в статус reject — отказ при получении.

В параметре запроса ordersIds передайте ID сборочного задания. Вы можете передать до 1000 ID сборочных заданий в одном запросе. ID сборочных заданий можно получить с помощью методов получения сборочных заданий.

Полезные ссылки в справочном центре:

• Сборочные задания

Метаданные сборочных заданий

Метаданные сборочных заданий — это дополнительная информация о товарах, которая используется для идентификации и отслеживания продукции на каждом этапе её жизненного цикла.

Для работы с метаданными вам нужно указать ID сборочных заданий в параметре ordersIds запросов. Получите ID сборочных заданий с помощью методов получения сборочных заданий.

С помощью WB API вы можете:

• Получить метаданные сборочных заданий — POST /api/marketplace/v3/click-collect/orders/meta/info.
  В ответе метода вы получите метаданные, доступные для сборочного задания: код маркировки, УИН, IMEI, GTIN. Если ответ вернулся пустым, значит у сборочного задания нет метаданных и добавить их нельзя.
• Закрепить коды маркировки товара за сборочными заданиями — POST /api/marketplace/v3/click-collect/orders/meta/sgtin.
  Код маркировки товара — уникальный код, которым маркируется каждая единица товара. Код маркировки получают в национальной системе цифровой маркировки РФ Честный знак. На сайте Честного знака можно проверить актуальный список товаров, которые нужно маркировать, а также узнать, как получить код маркировки на свои товары. У одного сборочного задания может быть несколько кодов маркировки.
• Закрепить УИН за сборочными заданиями — POST /api/marketplace/v3/click-collect/orders/meta/uin.
  УИН (Уникальный Идентификационный Номер) — уникальный код ювелирного изделия. Его используют для учёта ювелирных изделий и их маркировки. УИН получают в системе ГИИС ДМДК. Одно сборочное задание может иметь только один УИН.
• Закрепить IMEI за сборочными заданиями — POST /api/marketplace/v3/click-collect/orders/meta/imei.
  IMEI (International Mobile Equipment Identity) — международный идентификатор мобильного оборудования, например, смартфона или планшета, который присваивает производитель. Одно сборочное задание может иметь только один IMEI.
• Закрепить GTIN за сборочными заданиями — POST /api/marketplace/v3/click-collect/orders/meta/gtin.
  GTIN (Global Trade Item Number) — глобальный идентификационный номер товара в международной торговле. Обычно GTIN наносится на упаковку товара в виде штрихкода. Также его можно найти в документации от производителя или в базах данных GS1 — международной организации, которая регулирует стандарты идентификации товаров. Одно сборочное задание может иметь только один GTIN.
• Удалить метаданные сборочных заданий — POST /api/marketplace/v3/click-collect/orders/meta/delete.
  Одним запросом вы можете удалить значение только одного вида метаданных: код маркировки, УИН, IMEI или GTIN.

Полезные ссылки в справочном центре:

• Маркировка товаров и поставок. Баркод, ШК, КИЗ, УИН

Получение информации о покупателе

При модели Самовывоз продавцу могут потребоваться контакты покупателя, чтобы связаться с ним во время и после выполнения заказа. Например, если срок хранения заказа подходит к концу или при сборке заказа произошел форс-мажор и заказанного товара не оказалось в магазине.

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

• confirm — на сборке;
• prepare — готов к выдаче.

По сборочным заданиям в статусе new — новый — получить информацию о покупателе невозможно.

Чтобы получить имя и подменный номер телефона покупателя, используйте метод POST /api/v3/click-collect/orders/client. В рамках одного запроса можно передать несколько ID сборочных заданий orderId. ID сборочных заданий можно получить с помощью методов получения сборочных заданий .

Отмена сборочного задания по инициативе продавца

Продавец может отменить сборочное задание Самовывоз по своей инициативе. Например, если произошел форс-мажор и заказанного товара не оказалось в магазине.

Вы можете отменить заказы со статусами:

• new — новый;
• confirm — на сборке;
• prepare — готов к выдаче. 

Чтобы отменить заказ по инициативе продавца, переведите сборочное задание в статус cancel —отменено продавцом — с помощью метода POST /api/marketplace/v3/click-collect/orders/status/cancel. В параметре запроса ordersIds передайте ID сборочных заданий, которые нужно отменить. ID сборочных заданий можно получить с помощью методов получения сборочных заданий.

Полезные ссылки в справочном центре:

• Отмена заказов и возврат товаров