Загрузка электронных каталогов через API поставщика
Современное ведение бизнеса предъявляет к Вашей информационной системе повышенные требования. Недостаточно просто хранить в вашей программе список всей номенклатуры, которой вы торгуете.
Еще в не очень давние времена, глядя на артикул можно было сказать золото это или серебро, кольцо или сережки, какой цвет и что за камень закреплен. Не исключено, что и внешний вид изделия всплывал в воображении.
В настоящее время, каждый производитель старается максимально обновлять ассортимент. Каждый месяц осваивается 50 – 100 новинок. И это только от одного поставщика!
В результате, за несколько лет работы даже небольшой сети ювелирной розницы, на остатках оседает десятки тысяч SKU. Управлять этим разнообразием сложно, запомнить – нереально. Выход только один – максимально полное описание товара, в нашем случае ювелирного изделия, в используемой учетной системе.
Справочный раздел в программе “Ювелирный Торговый Дом” позволяет указать основные характеристики изделия через заполнение типовых реквизитов. Если будет недостаточно типовых реквизитов, всегда есть возможность определить свой набор свойств и значений.
Сколько реквизитов или элементов справочника надо заполнить в программе на одно изделие? По минимуму?
Практика показывает, что для качественного управления ассортимента, необходимо 10-12 свойств. И это на каждый артикул. Умножаем на количество артикулов. И получаем огромный массив информации, который требуется занести в программу.
Даже если известны все характеристики изделия (что не всегда так), в штате компании должны присутствовать работники, основной задачей которых будет поддержание справочной информации в актуальном состоянии. И, поверьте, они будут не успевать.
Что делать?
Крупные производители ювелирных изделий, такие как Sokolov, Platina идут навстречу своим клиентам, предлагая сервис доступа к информации через API (программный интерфейс). Для того, чтобы воспользоваться всеми прелестями автоматизации от производителя, необходима интеграция вашего программного продукта с API производителя.
Компания ЮвелирСофт, разработала подсистему автоматического обмена информацией с учетными системами производителей.
Покажем, как это работает, на примере взаимодействия с API от компании SOKOLOV.
API от компании SOKOLOV позволяет производить следующие действия:
- Загружать каталог товаров для выгрузки на сайт
- Обновлять данные (свойства) о номенклатуре
- Выгружать заказы поставщику
Подключение к сервису осуществляется в разделе Электронные каталоги поставщиков – Настройки загрузки каталогов поставщиков
Настраиваем подключение к API SOKOLOV
В поле Сервер вводим адрес api.b2b.sokolov.net. Чтобы получить Логин и Пароль необходимо обратиться в компанию Sokolov. Мы воспользуемся тестовым доступом, предоставленным нашей компании.
После ввода логина и пароля, нажимаем Проверить подключение. Если все данные верны, то получаем сообщение “Токен получен”.
Настройка загрузки информации
При настроенном подключении, программа готова принимать информацию из учетной системы компании SOKOLOV. На этом этапе очень важно понимать, как полученная информация будет синхронизироваться с вашими, уже существующими данными.
Обновление существующей номенклатуры
Представим такую ситуацию: мы уже работаем или раньше работали с SOKOLOV. В нашем справочнике номенклатуры есть артикула компании SOKOLOV. В этом случае при получении информации через API, программа перезапишет существующие реквизиты в соответствии с настройками (как выбрать, что мы получаем через API – чуть ниже).
Как программа будет искать уже существующие артикула?
Если включить поиск по всему справочнику номенклатуры, то обновление может занять довольно продолжительное время. В некоторых случаях, синхронизация может достигать 3-4 часов. Но есть способ ускорить процесс, наложив дополнительные условия.
Задавая комбинацию реквизитов Каталог для поиска номенклатуры, Основной поставщик, Основной производитель, Значение свойств поиска, можно существенно сузить общий объем выбираемых данных.
Как настроить отбор номенклатуры?
Каталог для поиска номенклатуры. Если у вас в справочнике номенклатуры построена иерархия по производителям, то напрямую указываем каталог с продукцией компании.
Но не всегда бывает удобно, дробить номенклатуру таким образом. Чаще, производитель указывается в отдельном реквизите справочника номенклатуры.
Основной поставщик, Основной производитель. В программном продукте “Ювелирный Торговый Дом” есть два выделенных реквизита, отвечающих за принадлежность продукции тому или иному поставщику.
Если у Вас поставщик или производитель хранится именно таким образом, тогда выбираем нужные значения в форме настройки загрузки каталога.
Значение свойств поиска. Третий путь указания, какому изготовителю принадлежит товар – через указание свойства номенклатуры. В свойствах номенклатуры вы сами определяете, какими атрибутами будете описываться изделие в системе. В частности, чтобы указать производителя можно номенклатуре назначить свойство Брэнд и проставить значение SOKOLOV.
В этом случае, для отбора по производителю через свойства номенклатуры, настраиваем поле Значение свойств поиска.
Выбрав любой вариант указания производителей, либо комбинацию вариантов, мы существенно увеличиваем скорость обработки данных и снижаем вероятность ошибок, связанных с появлением дублей (вернее с затиранием информации у такого же артикула, но другого производителя).
Создание новой номенклатуры.
Если в процессе загрузки информации по API программа не нашла в справочнике артикул, который нужно обновить, то создается новая номенклатура в папке Каталог для создания новой номенклатуры.
Вы можете позже перенести артикула из этого каталога в группы, которые соответствуют вашей настроенной иерархии.
Выбор реквизитов для загрузки.
API от компании SOKOLOV предоставляет доступ к большому количеству данных о каждом артикуле. Описание очень подробное и часто избыточное для задач управления ассортиментом. Полное описание доступной информации приведено на сайте Api Sokolov
Наш программный продукт позволяет точечно указывать какая именно информация должна быть загружена. Для настройки нажимаем кнопку Подготовить данные к загрузке и отмечаем необходимые разделы информации на появившейся форме
По кнопке Загрузить происходит считывание свойств номенклатуры компании SOKOLOV. Данные записываются в таблицу соответствий. Нажимая на кнопку Заполнить соответствие по умолчанию, мы проставляем соответствие реквизитов SOKOLOV и структуры справочника номенклатуры ЮТД, если программа может определить однозначное соответствие.
Что значат поля в табличной части?
Реквизит поставщика – это наименование свойства артикула, как оно определено в справочной системе SOKOLOV. Название всех реквизитов и их описание приведены на сайте Api Sokolov Рассмотрим реквизит probe. Отображение в табличной части загрузки:
Описание реквизита proba на сайте API от компании SOKOLOV
Тип значения в базе – указание для программы Ювелирный Торговый Дом в какое измерение грузить полученные данные.
Варианты:
1. Реквизит справочника. Это означает, что информация будет напрямую описывать артикул. Список доступных реквизитов пока ограничен следующим набором значений в базе.
Чтобы заполнить у артикула поле проба на основании данных, полученных по API, в программе должно быть указано следующее соответствие.
ВНИМАНИЕ!!! На что требуется обратить особое внимание. Значения справочников, полученных по API могут отличатся от значений, используемых в вашей программе. То же Золото 585 пробы можно описать как: AU 585, Au 585, Золото 585, золото 585 и т.д. Все это разнообразие может в дальнейшем привести к большой путанице при анализе данных. Решение это проблемы довольно простое – необходимо проставить соответствие получаемых по API данных и значений, которые используются в вашей справочной системе. Для этого проставляем галку в поле Заполнять соответствие значений и нажимаем на кнопку Заполнить соответствие значений.
В открывшемся окне, в поле Значение реквизита поставщика выводится список всех возможных значений, которые загрузятся по API. В поле Значение в базе, должно быть проставлено соответствие загружаемых значений и элементов нашего справочника.
2. Значение свойства – это способ хранения информации, при котором полученные данные записываются в Свойства номенклатуры.
К примеру, в программе значение Цвет металла хранится в Свойствах номенклатуры и мы хотим настроить соответствие данных выгружаемых по API с нашей структурой хранения информации.
Какие наши действия:
a) Находим в колонке Реквизит поставщика строку material-color.
b) Выбираем Значение свойства в колонке Тип значения в базе.
c) Выбираем свойство Цвет металла в Значение в базе.
d) Ставим галку Заполнять соответствие значений и и нажимаем на кнопку Заполнить соответствие значений.
Проставляем соответствие значений цветов для каждого элемента. В итоге получаем строку следующего вида
Теперь свойство Цвет металла готово к загрузке.
3. Значение регистра сведений. В программе Ювелирный Торговый Дом реализована уникальная возможность. Вы можете выгрузить на свой сайт ассортимент компании-партнера SOKOLOV, даже если у Вас нет в данный момент товара SOKOLOV в наличии или Вы никогда не работали с этим ассортиментом.
Компания ЮвелирСофт разработала специальный механизм хранения номенклатуры, предназначенной для выгрузки на сайт. Все данные полученные по API хранятся в регистре Товары поставщиков.
Регистр Товары поставщиков имеет предопределенные поля: Размер, Характеристика номенклатуры, Количество, Вес, Цена оптовая, Цена розничная. Выбор в Тип значения в базе строки Значение регистра сведений, позволяет получить доступ к заполнению полей, выгружаемых на сайт.
Например, настроим заполнение поля ЦенаОптовая.
4. Справочник – Тип значения в базе, предназначенный для хранения данных, которые в связке с Артикулом образуют изделия с разными характеристиками. Самой простой пример - кольца. Кольца могут быть разных размеров. Артикул в этом случае один, но комбинация артикул-размер разная. Чтобы при выгрузке на сайт передать информацию, что данный артикул доступен в определенном диапазоне размеров, как рас и используют Тип значения в базе – Справочник.
Кроме Размера, для типа значения Справочник доступны Камень и ХарактеристикиНоменклатуры.
Работа с этим типом немного сложнее и в первый раз рекомендуем проконсультироваться с нашей службой технической поддержки.
Отборы (фильтры на загружаемую информацию)
Как мы уже отмечали ранее, ассортимент у компании SOKOLOV огромный. Загрузка всего каталога занимает очень много времени. И формат вашего магазина может не предполагать торговлю всем ассортиментом производителя.
Условия, заданные на вкладке Отборы (фильтры на загружаемую информацию) помогут отобрать ассортимент, необходимый именно вашему салону.
Расписание обмена.
Взаимодействие по API c производителем может осуществляться для:
1) Загрузки каталога товаров производителя на сайт. При этом данные для сайта будут загружены в регистр сведений “Товары поставщиков” в соответствии с нашими настройками.
2) Обновления справочной информации по номенклатуре производителя, которая есть в нашей базе.
3) Выгрузки заказа поставщику
Настройка сценария взаимодействия указывается на закладке Расписание Обмена.
Если вы выгружаете товары SOKOLOV на свой сайт, необходимо поддерживать информацию об остатках у SOKOLOV в актуальном состоянии. Это означает, что информация по API должна поступать с определенной периодичностью. Рекомендуемый период – раз в день. Загрузка каталога с остатками может происходить в автоматическом режиме по заранее настроенному расписанию.
Обновление каталога может занять продолжительное время, так что для синхронизации по API рекомендуется выбрать часы с наименьшей интенсивностью работы программы.
По такому же алгоритму расписание можно настроить и обновление данных о номенклатуре.
Принудительная загрузка данных по API доступна в разделе Загрузка каталога поставщика.
Заключение
Подводя краткий итог, хочется остановиться на следующих моментах:
1. Актуальная информация об ассортименте жизненно необходима для качественного управления ассортиментом, а интеграция по API существенно сокращает время.
2. Вы можете самостоятельно настроить взаимодействие по API исходя из ваших задач, но для этого нужно четко знать структуру хранения информации в вашей справочной системе.
3. Если вы используете в вашей работе товарный классификатор, то необходимо проанализировать какая информация может быть предоставлена по API, и как эта информация будет сопоставлена с товарным классификатором.
4. Первоначальная настройка может представлять определенные трудности, если вы решили все делать самостоятельно, поэтому рекомендуем обратиться в нашу техподдержку при возникновении каких-либо вопросов
5. Наши специалисты могут доработать взаимодействие по API c каждым конкретным производителем, если обмен информации с вашей системой не может быть реализован типовыми методами.
