Турция — интеграция с Hepsiburada 2026: REST API, HepsiJet и централизованное управление продажами

1. Архитектура API Hepsiburada 2026

REST на mpop.hepsiburada.com

API для продавцов Hepsiburada — это чистый REST/JSON-сервис под общим хостом mpop.hepsiburada.com (mpop = «Merchant Platform Open API»). Вариантов на GraphQL или gRPC нет. Весь аутентифицированный трафик идёт по HTTPS с привязкой к Merchant ID, который выдаётся при подключении к HMS. API разделён на логические поддомены, а не на один монолитный корень:

• listing-external.hepsiburada.com — CRUD листингов (цена, остаток, статус листинга)
• mpop.hepsiburada.com/product/api/products — создание товаров и атрибуты категорий
• oms-external.hepsiburada.com — управление заказами (заказы, посылки, отправления)
• returns-external.hepsiburada.com — возвраты и возмещения
• integration.hepsiburada.com/finance — загрузка счетов и финансовая сверка

Все поддомены используют одну и ту же схему HTTP Basic auth, но у каждого свои лимиты запросов и правила пагинации. Коннектор HB в Zunapro скрывает это разветвление за единым нормализованным интерфейсом.

Аутентификация: HTTP Basic по HTTPS

В отличие от чуть более свободного API Trendyol или OAuth-потока SP-API Amazon, Hepsiburada использует намеренно простую схему HTTP Basic auth: заголовок Authorization содержит Basic base64(username:password), где username — ваш API-ключ, а password — парный секрет. Каждый запрос также должен содержать заголовок User-Agent с вашим Merchant ID. Отсутствующий или неверно сформированный User-Agent — самая частая причина ошибки 401 Unauthorized в продакшене.

GET /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU} Host: listing-external.hepsiburada.com Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= User-Agent: {MERCHANT_ID} - SelfIntegration Accept: application/json

HMS — панель Hepsiburada Marketplace Service

Панель HMS на merchant.hepsiburada.com — это операционная веб-консоль, работающая в паре с API. У каждой возможности API есть аналог в HMS — редактирование листингов, принятие заказов, возвраты средств, финансовая сверка, — и только в HMS можно выпускать API-ключи, настраивать адреса забора HepsiJet и управлять правами пользователей. Редизайн HMS 2024–2026 годов принёс единую левую навигацию, отчётность по расчётам в реальном времени и новую панель «API Health», которая показывает долю ошибок 4xx/5xx по каждому эндпоинту, — это бесценно при отладке интеграции.

Лимиты запросов и идемпотентность

Hepsiburada применяет щедрые, но строго соблюдаемые лимиты — обычно ~30 запросов в секунду на продавца для обновления листингов и меньше (~10/с) для эндпоинтов заказов. Массовый импорт товаров ограничивается отдельно и возвращает 202 Accepted с trackingId; затем нужно опрашивать /import/{trackingId} до завершения. API заказов поддерживает идемпотентность через идентификаторы посылок и заказов, которые остаются неизменными между запросами.

2. Подключение через REST API — пошагово

Предварительные условия: аккаунт HMS и ETBİS

Прежде чем делать какие-либо вызовы API, компания, зарегистрированная в Турции, с vergi numarası (налоговым номером), регистрацией в ETBİS (Elektronik Ticaret Bilgi Sistemi — реестр компаний электронной коммерции Министерства торговли) и турецким IBAN (TR…) должна пройти подключение через HMS. Проверка KYC для компаний, зарегистрированных в ETBİS, обычно занимает 1–3 рабочих дня; продавцы без ETBİS попадают в очередь ручной проверки, которая может длиться 1–2 недели.

Пошаговое подключение к API

1. Создайте аккаунт HMS на merchant.hepsiburada.com, указав vergi numarası и IBAN. Загрузите свидетельство ETBİS, образец подписи (imza sirküleri) и документ из налоговой инспекции.
2. Сгенерируйте учётные данные API в разделе Hesabım → Entegrasyon Bilgileri → API Anahtarı. Система выдаст username, password и ваш постоянный Merchant ID. Храните секреты в хранилище — Hepsiburada больше не покажет пароль.
3. Добавьте исходящие IP в белый список, если этого требует ваша платформа интеграции. Zunapro публикует фиксированный диапазон исходящих IP, чтобы продавцы могли закрепить его в списке разрешённых в HMS.
4. Проверьте подключение чтением листингов — вызовите GET /listings/merchantid/{MERCHANT_ID} и убедитесь, что получен ответ 200 OK с вашими текущими товарами.
5. Подпишитесь на вебхуки событий заказов: POST /webhook-subscriptions с вашим callback URL и типами событий (order.created, order.cancelled, return.created).
6. Загрузите первый товар через POST /product/api/products/import — Hepsiburada вернёт trackingId; опрашивайте его до status:DONE.
7. Запуск — переключите интеграцию в HMS в статус «Aktif», когда проверочные тесты пройдены.

Заголовки и типичные ошибки

Самая частая регрессия интеграции — отсутствующий или неверно сформированный User-Agent. Hepsiburada строго требует формат {MERCHANT_ID} - {AppName}; стандартный User-Agent вроде axios/1.6 или okhttp/4 возвращает 401 Unauthorized без пояснений в теле ответа. Всегда задавайте User-Agent явно и логируйте его в промежуточном слое запросов.

3. Синхронизация товаров — дерево категорий, атрибуты, варианты

Дерево категорий

Каталог Hepsiburada организован как строгое дерево категорий из трёх–пяти уровней, доступное через GET /product/api/categories/get-all-categories. Каждый товар должен быть привязан к ID конечной категории; промежуточные узлы отклоняются с VALIDATION_ERROR. Реорганизация категорий 2024 года объединила ряд устаревших узлов (отдельные «Bluetooth Kulaklık» и «Kablosuz Kulaklık» были слиты в «Kablosuz Kulaklık & Bluetooth»), поэтому интеграциям старше этого времени требуется обновить сопоставление категорий.

Обязательные атрибуты блокируют одобрение

Каждая категория предоставляет список обязательных и необязательных атрибутов через GET /product/api/categories/{categoryId}/attributes. В отличие от Trendyol, Hepsiburada считает отсутствие обязательных атрибутов жёсткой блокировкой листинга — товар переходит в состояние WAITING_FOR_APPROVAL и не станет «Active», пока все обязательные атрибуты не будут заполнены допустимыми значениями из справочника. Типичные проблемы:

• Бренд — должен точно совпадать с реестром брендов Hepsiburada; «Apple» и «APPLE» — разные ID
• Цвет, размер, объём — берутся из контролируемых справочников, а не вводятся свободным текстом
• Гарантийный срок — обязателен для электроники, указывается в месяцах в виде перечисления (enum)
• Страна происхождения (Menşei) — обязательна для косметики, продуктов питания, БАДов

Варианты: разделение листинга и товара

Hepsiburada использует более строгое разделение товара и листинга, чем большинство конкурентов. Один товар (HB-SKU, внутренний идентификатор) может иметь много листингов (merchantSku) — по одному на продавца, со своей ценой, остатком, состоянием (новый/восстановленный) и гарантией. Для вариативных товаров (например, футболка S/M/L × красная/синяя/чёрная) каждая комбинация — отдельный узел товара, который можно сгруппировать по varyantGroupID, чтобы на странице товара отображались образцы цветов и размеров.

Массовый импорт через trackingId

Загрузка каталога в продакшене выполняется через POST /product/api/products/import с массивом до 100 товаров на запрос. API возвращает trackingId; интеграторы должны опрашивать GET /product/api/products/import/{trackingId} до статуса DONE, а затем разбирать построчные результаты на предмет ошибок валидации. Zunapro отправляет импорт пакетами по 100 строк, повторяет мягкие сбои и показывает построчные отчёты об ошибках в панели продавца.

POST /product/api/products/import Host: mpop.hepsiburada.com Authorization: Basic ... User-Agent: {MERCHANT_ID} - Zunapro { "merchant": "{MERCHANT_ID}", "items": [{ "merchantSku": "ZP-TSHIRT-RED-M", "categoryId": 18021982, "productName": "Premium Pamuklu T-Shirt — Kırmızı M", "brand": "Zuna", "attributes": [ {"name":"Renk","value":"Kırmızı"}, {"name":"Beden","value":"M"} ], "price": 249.90, "availableStock": 87, "varyantGroupID": "ZP-TSHIRT-2026" }] }

4. Управление заказами — вебхуки, статусы, этикетки

Жизненный цикл заказа

Заказ Hepsiburada проходит через фиксированную машину состояний, которую должна реализовать каждая интеграция. Статусы важны — преждевременные переходы приводят к штрафным баллам в рейтинге продавца:

• Open — заказ получен, ожидает подтверждения (SLA 24 часа для большинства категорий, 48 ч для мебели)
• InProgress / Picking — продавец подтвердил заказ, идёт комплектация и упаковка
• Packaged — посылка создана через API, ожидает передачи перевозчику
• Shipped — перевозчик отсканировал посылку; трек-номер активен
• Delivered — доставка последней мили подтверждена
• Cancelled / Returned — возврат инициирован покупателем или продавцом

Вебхуки или опрос

Hepsiburada поддерживает и вебхуки (предпочтительно), и опрос. Вебхуки настраиваются для каждого Merchant ID в HMS или через POST /webhook-subscriptions; платформа отправляет JSON-события на ваш HTTPS-эндпоинт с HMAC-подписью в заголовке X-HB-Signature. Резервный вариант — опрос GET /orders?status=Open&offset=0&limit=100 по cron каждые 30–60 секунд. Zunapro по умолчанию использует вебхуки плюс 5-минутную сверку опросом, которая подхватывает пропущенные события, — двойная страховка для полноты заказов.

Этикетки доставки: автоматическое создание HepsiJet

Когда вы отмечаете заказ как Packaged с выбранным HepsiJet, API автоматически формирует PDF-этикетку для печати и возвращает ссылку для скачивания и трек-номер. Отдельного запроса на этикетку нет — она включена в ответ на создание посылки:

POST /packages Host: oms-external.hepsiburada.com { "orderId": "HB-72184", "lineItems": [{"id": "HB-72184-1", "qty": 1}], "cargoCompany": "HepsiJet" } → 201 Created { "packageId": "PKG-998812", "trackingNumber": "HJ73219840TR", "labelUrl": "https://mpop.hepsiburada.com/labels/PKG-998812.pdf", "status": "Packaged" }

Портал возвратов

Возвраты инициируются покупателями через стандартный портал возвратов Hepsiburada (Iade Talepleri) и становятся доступны продавцам через GET /returns?status=Open. У продавца есть 3 рабочих дня, чтобы одобрить или оспорить возврат; после этого он одобряется автоматически. Одобренные возвраты запускают возмещение через платёжную систему Hepsiburada (продавец увидит его в следующем финансовом расчёте), а остаток следует восстановить через PUT /listings/{merchantSku}/stock.

5. Синхронизация остатков и цен — реальное время, Buy Box, репрайсер

Эндпоинт остатков

Остатки обновляются через API листингов с учётом изменений:

PUT /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU} { "availableStock": 42, "price": 299.90 }

Эндпоинт принимает цену и остаток в одном вызове, но внутреннему кэшу Hepsiburada может потребоваться 30–90 секунд, чтобы изменения появились на витрине. Массовые обновления используют POST /listings/import с той же схемой trackingId, что и импорт товаров.

Синхронизация в реальном времени или по cron

Продавцы продакшен-уровня используют событийную синхронизацию (каждое изменение остатка в вашей ERP за секунды отправляет PUT в Hepsiburada), а не cron раз в 15 минут. Риск синхронизации только по cron — перепродажа в периоды пиковых распродаж (Ramazan kampanyası, Black Friday, Efsane Cuma). Гибридная модель Zunapro сразу отправляет PUT-запросы и запускает 15-минутную сверку на случай потерянных событий — та же схема, что описана в нашей архитектуре автоматической синхронизации цен и остатков master→local→targets.

Как выиграть Buy Box

Buy Box на Hepsiburada (предложение по умолчанию «Sepete Ekle» на общей странице товара) присуждается по взвешенной формуле, которая учитывает:

• Цену — в пределах 1–2% от самого низкого действительного предложения
• Состояние запасов — глубина, актуальность, отсутствие недавних обнулений
• Обещанный срок доставки — при прочих равных выигрывает HepsiJet
• Рейтинг продавца — минимум 9.0+ по KPI доставки и обслуживания
• Долю дефектных заказов — штрафуются отмены, просроченные отправки, возвраты

Хорошо настроенный репрайсер пересматривает цены конкурентов каждые 5–10 минут.

6. HepsiJet — собственная курьерская сеть

Вертикально интегрированная последняя миля Hepsiburada

HepsiJet — собственная курьерская сеть последней мили Hepsiburada, запущенная в 2017 году, чтобы уменьшить зависимость от Yurtiçi и Aras Kargo для товаров с критичными сроками. К 2026 году HepsiJet располагает 1 500+ пунктами приёма в 81 провинции, обеспечивает доставку в день заказа в Стамбуле, Анкаре и Измире и использует собственный парк из более чем 2 500 машин, а также сеть франчайзинговых отделений (şubeleri).

Стандарт штрихкода и формат этикетки

Каждая этикетка HepsiJet содержит штрихкод Code-128 с 12-символьным трек-номером с префиксом HJ (например, HJ73219840TR). PDF-этикетка, сформированная через API, имеет формат A6 для термопринтеров; этикетки можно печатать напрямую через встроенную очередь ZPL.

Доставка в день заказа и «Yarın Kapında»

HepsiJet предлагает два премиальных уровня доставки, которые видны на странице товара:

• «Yarın Kapında» — доставка на следующий день в 81 провинции, если заказ отправлен до 14:00 по местному времени
• «Bugün Kapında» — доставка в день заказа в Стамбуле, Анкаре, Измире, Бурсе и Адане для заказов, оформленных до 11:00

Оба значка существенно повышают конверсию — по собственным данным Hepsiburada, рост конверсии составляет 15–25% у листингов со значками, что примерно соответствует эффекту «Hızlı Teslimat» на Trendyol.

Забор курьером или «Şubeye Bırak»

Продавцы выбирают между забором HepsiJet (курьер забирает посылки со склада, оплата за посылку) и Şubeye Bırak (продавец сам сдаёт посылки в ближайшее отделение HepsiJet — дешевле за посылку, но операционно сложнее). API интеграции поддерживает оба варианта — ответ по посылке содержит поле pickupAddressId, которое определяет маршрут.

7. HepsiLojistik — модель FBA

Что такое HepsiLojistik

HepsiLojistik — сервис фулфилмента силами маркетплейса Hepsiburada, турецкий аналог Amazon FBA, Trendyol TFC и Allegro One Fulfillment. Продавцы отправляют товарные запасы партиями в фулфилмент-центры Hepsiburada; Hepsiburada отвечает за хранение, комплектацию, упаковку, доставку последней мили (через HepsiJet) и возвраты. Заказы HepsiLojistik получают отдельный значок «Hepsiburada Garanti» и наивысший вес видимости в формуле Buy Box.

Сеть фулфилмент-центров

• Гебзе (Коджаэли) — флагманский фулфилмент-центр, ~150 000 м², обслуживает Стамбул и Мраморноморский регион
• Чорлу (Текирдаг) — открыт в 2023 году, ориентирован на Западную Турцию и трансграничные поставки на Балканы
• Кемальпаша (Измир) — покрытие Эгейского региона, открыт в 2024 году для юго-запада Турции
• Анкара (Полатлы) — хаб Центральной Анатолии, оптимизирован для доставки в столичный регион

Структура тарифов

Тарифы HepsiLojistik публикуются как плата за фулфилмент единицы товара плюс ежемесячная плата за хранение:

• Плата за фулфилмент единицы — обычно ₺25–₺75 в зависимости от весовой категории и категории товара
• Ежемесячное хранение — оплата за м³ в месяц, тарифы зависят от оборачиваемости (медленно продающиеся SKU платят больше)
• Входящая доставка — доставку до фулфилмент-центра оплачивает продавец
• Обработка возвратов — для возвратов в рамках правил включена в плату за фулфилмент

Заявка и подключение

HepsiLojistik не доступен по умолчанию. Продавцы подают заявку через HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru, предоставляя историю продаж за 6 месяцев и список целевых SKU. Приоритет получают продавцы с ~500+ заказами в месяц и предсказуемым спросом; продавцы с меньшим объёмом обычно остаются на модели самостоятельного забора HepsiJet.

8. Интеграция электронных счетов (e-Fatura) — GİB и ERP

GİB e-Fatura обязателен

Турецкая GİB (Gelir İdaresi Başkanlığı — Управление доходов) требует e-Fatura (структурированные XML-счета, подаваемые на портал GİB) от всех компаний с оборотом выше годового порога (сейчас ~₺3M, снижен для продавцов электронной коммерции поправками 2026 года). Ниже порога применяется e-Arşiv Fatura — тоже электронный, но с чуть более простой процедурой подписания. Заказы на маркетплейсах не освобождаются: каждый заказ B2C и B2B на маркетплейсе требует электронного счёта, выставленного в течение 7 дней с момента отгрузки.

Эндпоинт счетов Hepsiburada

Hepsiburada предоставляет финансовый эндпоинт для загрузки счетов — продавцы (или их интеграторы e-Fatura) передают UUID GİB и PDF-версию выставленного счёта, который затем становится доступен покупателю по стандартной ссылке «Faturayı İndir» на странице заказа:

POST /finance/invoices Host: integration.hepsiburada.com { "orderId": "HB-72184", "invoiceNumber": "ZUN2026000087421", "invoiceUuid": "f8e7d6c5-1234-5678-9abc-def012345678", "invoiceDate": "2026-06-09", "pdfBase64": "JVBERi0xLjQKJ..." }

Совместимые ERP и провайдеры e-Fatura

Большинство турецких продавцов выставляют сам счёт через свою ERP / интегратора e-Fatura (entegratör) и передают результат в Hepsiburada. Zunapro предлагает встроенные коннекторы для:

• Logo Tiger 3 / Logo Wings — самая распространённая ERP в Турции
• Mikro Yazılım — сильна в рознице малого и среднего бизнеса
• Netsis (партнёр SAP) — для крупных продавцов
• Foriba, Uyumsoft, Digital Planet, izibiz — профильные интеграторы GİB e-Fatura

Уровень KVKK

Персональные данные покупателей, проходящие через конвейер счетов, регулируются турецким KVKK (Kişisel Verilerin Korunması Kanunu — Закон о защите персональных данных) — местным аналогом GDPR, за соблюдением которого следит KVKK Kurumu (орган по защите данных). Продавцы являются совместными операторами персональных данных из заказов и при необходимости должны регистрировать операции обработки в VERBİS.

9. Типичные ошибки и решения

Главные ошибки в продакшене

HTTP / код	Симптом	Причина	Решение
401 Unauthorized	Все запросы отклоняются	Отсутствует или неверно сформирован заголовок User-Agent	Явно задайте User-Agent: {MERCHANT_ID} - {AppName}
403 Forbidden	Заблокирован конкретный эндпоинт	У API-ключа нет нужных прав; продавец не одобрен для модуля	Перевыпустите ключ в HMS с полными правами, обратитесь в Merchant Support
VALIDATION_ERROR	Товар застрял в WAITING_FOR_APPROVAL	Отсутствует обязательный атрибут категории или указано недопустимое значение справочника	Получите /categories/{id}/attributes, заполните обязательные поля допустимыми значениями enum
BRAND_NOT_FOUND	Импорт товара отклонён	Название бренда не совпадает точно с реестром брендов HB	Запросите /brands?name=..., используйте полученный ID, при отсутствии подайте заявку на создание бренда
429 Too Many Requests	Пиковый трафик ограничен	Превышено ~30 запросов/с для листингов или ~10/с для заказов	Реализуйте экспоненциальную задержку с поддержкой заголовка Retry-After
STOCK_UPDATE_DELAY	Витрина показывает устаревший остаток 30–90 с	Задержка распространения кэша, а не ошибка	Заранее уменьшайте остаток при риске перепродажи; сверяйте после задержки
HEPSIJET_PICKUP_FAIL	Посылка создана, но курьер её не забрал	Неверный pickupAddressId или адрес вне зоны покрытия HepsiJet	Проверьте адрес забора в HMS, для исключённых индексов используйте Yurtiçi/Aras
INVOICE_UPLOAD_REJECTED	Загрузка e-Fatura возвращает 400	Неверный формат UUID или повреждённый base64 PDF	Проверьте формат UUID v4, перекодируйте PDF, повторите с идемпотентным номером счёта

Порядок диагностики

Когда интеграция с Hepsiburada начинает вести себя странно, Zunapro проводит диагностику в таком порядке:

1. Проверить HMS → панель API Health на долю ошибок по эндпоинтам
2. Проверить User-Agent и учётные данные Basic auth тестовым запросом curl
3. Посмотреть заголовок X-Request-Id в ответе с ошибкой — Hepsiburada Merchant Support требует его для отслеживания обращения
4. Сверить с журналом изменений developers.hepsiburada.com на предмет недавних изменений схемы

10. Комиссии Hepsiburada 2026 — от 8% до 22%

Тарифная сетка комиссий Hepsiburada на 2026 год зависит от категории, публикуется ежеквартально в HMS в разделе Hesabım → Komisyon Oranları и делится на три широких диапазона плюс несколько особых категорий (золото, автотовары, крупная бытовая техника).

Сравнение комиссий 2026 — Hepsiburada, Trendyol и Amazon TR

Маркетплейс	Низкий уровень	Средний уровень	Высокий уровень	Подписка / прочее
Hepsiburada	8% – 12%	12% – 17%	15% – 22%	Бесплатный аккаунт · HepsiAd по желанию · сборы HepsiLojistik при использовании
Trendyol	9% – 13%	13% – 18%	16% – 24%	Бесплатный аккаунт · сборы TFC при использовании · Trendyol Ads по желанию
Amazon TR	5% – 12%	12% – 17%	15% – 22%	Professional Seller ~₺99 / месяц · сборы FBA при использовании
n11	6% – 10%	10% – 15%	13% – 18%	Бесплатный аккаунт · подписка n11 Pro по желанию
Çiçeksepeti	10% – 14%	14% – 18%	16% – 22%	Бесплатный аккаунт · специализация на доставке цветов и подарков в день заказа

Как читать таблицу: Hepsiburada примерно на одном уровне с Amazon TR и немного дешевле Trendyol во всех диапазонах. Отличие не в комиссии, а в логистике — собственная последняя миля HepsiJet даёт Hepsiburada структурное преимущество по срокам доставки в крупных городах, а более широкая аудитория Trendyol компенсирует его немного более высокие комиссии.

Правовая база Турции 2026 — НДС, e-Fatura, KVKK, ETBİS

Ставки НДС (KDV) 2026

НДС в Турции — KDV (Katma Değer Vergisi) — в 2026 году применяется по трём установленным законом ставкам:

• 20% — стандартная ставка — большинство потребительских товаров, электроника, мода, дом и интерьер
• 10% — сниженная ставка — базовые продукты питания, текстиль в отдельных категориях, книги, гостиничные услуги
• 1% — особо сниженная ставка — основные продукты (хлеб, молоко, яйца), сельскохозяйственное сырьё, отдельные медицинские товары

Продавцы на маркетплейсах регистрируются как плательщики KDV в региональной Vergi Dairesi (налоговой инспекции); трансграничные продавцы могут использовать расширенный после 2024 года специальный режим НДС Турции для электронной коммерции.

e-Fatura и e-Arşiv — требование GİB

• e-Fatura — структурированные XML-счета, подаваемые в GİB; обязательны при обороте выше годового порога и для всех продавцов электронной коммерции согласно поправкам 2026 года
• e-Arşiv Fatura — тоже электронный, но более простой формат; для B2C ниже порога e-Fatura
• 7-дневный срок выставления — каждый заказ на маркетплейсе требует электронного счёта в течение 7 дней с момента отгрузки
• e-İrsaliye, e-Müstahsil, e-Smm — сопутствующие документы для логистики, сельского хозяйства и фрилансеров

KVKK — турецкий аналог GDPR

KVKK (Kişisel Verilerin Korunması Kanunu), действующий с 2016 года и ужесточённый в 2024 году в рамках сближения с GDPR, регулирует обработку персональных данных. Продавцы на маркетплейсах являются совместными операторами персональных данных из заказов (имя, адрес, телефон, при необходимости IBAN) и обязаны:

• Зарегистрироваться в VERBİS (Veri Sorumluları Sicil Bilgi Sistemi) при превышении пороговых значений
• Иметь письменную политику конфиденциальности (Aydınlatma Metni), доступную покупателям
• Соблюдать права субъектов данных (доступ, исправление, удаление) в течение 30 дней
• Сообщать об утечках в KVKK Kurumu в течение 72 часов

ETBİS — реестр компаний электронной коммерции

ETBİS (Elektronik Ticaret Bilgi Sistemi), который ведёт Министерство торговли (Ticaret Bakanlığı), — обязательный реестр для каждой компании электронной коммерции, работающей в Турции. Регистрация бесплатная и проводится онлайн; номер ETBİS должен быть указан в профилях продавца на маркетплейсах и в футере собственного магазина. KYC Hepsiburada автоматически проверяет ETBİS при подключении.

Логистика и доставка — сначала HepsiJet, Yurtiçi/Aras как резерв

По умолчанию: HepsiJet

HepsiJet — перевозчик по умолчанию для заказов Hepsiburada и единственный, который автоматически включает значки «Yarın Kapında» / «Bugün Kapında». Для большинства продавцов в крупных городах правильный выбор — направлять через HepsiJet 80–100% объёма.

Интегрированные сторонние перевозчики

Hepsiburada также интегрирован с крупнейшими национальными перевозчиками Турции; этикетки формируются через тот же эндпоинт создания посылки — достаточно изменить значение cargoCompany:

• Yurtiçi Kargo — самое плотное покрытие в сельской местности, силён в индексах Восточной Анатолии, которые HepsiJet не обслуживает
• Aras Kargo — конкурентные SLA для B2B, популярен для мебели и крупногабаритных товаров
• DHL Kargo — гибкие окна доставки в день заказа на отдельных направлениях
• PTT Kargo — государственный почтовый оператор, охват сельской местности, более длительные сроки
• UPS Türkiye / DHL — международные трансграничные направления

Логика маршрутизации в Zunapro

Логистический маршрутизатор Zunapro оценивает каждый заказ по настраиваемой матрице — вес, индекс получателя, объявленная стоимость, класс SKU — и по умолчанию выбирает HepsiJet, переключаясь на Yurtiçi для исключённых индексов и на Aras для посылок тяжелее 30 кг. Выбранный перевозчик передаётся через тот же эндпоинт посылок Hepsiburada, поэтому покупатель видит единое отслеживание.

Как начать продавать на Hepsiburada — пошагово в 2026 году

Запуск в 5 шагов

1. Зарегистрируйтесь в ETBİS и HMS — создайте запись ETBİS на etbis.ticaret.gov.tr, затем подключитесь на merchant.hepsiburada.com с vergi numarası, IBAN и образцом подписи. Проверка KYC занимает 1–3 рабочих дня.
2. Сгенерируйте учётные данные API — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Сохраните username/password в хранилище секретов; запишите Merchant ID для заголовков User-Agent.
3. Подключите e-Fatura — выберите интегратора GİB (Logo, Mikro, Foriba, izibiz) и убедитесь, что эндпоинт загрузки счетов Hepsiburada доступен. Проверьте на одном заказе B2C.
4. Выберите логистическую схему — забор HepsiJet или Şubeye Bırak, плюс Yurtiçi/Aras как резерв для исключённых индексов. Заранее подготовьте этикетки и упаковочные материалы.
5. Подключитесь через Zunapro — вставьте учётные данные API в плитку Hepsiburada, сопоставьте мастер-каталог, включите автоэтикетки HepsiJet и e-Fatura и переведите интеграцию в рабочий режим.

Процесс подключения в Zunapro

1. Войдите в Zunapro и откройте модуль «Турция»
2. Нажмите «Подключить Hepsiburada» — вставьте API username, password и Merchant ID
3. Автоматическое сопоставление категорий — ML-модель Zunapro предлагает конечные категории для каждого SKU мастер-каталога; подтвердите в несколько кликов
4. Включите автоэтикетки HepsiJet + e-Fatura — по одному переключателю
5. Запуск — запускается первая синхронизация листингов; вебхуки регистрируются автоматически

Вопросы об интеграции с Hepsiburada 2026