Hepsiburada連携ガイド 2026年：REST API、HepsiJet、出品者管理の一元化

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

mpop.hepsiburada.com上のREST

Hepsiburadaの出品者向けAPIは純粋な REST/JSONサービス で、包括的なホスト mpop.hepsiburada.com （mpop =「Merchant Platform Open API」）の下で提供されています。GraphQLやgRPCの版はありません。認証が必要な通信はすべてHTTPSで行われ、HMSのオンボーディング時に発行される Merchant ID に紐づけられます。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認証方式を共有していますが、レート制限やページネーションの規則はそれぞれ異なります。ZunaproのHBコネクターは、こうした分散を1つの統一されたインターフェースの裏側で抽象化します。

認証：HTTPS上のHTTP Basic

やや寛容なTrendyolのAPIやAmazonのSP-APIのOAuthフローとは異なり、Hepsiburadaはあえてシンプルな HTTP Basic認証 方式を採用しています。 Authorization ヘッダーには Basic base64(username:password)を指定します。ここで username はAPIキー、 password は対になるシークレットです。すべてのリクエストには、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パネル

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

レート制限と冪等性

Hepsiburadaは余裕はあるものの厳格なレート制限を適用しています。通常、リスティングの更新では 出品者あたり約30リクエスト/秒 、注文のエンドポイントではそれより低い（約10/秒）制限です。商品の一括インポートは別途スロットリングされ、 202 Accepted と trackingIdを返します。その後、 /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証明書、署名証明書（imza sirküleri）、税務署の書類をアップロードします。
2. API認証情報を生成 します（Hesabım → Entegrasyon Bilgileri → API Anahtarı）。システムはユーザー名、パスワード、固定のMerchant IDを返します。シークレットは保管庫（vault）に保存してください。Hepsiburadaはパスワードを再表示しません。
3. 送信元IPをホワイトリストに登録 します（連携プラットフォームで必要な場合）。Zunaproは固定の送信元IP範囲を公開しているため、出品者はHMSの許可リストにそれを登録できます。
4. リスティングの読み取りで動作確認 — 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のカタログは、厳格な 3〜5階層のカテゴリーツリー として構成されており、 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です
• 色、サイズ、容量 — 自由入力ではなく、管理された語彙から選択します
• 保証期間 — 電子機器で必須。月数を列挙値で指定します
• 原産国（Menşei） — 化粧品、食品、サプリメントで必須です

バリエーション：リスティングと商品の分離

Hepsiburadaは、多くの競合よりも厳格な 商品とリスティング の分離を採用しています。1つの 商品 （HB-SKU、内部識別子）には、複数の リスティング （merchantSku）を紐づけられます。リスティングは出品者ごとに1つで、それぞれ独自の価格、在庫、状態（新品／整備済み）、保証を持ちます。バリエーション商品（例：S/M/L × 赤/青/黒のTシャツ）では、各組み合わせが個別の商品ノードとなり、必要に応じて 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 — 注文を受信し、承認待ち（ほとんどのカテゴリーでSLAは24時間、家具は48時間）
• InProgress / Picking — 出品者が確認済みで、ピッキングと梱包中
• Packaged — APIでパッケージを作成済みで、配送業者への引き渡し待ち
• Shipped — 配送業者が荷物をスキャン済みで、追跡番号が有効
• Delivered — ラストマイルで配達完了を確認
• Cancelled / Returned — 顧客または出品者が返品ポータルで手続きを開始

Webhookとポーリング

Hepsiburadaは Webhook （推奨）とポーリングの両方に対応しています。Webhookは、HMSまたは POST /webhook-subscriptionsでMerchant IDごとに設定します。プラットフォームはJSONイベントをHTTPSエンドポイントに送信し、HMAC署名を X-HB-Signature ヘッダーに含めます。ポーリングの場合は、30〜60秒間隔のcronで GET /orders?status=Open&offset=0&limit=100 を呼び出します。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の標準の返品ポータル（İade Talepleri）から顧客が開始し、出品者には GET /returns?status=Openで通知されます。出品者は 3営業日 以内に返品を承認するか異議を申し立てる必要があり、それを過ぎると自動承認されます。承認された返品はHepsiburadaの決済インフラを通じて返金され（出品者には次回の財務精算で反映されます）、在庫は次のエンドポイントで再計上する必要があります： PUT /listings/{merchantSku}/stock.

5. 在庫と価格の同期 — リアルタイム、カートボックス、価格自動調整

在庫エンドポイント

在庫は、差分を考慮したデータでリスティングAPIから更新します：

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

このエンドポイントは価格と在庫を同じ呼び出しで受け付けますが、Hepsiburadaの内部キャッシュによりストアフロントへの反映には 30〜90秒 かかる場合があります。一括更新には POST /listings/import を使用し、商品インポートと同じtrackingIdの仕組みで処理します。

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

本番品質の出品者は、15分間隔のcronではなく イベント駆動の同期 （ERPでの在庫変更のたびに、数秒以内にHepsiburadaへPUTを送信）を使用しています。cronのみの同期では、セール期間（ラマダンキャンペーン、ブラックフライデー、Efsane Cuma）に売り越しが発生するリスクがあります。Zunaproのハイブリッドモデルは、即時のPUTに加えて、イベントの取りこぼしに備えた15分間隔の照合を行います。これは、マスター→ローカル→ターゲットの価格・在庫自動同期アーキテクチャで紹介しているのと同じ仕組みです。

カートボックスの獲得

Hepsiburadaのカートボックス（共有商品ページでデフォルトとなる「Sepete Ekle」のオファー）は、次の要素を組み合わせた加重式で決まります：

• 価格 — 有効な最安オファーとの差が1〜2%以内で競争力があること
• 在庫の健全性 — 在庫の厚み、更新の鮮度、最近の在庫切れがないこと
• 配送の約束 — 他の条件が同じならHepsiJetが優先されます
• 出品者評価 — 配送とサービスのKPIで最低9.0以上
• 注文の不具合率 — キャンセル、出荷遅延、返品はペナルティの対象です

競合価格を5〜10分ごとに再評価するよう適切に調整された価格自動調整ツールは、競合するSKUのカートボックス獲得率を通常15〜30%向上させます。

6. HepsiJet — 自社配送網

Hepsiburadaの垂直統合型ラストマイル

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

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

HepsiJetのすべての配送ラベルには、 HJ で始まる12文字の追跡番号をエンコードしたCode-128バーコードが記載されています（例： HJ73219840TR）。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」（スピード配送）の効果とほぼ同等です。

集荷か「Ş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」 バッジが付き、カートボックスの算出式で最も高い表示の重み付けを得られます。

物流センターのネットワーク

• Gebze（コジャエリ県） — 旗艦物流センター、約150,000 m²、イスタンブールとマルマラ地方をカバー
• Çorlu（テキルダー県） — 2023年に追加、トルコ西部とバルカン諸国への越境配送に注力
• Kemalpaşa（イズミル県） — エーゲ海地方をカバー、トルコ南西部向けに2024年開設
• Ankara（Polatlı） — 中央アナトリアのハブ、首都圏への配送に最適化

料金体系

HepsiLojistikの料金は、ユニットごとのフルフィルメント手数料と月額保管料で公表されています：

• ユニットごとのフルフィルメント手数料 — 重量帯とカテゴリーに応じて通常₺25〜₺75
• 月額保管料 — 1 m³あたり月単位で請求され、回転率によって段階的に設定（ロングテール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ığı — 歳入庁） は、年間売上が基準額（現在約₺3M、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の層

請求書の処理パイプラインを流れる顧客の個人情報は、トルコの 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を取得し、必須項目に有効な列挙値を入力する
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の形式が無効、または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. Hepsiburadaの手数料 2026年 — 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

VAT（KDV）税率 2026年

トルコの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との整合に向けて強化された、個人データの処理を規制する法律です。マーケットプレイス出品者は注文側の個人情報（氏名、住所、電話番号、該当する場合は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の対象外となる東アナトリアの郵便番号に強い
• Aras Kargo — 競争力のあるB2BのSLAで、家具や大型商品で人気
• DHL Kargo — 一部の路線で柔軟な当日配送枠
• PTT Kargo — 国営郵便事業者、地方へのリーチがあるがSLAは遅め
• UPS Türkiye / DHL — 国際越境配送ルート

Zunaproでの振り分けロジック

Zunaproの物流ルーターは、重量、配送先の郵便番号、申告価格、SKUクラスなどの設定可能なマトリクスですべての注文を評価し、デフォルトでHepsiJetを選択します。対象外の郵便番号ではYurtiçiに、30 kgを超える荷物ではArasに切り替えます。選択された配送業者は同じHepsiburadaのパッケージエンドポイントで送信されるため、顧客には一貫した追跡体験が提供されます。

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

5ステップで販売開始

1. ETBİSとHMSに登録する — etbis.ticaret.gov.trでETBİSの登録を行い、その後merchant.hepsiburada.comでvergi numarası、IBAN、署名証明書を提出してオンボーディングします。KYCは1〜3営業日で完了します。
2. API認証情報を生成する — Hesabım → Entegrasyon Bilgileri → API Anahtarı。ユーザー名とパスワードを保管庫に保存し、User-Agentヘッダー用にMerchant IDを控えておきます。
3. e-Faturaを接続する — GİB連携事業者（Logo、Mikro、Foriba、izibiz）を選び、Hepsiburadaの請求書アップロードエンドポイントに到達できることを確認します。B2Cの注文1件でテストします。
4. 物流体制を選ぶ — HepsiJetの集荷かŞubeye Bırakかを選び、対象外の郵便番号向けにYurtiçi/Arasのバックアップも用意します。ラベルと梱包資材を事前に準備しておきます。
5. Zunaproで接続する（10分） — Hepsiburadaのタイルに API認証情報を貼り付け、マスターカタログをマッピングし、HepsiJetのラベル自動発行とe-Faturaを有効にして、販売を開始します。

Zunaproでの接続の流れ

1. Zunaproにログイン してトルコモジュールを開きます
2. 「Hepsiburadaを接続」をクリック — APIのユーザー名、パスワード、Merchant IDを貼り付けます
3. カテゴリーの自動マッピング — Zunaproの機械学習がすべてのマスターSKUについて最下層カテゴリーのマッピングを提案するので、数回のクリックで確認します
4. HepsiJetのラベル自動発行とe-Faturaを有効化 — それぞれワンタッチで切り替えられます
5. 販売開始 — 1,000 SKUのカタログなら初回のリスティング同期は約10分で完了し、Webhookは自動で登録されます

Hepsiburada連携のよくある質問 2026年