Интеграция с Wildberries API для схемы FBS (ERP 2.5)

Начало работы

Управление интеграцией осуществляется через обработку "Управление интеграцией (WB FBS)", обработка добавлена в типовую подсистему "Продажи". 

Для начала работы необходимо в ЛК WB создать токены для категорий "Контент" и "Маркеплейс", если они еще у вас не созданы. Для категории "Контент" достаточно токена на чтение, для категории "Маркеплейс" нужен токен на чтение и запись. Далее необходимо в обработке "Управление интеграцией (WB FBS)" перейти на вкладку "Настройки" - > "Настройки подключения к API (WB FBS)" и там задать настройки подключения для двух предопределенных элемента. Хранение токенов реализовано через безопасное хранилище БСП.

После этого необходимо добавить склады продавца из ЛК WB. Для этого нужно перейти на вкладку "Настройки" - > "Склады (WB FBS)". Нужно указать соответствие между складом в ERP и складом ЛК WB (с этого склада мы будем выгружать свободные остатки), идентификатор склада из ЛК WB (нужен для управления остатками), а также условия агрегации сборочных заданий в поставки. В данной интеграции реализовано 2 условия – по количеству сборочных заданий, либо по времени, прошедшего с момента получения сборочного задания. Например, передавать на сборку и создавать поставку, когда накопилось 5 сборочных заданий. Либо передавать на сборку, если с момента получения сборочного задания прошло 60 минут. Условия можно комбинировать, если хотя бы одно выполнилось, будет создана новая поставка и все сборочные задания перейдут на сборку.

Далее нужно настроить значения для автоматического создания документа "Заказ клиента". Для этого нужно перейти на вкладку "Настройки" - > "Параметры заполнения заказа клиента (WB FBS)". Настройки реализованы через периодический регистр сведений, т.к. значения могут поменяться, и можно задать их заранее будущей датой.

После того, как все настройки заполнены, нужно загрузить идентификаторы размеров из ЛК WB. Для этого на вкладке "Настройки" нужно нажать "Загрузить идентификаторы размеров". Это внутренние идентификаторы из ЛК WB, которые автоматически присваиваются каждому размеру в карточке товара. Именно в разрезе этих идентификаторов и осуществляется управление остатками, так что их придется хранить и актуализировать для новых карточек (загрузка новых идентификаторов встроена в обмен). Сопоставление между номенклатурой в ERP и ЛК WB осуществляется по штрихкодам. Если штрихкод не заполнен, то по артикулу и наименованию характеристики.

Также можно задать срок хранения логов, выбрать режим песочницы для тестирования (влияет на интервалы между запросами к API), а также протестировать сам обмен, запустив его по кнопке "Выполнить обмен". Регламентное задание, которое будет выполнять обмен, по умолчанию выключено, его нужно будет включить в типовой форме для работы с регламентными заданиями ("НСИ и администрирование" - > "Обслуживание" - > "Регламентные и фоновые задания"). Называется "Обмен (WB FBS)". Также есть регламентник для очистки логов, его тоже нужно включить - "Очистка журнала обмена (WB FBS)".

Управление остатками

Реализовано в обработке "Управление интеграцией (WB FBS)" на вкладке "Управление остатками". Доступна выгрузка и обнуление остатков в разрезе складов ЛК WB. По кнопке "Заполнить" будут заполнены все идентификаторы размеров, которые были загружены ранее. Также можно задать дополнительные отборы. Далее нужно отметить необходимую номенклатуру к выгрузке и нажать "Выгрузить остатки" - будут выгружены свободные остатки со склада отгрузки ERP на выбранный склад продавца ЛК WB, а также включена синхронизация остатков по выгруженным позициям. Если продажи нужно остановить, то необходимо выбрать номенклатуру и нажать "Обнулить остатки" - остатки будут обнулены, синхронизация выключена.

Загрузка и обработка сборочных заданий

После выгрузки остатков начнут поступать новые сборочные задания. Сборочное задание WB представляет собой заказ клиента, содержащий одну позицию одного размера. Даже если один клиент заказал несколько одинаковых позиций, они будут разбиты системой WB на отдельные сборочные задания. Практика показала, что грузить это в типовой документ "Заказ клиента" нецелесообразно – при большом количестве заданий с этим просто неудобно работать. Поэтому реализована следующая схема: сборочные задания грузятся в нетиповой документ "Сборочное задание (WB FBS)". Документ максимально простой, без движений, но с системой статусов. Далее для новых сборочных заданий создается "Заказ клиента" - это будущая поставка. Из этого заказа берется назначение, и под него резервируются сборочные задания типовым документом "Корректировка назначения товаров". Когда срабатывает условие, указанное в складе WB FBS, заказ клиента заполняется и проводится, создается новая поставка и все сборочные задания, привязанные к этому заказу клиента, добавляются в эту поставку. Далее с этим заказом клиента уже можно работать как обычно.

Покупатель может отменить свой заказ до передачи на сборку, так что для новых сборочных заданий реализована проверка на статус, ведь если задание отменено, его не получится передать в поставку.
Так как продажи идут со свободного остатка, то возможна ситуация, при которой остаток будет списан прямо перед загрузкой нового сборочного задания. В таком случае сборочное задание отменится автоматически. Чем чаще выгружаются остатки, тем реже вероятность того, что такая ситуация произойдет.

Список сборочных заданий можно просмотреть в обработке "Управление интеграцией (WB FBS)" на вкладке "Сборочные задания".

Список поставок на вкладке "Поставки".

Все взаимодействие с API WB логируется, логи можно посмотреть на вкладке «Журнал обмена».