Интеграция с Halyk Market
Подключите магазин Halyk Market к организации в SelSup, чтобы загружать товары и заказы, а затем получать изменения статусов заказов.
Что поддерживается
- Импорт товаров из разделов «В продаже», «В архиве», «Нет в наличии» и «Истек срок».
- Сохранение связи товара с артикулом продавца в Halyk Market.
- Импорт цены в тенге, если она одинакова во всех городах. Если цены отличаются, минимальная цена из списка Halyk Market не записывается как единая цена товара.
- Импорт состава заказов, количества и цены каждой позиции.
- Обновление статусов доставки, завершения, отмены и возврата.
Передача цен и остатков из SelSup в Halyk Market пока не поддерживается. Обновляйте их в кабинете Halyk Market. Метод изменения остатков Halyk Market также меняет скидку и срок рассрочки; в доступной документации нет метода чтения полной настройки, необходимой для сохранения этих значений при автоматическом обмене.
Принимайте и отменяйте заказы, вызывайте курьеров, подтверждайте выдачу по OTP и получайте накладные в кабинете Halyk Market. Эти действия не отправляются из SelSup. Аналитика взаиморасчётов и создание новых карточек на площадке в подключение не входят.
Выберите Halyk Market в тарифе
Откройте «Тариф» → «Конструктор тарифа» и выберите Halyk Market в блоке «Выберите маркетплейсы». Подключение оплачивается по общим правилам маркетплейсов: если Halyk выбран как включённая в тариф интеграция, отдельная плата за него не начисляется. Дополнительный канал учитывается по цене выбранного базового тарифа с учётом периода оплаты. Проверьте итоговую стоимость перед оформлением.
После активации тарифа с Halyk Market переходите к настройке подключения. Если в интеграции показано сообщение об отсутствии оплаты, проверьте, что Halyk включён в действующий тариф именно вашего кабинета.
Подготовьте данные
Запросите включение API у менеджера Halyk Market. Получите идентификатор client_id вида HMM_БИН у менеджера и секрет client_secret из письма о включении API. Оба значения должны относиться к одному магазину.
Нужны права на настройку интеграций и доступ к нужной организации в SelSup. Не передавайте секрет в переписке или на скриншотах.
Подключите магазин
- Откройте «Интеграции» → Halyk Market и включите работу с сервисом, если переключатель доступен.
- Выберите организацию, которой принадлежит магазин.
- В поле «Идентификатор» введите полный
client_id, включаяHMM_. - В поле «Client Secret» введите
client_secret. - Нажмите «Сохранить» и дождитесь успешного ответа.
- Повторно откройте подключение той же организации и убедитесь, что оно сохранилось. Секрет повторно не отображается.
SelSup получает временный токен автоматически и обновляет его по мере истечения срока действия. Вставлять временный access_token вместо секрета не нужно.
Для нескольких организаций настройте каждое подключение отдельно.
Импортируйте товары и заказы
Сначала нажмите «Импортировать товары» на странице подключения и выполните загрузку из Halyk Market. Если товары уже есть в SelSup, проверьте и при необходимости объедините дубликаты стандартными средствами работы с товарами.
После загрузки проверьте артикулы продавца в связях товаров. Заказы сопоставляются по этим артикулам: номер общей карточки на витрине не заменяет артикул продавца.
В разделе заказов FBS выберите Halyk Market и нужную организацию, затем запустите импорт. При первой обычной загрузке запрашиваются заказы за последние два месяца. Halyk Market ограничивает доступную историю заказами не старше 90 дней; более ранняя выбранная дата не гарантирует загрузку архива.
В заказе показывается номер Halyk Market с сохранением начальных нулей. Внутренний номер документа SelSup назначает отдельно. Промежуточные статусы Halyk Market «Доставка завершена» и «Завершение заказа» ещё не считаются окончательным завершением: SelSup ожидает итоговый статус «Завершен».
Если хотя бы один товар заказа не связан с товаром SelSup, заказ не создаётся частично. Загрузите или свяжите недостающий товар и повторите импорт за период, включающий этот заказ.
Если подключение или импорт не работают
Проверьте организацию, полный идентификатор с префиксом HMM_, секрет и включение API у Halyk Market. При замене данных сохраните новый секрет для того же магазина.
Ошибка прав доступа не равнозначна истечению токена. Уточните у менеджера площадки разрешения API для каталога и заказов. Если Halyk Market временно недоступен или вернул неполные данные, повторите запрос позже. При обращении в поддержку передайте организацию, номер заказа и время ошибки без секретов.
Официальные требования к подключению и API опубликованы в справке Halyk Market.

