Содержание
Прайсматрикс - это сервис для автоматизации обновления цен и остатков товаров, который позволяет магазинам и интернет-магазинам быстро и эффективно обновлять информацию в своих прайс-листах. Например, один из способов, которым сервис обеспечивает автоматическое обновление прайс-листов — это интеграция с поставщиками через API.
Что же такое API-интеграция? API-интеграция позволяет обеспечить автоматическое обновление прайс-листов без необходимости вручную получать и обрабатывать данные от поставщиков. В результате, компании могут значительно сократить время и усилия, затрачиваемые на обновление прайс-листов, а также улучшить точность данных.
Шаги по загрузке поставщика по API
Для того чтобы загрузить товары поставщика по API в Прайсматрикс, необходимо выполнить следующие шаги:
- Получить доступ к API поставщика. Для этого нужно обратиться в службу поддержки поставщика и запросить API-доступы. Как правило, это требует регистрации и выполнения определенных требований, например, заключение договора или прохождение обучения.
- Настроить импорт товаров. Для загрузки товаров поставщика по API создайте прайс поставщика и нажмите Загрузить. Нажмите тип загрузки - "Загрузить из API" и из списка возможных интеграций выберите своего поставщика.
- Запустить автоматический обмен данными. После настройки интеграции можно запустить автоматический обмен данными между сервисом и поставщиком. Обычно это происходит по расписанию.
Сервис Прайсматрикс настроил интеграцию со следующими поставщиками через API, с такими как:
Merlion
Merlion (https://merlion.com/) - крупнейшая российская компания на рынке IT, бытовой техники, канцелярских товаров и офисной мебели.
Для подключения к API поставщика Merlion, необходимо ввести логин и пароль от API и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
Для подключения тестовых доступов необходимо в дополнительные параметры ввести - api_test=True
У Мерлиона есть доступ к ценам/остаткам, а есть и доступ к контенту (фото, хар-ки). Если Вам предоставили доступ и к контенту, тогда в "Дополнительные параметры" укажите параметр content=true .
OCS
OCS (https://www.ocs.ru/) - поставщик компьютерной и офисной техники, расходных материалов, мебели и бытовой техники.
Для подключения к API поставщика OCS, необходимо ввести токен от API.
Запись должна быть такой: token=Ваш_токен_от_API.
После ввода токена нажмите Загрузить.
Кроме токена можно передавать еще два параметра:
- Список доступных городов отгрузки: Санкт-Петербург или Москва. Задавать можно так: shipmentcity=Санкт-Петербург или shipmentcity=Москва
- locations - местоположение остатков, например, МСК. Настройка будет такой: locations=МСК
Итого строка настроек будет иметь такой вида: token=Ваш_токен_от_API[next]shipmentcity=Москва[next]locations=МСК
После подключения, данные будут автоматически загружаться в систему.
В админке OCS в настройках API укажите IP адрес Прайсматрикс в разрешенные адреса. Узнать IP можно у поддержки Прайсматрикс.
Treolan
Treolan (http://treolan.ru/) - крупнейший широкопрофильный ИТ-дистрибьютор, который сотрудничает с ведущими мировыми производителями программных и аппаратных решений.
Для подключения к API поставщика Treolan, необходимо ввести логин и пароль от API и нажать Загрузить.
После подключения, данные будут автоматически загружаться в систему.
Обновление Treolan может занимать много времени, так как при каждом обновлении у товаров обновляются цены, остатки и контент. Чтобы ускорить обновление Treolan можно (нужно) отключить обновление контента для товаров которые уже есть в прайсе поставщика.
Для этого нужно сделать следующее:
1) Перейдите в Функции - Экспортировать Главный прайс. Создайте экспорт в файл.
2) Выберите тип файла - Export Custom(1).
3) Добавьте одно поле - Артикул и так же добавьте параметр который позволяет выгружать определенный прайс поставщика &price_id=59(2).Нам нужно выгрузить артикул прайса поставщика Treolan, поэтому указываем ID прайса поставщика Treolan.
4) Скопируйте постоянную ссылку на эту выгрузку
5)Запустите экспорт и включите его чтобы дальше этот экспорт запускался по Расписанию.
6) Перейдите в прайс поставщика Treolan.
7) Режим загрузки прайса поставщика должен быть "Обновить цены и остатки и добавить новые товары"
8) Перейдите во вкладку Загрузить. Вставьте ссылку на выгрузку артикулов, которую ранее копировали, в строку "Исключить товары из обработки" и запустите загрузку прайса.
ABCP
ABCP.ru (https://www.abcp.ru/) — это платформа для интернет-магазинов автозапчастей, предлагающая удобные инструменты для создания сайтов, управления ассортиментом и обработки заказов.
Для подключения к API поставщика ABCP необходимо:
- ввести логин и пароль от API
- указать адрес хоста так: ApiHost=https://ваш_хост.public.api.abcp.ru (адрес хоста следует уточнять у менеджеров ABCP )
- указать название поставщика, данные которого нужно загрузить: distributor=OZON
- загрузить данные из ABCP можно только имея список артикулов, по которым можно осуществлять поиск в базе ABCP. Для этого в Прайсматрикс нужно получить ссылку на выгрузку csv из вашего Главного прайса с двумя полями: артикул и бренд(используйте для этого выгрузку ExportCustom). Ссылку нужно указать через параметр skuFileUrl. Пример: skuFileUrl=https://app.price-matrix.ru/WebApi/CampaignDataLatestGet/?export_config_id=1
- итого дополнительные параметры будут выглядеть так: ApiHost=https://ваш_хост.public.api.abcp.ru[next]distributor=OZON[next]skuFileUrl=https://app.price-matrix.ru/WebApi/CampaignDataLatestGet/?export_config_id=1
- и теперь нажать кнопку Загрузить
- дождаться завершения и проверить результат.
LTM
LTM Music (https://ltm-music.ru/) — эксклюзивный дистрибьютор звукового, светового оборудования и музыкальных инструментов, с более чем 20-летним опытом на российском рынке
Для подключения к API поставщика LTM необходимо:
- ввести API Ключ( API Ключ нужно взять в личном кабинете LTM(https://ltm-music.ru/personal/index.php)
- в доп. параметрах нужно указать склад, из которго грузить остатки, вот так: Warehouse=Москва опт
- нажать Загрузить.
После подключения, данные будут автоматически загружаться в систему.
Invask
Invask (https://invask.ru/) — это компания, специализирующаяся на продаже музыкальных инструментов и профессионального звукового и светового оборудования. Они предлагают широкий ассортимент товаров, включая гитары, клавишные инструменты, микрофоны, наушники, а также оборудование для DJ и студийной записи.
Для подключения к API поставщика Invask, необходимо ввести Ваш API-key и нажать Загрузить.
После подключения, данные будут автоматически загружаться в систему.
Breez.ru
Breez.ru (https://breez.ru/) — это российская компания, специализирующаяся на оптовой продаже климатического оборудования. Бриз предлагает широкий ассортимент продукции, включая кондиционеры, системы вентиляции, обогреватели и многое другое.
Для подключения к API поставщика Breez, необходимо ввести логин и ключ API, а затем нажать кнопку "Загрузить".
Если необходимо загрузить остатки с определенного склада, в дополнительных параметрах следует указать название склада через параметр "warehouse".
Например: warehouse=РРЦ Бриз Екатеринбург LV.
Optic-Dias
Optic-Dias (https://optic-dias.ru/) — ведущий дистрибьютор на российском оптическом рынке с 1996 года, специализирующийся на медицинских оправах, солнцезащитных очках и корригирующих линзах. Представляет продукцию известных брендов и предлагает качественные услуги своим партнерам
Для подключения к API поставщика Optic-Dias, необходимо ввести логин и пароль от API и нажать Загрузить.
После подключения, данные будут автоматически загружаться в систему.
Topsports
Topsports (https://topsports.ru/) - официальный дистрибьютор лучших мировых брендов экипировки, запчастей и комплектующих для экстремальных видов спорта.
Для подключения к API поставщика Topsports, необходимо ввести логин и пароль от API и нажать Загрузить.
После подключения, данные будут автоматически загружаться в систему.
Marvel
Marvel (https://www.marvel.ru/) - один из крупнейших широкопрофильных дистрибуторов компьютерной техники, серверного и сетевого оборудования, программного обеспечения, портативной электроники и средств связи в России
Для подключения к API поставщика Marvel, необходимо ввести логин и пароль от API и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
RCStore
RCStore (https://rcstore.ru/) - поставщик радиоуправляемых моделей, запчастей и аксессуаров.
Для подключения к API поставщика RCStore, необходимо ввести токен от API.
Запись должна быть такой: token=key:Ваш_токен_от_API.
После ввода токена нажмите Загрузить.
После подключения, данные будут автоматически загружаться в систему.
DKC
DKC (https://www.dkc.ru/) - производитель кабеленесущих систем и низковольтного оборудования.
Для подключения к API поставщика DKC, необходимо ввести ключ от API.
Запись должна быть такой: masterkey=Ваш_ключ_API.
После ввода токена нажмите Загрузить.
После подключения, данные будут автоматически загружаться в систему.
Russvet
Russvet (http://russvet.ru/) - является одним из крупнейших российских дистрибьюторов электротехнической продукции.
Для работы интеграции между Прайсматрикс и Russvet необходимо получить логин и пароль от сервисов PRICAT и PRODAT.
Для подключения к API Русский свет должны быть заполнены следующие поля:
- FTP логин номенклатуры: Ваш логин для доступа к FTP, где хранится файл PRODAT
- FTP пароль номенклатуры: Ваш пароль для доступа к FTP, где хранится файл PRODAT
- URL папки номенклатуры: ссылка на папку, в котором хранится файл PRODAT (пример ftp://service.russvet.ru:21021/sklad/MOSKVA/)
- FTP логин цен/остатков: Ваш логин для доступа к FTP, где хранится файл PRICAT
- FTP пароль цен/остатков: Ваш пароль для доступа к FTP, где хранится файл PRICAT
- URL папки цен/остатков: ссылка на папку, в котором хранится файл PRICAT (пример ftp://service.russvet.ru:21021/MOSKVA/ или ftp://service.russvet.ru:21021/pricat - нужно смотреть на этом фтп путь к файлу PRICAT_********.xml, у разных пользователей разные пути)
Samsonopt
Samsonopt (https://www.samsonopt.ru/) - оптовый дистрибьютор товаров для дома, офиса и школы.
Для подключения к API поставщика Samsonopt , необходимо ввести ключ от API.
Запись должна быть такой: api_key=Ваш_ключ_API.
Resurs-Media
Resurs-Media (https://resurs-media.ru/) - один из крупнейших дистрибьюторов на рынке расходных материалов для печатной техники.
Для подключения к API поставщика Resurs-Media, необходимо ввести логин и пароль от API и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
VTT
VTT (https://www.vtt.ru/) - поставщик всего спектра расходных материалов, комплектующих и запчастей для восстановления картриджей и ремонта печатающей техники.
Для подключения к API поставщика VTT, необходимо ввести логин и пароль от API и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
NETLAB
NETLAB (https://www.netlab.ru/) - этот поставщик работает в сфере дистрибуции компьютерной техники и комплектующих.
Для подключения к API поставщика NETLAB необходимо:
- ввести логин и пароль от API (не личного кабинета). Как сделать пользователя API - см. ниже.
- указать с какого склада грузить остатки, вписав параметр и название склада так: Warehouse=количество на Лобненской
- указать колонку, с какой брать цену, по которой покупаете товар: Price=цена по категории B
- итого дополнительные параметры будут выглядеть так: Price=цена по категории B[next]Warehouse=количество на Лобненской
- и теперь нажать кнопку Загрузить
- дождаться завершения и проверить результат.
Пример настроек на скриншоте:
Как создать API в личном кабинете (скриншоты с документации Netlab):
Rossko
ROSSKO (https://rossko.ru/) — российская компания, занимающаяся дистрибуцией автозапчастей. Она предлагает широкий ассортимент запасных частей, масел и аксессуаров для легковых и грузовых автомобилей, обслуживая как автосервисы, так и розничных покупателей.
Для подключения к API поставщика ROSSKO необходимо выполнить следующие шаги:
- Подготовьте список артикулов: Для того чтобы загрузить данные из ROSSKO, необходимо иметь файл со списком артикулов + бренд, по которым будет осуществляться поиск в базе ROSSKO.
- Создайте прайс поставщика в PriceMatrix:
- В PriceMatrix создайте отдельный прайс поставщика.
- Загрузите в него файл с артикулами и брендами товаров, для которых нужно получить цены и остатки из ROSSKO.
- Выгрузите новый прайс поставщика в CSV:
- Создайте выгрузку нового прайса поставщика в файл CSV, используя экспорт ExportCustom. Добавьте поля - Артикул и Производитель; так же добавьте параметр который позволяет выгружать определенный прайс поставщика &price_id=2(2)
- Скопируйте ссылку на выгрузку(3)
- Загрузка данных ROSSKO.
- Создайте отдельный прайс поставщика для ROSSKO и перейдите во вкладку Загрузить.
- Выберите тип загрузки - загрузить из API поставщика.
- Из списка выберите ROSSKO и нажмите Далее
- Получите ключи доступа: В личном кабинете ROSSKO получите два ключа: KEY1 и KEY2.
- Вставьте ссылку в настройки загрузки Роско.
Скопированную ссылку укажите через параметрskuFileUrl
(смотрите внизу скрин).
Пример:skuFileUrl=https://app.price-matrix.ru/WebApi/CampaignDataLatestGet/?export_config_id=1
. - Загрузите данные:
- Нажмите кнопку "Загрузить" для начала процесса загрузки данных.
- Проверьте результат: Дождитесь завершения загрузки и проверьте полученные данные.
Mad Wave
Mad Wave(https://madwave.eu/) — бренд, специализирующийся на производстве оборудования и аксессуаров для плавания. Он предлагает широкий ассортимент товаров, включая спортивные купальники, очки для плавания, ласты и плавательные шапочки, ориентированные на профессиональных пловцов и любителей.
Для подключения к API поставщика Mad Wave необходимо ввести API token и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
TFNOPT
TFN Optics (https://www.tfnopt.ru/)является официальным дистрибьютором солнцезащитных очков и медицинских оправ.
Для подключения к API поставщика TFN необходимо ввести логин, пароль от API и API token и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
Комус ОПТ
Комус ОПТ(https://komus-opt.ru/) - это оптовый интернет-магазин, специализирующийся на продаже товаров для офиса, школы, дома и бизнеса. В ассортименте представлены канцтовары, упаковочные материалы, мебель, техника, товары для уборки и многое другое.
Для начала интеграции с Комус ОПТ, вам необходимо получить токен для доступа к их API. Это можно сделать следующим образом:
- Войдите в личный кабинет на сайте Комус ОПТ.
- Перейдите в раздел API-доступа: https://komus-opt.ru/personal/api_permit/ .
- Сгенерируйте токен, который нужен для работы с API.
После получения токена его нужно передать поддержке PriceMatrix для подключения поставщика в ваш личный кабинет.
Через API Комус ОПТ можно получить такие данные:
- Артикулы,
- Цены (РРЦ, партнёрская, PMC),
- Остатки,
- Описание,
- Фото,
- Характеристики,
- Категории товаров.
Проект 111
Проект 111(https://gifts.ru/) — это компания, специализирующаяся на производстве и продаже корпоративных подарков, промо-продукции и брендированных сувениров. В их ассортимент входят товары для бизнеса, спорта, отдыха, а также различные аксессуары, которые можно персонализировать с помощью логотипов и надписей.
1. Войдите в личный кабинет Проект 111
2. Перейдите в раздел Услуги - XML выгрузка
3. Добавьте IP-адреса Прайсматрикс (185.130.227.158/32 и 85.209.2.144/32) и укажите URL: app.price-matrix.ru.
4. Логин и пароль для доступа к API предоставляются при подключении XML-выгрузки.
5. Для подключения к API поставщика Проект 111 необходимо ввести логин и пароль от API и нажать Загрузить. После подключения, данные будут автоматически загружаться в систему.
Natali37
Natali37 (https://natali.ru/) - поставщик женского, мужского и детского трикотажа.
Для импорта товаров этого поставщика нужно выбрать Natali37 в списке интеграций и нажать Загрузить.
TK-Bagira
TK-Bagira (https://tk-bagira.ru/) - является отечественным производителем швейных текстильных изделий для дома и отдыха, а также женской трикотажной одежды.
Для импорта товаров этого поставщика нужно выбрать TK-Bagira в списке интеграций и нажать Загрузить.
Margo37
Margo37 (https://margo37.ru/) - текстильная компания, которая производит и продает текстильные изделия.
Для импорта товаров этого поставщика нужно выбрать Margo37 в списке интеграций и нажать Загрузить.
P.S. Для заказа разработки импорта товаров по API вашего поставщика пришлите на почту - sales@price-matrix.ru документацию на API поставщика и какие данные нужно загружать (артикул, имя товара, цены и т.п.).
Если во время настройки появились вопросы — наша поддержка на связи, пишите(https://app.price-matrix.ru/Tickets), поможем.