Trendyol 連携ガイド 2026：REST API・XML 接続・一元的なストア管理

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

Trendyol の Marketplace API は、単一の本番ベースURL——https://api.trendyol.com——上で公開されるRESTful、JSON-over-HTTPSインターフェースで、https://stageapi.trendyol.com に別途のステージ環境があります。すべてのAPI呼び出しは HTTP Basic認証 で認証されます：Authorization ヘッダーにbase64エンコードされた ApiKey:ApiSecret のペアを載せ、Supplier IDはサプライヤースコープの各エンドポイントでパスパラメータとして渡されます。ファーストパーティのセラーには別途のアクセストークンのラウンドトリップはなく——Basic認証がすべてのリクエストでチェックされます——連携はシンプルに保たれますが、漏洩した認証情報はパートナーパネルから即座にローテーションする必要があることを意味します。

ベースURL、認証、ヘッダー

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products
Authorization: Basic BASE64(ApiKey:ApiSecret)
User-Agent: {supplierId} - SelfIntegration
Content-Type: application/json
Accept: application/json

User-Agent ヘッダーは飾りではありません：Trendyolのトラフィックシェーピングとレート制限の集計はこれをキーとします。インテグレーター（Zunaproなど）は {supplierId} - Zunapro を送信し、ファーストパーティのセラーは {supplierId} - SelfIntegration を送信します。誤ってスタンプされた User-Agent ヘッダーは、有効な認証情報があっても401/403レスポンスを引き起こすことがあります。

レート制限とクォータ

Trendyolはエンドポイントごと、サプライヤーごとにレート制限を課します。公開されている2026年の上限は次のとおりです：

• 商品エンドポイント — Supplier IDごとに通常毎分60リクエスト、30秒間は最大90/分までのバースト許容
• 注文エンドポイント — 通常毎分600リクエスト（注文は設計上、高トラフィック・低レイテンシのエンドポイント）
• 価格・在庫更新エンドポイント — 通常毎分100リクエストで、各リクエストが1バッチで最大1,000 SKUを運びます
• カテゴリー・属性ルックアップ — 通常毎分30リクエスト（変化が遅いため、積極的なキャッシュが想定されています）

すべてのレスポンスに X-RateLimit-Limit、X-RateLimit-Remaining、そして429時には Retry-After ヘッダーが含まれます。よく作り込まれた連携はSupplier IDごとにトークンバケットキューを用い、429時には指数バックオフでバックプレッシャーをかけます。Zunaproはこれをデフォルトで実装しているため、数千SKUの一括プッシュでも制限に触れることはありません。

独立系インテグレーター向けの OAuth 2.0

独立系の中間レイヤーインテグレーター（Zunaproや、多数のサプライヤーの代理として動作する類似のSaaSプラットフォーム）向けに、Trendyolは直接のBasic認証ではなく OAuth 2.0認可コードフロー を提供します。インテグレーターはTrendyolのデベロッパーリレーションズチームに client_id / client_secret を登録し、サプライヤーはパートナーパネルからインテグレーターを認可し、インテグレーターは有効期限1時間のアクセストークンと再発行用のリフレッシュトークンを受け取ります。これによりサプライヤーの生のApiKey / ApiSecretを扱うことを回避でき、多数のTrendyolストアを管理する企業顧客にとって監査に適した道です。

Webhook

Trendyol は注文ライフサイクルイベントを登録済みのWebhook URLにプッシュします：Created、Picking、Invoiced、Shipped、Delivered、Cancelled、Returned、UnDelivered。Webhookのペイロードは注文IDと新しいステータスを運ぶJSONエンベロープで、あなたのエンドポイントは3秒以内にHTTP 200で応答しなければなりません。失敗するとTrendyolは指数バックオフで5回リトライした後、イベントを保留します——これが /sapigw/suppliers/{id}/orders に対する5分ごとの照合プルが必須の安全網である理由です。

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

2026年にTrendyolのREST APIに接続する公式のハッピーパスは短く、よく文書化されています——ただし、一部の法的前提条件はAPI自体の上流にあるため、操作の順序が重要です。

2.1 Trendyol セラーアカウントを開設する

partner.trendyol.com にアクセスし、「Trendyolアカウントを開設」申請を提出します。以下が必要です：

• VKN (Vergi Kimlik Numarası) — トルコの税番号（またはTrendyol International向けの外国相当の事業登録）
• 有限責任会社または株式会社向けの商業登記官報（Ticaret Sicil Gazetesi）
• 署名回覧文書（imza sirküleri）
• ETBİS (Elektronik Ticaret Bilgi Sistemi) 登録受領書 — 2018年以降、すべてのトルコのeコマース事業者に必須
• マーケットプレイスの支払い用の、法人名義の銀行口座（IBAN TR）

承認には通常2～5営業日かかります。承認されると、セラーは Supplier ID とTrendyolパートナーパネルへのアクセス権を受け取ります。

2.2 API Key と Secret を生成する

パートナーパネルから アカウント設定 → 連携情報 を開き、「API Keyを作成」をクリックします。Trendyolは 40文字のAPI Key と 40文字のAPI Secret を生成します。両方の値は一度だけ表示され——後から取得することはできません。パスワードマネージャーに保存するか、より良い方法として、Zunaproの連携タイルに直接貼り付けてください。そこではAES-256暗号化されマスクされたシークレットとして保存されます。

2.3 最初のスモークテストリクエスト

サプライヤー情報エンドポイントにアクセスして、認証情報が有効であることを確認します：

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \
  -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \
  -H "User-Agent: {supplierId} - SelfIntegration" \
  -H "Accept: application/json"

成功したレスポンスは、サプライヤーの登録済み倉庫および返品先住所をJSONで返します。401はBasic認証ヘッダーが誤っていること、403はSupplier IDが認証情報と一致しないこと、404はエンドポイントパスが不正であることを意味します。

2.4 OAuth バリアント（マルチサプライヤーインテグレーター向け）

独立系インテグレーター向けには、OAuth 2.0フローは次のようになります：

1. インテグレーターがサプライヤーを次へリダイレクト：
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. サプライヤーがアクセスを承認；Trendyolが ?code={authCode} を付けてリダイレクトで戻す

3. インテグレーターがcodeをトークンに交換：
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. レスポンス：{ access_token, refresh_token, expires_in: 3600 }

アクセストークンは1時間有効で、30日間更新可能です。Zunaproは4つすべてのステップを透過的に処理するため、サプライヤーは単一の「Trendyolに接続」ボタンだけを見ることになります。

2.5 最初の商品を投稿する

POST /sapigw/suppliers/{supplierId}/v2/products をアイテムのJSON配列とともに使用します。最小の商品オブジェクトには、barcode、title、productMainId、brandId、categoryId、quantity、stockCode、dimensionalWeight、description、currencyType（通常は TRY）、listPrice、salePrice、vatRate、cargoCompanyId、images 配列（1～8個のURL）、そしてカテゴリー固有の属性IDの attributes 配列が必要です。

3. スケールでの商品同期

一括アップロード — バッチあたり1,000 SKU

Trendyolの POST /v2/products エンドポイントは、単一のJSONリクエストで 最大1,000 SKU を受け付けます。10,000以上のSKUカタログを持つセラーにとって、これは1時間のオンボーディングと数日のオンボーディングの違いになります。バッチは呼び出しごとに batchRequestId を返します。Trendyolは各バッチを非同期に処理し、処理完了後にSKUごとの成功／失敗を公開します（検証キューの深さにより通常1～15分以内）。

カテゴリーマッピング — 唯一にして最も難しいステップ

Trendyolのカテゴリーツリーは深く厳格です。2026年時点でおよそ 12,000のリーフカテゴリー があり、それぞれに独自の必須・任意の属性セットがあります。「メンズ → パンツ → カジュアル」の下に掲載されたジーンズには gender、size、color、material、fit-type 属性が必要で、「エレクトロニクス → モバイル → 電話」の下のスマートフォンには brand、model、memory、guaranteeType、warrantyPeriod が必要です。誤ったリーフカテゴリーに、あるいは正しいカテゴリーでも必須属性が欠けたまま商品を投稿すると、バッチ結果でサイレントな拒否が発生します。

サポートされているアプローチは次のとおりです：

1. GET /sapigw/product-categories からライブのカテゴリーツリーをプルする（24時間キャッシュ）
2. 各リーフカテゴリーについて、GET /sapigw/product-categories/{categoryId}/attributes から必須 + 任意の属性をプルする
3. マスターカタログのSKUをTrendyolのリーフカテゴリーにマッチさせる——Zunaproは数百万件の過去のTrendyol出品でトレーニングされたMLマッパーを使用し、タイトル + ブランド + あなたの分類体系からカテゴリーを提案し、初回一致率は92%以上です
4. POSTエンドポイントにアクセスする前に、必須属性に対してすべてのSKUを検証し、失敗が確実なリクエストでレート制限を浪費しないようにする

ブランドホワイトリストと brandId

すべての商品は、Trendyolのブランドレジストリに存在する brandId を参照しなければなりません。新しいブランドはその場で作成できず——パートナーパネル経由の手動ブランド承認プロセス（通常1～3営業日）を経ます。商品を作成する前に、GET /sapigw/brands?name={brandName} を使って既存のbrandIdを検索してください。

画像アップロードのルール

• 商品あたり1～8枚の画像
• 公開のHTTPS URL（Trendyolが画像をクロールし、自社CDNで再ホストします）
• ファッションカテゴリーは最低 1200×1800 px、白背景
• JPGまたはPNG、画像あたり最大約10 MB
• 最初の画像が検索結果のサムネイルになります——ここに投資してください

バッチステータスのポーリング

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}

Response:
{
  "batchRequestId": "abc-def-...",
  "status": "COMPLETED",
  "itemCount": 1000,
  "items": [
    { "requestItem": {...}, "status": "SUCCESS" },
    { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] }
  ]
}

4. 注文管理 — Webhook とステータスフロー

2026年の注文ライフサイクル

Trendyolの注文は固定のステータスフローを進みます：

Created → Picking → Invoiced → Shipped → Delivered

分岐フロー：
  Cancelled（Shipped 前のいつでも）
  Returned（Delivered 後、14日間の期間内）
  UnDelivered（配送業者の例外）

各遷移はWebhookイベント（プッシュ）を発火させると同時に、次の GET /orders プル（ポーリング）にも反映されます。セラーは Picking → Invoiced → Shipped の遷移に責任を持ち、Trendyolの物流パートナーが Shipped → Delivered を制御します。

Webhook の受信と冪等性

すべてのWebhookは一意の shipmentPackageId を運びます。これを冪等に処理してください——Trendyolは非200レスポンスでイベントをリトライしますし、あなた側での重複処理（二重請求、二重ピッキング）は現実的なリスクです。実用的なパターンは次のとおりです：

POST /webhook/trendyol
{
  "supplierId": 123456,
  "shipmentPackageId": 987654321,
  "status": "Picking",
  "timestamp": 1717930000000
}

ハンドラー：
1. shipmentPackageId にロックを取得
2. 保存済みステータスを確認；すでに >= "Picking" なら 200 を返す（no-op）
3. 新しいステータスを永続化し、下流アクション（電子請求書、ピッキングタスク）をスケジュール
4. 3秒以内に HTTP 200 を返す

キャンセルと返金のフロー

買い手が開始したキャンセルは Cancelled Webhookとして到着し、セラーが開始したキャンセルはキャンセル理由コード（OUT_OF_STOCK、OTHER など）を付けて POST /sapigw/suppliers/{id}/orders/{orderId}/cancel でプッシュされます。配達済み + 返品済みアイテムの返金はTrendyolが自動的に処理します。セラーの唯一の義務は、配送業者のスキャンから48時間以内に返品品の受領を確認することです。

Trendyol Express の配送ラベル

パッケージが Picking ステータスに移されたら、GET /sapigw/suppliers/{id}/orders/{orderId}/labels で配送ラベルをリクエストします——TrendyolはTrendyol Expressのバーコード、買い手の住所、貨物追跡番号を含むPDF（およびオプションでサーマルプリンター用のZPL）を返します。バーコードは唯一の配送業者ルーティングの成果物です——印刷し、貼付し、WMSにスキャンし、Trendyol Expressの集荷ポイントに預ける（または大量販売のセラーは配送業者の集荷を予約する）。

5. リアルタイムの在庫・価格更新

在庫・価格プッシュのパターン

Trendyolは在庫と価格の更新に専用のエンドポイントを公開しています：POST /sapigw/suppliers/{id}/products/price-and-inventory。各呼び出しは最大1,000アイテムを受け付け、アイテムごとに barcode、quantity、salePrice、任意の listPrice を持ちます。更新は在庫については数秒以内、価格については2～5分以内に適用されます（Trendyolはショッピングフィードの一貫性のために価格をキャッシュします）。

POST /sapigw/suppliers/{id}/products/price-and-inventory
{
  "items": [
    { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 },
    { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 }
  ]
}

Master → Local → Targets 同期アーキテクチャ

複数の販売チャネル（Trendyol + Hepsiburada + Çiçeksepeti + 自社ショップ）を運営するセラーにとって、唯一まともなアーキテクチャは、Zunapro内のマスター在庫がすべてのターゲットマーケットプレイスへプッシュする方式です。2026年のZunapro本番スタックは、15分ごとのcronにイベント駆動プッシュを加えて動作します：マスターでの在庫変更はいずれもTrendyolへの即時のprice-and-inventoryプッシュを発火させ、一方cronは漏れたプッシュに対する結果整合性を保証します。SKUはバーコード（主）またはstockCode（フォールバック）でマッチされます——カテゴリーの再マッピングで変わり得るTrendyolの内部商品IDでマッチさせることは決してありません。

VAT と価格表示のルール

Trendyolの価格は VAT込み です。トルコの2026年VAT（KDV）制度は 標準20%、軽減10%（食品、書籍、医薬品、基本財）、特別1%（必需食料品、特定の農産物）です。セラーは商品ごとに vatRate を指定し、正しい税率を選ぶ責任があります。誤りは事後にGİBによる電子請求書の拒否として表面化し、その是正は高くつきます。

Trendyol Fast Sale とキャンペーン同期

Trendyolの旗艦キャンペーン——Trendyol Fast Sale（Hızlı Satış）、Trendyol Week、Çarşamba Pazarı（水曜マーケット）——は資格必須のキャンペーンで、出品の可視性を高めますが、追加で1～3%のキャンペーン手数料がかかります。セラーは割引価格のオーバーライドとともに POST /sapigw/suppliers/{id}/products/campaigns でSKUをキャンペーンにオプトインします。Zunaproはあなたのマスター利益率ルールに対してキャンペーンの価格下限を自動検証し、原価割れのコミットメントを防ぎます。

6. XML / CSV の代替手段 — いつ使うべきか（そしていつ使わないべきか）

XML プルモデル

Trendyol は REST POST フローの代替として XMLフィードモデル をサポートしています。セラーは公開のHTTPS URLにカタログを記述したXMLファイルをホストし、Trendyolが設定可能な間隔（通常1～4時間ごと）でプルします。XMLスキーマはパートナーパネルで公開されており、RESTエンドポイントの商品オブジェクトの形状——barcode、title、brandId、categoryId、attributes、images、price、stock——をミラーします。

ERPがXMLよりもCSVを自然にエクスポートするセラー向けには、同じパターンがCSV（SKUごとに1行）でもサポートされています。

比較：REST API と XML / CSV

XML / CSV が実際に正しい選択となる場合

• すでに毎晩XML / CSVをエクスポートしている、HTTPクライアント機能を持たないレガシーERP
• 変化の少ないカタログ（500 SKU未満、週次の価格変更、月次のカタログ追加）
• 別のマーケットプレイスからの初期移行で、一発のCSVエクスポートが初回同期を加速する場合

それ以外のすべて——注文Webhook、リアルタイム在庫、キャンペーンのオプトイン、マルチチャネル同期——については、RESTが2026年で唯一の実行可能な道です。Zunaproは両方のモードをサポートしますが、デフォルトはRESTであり、XML / CSVはレガシーERPからのETL取り込みソースとして厳密に使用します。

7. Trendyol Express と FBA Trendyol

Trendyol Express — 物流レイヤー

Trendyol Express はTrendyolの完全子会社の物流部門です——2018年に立ち上げられ、現在ではトルコで最も密度の高いeコマースネイティブの小包ネットワークを運営しています。2026年までに、自社配達車両とともに 50,000以上のセルフサービスロッカーと集荷ポイント をカバーし、81県に到達し、イスタンブール、アンカラ、イズミル、ブルサ、アンタルヤで当日配送、トルコ本土の残りの地域には翌日配送を実現しています。買い手は対象出品に「Hızlı Teslimat」（高速配送）バッジを目にし、Trendyolの検索ランキングはこれを積極的に重み付けします。

FBA Trendyol — Trendyol 物流倉庫

FBA Trendyol（「Trendyol Lojistik Deposu」または「Trendyol Mağaza Plus」と呼ばれることもあります）はAmazon-FBAに相当するものです：セラーは Çorlu（旗艦施設、イスタンブール近郊の25万m²）、Sancaktepe、Ankara にあるTrendyolのフルフィルメントセンターに在庫を送り、Trendyolが保管、ピッキング、梱包、Trendyol Expressによるラストマイル配送、返品を処理します。FBA出品は独自の「Trendyol'dan Gönderim」バッジを持ち、検索で優先的な可視性の重み付けを受けます。

FBA Trendyol の料金と資格

• オンボーディング — パートナーパネルを通じて申請；Trendyolの商業チームが月間数量、SKUの寸法、カテゴリー適合性をレビューします
• 保管料 — 占有した倉庫スペースの立方メートルごとに月次で請求；季節により変動します（第4四半期の保管はより高価）
• ピック＆パック料 — 注文ごとの定額で、パッケージ重量帯により変動します（500g未満、500g～2kg、2～5kg、5～10kg、10kg以上）
• 返品処理 — 標準の返品はピック＆パック料に含まれます；フラグ付きの状態は別途請求されます

FBA Trendyol が理にかなう場合

FBA Trendyol の自己フルフィルメントに対する損益分岐点は、回転の速い消耗品、エレクトロニクス、サイズ展開のあるファッションについて、倉庫SKUあたりおおよそ 月間800～1,200個 です。それ未満では、Trendyol Expressへの持ち込みに加えて自社のAras / Yurtiçi / DHL契約による自己フルフィルメントの方が通常は安価です。それを超えると、「Trendyol'dan Gönderim」バッジと当日配送の約束によるコンバージョンの向上が、単位あたりのフルフィルメントコストをほぼ常に上回ります。

8. GİB 電子請求書連携（e-Fatura / e-Arşiv）

GİB の義務

トルコの Gelir İdaresi Başkanlığı（GİB — 歳入庁） は、年間売上高がGİB公表のしきい値（毎年改定；2026年時点で約300万TRY）を超えるあらゆる事業者に e-Fatura を義務付け、約30,000TRYを超えるすべてのB2C請求書に e-Arşiv Fatura を義務付けています（毎年改定）。2026年のアクティブなTrendyolセラーにとって、e-Fatura / e-Arşiv のカバレッジは事実上普遍的です——ほぼすべてのマーケットプレイス注文は、注文ステータスの窓の中でGİB刻印の電子請求書を生成しなければならず、さもなければ罰則に直面します。

5社の GİB 認定インテグレーター

セラーはGİBのポータルを直接使用する（マーケットプレイスの量では非現実的）か、GİB認定の Özel Entegratör（特別インテグレーター）と契約できます。2026年の支配的な5社は次のとおりです：

• Logo Yazılım — 最大のトルコERPベンダー；請求書発行向けのe-Logo
• Mikro Yazılım — ミッドマーケットのERPおよび電子請求書プロバイダー、SMEセグメントに強い
• Uyumsoft — 堅牢なREST APIと最大のマーケットプレイスセラー基盤を持つ独立系インテグレーター
• Foriba — エンタープライズ層のプロバイダー（2019年にSovosが買収）、規制産業に強い
• Veriban — 競争力のある価格と開発者に優しいAPIを持つ、急成長中の代替

マーケットプレイスの電子請求書フロー

1. Trendyol Webhook：注文ステータス -> "Picking"
2. Zunapro が注文詳細をプル（買い手名、VKN/TCKN、住所、アイテム）
3. Zunapro が請求書ドラフトをインテグレーターへPOST（Logo/Mikro/Uyumsoft/Foriba/Veriban）
4. インテグレーターが電子署名証明書で署名し、GİBへ提出
5. GİB が ETTN（電子文書一意番号）を返す
6. Zunapro が ETTN を保存し、PDFをTrendyol注文に添付
7. Zunapro が API 経由で Trendyol 注文を Picking -> Invoiced に遷移

2026年の実際的な選択

新規セラーには、UyumsoftとVeribanが最もオンボードしやすい（ウェブサインアップ、REST API、オンプレ依存なし）です。すでにLogoまたはMikroのERPを運用しているセラーは、会計照合のために同じベンダーの電子請求書製品を使い続けるべきです。Foribaは複雑な税務ワークフローを持つ大企業向けの選択肢です。Zunaproは単一の設定画面の背後に5社すべての連携を備えています——インテグレーターを選び、API認証情報を貼り付ければ、すべてのTrendyol注文が自動で請求書化されます。

9. よくあるエラーとその回避設計

カテゴリーの不一致

症状：バッチ結果に INVALID_CATEGORY または CATEGORY_NOT_LEAF が表示される。原因：非リーフカテゴリーへの投稿、あるいはSKUが属性セットに一致しないリーフカテゴリーへの投稿。修正：常にリーフカテゴリーにのみ投稿し（APIは非リーフを拒否します）、POST前にカテゴリーの required: true セットに対して属性を事前検証する。

必須属性の欠落

症状：他の点では有効なSKUに MANDATORY_ATTRIBUTE_MISSING が出る。原因：Trendyolはカテゴリーごとに属性の約30%を必須としてマークします（ファッションの性別、エレクトロニクスの保証など）。修正：カテゴリーごとの属性要件マップをキャッシュし、完全性でPOSTをゲートする；Zunaproは可能な場合、あなたのマスター分類体系から自動入力します。

在庫同期の遅延

症状：売り切れたSKUが数分間Trendyolで在庫ありと表示され続け、過剰販売を引き起こす。原因：price-and-inventoryのプッシュは約5～8秒の中央値レイテンシで結果整合的であり、トラフィックのスパイク（ブラックフライデー、Trendyol Week）の間はキューが30～60秒まで伸びることがあります。修正：ローカルの安全バッファを実装し（高回転SKUごとに最後の1～2個を在庫切れバッファとして予約）、cronだけでなく注文確認イベントで在庫変更を同期的にプッシュする。

Webhook の欠落

症状：注文Webhookが届かない、または数時間遅れて届く。原因：通常はセラー側のファイアウォール変更、Webhook URLを壊したTLS証明書の更新、あるいはTrendyolの5回リトライ予算を超えた短時間の停止です。修正：常に /sapigw/suppliers/{id}/orders?status=Created&startDate=... に対して並行の5分ごとの照合プルを実行する；Zunaproはこれをデフォルトで行い、Webhookでも配信された注文を冪等にマージします。

複数の出品、同一バーコード（Mükerrer Listing）

症状：単一のSKUが複数のTrendyol出品として現れ、それぞれで在庫の減少が異なる。原因：過去のマージ、重複したバーコードエントリ、あるいはマルチストアの同一商品のファンアウト。修正：ZunaproのMIN在庫重複排除ポリシー（当社の2026-06-06本番アップデートで導入）は、同一バーコード下のすべての重複出品を1つにまとめ、それらにわたる最小在庫値を追跡し、古典的な「2つの出品で2回売れたのに、配送は1件しか約束していない」惨事を防ぎます。

10. Trendyol の手数料とベンダー費用 2026

Trendyolの2026年の手数料表はカテゴリー別に段階分けされ、3つの大まかな帯があり、固定の商品単位手数料はありません。キャンペーン参加（Trendyol Fast Sale、Trendyol Week、Çarşamba Pazarı）はカテゴリー料率に加えて追加で1～3%を上乗せします。

ベンダー / サブスクリプション費用

Trendyolは月額サブスクリプションを 請求しません。Amazon式の「プロフェッショナルセラー」層はありません。セラーが支払うのは：

• 各販売のカテゴリー手数料（8～22%）
• Trendyol Fast Sale / Weekに参加する際のキャンペーン手数料（+1～3%）
• Trendyol Express の出荷ごとの料金（買い手が支払うが、セラーのP&Lを通過する）
• FBA Trendyol の保管 + ピック＆パック（登録している場合のみ）
• Trendyol Ads のCPC（任意、セラーが制御）

支払いサイクル

標準セラーは T+14サイクル（注文配達の14日後）で支払われ、最上位のセラースコアを持つセラーはT+7に短縮されます。係争中の注文、14日間の期間内の返品、チャージバックは支払いから差し引かれます。支払いは登録済みのTR IBANに着金します。

トルコの法的枠組み 2026 — マーケットプレイスセラーが知っておくべきこと

KDV（VAT）と KDV 税率帯

トルコのVAT——KDV (Katma Değer Vergisi)——は2026年に3つの税率を適用します：標準20%、軽減10%（食品、書籍、医薬品、ホスピタリティ）、特別1%（基本食料品、農業）。トルコに拠点を置くマーケットプレイスセラーは地元の税務署を通じてKDVに登録します。デジタルサービスのしきい値を超える越境セラーはKDVの非居住者制度を使用します。各Trendyol商品POSTの vatRate フィールドは法的に正しい税率と一致しなければなりません——誤りは電子請求書に伝播し、修正申告を要することがあります。

e-Fatura / e-Arşiv（GİB 必須）

すでに第8節で詳しく説明しました。2026年の要点：すべてのマーケットプレイス注文はGİB刻印の電子請求書を生成します（B2B / 登録済みe-Fatura受領者にはe-Fatura、B2Cにはe-Arşiv）。セラーは注文ステータスの窓の中での発行に責任を負います。マーケットプレイスの量では手動発行は非現実的です——5社のGİBインテグレーターのうち1つを選び、自動化してください。

KVKK — トルコ版 GDPR

KVKK (Kişisel Verilerin Korunması Kanunu — 法律第6698号) はトルコのデータ保護制度で、構造的にはGDPRに類似しており、KVKK Kurumu によって執行されます。マーケットプレイスは買い手側の同意と処理を扱いますが、直接のカスタマーサポート連絡、マーケティング、購入後のコミュニケーションについては、セラーは共同管理者のままです。不遵守に対する罰則は違反区分に応じて60,000TRYから300万TRY超まで及びます。

ETBİS — 必須のeコマース登録

ETBİS (Elektronik Ticaret Bilgi Sistemi) は、トルコのあらゆるeコマース事業者に対する商業省の必須登録で、2018年以降施行されています。セラーはTrendyolに出品する前に登録し、年間取引量を報告しなければなりません。ETBİSのデータは消費者保護の執行、不正防止スクリーニング、競争分析に供給されます。

消費者保護 — 14日間の撤回権、2年間の保証

• 14日間の撤回権 — トルコの消費者は、通信販売で購入した商品を理由を問わず14日以内に返品できます（Tüketicinin Korunması Hakkında Kanun、法律第6502号）
• 2年間の法定保証 — B2C販売に必須で、メーカー保証とは独立しています
• トルコ語での商品情報の必須化 — タイトル、説明、保証、返品ポリシーはすべてトルコ語で

トルコにおける物流と配送 — Trendyol Express 優先

Trendyol Express — 支配的なレイヤー

Trendyol Express は2026年におよそ70%超のTrendyol注文でデフォルトの配送業者です。買い手は主要都市圏での当日または翌日配送を伴う無料または低コストの配送に加えて、買い物客が24時間365日荷物を受け取れる50,000以上のセルフサービスロッカー（Trendyol Hızlı Teslimat Noktaları）を目にします。セラーは荷物をTrendyol Expressの集荷ポイントに預けるか、配送業者の集荷を予約します。ルーティング伝票には注文ラベルAPIから取得したTrendyol Expressのバーコードが付きます。

その他の連携済み配送業者

• Yurtiçi Kargo — 老舗のトルコの配送業者、強力なB2CおよびB2Bネットワーク、Trendyol注文向けに連携済み
• Aras Kargo — 強力なアナトリアのカバレッジを持つ競合、自己フルフィルメントのTrendyol注文によく使われる
• DHL Kargo — トルコ第3の主要配送業者、大量販売セラーの一般的なフォールバック
• PTT Kargo — 国営郵便事業者、最も広い地方到達、SLAは遅め
• Sürat Kargo — 地域プレイヤー、マルマラおよびエーゲ地域で競争力あり

実用的な2026年の配送スタック

Trendyolセラー向けの実用的な2026年のスタック：デフォルトとしてのTrendyol Express（これが買い手の期待するもの）、Trendyol Expressの集荷ウィンドウに間に合わない自己フルフィルメント注文向けのセラー側フォールバックとしての Yurtiçi または Aras、他のどの配送業者も経済的でない地方専用の郵便番号向けの PTT Kargo、そして量が保管のコミットメントを正当化した後の回転の速いSKU向けの FBA Trendyol です。

Trendyol で販売を始める方法 — 5ステップのオンボーディング

1. Trendyol セラーアカウント

partner.trendyol.com で申請します。VKN、商業登記官報、署名回覧文書、ETBİS登録受領書、TR IBANを提供します。承認は2～5営業日。

2. ETBİS + 税務登録

商業省のポータル（etbis.gtb.gov.tr）で法人を ETBİS に登録し、地元の税務署でKDV登録を確認します。Trendyol International経由で運営する外国セラーは、トルコの代表者を任命するか、Trendyolの輸入者プログラムを使用します。

3. API Key + Secret を生成する

パートナーパネル → アカウント設定 → 連携情報から、「API Keyを作成」をクリックします。API Key（40文字）とAPI Secret（40文字）を 直ちに コピーしてください——一度だけ表示されます。それらをZunaproのTrendyolタイルに貼り付けると、AES-256暗号化されマスクされて保存されます。

4. Zunapro パネル経由で接続する

1. Zunaproにサインインし、トルコモジュールを開く
2. Supplier ID + API Key + API SecretをTrendyol連携タイルに貼り付ける
3. 自動ヘルスチェックを実行する（認証情報、addressesエンドポイント、サプライヤー情報）
4. 上位100 SKUのML提案カテゴリーマッピングを確認する
5. 電子請求書インテグレーター（Logo、Mikro、Uyumsoft、Foriba、Veriban）を選び、その認証情報を貼り付ける
6. 「Trendyol Express」+「FBA Trendyol」を切り替える（登録している場合）

5. テスト注文を実行する

stageapi.trendyol.com に対して3～5件のステージ注文を投入し、ピッキング・梱包、ラベル印刷、ステータス遷移、返金フローをエンドツーエンドで演習します。問題なければ、単一のトグルで連携を本番に切り替えます。Trendyolのレート制限を考慮すると、5,000 SKUカタログの初回本番同期はおよそ30～60分で完了します。

3つの Trendyol 連携パス — 比較

連携アーキテクチャを決める前に、3つの正当なパスを並べて比較すると役立ちます。

Trendyol 連携 FAQ 2026