Справочник интеграций
У Bulutegra есть REST API только для чтения и вебхуки; документация — на developers.bulutegra.com. Эта страница описывает другое: подключения, которые Bulutegra строит на официальном сервисе каждой системы.
О чём эта страница
Bulutegra — это интеграционный слой: он стоит между маркетплейсами, вашим сайтом и вашей ERP. Мы строим подключение и берём на себя различия на стороне каналов, поэтому вы работаете в одной панели, а не изучаете технические особенности каждого канала.
Из 47 интеграций, перечисленных на этом сайте, у 22 подключение построено и работает; 25 настраиваются по запросу. Это говорит о том, что поддерживает продукт. И ничего не говорит о том, кто и на каком канале продаёт.
Адреса сервисов в таблицах — это официальные сервисы продавца, опубликованные самими системами. Bulutegra подключается к ним от вашего имени и с правами вашего аккаунта. Никакой промежуточной точки Bulutegra между ними нет.
В этих таблицах нет ни одного ключа, пароля, номера продавца или примера учётных данных. Колонка «Что нужно от вас» лишь называет, какие сведения требуются.
Маркетплейсы
Каждое подключение к маркетплейсу идёт через собственный сервис продавца этого канала. Заказы читаются из канала; остатки, цены и объявления записываются в той мере, в какой канал это поддерживает.
Прокрутите таблицу вбок, чтобы прочитать её.
| Система | Подключение | Читается | Записывается | Что нужно от вас | Готовность |
|---|---|---|---|---|---|
| Trendyol | REST · apigw.trendyol.com | Заказы, товары | Остатки, цены, выставление товаров, контент | Ключ API, секретный ключ API, номер продавца | Подключение готово |
| Hepsiburada | REST · oms-external.hepsiburada.com · listing-external.hepsiburada.com | Заказы, товары | Остатки, цены, выставление товаров, контент | Имя пользователя, номер продавца, секретный ключ | Подключение готово |
| n11 | SOAP + REST · api.n11.com | Заказы, товары | Остатки, цены, выставление товаров, контент | Ключ приложения и секретный ключ приложения | Подключение готово |
| Pazarama | OAuth2 + REST · isortagimgiris.pazarama.com · isortagimapi.pazarama.com | Заказы, товары | Остатки, цены, выставление товаров, контент | Идентификатор клиента и секретный ключ клиента | Подключение готово |
| ePttAVM | SOAP (WS-Security) · ws.pttavm.com | Заказы, товары | Остатки, цены, выставление товаров, контент | Имя пользователя и пароль | Подключение готово |
| FLO | REST · api.flo.com.tr | Заказы | Остатки, цены | Идентификатор API | Подключение готово |
| Çiçeksepeti | REST · apis.ciceksepeti.com | Заказы, товары | Остатки, цены, выставление товаров, контент | Ключ API | Подключение готово |
| idefix | REST · merchantapi.idefix.com | Заказы, товары | Остатки, цены, выставление товаров | Номер продавца и ключ API | Подключение готово |
| Modanisa | REST | Заказы | Остатки, цены | Имя пользователя и пароль API | Подключение готово |
| Amazon | Amazon Selling Partner API (SP-API) | Заказы, товары | Остатки, цены, контент | Авторизация приложения SP-API и идентификатор продавца | Подключение готово |
| eBay | REST | Заказы, товары | Остатки, цены, выставление товаров, контент | Авторизация приложения OAuth | Подключение готово |
| Walmart (US) | OAuth2 + REST · Walmart Marketplace API v3 | Заказы, товары | Остатки, цены, выставление товаров, контент | Идентификатор клиента и секретный ключ клиента | Подключение готово |
| Etsy | OAuth2 + REST · Etsy Open API v3 | Заказы, товары | Остатки, цены, выставление товаров, контент | Ключ приложения и авторизация магазина | Подключение готово |
| Ozon | REST · api-seller.ozon.ru | Заказы, товары | Остатки, цены, выставление товаров, контент | Client-Id · Api-Key | Подключение готово |
| Temu | REST · Temu Open API | Заказы, товары | Остатки, цены, выставление товаров | Ключ приложения, секрет и токен доступа | Подключение готово |
| SHEIN | REST · SHEIN Open Platform API | Заказы на закупку, товары | Остатки | Авторизация магазина из основного аккаунта продавца | Подключение готово |
| Jumia | REST | Заказы | Определяется при настройке | Идентификатор API продавца | Подключение готово |
| noon | REST · noon Partner API (JWT) | Товары | Выставление товаров | Ключ сервисного аккаунта | Подключение готово |
| Namshi | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Allegro | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Wildberries | REST | Заказы | Определяется при настройке | Ключ API | Подключение готово |
| Takealot | REST · seller-api.takealot.com | Заказы | Определяется при настройке | Ключ API | Подключение готово |
| Ananas | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| JustYol | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
Если в колонке «Записывается» стоит «Определяется при настройке», направление записи для этого канала открывается по правам вашего аккаунта и результатам теневого режима. Права на запись никогда не включаются сразу для всех каналов — только канал за каналом.
Остатки ведутся из единого пула по всем каналам: продажа в одном канале уменьшает количество в остальных. Отдельной книги остатков на каждый канал нет.
Платформы электронной коммерции
Если ваш сайт работает на платформе электронной коммерции, его товары, остатки и цены попадают в тот же пул, а сам сайт ведёт себя как ещё один канал.
Прокрутите таблицу вбок, чтобы прочитать её.
| Система | Подключение | Читается | Записывается | Что нужно от вас | Готовность |
|---|---|---|---|---|---|
| ikas | GraphQL · api.myikas.com · adminapi.myikas.com | Товары, варианты, остатки, цены | Определяется при настройке | Ключ Admin API | Подключение готово |
| Shopify | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| WooCommerce | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Ticimax | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| IdeaSoft | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| T-Soft | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
Там, где готового коннектора нет, есть два пути: собственный официальный API платформы или регулярный XML/CSV-фид. Какой из них подойдёт, зависит от того, что доступно в вашей редакции, и определяется при настройке.
Флаг владения действует и здесь: для конкретного товара и канала понятно, кто отвечает — Bulutegra или внешняя система, поэтому две системы никогда не правят одно поле в противоположных направлениях.
ERP
Подключение к ERP всегда идёт в одном порядке: сначала чтение, затем сравнение и только потом запись. На стороне ERP запись остаётся отдельной и контролируемой, потому что ошибочная запись доходит до бухгалтерии.
Прокрутите таблицу вбок, чтобы прочитать её.
| Система | Подключение | Читается | Записывается | Что нужно от вас | Готовность |
|---|---|---|---|---|---|
| Nebim V3 | Nebim V3 Integrator | Заказы, клиенты, остатки (процедуры только для чтения) | Отдельно и под контролем | Адрес сервиса, пользователь сервиса и пароль | Подключение готово |
| Logo | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Mikro | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| SAP | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
Для Logo, Mikro и SAP подключение зависит от редакции у клиента и лицензированных модулей — поэтому мы называем его настраиваемым по запросу, а не готовым. Сообщите редакцию и модули, и мы сразу скажем, что возможно.
Фид поставщика
Если вы не производите товар сами, а закупаете у поставщика, каталог читается из файла-фида.
Прокрутите таблицу вбок, чтобы прочитать её.
| Система | Подключение | Читается | Записывается | Что нужно от вас | Готовность |
|---|---|---|---|---|---|
| XML-фид поставщика | XML | Код товара, штрихкод, название, цена, остаток, изображение | Ничего не записывается | Адрес фида и структура колонок | Подключение готово |
Поля читаются из фиксированных колонок. Цена рассчитывается с множителем по каждому поставщику, а остаток ниже установленного порога в продажу не выводится.
Здесь и работает тормоз массового обнуления: если за один проход обнулилось бы аномально много кодов товаров, отправка останавливается и поднимается предупреждение. Битый или наполовину загруженный фид не может опустошить все каналы.
Перевозчики
Заказ с маркетплейса приходит вместе с перевозчиком и способом доставки. Эти данные задаются для каждого канала и записываются в ERP вместе с заказом.
Прокрутите таблицу вбок, чтобы прочитать её.
| Система | Подключение | Читается | Записывается | Что нужно от вас | Готовность |
|---|---|---|---|---|---|
| Aras Kargo | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Yurtiçi Kargo | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| MNG Kargo | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| PTT Kargo | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Sürat Kargo | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Hepsijet | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Trendyol Express | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| DHL | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| FedEx | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| UPS | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
Прямое подключение к собственному сервису перевозчика создаётся по запросу, а его объём определяется при настройке. Поэтому в каждой строке здесь написано «настраивается по запросу»: мы не показываем как готовое то, что не построено.
Социальные и рекламные каналы
Эти три системы входят в перечень каналов, показанный на этом сайте.
Прокрутите таблицу вбок, чтобы прочитать её.
| Система | Подключение | Читается | Записывается | Что нужно от вас | Готовность |
|---|---|---|---|---|---|
| WhatsApp Business | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Meta | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
| Google Ads | Определяется при настройке | Определяется при настройке | Определяется при настройке | Определяется при настройке | Настраивается по запросу |
Во всех трёх случаях подключение создаётся по запросу; объём и необходимые сведения определяются при настройке.
Четыре правила для каждого подключения
Теневой режим. На старте настройка только читает. Данные берутся с обеих сторон и сравниваются, никуда ничего не записывается. Вы видите, что произошло бы, ещё до передачи.
Передача канал за каналом. Права на запись не включаются сразу для всех. Каждый канал запускается отдельно, а перед началом записи проверяются сопоставление и данные этого канала.
Единый пул остатков. Остаток ведётся в одном месте. Продажа в одном канале уменьшает количество в остальных.
Тормоз массового обнуления. Если за один проход обнулилось бы аномально много кодов товаров, отправка останавливается и поднимается предупреждение. Тихого прохода, опустошающего все каналы, не бывает.
Что нужно от вас для подключения
Колонка «Что нужно от вас» перечисляет учётные данные, которые вы создаёте в панели самой системы. Они принадлежат вашему аккаунту, и Bulutegra использует их только от вашего имени.
Не вводите учётные данные открытым текстом в форму обратной связи или в письмо. При настройке мы договариваемся, как будет передана каждая деталь, и фиксируем, зачем она нужна.
Ключи хранятся на сервере в файлах, которые может прочитать только пользователь, от имени которого работает сервис, и в панели они никогда не показываются в читаемом виде. Для Etsy и eBay подключение создаётся авторизацией в один клик; отзовите эту авторизацию в своём аккаунте — и подключение прекращается в тот же момент.
Что мы делаем в части хранения, резервных копий и шифрования диска — и чего не делаем — прямо написано на странице безопасности: Безопасность, доступ и защита данных.
Система, которой нет в списке
Если нужного вам маркетплейса, платформы, ERP или перевозчика нет в этих таблицах, подключение создаётся по запросу.
Первый вопрос всегда один: публикует ли эта система официальный сервис продавца или регулярный XML/CSV-фид и доступен ли он на вашем аккаунте? Если да, подключение идёт в том же порядке: сначала чтение, затем теневой режим, затем запись канал за каналом. Если нет, мы сразу говорим, что невозможно.
На этой странице мы не даём обещаний по срокам. Когда объём определён, мы сообщаем график письменно.
Кому полезна эта страница
Компания, продающая на маркетплейсах
Аккаунты каналов остаются вашими. Bulutegra подключается к ним через собственный официальный сервис канала, а ключи создаются на ваше имя.
Команда ERP
Для Nebim V3 подключение построено. Для других ERP объём зависит от редакции и лицензированных модулей и определяется при настройке.
Агентства и партнёры
Команды, подключающие нескольких клиентов, каждый раз идут в одном порядке: чтение, теневой режим, затем запись канал за каналом.
- Объём: какие системы, какое направление (чтение, запись) и какие данные.
- Учётные данные: сведения, которые вы создаёте в панели каждой системы, передаются тем способом, который мы согласуем при настройке.
- Теневой режим: система только читает, показывает, что сделала бы, и не пишет ни в один канал.
- Передача: после того как вы увидели результат, права на запись открываются канал за каналом.
Часто задаваемые вопросы
Есть ли у Bulutegra собственный API?
Да. Есть REST API только для чтения и вебхуки: ваша программа может читать заказы, товары, остатки и статус каналов, а новые заказы, смены статуса и передача в ERP приходят вебхуком. API ничего не может изменить — запись в каналы и ERP выполняет Bulutegra. Ключ создаётся в панели: Настройки › Bulutegra API и вебхуки; документация — на developers.bulutegra.com.
Что означает «подключение готово» в таблице?
Это значит, что код подключения к этой системе написан и работает. Чтобы открыть его на вашем аккаунте, всё равно нужны учётные данные, сопоставление товаров и этап теневого режима. «Настраивается по запросу» означает, что подключение будет построено под ваш случай; мы не выдаём его за уже существующее.
Доступ к API платный?
В таблице тарифов на странице цен нет отдельной строки «API». Интеграционные подключения не продаются как отдельный продукт; они оцениваются вместе с вашим тарифом и запрошенным объёмом. Если настройка системы, которой нет в списке, влечёт стоимость, вы увидите её отдельной строкой в письменном предложении. Тарифы здесь: Цены.
Как передать учётные данные?
Не открытым текстом в форме или письме. Как передаётся каждая деталь, мы согласуем при настройке. Как эти данные хранятся на сервере — и чего мы не делаем, например шифрования диска — написано на странице безопасности: Безопасность.
Есть ли отдельная тестовая среда?
Отдельной песочницы нет. Тестирование проходит через теневой режим при внедрении и, где полезно, демо-аккаунт: система сначала только читает, вы проверяете результат, и запись открывается канал за каналом после вашего одобрения.
Напишите, какую систему нужно подключить и в каком направлении должны идти данные, и мы вместе определим объём. Заполните форму ниже или напишите на destek@bulutegra.com.