Hepsiburada API と Odoo の統合: 完全なセットアップ ガイド

トルコの e コマース環境には 2 つの主要なプラットフォームがあり、Hepsiburada は真剣な販売者が必ずマスターしなければならないプラットフォームです。 2000 年に設立された Hepsiburada は、トルコで最も古く、最も信頼されているオンライン マーケットプレイスの 1 つであり、月間訪問者数は 1 億人を超え、販売者は 65,000 人を超え、製品カタログはエレクトロニクスやファッションから自動車部品や工業用品に至るまで、あらゆる消費者カテゴリーに及びます。 Odoo ERP で業務を実行している販売者にとって、堅牢な API を介して Hepsiburada と統合することは、トルコ市場で効率的かつスケーラブルな販売への道となります。

重要なポイント

• ヘプシブラダは月間 1 億人以上の訪問者があり、トルコで最も訪問者の多い市場です
• このプラットフォームは 5,000 万件以上の商品リストを持つ 65,000 人以上の販売者をホストしています
• ヘプシブラダは 2021 年にナスダックに上場し、機関レベルの市場インフラを実証しました
• HepsiBurada API (HBAPI) は、製品、注文、在庫、請求の包括的な統合エンドポイントを提供します
• ECOSIRE のコネクタは、トルコ語のローカリゼーション、KDV 税コンプライアンス、および複数の貨物の統合を処理します
• API を統合した販売者は、注文処理を 40% 高速化し、在庫エラーを 90% 削減します。

---

ヘプシブラダが重要な理由

トレンディオールはファッションと毎日の注文量でリードしていますが、ヘプシブラダはエレクトロニクス、電化製品、自動車、産業分野で明確な優位性を持っています。 25 年間の運用を通じて構築された消費者の信頼に関するプラットフォームの評判により、Trendyol の視聴者と重複するものの異なる忠実な顧客ベースが得られます。成功しているトルコの e コマース販売者のほとんどは両方のプラットフォームで運営しているため、Trendyol と Hepsiburada の統合が標準要件となっています。

ヘプシブラダ統計 (2025-2026)

ヘプシブラダの競争上の地位

ヘプシブラダは以下の点で差別化されています。

• 信頼: 25 年間の運営により、特に高額商品の購入において消費者から深い信頼を築いてきました。
• エレクトロニクスの強み: 家庭用電化製品、コンピューティング、モバイル デバイスでトップの市場シェア
• HepsiJet 物流: 主要都市での同日配送を実現する社内物流ネットワーク
• HepsiPay: 分割払いオプションを備えた統合支払いシステム (トルコの分割払い主導の市場では不可欠)
• 法人販売: 企業購買向けの B2B マーケットプレイス セグメント
• Hepsiglobal: 国際市場に到達する国境を越えた販売プログラム

---

ヘプシブラダ API (HBAPI) の詳細

Hepsiburada は、包括的な販売者の統合を可能にする、適切に構造化された REST API を提供します。 API ドキュメントは (一部のトルコ語プラットフォーム API とは異なり) 英語で提供されているため、国際的な開発チームがアクセスできます。

API アーキテクチャ

HBAPI はサービス ドメインに編成されています。

リスティングサービス

• 完全な属性セットを含む製品リストを作成します
• バリエーションの管理 (色、サイズ、モデル、容量)
• 画像のアップロードと注文を処理します
• Hepsiburada のカテゴリ分類へのマップ
• 出品ステータスの管理 (アクティブ、パッシブ、ロック)
• バーコード (GTIN/EAN) 要件の処理

注文サービス

• 新しい注文の取得 (梱包可能な注文)
• 注文の詳細（品目、数量、住所）にアクセスします
• 注文明細ステータスの更新 (ピッキング、請求書発行、出荷済み)
• 荷物を作成し、貨物会社を割り当てます
• 部分的なフルフィルメントの処理 (利用可能なアイテムを最初に発送)

在庫サービス

• 倉庫ごとのリストごとの在庫数量を更新します
• 可用性ステータスの設定
• 複数の倉庫の在庫割り当てを処理します

クレームサービス

• 購入者のクレームを処理する (商品違い、破損、紛失)
• 証拠を添えて請求回答を提出する
• 保険金請求の結果と財務上の影響を追跡する

金融サービス

• 決済レポートへのアクセス
• コミッションの内訳を表示
• ペナルティと調整控除を追跡する
• 請求書と財務書類のダウンロード

認証

HBAPI は、Hepsiburada マーチャント パネルを通じて提供されるマーチャント ID、ユーザー名、およびパスワードによる HTTP 基本認証を使用します。一部のエンドポイントでは、セキュリティのために追加の IP ホワイトリストが必要です。

レート制限とベストプラクティス

• 標準レート制限: エンドポイントあたり 1 分あたり 100 リクエスト
• 在庫更新: バッチ操作を推奨 (リクエストあたり最大 100 SKU)
• 注文ポーリング: 10 分ごとを推奨
• 商品作成: ピーク時は 1 時間あたりの新規出品数が 500 件に制限されます

---

統合アーキテクチャ

注文処理パイプライン

Hepsiburada の注文ライフサイクルは他のマーケットプレイスとは若干異なります。注文は特定のステートマシンを通過します。

New → Picking → Invoiced → Packaged → Shipped → Delivered
  ↓        ↓         ↓          ↓
Cancel  Re-stock  [Skip if    Tracking
                   digital]    Push

統合では、このステート マシンを尊重する必要があります。状態をスキップしたり、順序を外して更新すると、API エラーが発生し、注文処理が失敗する可能性があります。

コンポーネント 1: 製品リストの統合

Hepsiburada でリスティングを作成および管理するには、プラットフォーム固有の要件に注意する必要があります。

• カテゴリ属性: 各カテゴリには必須の属性とオプションの属性があります。電子機器にはブランド、モデル、技術仕様、保証期間が必要です。ファッションにはサイズチャート、素材、お手入れ方法が必要です
• バーコード要件: すべての物理的な製品には有効な GTIN/EAN バーコードが必要です。統合では、送信前にバーコード形式を検証する必要があります
• 画像要件: 最小 500x500 ピクセル、メイン画像の背景は白、リストごとに最大 8 つの画像
• ブランド認証: 製品を掲載するには、ブランドが Hepsiburada で承認される必要があります。統合では、リスティングの作成を試行する前にブランドの承認ステータスを確認する必要があります
• コンテンツ言語: 国内市場では、すべての出品コンテンツはトルコ語である必要があります

コネクタは、Odoo 製品データを Hepsiburada のリスト形式にマッピングし、必須属性を検証し、画像形式の変換を処理します。

コンポーネント 2: 注文のインポートと状態管理

コネクタは、新しいパッカブル注文について HBAPI をポーリングし、以下を使用して Odoo 販売注文を作成します。

• 完全な製品とバリアントのマッピング
• お客様の配送先住所
• 状態更新追跡のための注文レベルおよび明細レベルの ID
• 支払い方法に関する情報
• 配信 SLA 要件

状態の更新は、Hepsiburada に必要なシーケンスに従います。

1. ピッキング: 注文の受領を確認し、倉庫処理を開始します
2. 請求書発行済み: 請求書を生成して登録します (梱包前に必要)
3. 梱包済み: 寸法、重量、指定された貨物会社を指定してパッケージを作成します。
4. 出荷済み: 貨物追跡番号をプッシュします。

各状態遷移は適切なデータを使用して HBAPI を呼び出し、コネクタは一時的なエラーの再試行を処理します。

コンポーネント 3: 在庫管理

在庫状況は、バッチ API 呼び出しを介して Odoo から Hepsiburada にプッシュされます。

• SKU ごとの在庫数量は 15 ～ 30 分ごとに更新されます
• マルチチャネル販売者に適用される安全バッファ
• 在庫ゼロのアイテムはヘプシブラダで自動的に無効化されます
• 在庫の復元により自動再アクティブ化がトリガーされます

ヘプシブラダの在庫を他の販売チャネルと調整するには、リアルタイム在庫同期ガイド で説明されている集中アプローチが必要です。

コンポーネント 4: 貨物と物流

Hepsiburada は複数の貨物オプションをサポートしています。

• HepsiJet: ヘプシブラーダ独自の物流ネットワーク (主要都市での同日配送)
• Yurtic Kargo: トルコ最大の貨物運送会社
• Aras Kargo: 競争力のある価格で全国をカバー
• MNG Kargo: 法人向けおよび大型商品の配送に強い
• Surat Kargo: 標準配送の予算に優しいオプション
• UPS Turkey: 国際配送およびプレミアム配送の場合

このコネクタは Odoo の配送モジュールと統合されており、設定可能なルール (製品カテゴリ、目的地、重量、緊急度) に基づいて適切な配送業者を割り当て、追跡情報を Hepsiburada にプッシュします。

コンポーネント 5: クレームとアフターセールス

Hepsiburada の請求システムは購入者の紛争を処理します。

• 間違った商品: 購入者は注文したものとは異なる商品を受け取りました
• 破損: 到着した製品は破損していました
• 欠品品: 注文の配達が完了していません
• 品質: 製品はリストの説明と一致しません

このコネクタは、クレームを Odoo のヘルプデスク モジュールにインポートし、カスタマー サービス チームが証拠を確認し、回答を送信し、結果を追跡できるようにします。これらすべてを Odoo 内から行うことができます。クレーム解決の品質は販売者のスコアに影響を与えるため、効率的な対応が重要になります。

コンポーネント 6: 財務決済

隔週決済には次のものが含まれます。

• 注文明細ごとの総売上収益
• カテゴリ固有の手数料 (6-18%)
• HepsiJet物流手数料
• サービス料金（出品、取引）
• 違約金控除（発送遅延、キャンセル、損害賠償請求）
• プロモーションへの貢献

コネクタは各決済コンポーネントの詳細な仕訳を作成し、Odoo で製品ごとおよびカテゴリごとの正確な収益性分析を可能にします。

---

セットアップガイド

ステップ 1: Hepsiburada マーチャント アカウント

1.ヘプシブラダマーチャントパネルに登録する 2. 本人確認と納税確認を完了する 3. API アクセスをリクエストし、認証情報 (販売者 ID、ユーザー名、パスワード) を受け取ります。 4. API アクセス用の IP ホワイトリストを送信する 5. 製品ブランドのブランド承認をリクエストする

ステップ 2: Odoo の構成

1. トルコ語ローカライズ: トルコ固有の会計、税金、および文書モジュールをインストールします。
2. 通貨: 為替レートの自動更新を使用して TRY を構成します
3. KDV (VAT) 設定: 製品カテゴリごとに税率 (1%、10%、20%) を設定します。
4. 販売チャネル: 「ヘプシブラーダ」販売チームの作成
5. 顧客: 「Hepsiburada Marketplace」顧客レコードを作成します
6. 運送業者: Odoo 配送モジュールで HepsiJet と承認された貨物会社を構成します
7. アカウント: 手数料、物流費、違約金の経費アカウントを作成します。

ステップ 3: ECOSIRE コネクタをインストールする

ECOSIRE Hepsiburada コネクタ をデプロイします。

1. Odoo アプリを通じてインストールする
2. [設定] > [ヘプシブラダ統合] に移動します。
3. 販売者 ID、API ユーザー名、パスワードを入力します
4. 必要に応じて IP ホワイトリストを構成します
5. 同期間隔を設定します。

• 注文: 10分ごと
• インベントリ: 15分ごと
• 製品: 4 時間ごとまたは手動

6. 製品カテゴリーを Hepsiburada の分類法にマッピングする

ステップ 4: 製品リストの構成

1. Odoo 製品を必須の属性を持つ Hepsiburada カテゴリにマッピングする
2. すべての製品の GTIN/EAN バーコードを確認する
3. トルコ語の製品コンテンツを準備する
4. 準拠した製品画像をアップロードする
5. 手数料を考慮したマージンで TRY 価格を設定する
6. 初期カタログとモニターリストの承認を同期する

ステップ 5: 注文ワークフローの設定

1. 注文のインポートと状態管理を構成する 2.ヘプシブラダの注文に対する倉庫割り当てルールを設定する
2. 請求書の生成を構成します (Hepsiburada フローでパッケージ化する前に必要)
3. 貨物の割り当てルールを設定する
4. エンドツーエンドの注文処理をテストする

ステップ 6: 財務上の設定

1. 製品カテゴリごとの手数料率をマップする 2.決済インポートスケジュールの設定
2. 料金別の経費アカウントを設定する
3. 軽微な差異に対する調整許容値を定義する

---

ヘプシブラダ特有の課題

課題 1: 梱包前請求書の要件

Hepsiburada では、販売者は発送パッケージを作成する前に請求書を作成する必要があります。この手順は、請求書発行が発送後または発送と同時に行われるほとんどのマーケットプレイスとは異なります。

解決策: コネクタは Odoo の請求書生成ステップを自動化し、ピッキングが確認されるとすぐに請求書を作成して登録します。これにより、正しい状態シーケンス (ピッキング > 請求書発行 > 梱包済み > 出荷済み) が常に従うようになります。

課題 2: 分割払いの文化

トルコには強力な分割払い文化があり、消費者は購入代金を 3 か月、6 か月、9 か月、または 12 か月の分割払いで支払うことがよくあります。 Hepsiburada と HepsiPay は消費者の分割払い関係を管理しますが、売り手は通常の決済条件に従って全額の支払い (手数料を差し引いた) を受け取ります。

解決策: コネクタは、消費者の分割払いプランに関係なく、Odoo に支払い総額を正しく記録します。分割払いの構造は情報提供を目的として記録されていますが、売り手の会計処理には影響しません。

課題 3: ヘプシグローバルの国境を越えた複雑さ

Hepsiburada の Hepsiglobal プログラムは、国境を越えた販売を可能にし、複数通貨の価格設定、国際輸送物流、税関書類要件の導入を可能にします。

解決策: このコネクタは、ターゲット市場ごとに個別の価格設定、国際通信事業者の統合、Odoo を介した税関書類の生成により Hepsiglobal をサポートします。

課題 4: エレクトロニクス分野の激しい競争

エレクトロニクスはヘプシブラーダの最も強いカテゴリーですが、最も競争が激しいカテゴリーでもあります。価格に対する敏感度は非常に高く、Buy Box の競争ではリアルタイムの価格設定への対応力が求められます。

解決策: コネクタは、競争上の地位とマージンの下限に基づいて調整される価格設定ルールをサポートしています。競争の激しいカテゴリでは、収益性のガードレールを維持しながら、価格更新をより頻繁に行うことができます。

課題 5: 季節的な需要の急増

トルコの e コマースでは、11.11 (独身の日)、ブラック フライデー、ラマダン前のショッピング期間中に需要が大幅に急増します。これらのイベント中は注文量が 3 ～ 5 倍に増加する可能性があります。

解決策: このコネクタは、同期周波数の増加、より大きな安全バッファ、および自動容量アラートを備えたピークモード構成をサポートしています。イベント前のチェックリストにより、需要が急増する前に在庫、価格設定、フルフィルメント能力が確実に準備されるようになります。

---

手動コネクタと ECOSIRE コネクタ

---

デュアルプラットフォーム戦略: ヘプシブラーダ + トレンディオール

成功しているトルコの e コマース販売者のほとんどは、ヘプシブラダとトレンディオールの両方を同時に運営しています。 2 つのプラットフォームには異なる長所があります。

• ヘプシブラダ: エレクトロニクス、家電製品、B2B に強い。高齢者、高所得層
• Trendyol: ファッション、美容、食料品に強い。若年層のモバイルファースト層

Odoo から両方を実行するには、次のものが必要です。

1. 統合在庫: 安全バッファーを備えた両方のプラットフォームに割り当てられた単一の在庫プール
2. プラットフォーム固有の価格設定: プラットフォームごとに異なる手数料率と競争力学
3. 個別のパフォーマンス追跡: 各プラットフォームには独自の販売者スコア アルゴリズムがあります。
4. 連結レポート: クロスプラットフォームの収益、マージン、パフォーマンスの比較

ECOSIRE コネクタはマルチプラットフォーム Odoo 構成をサポートしており、マルチマーケットプレイス管理ガイド では運用戦略について詳しく説明しています。

---

ECOSIRE 統合サービス

ECOSIRE の Odoo 統合サービス は、Hepsiburada 販売者に完全なサポートを提供します。

• エンドツーエンドのコネクタの展開と構成
• トルコ語ローカリゼーション (KDV、会計、電子請求書)
• カスタムフルフィルメントワークフロー設計
• 貨物運送業者の統合と最適化
• デュアルプラットフォームセットアップ (1 つの Odoo からの Hepsiburada + Trendyol)
• スタッフのトレーニングと継続的なサポート

利用可能なすべての統合については、ECOSIRE のマーケットプレイス コネクタ カタログ を参照してください。

---

よくある質問

コネクタは HepsiJet や他のトルコの貨物会社をサポートしていますか?

はい。このコネクタは、HepsiJet、Yurtic Kargo、Aras Kargo、MNG Kargo、Surat Kargo、UPS Turkey と統合されます。運送業者の割り当てはルールベースで (製品カテゴリ、重量、目的地、緊急度のルールを構成します)、追跡番号は Odoo の配送モジュールから自動的に Hepsiburada にプッシュされます。

トルコ税 (KDV) はどのように処理されますか?

コネクタは、Hepsiburada 製品カテゴリを正しい KDV 率 (1%、10%、または 20%) にマッピングします。 Odoo で生成された請求書には適切な税金計算が記載されており、決済調整により税額が Hepsiburada の記録と照合して検証されます。規制遵守のために、トルコの電子請求書 (e-Fatura) 形式がサポートされています。

注文状態の更新中に API 呼び出しが失敗した場合はどうなりますか?

コネクタは、一時的な API エラーに対する指数バックオフを備えた再試行ロジックを実装します。再試行後に状態の更新が失敗した場合、手動で対応するために Odoo で注文にフラグが立てられ、設定された運用連絡先にアラートが送信されます。システムは API の信頼性メトリクスを追跡して、システムの問題を特定します。

どの Odoo バージョンがサポートされていますか?

ECOSIRE Hepsiburada コネクタは、Odoo 17、18、および 19 (Community および Enterprise エディション) をサポートします。トルコ語ローカリゼーション機能はモジュールにバンドルされています。

---

結論

ヘプシブラダは、大量のトラフィック、25 年にわたって築き上げた消費者の信頼、高価値カテゴリーでの強力な地位を兼ね備えており、トルコ市場をターゲットとする販売者にとって不可欠な販売チャネルとなっています。プラットフォームの構造化 API は自動化のための強固な基盤を提供しますが、統合では Hepsiburada 固有の要件を尊重する必要があります。つまり、注文ステート マシン、荷物前請求ワークフロー、貨物統合、およびクレーム処理はすべてプラットフォーム固有のニュアンスを持っています。

Hepsiburada と Odoo の適切な統合に投資する販売者は、複合的な利点を獲得します。注文処理の高速化により販売者のスコアが向上し、可視性が高まり、より多くの注文が促進されます。これは業務効率による好循環です。手動プロセスに依存している企業はその逆に気づきます。処理が遅いと、スコアの低下、可視性の低下、売上の減少につながります。

進むべき道は明らかです。初めて Hepsiburada のプレゼンスを確立する場合でも、既存の事業を拡張する場合でも、ECOSIRE の専用コネクタ を介してプラットフォームを Odoo ERP に接続すると、成長を制限し利益を損なう運用上の摩擦が排除されます。