Hepsiburada 連携ガイド 2026：REST API、HepsiJet & 一元的なセラー管理

1. Hepsiburada API アーキテクチャ 2026

mpop.hepsiburada.com 上の REST

Hepsiburada のセラー API は、統一ホスト mpop.hepsiburada.com（mpop = 「Merchant Platform Open API」）の下でホストされる純粋な REST/JSON サービスです。GraphQL や gRPC の亜種はありません。認証済みのトラフィックはすべて HTTPS 経由で行われ、HMS オンボーディング時に発行される Merchant ID に紐づけられます。API 面は単一のモノリシックなルートではなく、論理的なサブドメインに分割されています：

• listing-external.hepsiburada.com — listing の CRUD（価格、在庫、出品ステータス）
• mpop.hepsiburada.com/product/api/products — 商品作成とカテゴリ属性
• oms-external.hepsiburada.com — 注文管理（注文、パッケージ、出荷）
• returns-external.hepsiburada.com — 返品と返金
• integration.hepsiburada.com/finance — インボイスのアップロードと財務照合

各サブドメインは同一の HTTP Basic 認証方式を共有しますが、それぞれ独自のレート制限とページネーション規約を持ちます。Zunapro の HB コネクターは、このファンアウト構造を単一の正規化されたインターフェースの背後に抽象化します。

認証：HTTPS 上の HTTP Basic

Trendyol のやや寛容な API や Amazon の SP-API OAuth フローとは異なり、Hepsiburada は意図的にシンプルな HTTP Basic 認証方式を採用しています。Authorization ヘッダーに Basic base64(username:password) を載せ、username が API key、password がペアの secret です。すべてのリクエストには、Merchant ID を含む User-Agent ヘッダーも必要です。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 パネル

merchant.hepsiburada.com にある HMS パネルは、API と対をなす運用ウェブコンソールです。すべての API 機能には HMS の同等操作（listing 編集、注文承認、返金発行、財務照合）があり、HMS は API キーの発行、HepsiJet 集荷住所の設定、ユーザー権限の管理を行える唯一の場所です。2024〜2026年の HMS 刷新により、統一された左ナビゲーション、リアルタイム精算レポート、そしてエンドポイント別の 4xx/5xx 率を表示する新しい「API Health」ダッシュボードが導入され、連携のデバッグに非常に役立ちます。

レート制限と冪等性

Hepsiburada は寛容ながらも厳格に適用されるレート制限を課しています——通常、listing 更新で マーチャントあたり約30リクエスト/秒、注文エンドポイントではより低く（約10/秒）です。一括商品インポートは別途スロットリングされ、trackingId 付きの 202 Accepted を返します。その後、完了まで /import/{trackingId} をポーリングします。注文 API は、複数回の読み取り間で安定したパッケージ ID と注文 ID により冪等性をサポートします。

2. REST API での接続 — ステップバイステップ

前提条件：HMS アカウント & ETBİS

いかなる API 呼び出しの前にも、vergi numarası（税番号）、ETBİS 登録（Elektronik Ticaret Bilgi Sistemi——通商省の e コマース事業者登録）、そして トルコの IBAN（TR…）を持つトルコ登記の事業者が HMS を通じてオンボーディングする必要があります。ETBİS 登録済みの事業者の場合、KYC 審査は通常1〜3営業日で完了します。ETBİS 未登録のセラーは手動審査キューに回され、1〜2週間かかることがあります。

API オンボーディング手順

1. HMS アカウントを作成し、merchant.hepsiburada.com で vergi numarası と IBAN を入力します。ETBİS 証明書、署名回状、税務当局の書類をアップロードします。
2. API 認証情報を生成します。Hesabım → Entegrasyon Bilgileri → API Anahtarı で、システムが username、password、そして安定した Merchant ID を返します。secret はボールトに保管してください——Hepsiburada は password を再表示しません。
3. アウトバウンド IP をホワイトリストに登録します。連携プラットフォームが必要とする場合、Zunapro は固定の送信元 IP 範囲を公開しているので、セラーは HMS の許可リストで固定できます。
4. listing の読み取りでスモークテスト——GET /listings/merchantid/{MERCHANT_ID} を呼び出し、既存の在庫とともに 200 OK が返ることを確認します。
5. 注文イベントの webhook を購読します。POST /webhook-subscriptions にコールバック 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} の書式を厳格に要求します。デフォルトの axios/1.6 や okhttp/4 の User-Agent は、説明的な本文のない 401 Unauthorized を返します。常に User-Agent を明示的に設定し、リクエストのミドルウェアでログに記録してください。

3. 商品同期 — カテゴリツリー、属性、バリアント

カテゴリツリー

Hepsiburada のカタログは、GET /product/api/categories/get-all-categories で公開される厳格な 3〜5階層のカテゴリツリーとして構成されています。すべての商品はリーフレベルのカテゴリ 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」にはなりません。よくある原因：

• ブランド（Brand）——Hepsiburada のブランドレジストリと完全一致が必要。「Apple」と「APPLE」は別の ID です
• 色・サイズ・容量——自由記述ではなく統制語彙から選択します
• 保証期間（Warranty period）——電子製品では必須で、月数を列挙値で表します
• 原産国（Menşei）——化粧品・食品・サプリメントで必須です

バリアント：listing と product の分離

Hepsiburada は、多くの競合よりも厳格な product と listing の分離を採用しています。単一の product（HB-SKU、内部識別子）は複数の listing（merchantSku）を持てます——セラーごとに1つで、それぞれ独自の価格、在庫、コンディション（新品/リファービッシュ）、保証を持ちます。バリアント商品（例：S/M/L × 赤/青/黒 の T シャツ）では、各組み合わせが個別の product ノードとなり、任意で varyantGroupID の下にグループ化され、商品ページに色とサイズのスウォッチが表示されます。

trackingId による一括インポート

本番のカタログ投入では POST /product/api/products/import を使い、1リクエストあたり最大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. 注文管理 — Webhook、ステータスフロー、ラベル

注文のライフサイクル

Hepsiburada の注文は、あらゆる連携が実装しなければならない固定のステートマシンを進みます。これらのステータスは重要で、早すぎる遷移はセラースコアに対するペナルティポイントを引き起こします：

• Open（未処理）——注文受領、承認待ち（多くのカテゴリで24時間 SLA、家具では48時間）
• InProgress / Picking（処理中 / ピッキング）——セラーが承認し、ピッキングと梱包中
• Packaged（梱包済）——API でパッケージ作成済み、配送会社への引き渡し待ち
• Shipped（発送済）——配送会社が荷物をスキャン、追跡番号が有効
• Delivered（配達済）——ラストマイルで配達確認済み
• Cancelled / Returned（キャンセル / 返品）——顧客またはマーチャントが返品ポータルを開始

Webhook とポーリング

Hepsiburada は webhook（推奨）とポーリングの両方をサポートします。webhook は HMS で Merchant ID 単位、または POST /webhook-subscriptions で設定します。プラットフォームは JSON イベントを HTTPS エンドポイントへ送信し、X-HB-Signature ヘッダーに HMAC 署名を付けます。ポーリングは GET /orders?status=Open&offset=0&limit=100 を30〜60秒の cron で実行するフォールバックです。Zunapro はデフォルトで webhook を用い、5分間隔のポーリング照合器で漏れたイベントを捕捉します——注文の完全性を99.99%超に保つ二重の備えのパターンです。

配送ラベル：HepsiJet 自動生成

HepsiJet を選択した状態で注文を Packaged にマークすると、API は印刷可能な PDF 配送ラベルを自動生成し、ダウンロード URL と追跡番号を返します。別途のラベルリクエストはありません——ラベルはパッケージ作成のレスポンスにバンドルされます：

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、リプライサー

在庫エンドポイント

在庫は、差分を考慮したペイロードで listing API を通じて更新されます：

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

このエンドポイントは同一呼び出しで価格と在庫の両方を受け付けますが、Hepsiburada の内部キャッシュがストアフロントへ伝播するまで 30〜90秒かかる場合があります。一括更新は POST /listings/import を使い、商品インポートと同じ trackingId パターンを取ります。

リアルタイム同期 vs cron 同期

本番グレードのセラーは、15分ごとの cron ではなく イベント駆動同期（ERP のあらゆる在庫変更が数秒以内に Hepsiburada への PUT を発火）を使います。cron のみの同期のリスクは、繁忙期（Ramazan kampanyası、Black Friday、Efsane Cuma）の売り越しです。Zunapro のハイブリッドモデルは即時 PUT を発火し、イベント欠落に備えて15分間隔の照合器を併用します——当社の master→local→targets 価格・在庫自動同期アーキテクチャに記載されているのと同じパターンです。

Buy Box を勝ち取る

Hepsiburada の Buy Box（共有商品ページでのデフォルトの「Sepete Ekle」オファー）は、以下を組み合わせた重み付け式で付与されます：

• 価格——最安の有効オファーの1〜2%以内で競争力がある
• 在庫の健全性——数量、鮮度、直近の欠品なし
• 配送の約束——条件が同じなら HepsiJet が優先
• セラー評価——配送とサービスの KPI で最低9.0以上
• 注文欠陥率——キャンセル、発送遅延、返品が減点対象

5〜10分ごとに競合価格を再評価する適切に調整されたリプライサーは、競合の激しい SKU で Buy Box シェアを通常15〜30%引き上げます。

6. HepsiJet — 自社配送網

Hepsiburada の垂直統合されたラストマイル

HepsiJet は Hepsiburada 自社のラストマイル配送網で、時間に敏感な SKU での Yurtiçi や Aras Kargo への依存を断ち切るため2017年に立ち上げられました。2026年までに HepsiJet は81県で 1,500以上の受取拠点を運営し、イスタンブール・アンカラ・イズミルで当日配達を行い、2,500台超の自社車両とフランチャイズ拠点（şube）のネットワークを活用しています。

バーコード規格とラベル形式

すべての HepsiJet 配送ラベルには、HJ で始まる12桁の追跡番号（例：HJ73219840TR）をエンコードした Code-128 バーコードが付いています。API 生成の PDF ラベルはサーマルプリンター向けの A6 レイアウトを使い、統合された ZPL キューから直接印刷できます。

当日配達 & Yarın Kapında

HepsiJet は商品ページに表示される2つのプレミアム配送ティアを提供します：

• 「Yarın Kapında（明日お届け）」——現地時間14:00より前に発送された場合、81県で翌日配達
• 「Bugün Kapında（本日お届け）」——11:00より前に注文された場合、イスタンブール・アンカラ・イズミル・ブルサ・アダナで当日配達

両方のバッジはコンバージョンを大きく押し上げます——Hepsiburada 自身のデータでは、バッジ付きの出品で 15〜25%のコンバージョン向上が示されており、これは Trendyol の「Hızlı Teslimat（迅速配達）」効果とほぼ同等です。

集荷 vs Şubeye Bırak（拠点持ち込み）

セラーは HepsiJet 集荷（配送員が倉庫から集荷、荷物ごとに課金）と Şubeye Bırak（拠点持ち込み）（セラーが最寄りの HepsiJet 拠点へ荷物を持ち込み、荷物ごとに安価だが運用負荷が高い）から選べます。連携 API は両方をサポートし、パッケージのレスポンスにはルーティングを決める pickupAddressId フィールドが含まれます。

7. HepsiLojistik — FBA モデル

HepsiLojistik とは

HepsiLojistik は Hepsiburada のマーケットプレイス・フルフィルメント（fulfillment-by-marketplace）サービスで、Amazon FBA、Trendyol TFC、Allegro One Fulfillment のトルコ版に相当します。セラーは在庫を Hepsiburada のフルフィルメントセンターへ一括で送り、Hepsiburada が保管、ピッキング、梱包、ラストマイル配達（HepsiJet 経由）、返品を担います。HepsiLojistik の注文には独自の 「Hepsiburada Garanti（Hepsiburada 保証）」バッジが付き、Buy Box 式で最高の露出ウェイトを得ます。

フルフィルメントセンター網

• Gebze（Kocaeli）——旗艦フルフィルメントセンター、約150,000㎡、イスタンブール + マルマラ地域をカバー
• Çorlu（Tekirdağ）——2023年に追加、トルコ西部 + バルカン越境に注力
• Kemalpaşa（Izmir）——エーゲ海地域をカバー、2024年に開設、トルコ南西部向け
• Ankara（Polatlı）——中央アナトリアのハブ、首都圏配達に最適化

料金体系

HepsiLojistik の価格は、1個あたりのフルフィルメント料と月額保管料として公開されています：

• 1個あたりフルフィルメント料——重量帯とカテゴリに応じて通常 ₺25〜₺75
• 月額保管料——1立方メートルあたり月額で課金、回転率で段階化（ロングテール SKU ほど高い）
• 入庫配送料——フルフィルメントセンターへの入庫はセラー負担
• 返品処理——ポリシー内の返品はフルフィルメント料に含まれる

申請とオンボーディング

HepsiLojistik はデフォルトで開放されていません。セラーは HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru から、6か月分の販売履歴と対象 SKU リストを提出して申請します。Hepsiburada は月間 約500件超の注文があり需要パターンが予測可能なセラーを優先します。少量のセラーは通常、単体の HepsiJet 集荷モデルにとどまります。

8. 電子インボイス（e-Fatura）連携 — GİB & ERP

GİB e-Fatura は必須

トルコの GİB（Gelir İdaresi Başkanlığı——歳入庁）は、年間売上高の基準（現在およそ ₺300万、2026年改正で e コマースセラー向けに引き下げ）を超えるすべての企業に e-Fatura（GİB ポータルへ提出する構造化 XML インボイス）を義務付けています。基準未満の場合は e-Arşiv Fatura が適用されます——同じく電子ですが、署名がやや軽量です。マーケットプレイスの注文も例外ではありません：すべての B2C・B2B マーケットプレイス注文は、発送イベントから 7日以内に電子インボイスの発行が必要です。

Hepsiburada インボイスエンドポイント

Hepsiburada はインボイスアップロード用の財務エンドポイントを公開しています——セラー（またはその e-Fatura 統合業者）が GİB UUID と発行済みインボイスの 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 レイヤー

インボイスのパイプラインを流れる顧客 PII は、トルコの KVKK（Kişisel Verilerin Korunması Kanunu——個人データ保護法）によって規制されます。これは KVKK Kurumu（データ保護当局）が執行する GDPR 相当のローカル規制です。セラーは注文側 PII の共同管理者であり、該当する場合は VERBİS に処理活動を登録しなければなりません。

9. よくあるエラーと解決策

主な本番エラー

HTTP / コード	症状	根本原因	対処
401 Unauthorized	すべてのリクエストが拒否される	欠落または書式不正の User-Agent ヘッダー	User-Agent: {MERCHANT_ID} - {AppName} を明示的に設定する
403 Forbidden	特定のエンドポイントがブロックされる	API key にスコープがない／マーチャントがモジュール未承認	HMS でフルスコープでキーを再発行し、Merchant Support に連絡する
VALIDATION_ERROR	商品が WAITING_FOR_APPROVAL で止まる	必須カテゴリ属性の欠落または無効なルックアップ値	/categories/{id}/attributes を取得し、必須項目を有効な列挙値で埋める
BRAND_NOT_FOUND	商品インポートが拒否される	ブランド文字列が HB ブランドレジストリと完全一致しない	/brands?name=... を照会し、返された ID を使う。なければブランド作成を申請する
429 Too Many Requests	バースト・トラフィックがスロットリングされる	listing の約30リクエスト/秒または注文の約10/秒を超過	Retry-After ヘッダー対応の指数バックオフを実装する
STOCK_UPDATE_DELAY	ストアフロントが30〜90秒古い在庫を表示する	キャッシュ伝播の遅延であり、バグではない	売り越しリスクがある場合は先回りして在庫を減らし、遅延後に照合する
HEPSIJET_PICKUP_FAIL	パッケージは作成されたが集荷がない	pickupAddressId の誤り、または住所が HepsiJet 圏外	HMS で集荷住所を確認し、除外 ZIP は Yurtiçi/Aras にフォールバックする
INVOICE_UPLOAD_REJECTED	e-Fatura アップロードが 400 を返す	UUID 形式が無効、または PDF base64 の破損	UUID v4 形式を検証し、PDF を再エンコードし、冪等なインボイス番号で再試行する

診断ワークフロー

Hepsiburada の連携が不審な挙動を始めたとき、Zunapro が従う診断の順序は次のとおりです：

1. HMS → API Health ダッシュボードでエンドポイント別のエラー率を確認する
2. curl のスモークテストで User-Agent と Basic 認証の認証情報を検証する
3. 失敗レスポンスの X-Request-Id ヘッダーを確認する——Hepsiburada Merchant Support がチケット追跡に必要とします
4. developers.hepsiburada.com の変更履歴と照合し、最近のスキーマ変更を確認する

10. 2026年 Hepsiburada 手数料 — 8% から 22%

Hepsiburada の2026年の手数料スケジュールはカテゴリ別に段階化されており、HMS の Hesabım → Komisyon Oranları に四半期ごとに公開され、3つの大きな帯と、いくつかの外れ値カテゴリ（金、自動車、大型家電）に分かれています。

2026年 手数料比較 — Hepsiburada vs Trendyol vs 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%	プロフェッショナルセラー 約 ₺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年 トルコ法制度 — VAT、e-Fatura、KVKK、ETBİS

2026年 VAT（KDV）率

トルコの VAT——KDV（Katma Değer Vergisi）——は2026年に3つの法定税率を用います：

• 20% 標準税率——大半の消費財、電子製品、ファッション、ホーム＆リビング
• 10% 軽減税率——基本的な食料品、一部カテゴリの繊維製品、書籍、ホスピタリティ
• 1% 超軽減税率——主食（パン、牛乳、卵）、農業投入財、一部の医療

マーケットプレイスのセラーは地域の Vergi Dairesi（税務署）で KDV に登録します。越境セラーは、2024年以降に拡張されたトルコの e コマース向け特別 VAT 制度を利用できます。

e-Fatura & e-Arşiv — GİB の義務

• e-Fatura——GİB へ提出する構造化 XML インボイス、年間売上高の基準超で必須、2026年改正ですべての e コマースセラーに必須
• e-Arşiv Fatura——同じく電子だがより軽量、e-Fatura 基準未満の B2C 向け
• 7日の発行期限——すべてのマーケットプレイス注文で発送から7日以内に電子インボイスが必要
• e-İrsaliye、e-Müstahsil、e-Smm——物流、農業、フリーランス向けの付随文書

KVKK — トルコの GDPR 相当法

KVKK（Kişisel Verilerin Korunması Kanunu）は2016年から施行され、2024年に GDPR との整合で強化された、個人データ処理を規制する法です。マーケットプレイスのセラーは注文側 PII（氏名、住所、電話、該当時は IBAN）の共同管理者であり、以下が必要です：

• 基準を超える場合、VERBİS（Veri Sorumluları Sicil Bilgi Sistemi）に登録する
• 顧客がアクセスできる書面のプライバシーポリシー（Aydınlatma Metni）を維持する
• データ主体の権利（アクセス、訂正、削除）を30日以内に履行する
• 侵害を72時間以内に KVKK Kurumu に報告する

ETBİS — e コマース事業者登録

ETBİS（Elektronik Ticaret Bilgi Sistemi）は 通商省（Ticaret Bakanlığı）が運営し、トルコで事業を行うすべての e コマース事業者にとって必須の登録です。登録は無料でオンラインで行え、ETBİS 番号はマーケットプレイスのセラープロフィールと自社ショップのフッターに表示する必要があります。Hepsiburada の KYC はオンボーディング時に ETBİS を自動チェックします。

物流と配送 — HepsiJet 優先、Yurtiçi/Aras バックアップ

デフォルト：HepsiJet

HepsiJet は Hepsiburada の注文のデフォルト配送会社であり、「Yarın Kapında」／「Bugün Kapında」バッジを自動でトリガーする唯一の会社です。主要都市の大半のセラーにとって、80〜100%の量を HepsiJet 経由でルーティングするのが正しい選択です。

統合された第三者配送会社

Hepsiburada はトルコの既存の全国配送会社とも統合しており、cargoCompany の値を変えるだけで、同じパッケージ作成エンドポイントを通じて配送ラベルを生成できます：

• Yurtiçi Kargo——最も密な地方カバレッジ、HepsiJet が除外する東アナトリアの ZIP に強い
• Aras Kargo——競争力のある B2B SLA、家具や大型商品で人気
• DHL Kargo——一部の回廊で柔軟な当日配達枠
• PTT Kargo——国営郵政事業者、地方までのリーチ、SLA は遅め
• UPS Türkiye / DHL——国際越境レーン

Zunapro のルーティングロジック

Zunapro の物流ルーターは、設定可能なマトリクス——重量、宛先 ZIP、申告価額、SKU クラス——に対して各注文を評価し、デフォルトで HepsiJet を選択、除外 ZIP では Yurtiçi、30kg 超の荷物では Aras にフォールバックします。選択された配送会社は同じ Hepsiburada パッケージエンドポイントを通じて送られるため、顧客は単一の追跡体験を得ます。

Hepsiburada で販売を始める方法 — 2026年 ステップバイステップ

5ステップの立ち上げ

1. ETBİS & HMS に登録——etbis.ticaret.gov.tr で ETBİS 記録を作成し、次に vergi numarası、IBAN、署名回状で merchant.hepsiburada.com にオンボーディングします。KYC は1〜3営業日で完了します。
2. API 認証情報を生成——Hesabım → Entegrasyon Bilgileri → API Anahtarı。username/password をボールトに保管し、User-Agent ヘッダー用に Merchant ID を控えます。
3. e-Fatura を配線——GİB 統合業者（Logo、Mikro、Foriba、izibiz）を選び、Hepsiburada のインボイスアップロードエンドポイントに到達できることを確認します。1件の B2C 注文でテストします。
4. 物流スタックを選択——HepsiJet 集荷 vs Şubeye Bırak、加えて除外 ZIP 向けの Yurtiçi/Aras フォールバック。ラベルと梱包材を事前準備します。
5. Zunapro で接続（10分）——Hepsiburada タイルに API 認証情報を貼り付け、マスターカタログをマッピングし、HepsiJet 自動ラベルと e-Fatura を有効化し、ライブに切り替えます。

Zunapro の接続フロー

1. Zunapro にサインインし、Turkey モジュールを開く
2. 「Hepsiburada を接続」をクリック——API username、password、Merchant ID を貼り付ける
3. 自動カテゴリマッピング——Zunapro の機械学習が各マスター SKU にリーフカテゴリのマッピングを提案、数クリックで確認する
4. HepsiJet 自動ラベル + e-Fatura を有効化——それぞれ1つのトグル
5. 本番稼働——1,000 SKU カタログの初回 listing 同期はおよそ10分で完了、webhook は自動登録される

2026年 Hepsiburada 連携 FAQ