Перейти к основному содержимому

Интеграция с 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. Не передавайте секрет в переписке или на скриншотах.

Подключите магазин​

  1. Откройте «Интеграции» → Halyk Market и включите работу с сервисом, если переключатель доступен.
  2. Выберите организацию, которой принадлежит магазин.
  3. В поле «Идентификатор» введите полный client_id, включая HMM_.
  4. В поле «Client Secret» введите client_secret.
  5. Нажмите «Сохранить» и дождитесь успешного ответа.
  6. Повторно откройте подключение той же организации и убедитесь, что оно сохранилось. Секрет повторно не отображается.

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.