Агент по созданию карточек товаров на МП
Делаю агента по созданию карточек товаров на маркетплейсах.
Данный процесс не включает в себя создание описания для карточки и добавление фотографий. Это будут отдельные этапы. В этом функционале: создание карточек с максимальным заполнением всех характеристик на ВБ, Озон, ЯМ. Тоесть я скидываю агенту артикулы новых карточек, он идет на маркетплейсы, создает карточки и заполняет характеристики исходя из информации, вшитой в артикул.
Архитектура данных
МойСклад хранит основную информацию о продукте: артикул, размер, ткань, цвет, состав, плотность и другие характеристики, которые пересекаются на всех маркетплейсах.
mp_field_map — таблица соответствия полей. Она отвечает на вопрос: куда попадут данные из МойСклад на каждом маркетплейсе
| Поле МойСклад | WB | Ozon | ЯМ |
|---|---|---|---|
| Ткань | Вид ткани постельного белья | Название материала | Тип ткани |
| Состав | Состав | Состав материала | Состав |
| Цвет | Цвет | Название цвета | Название цвета от производителя |
| Цвет фильтра | Цвет | Цвет товара | Цвет для фильтра |
| Уход | Уход за вещами | Режим стирки | Режим стирки |
mp_value_map — справочник перевода значений. Некоторые поля на маркетплейсах не принимают произвольные значения, а предлагают единственный или множественный выбор из списка. Тут указаны валидные значения.
| Поле | Наше значение | WB | Ozon | ЯМ |
|---|---|---|---|---|
| Ткань | сатин люкс | сатин | Сатин | сатин |
| Уход | стирка до 40°C | стирка при температуре до 40 °C | При 40 градусах | до 40 °C |
| Цвет | латте | бежевый | бежевый | бежевый |
mp_overrides — файл исключений. Заполняется вручную в случаях каких то единичных отклонений от логики.
validation_report — технический файл с отчетом валидации.
Эта схема показывает систему в самом простом виде. Агенту не нужно хранить копии всех карточек всех маркетплейсов. Ему достаточно знать, что за товар находится в МойСклад, как поля называются на разных площадках, какие значения допустимы и есть ли ручные исключения.
Логика заполнения поля на МП
Здесь важный принцип: агент не должен придумывать значения. Если он не находит соответствие поля или допустимое значение для маркетплейса, он не импровизирует, а фиксирует ошибку. Это снижает риск неверных характеристик, проблем с модерацией и неправильной индексации карточки.
Процесс создания новой карточки
При создании новой карточки главный риск — неполные или неточные исходные данные. Поэтому первый этап — проверка МойСклад: хватает ли данных о размере, ткани, составе, цвете, комплектации, упаковке и других ключевых характеристиках.
Обновление существующей карточки
При обновлении карточек важно понять где расхождения. Ошибка может быть на маркетплейсе, могут устареть данные в МойСклад, а иногда различие сделано специально — например, из-за ограничений справочника конкретной площадки. Для таких случаев и нужен mp_overrides.
Итоговая схема агента
Агент не заполняет маркетплейсы напрямую, а сначала собирает единую карточку товара на основе данных из МойСклад. После этого он переводит её под требования каждой площадки, проверяет ошибки и только затем готовит черновики для ручного подтверждения.
