Trendyol連携の概要 2026 — クイックリード
Trendyolはトルコの No.1 Eコマースプラットフォーム です — アクティブな購入者3,000万人以上、アクティブセラー23万社以上、年間GMV100億ドル以上を誇り、8,500万人以上の消費者市場への主要な入り口となっています。正規の連携方法は3つあります。 公式REST API ( api.trendyol.com 上でHTTP Basic認証を使用。本格的な運営に推奨)、 XML / CSV一括フィード (1時間ごとに取得。小規模で動きの少ないカタログなら許容範囲)、そして 独立系インテグレーター (Zunapro)です。インテグレーターは中間レイヤーとしてマスターカタログを正規化し、Trendyolをはじめとするすべてのマーケットプレイスへ送信します。 Trendyol Express (5万台以上のセルフサービスロッカーと自社配送網)は事実上の物流レイヤーであり、 GİB e-Fatura / e-Arşiv への準拠は注文単位で義務付けられています。また、Trendyolの2026年の手数料体系は カテゴリー別に8〜22% で、固定手数料はありません。
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認証が検証されます。これにより連携はシンプルになりますが、認証情報が漏洩した場合はPartnerパネルから直ちにローテーションする必要があります。
ベース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 を登録し、サプライヤーがPartnerパネルからインテグレーターを承認すると、インテグレーターは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分間隔の照合プルは欠かせない安全策です。
APIの配管作業は不要 — 10分でTrendyolに接続
Zunaproは、Trendyolの4つの認証モード、レート制限キュー、Webhook照合プル、GİB e-Fatura連携を標準で実装しています。1つのパネルで、すべてのTrendyolストアを管理できます。
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 Partnerパネルへのアクセスが付与されます。
2.2 APIキーとシークレットを生成する
Partnerパネルで アカウント設定 → 連携情報 を開き、「APIキーを作成」をクリックします。Trendyolは 40文字のAPIキー と 40文字のAPIシークレットを生成します。どちらも一度しか表示されず、後から取得することはできません。パスワードマネージャーに保存するか、より安全な方法として、Zunaproの連携タイルに直接貼り付けてください。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. インテグレーターがコードをトークンと交換:
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に接続」ボタンが1つ表示されるだけです。
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 配列です。
ヒント: 商品作成は非同期で行われます。POSTは batchRequestIdを返すので、その後 GET /sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId} をポーリングして、SKUごとの成功または却下理由を確認します。Zunaproは自動でポーリングし、却下されたSKUだけを分かりやすいエラーメッセージとワンクリック修正アクション付きで表示します。
3. 大規模な商品同期
一括アップロード — 1バッチあたり1,000 SKU
Trendyolの POST /v2/products エンドポイントは 1回のJSONリクエストで最大1,000 SKUを受け付けます。10,000 SKU以上のカタログを持つセラーにとって、これはオンボーディングが1時間で終わるか数日かかるかの違いになります。バッチは呼び出しごとに batchRequestId を返し、Trendyolは各バッチを非同期で処理します。処理完了後(検証キューの混雑状況により通常1〜15分以内)、SKUごとの成功・失敗が確認できます。
カテゴリーマッピング — 最も難しいステップ
Trendyolのカテゴリーツリーは深く、厳格です。2026年時点で約 12,000のリーフカテゴリーがあり、それぞれに必須・任意の属性セットがあります。「Men → Trousers → Casual」に出品するジーンズには gender, size, color, material 、 fit-type の属性が必要で、「Electronics → Mobile → Phones」のスマートフォンには brand, model, memory, guaranteeType 、 warrantyPeriodが必要です。誤ったリーフカテゴリーに商品を登録したり、正しいカテゴリーでも必須属性が欠けていたりすると、バッチ結果で何の通知もなく却下されます。
推奨される方法は次のとおりです。
- 最新のカテゴリーツリーを
GET /sapigw/product-categoriesから取得する(24時間キャッシュ) - 各リーフカテゴリーについて、必須・任意の属性を次のエンドポイントから取得する:
GET /sapigw/product-categories/{categoryId}/attributes - マスターカタログのSKUをTrendyolのリーフカテゴリーに対応付ける — Zunaproは、過去の膨大なTrendyol出品データで学習したMLマッパーを使い、タイトル・ブランド・自社分類からカテゴリーを提案します。 初回マッチ率は92%以上
- すべてのSKUを必須属性に照らして検証する — POSTエンドポイントを呼び出す前に 行うことで、失敗が確定しているリクエストでレート制限を浪費せずに済みます
ブランドのホワイトリストとbrandId
すべての商品は、Trendyolのブランド登録に存在する brandId を参照する必要があります。新しいブランドをその場で作成することはできず、Partnerパネルからの手動のブランド承認プロセス(通常1〜3営業日)を経る必要があります。商品を作成する前に GET /sapigw/brands?name={brandName} で既存のbrandIdを調べてください。
画像アップロードのルール
- 1商品あたり1〜8枚の画像
- 公開されたHTTPSのURL(Trendyolが画像をクロールし、自社CDNに再ホストします)
- 最小 1200×1800 px、ファッションカテゴリーでは白背景
- JPGまたはPNG、1枚あたり最大約10 MB
- 1枚目の画像が検索結果のサムネイルになります — ここに力を入れましょう
バッチステータスのポーリング
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"] }
]
}
📦 12,000カテゴリーのマッピングは不要 — MLにお任せください
ZunaproのTrendyolカテゴリーマッパーは、マスターカタログを正しいTrendyolリーフカテゴリーに初回92%以上の精度で対応付けます。数千SKU規模のオンボーディングも1時間以内に完了します。
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 を返す(何もしない)
3. 新しいステータスを保存し、後続処理(電子インボイス、ピッキングタスク)を予約
4. 3秒以内に HTTP 200 を返す
キャンセルと返金のフロー
購入者によるキャンセルは Cancelled Webhookとして届きます。セラーによるキャンセルは POST /sapigw/suppliers/{id}/orders/{orderId}/cancel にキャンセル理由コード(OUT_OF_STOCK, OTHER など)を付けて送信します。配達済み・返品済み商品の返金は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回の呼び出しで最大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 }
]
}
マスター → ローカル → ターゲットの同期アーキテクチャ
複数の販売チャネル(Trendyol + Hepsiburada + Çiçeksepeti + 自社ショップ)を運営するセラーにとって、唯一まともなアーキテクチャは、Zunapro上のマスター在庫からすべての対象マーケットプレイスへ送信する方式です。2026年のZunapro本番環境では、15分間隔のcronとイベント駆動のプッシュを併用しています。マスターで在庫が変わると即座にTrendyolへ価格・在庫プッシュが発火し、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はキャンペーン価格の下限をマスターの利益率ルールと自動で照合し、原価割れの約束を防ぎます。
実際の結果: Zunaproの本番テレメトリーによると、典型的なマルチチャネルセラーはTrendyol全体で1日あたり約12,000件の価格・在庫更新を送信しています。マスターでの変更がTrendyolに反映されるまでの遅延の中央値は 8秒未満で、99パーセンタイルでも90秒未満です。 同期アーキテクチャの全体を見る →
6. XML / CSVという選択肢 — 使うべき場合と使うべきでない場合
XMLプルモデル
Trendyolは、REST POSTフローの代替として XMLフィードモデル をサポートしています。セラーはカタログを記述したXMLファイルを公開HTTPSのURLでホストし、Trendyolが設定された間隔(通常1〜4時間ごと)でそれを取得します。XMLスキーマはPartnerパネルで公開されており、RESTエンドポイントの商品オブジェクトと同じ構造(barcode、title、brandId、categoryId、attributes、images、price、stock)になっています。
ERPがXMLよりCSVを出力しやすいセラー向けに、同じパターンがCSV(1 SKUにつき1行)でもサポートされています。
比較:REST API vs XML / CSV
XML / CSVが本当に正しい選択となる場合
- HTTPクライアント機能を持たないレガシーERP で、すでに毎晩XML / CSVを出力している場合
- 動きの少ないカタログ (500 SKU未満、価格変更は週単位、カタログ追加は月単位)
- 初期移行 — 他のマーケットプレイスからの移行で、単発のCSVエクスポートが最初の同期を早める場合
それ以外のすべて — 注文Webhook、リアルタイム在庫、キャンペーン参加、マルチチャネル同期 — において、2026年に実用的な方法はRESTだけです。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に相当するサービスです。セラーは在庫をTrendyolのフルフィルメントセンター — Çorlu (イスタンブール近郊の旗艦施設、250,000 m²)、 Sancaktepe 、 Ankara— に送り、Trendyolが保管、ピッキング、梱包、Trendyol Expressによるラストワンマイル配送、返品を担当します。FBAの出品には専用の「Trendyol'dan Gönderim」バッジが付き、検索で優先的に表示されます。
FBA Trendyolの料金と利用条件
- オンボーディング — Partnerパネルから申請します。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」バッジと当日配送の約束によるコンバージョン向上が、1個あたりのフルフィルメント費用をほぼ確実に上回ります。
📦 Trendyol Express + FBAの完全ガイドを読む
季節ごとの保管料、ピッキング・梱包の料金帯、Çorlu倉庫のオンボーディングの流れ、そして自社発送からFBA Trendyolへ切り替える際の損益分岐点の計算。
8. GİB電子インボイス連携(e-Fatura / e-Arşiv)
GİBの義務化
トルコの Gelir İdaresi Başkanlığı(GİB — 歳入庁) は、 e-Fatura をGİBが公表する基準額(毎年改定、2026年時点で約TRY 300万)を超える年間売上高のすべての事業者に義務付け、 e-Arşiv Fatura を約TRY 30,000(毎年改定)を超えるすべてのB2Cインボイスに義務付けています。2026年に活動中のTrendyolセラーにとって、e-Fatura / e-Arşivの対応は事実上必須です。ほぼすべてのマーケットプレイス注文で、注文ステータスの期間内にGİBの承認済み電子インボイスを発行しなければ、罰則の対象となります。
GİB認定の5つのインテグレーター
セラーはGİBのポータルを直接使う(マーケットプレイスの取引量では非現実的)か、GİB認定の Özel Entegratör (特別インテグレーター)と契約することができます。2026年の主要5社は以下のとおりです。
- Logo Yazılım — トルコ最大のERPベンダー。インボイス発行にはe-Logoを使用
- Mikro Yazılım — 中堅企業向けERPおよび電子インボイスプロバイダー。中小企業セグメントに強み
- Uyumsoft — 堅牢なREST APIを持ち、マーケットプレイスセラーの顧客基盤が最大の独立系インテグレーター
- Foriba — エンタープライズ向けプロバイダー(2019年にSovosが買収)。規制業種に強み
- Veriban — 競争力のある価格と開発者にやさしいAPIを持つ、急成長中の代替選択肢
マーケットプレイスの電子インボイスフロー
1. Trendyol Webhook: 注文ステータス -> "Picking"
2. Zunaproが注文詳細(購入者名、VKN/TCKN、住所、商品)を取得
3. Zunaproがインボイスの下書きをインテグレーター(Logo/Mikro/Uyumsoft/Foriba/Veriban)へPOST
4. インテグレーターが電子署名証明書で署名し、GİBへ送信
5. GİBがETTN(電子文書固有番号)を返却
6. ZunaproがETTNを保存し、PDFをTrendyolの注文に添付
7. ZunaproがAPI経由でTrendyolの注文を Picking -> Invoiced に遷移
2026年の実践的な選択
新規セラーにとっては、UyumsoftとVeribanが最も導入しやすい選択肢です(Web登録、REST API、オンプレミス依存なし)。すでにLogoやMikroのERPを使っているセラーは、会計照合のために同じベンダーの電子インボイス製品を使い続けるべきです。Foribaは複雑な税務ワークフローを持つ大企業向けの選択肢です。Zunaproは5つすべての連携を1つの設定画面にまとめて提供しています — インテグレーターを選び、API認証情報を貼り付けるだけで、すべてのTrendyol注文が自動でインボイス化されます。
9. よくあるエラーとその回避設計
カテゴリーの不一致
症状: バッチ結果に次のエラーが表示される: INVALID_CATEGORY または CATEGORY_NOT_LEAF. 原因: リーフではないカテゴリー、またはSKUの属性セットが一致しないリーフカテゴリーに登録している。 対処: 必ずリーフカテゴリーにのみ登録し(APIはリーフ以外を拒否します)、POSTの前にカテゴリーの required: true の属性セットに対して事前検証してください。
必須属性の欠落
症状: MANDATORY_ATTRIBUTE_MISSING (それ以外は有効なSKUで発生) 原因: Trendyolはカテゴリーごとに約30%の属性を必須としています(ファッションなら性別、電子機器なら保証など)。 対処: カテゴリーごとの必須属性マップをキャッシュし、情報が揃っている場合のみPOSTするようにします。Zunaproは可能な範囲でマスター分類から自動入力します。
在庫同期の遅延
症状: 売り切れたSKUがTrendyol上で数分間在庫ありと表示され、過剰販売が発生する。 原因: 価格・在庫プッシュは最終的整合性であり、遅延の中央値は約5〜8秒です。トラフィックのピーク時(ブラックフライデー、Trendyol Week)にはキューが30〜60秒に延びることがあります。 対処: ローカルの安全在庫バッファ を実装し(回転の速いSKUごとに最後の1〜2個を在庫切れバッファとして確保)、cronだけでなく注文確定イベントの時点で同期的に在庫変更をプッシュしてください。
Webhookの取りこぼし
症状: 注文Webhookがまったく届かない、または数時間遅れて届く。 原因: 多くの場合、セラー側のファイアウォール変更、TLS証明書の更新によるWebhook URLの不具合、またはTrendyolの5回のリトライ枠を超える短時間の障害です。 対処: 常に5分間隔の照合プルを並行して実行します: /sapigw/suppliers/{id}/orders?status=Created&startDate=...。Zunaproはこれを標準で行い、Webhookでも届いた注文は冪等にマージします。
同一バーコードの複数出品(Mükerrer Listing)
症状: 1つの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 — 配送ごとの料金(購入者が支払いますが、セラーの損益を経由します)
- 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インテグレーターのいずれかを選んで自動化してください。
KVKK — トルコ版GDPR
KVKK(Kişisel Verilerin Korunması Kanunu — 法律第6698号) はトルコのデータ保護制度で、構造的にはGDPRに類似しており、 KVKK Kurumuによって執行されます。購入者側の同意と処理はマーケットプレイスが扱いますが、直接のカスタマーサポート連絡、マーケティング、購入後のコミュニケーションについてはセラーも共同管理者としての責任を負います。違反に対する罰金は、違反の区分に応じてTRY 6万からTRY 300万以上に及びます。
ETBİS — 義務的なEコマース登録制度
ETBİS(Elektronik Ticaret Bilgi Sistemi) は、2018年から施行されている、トルコのすべてのEコマース事業者を対象とした商務省の義務的な登録制度です。セラーはTrendyolに出品する前に登録し、年間の取引量を報告する必要があります。ETBİSのデータは、消費者保護の執行、不正防止の審査、競争分析に活用されます。
消費者保護 — 14日間の撤回権、2年間の保証
- 14日間の撤回権 — トルコの消費者は、通信販売で購入したあらゆる商品を理由を問わず14日以内に返品できます(Tüketicinin Korunması Hakkında Kanun、法律第6502号)
- 2年間の法定保証 — B2C販売では、メーカー保証とは別に義務付けられています
- トルコ語での商品情報の義務 — タイトル、説明、保証、返品ポリシーはすべてトルコ語で記載
トルコの物流と配送 — Trendyol Expressが第一
Trendyol Express — 支配的なレイヤー
Trendyol Express は、2026年にはTrendyolの注文の約70%以上で標準の配送業者となっています。購入者には無料または低価格の送料と、主要都市圏での当日・翌日配送が提示され、さらに24時間いつでも荷物を受け取れる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を標準に (購入者が期待しているのはこれです)、 YurtiçiまたはAras をTrendyol Expressの集荷時間に間に合わなかった自社発送注文のセラー側の代替手段に、 PTT Kargo を他の配送業者では採算が合わない地方の郵便番号向けに、そして FBA Trendyol を、販売量が保管契約に見合うようになった回転の速いSKU向けに使います。
Trendyolで販売を始める方法 — 5ステップのオンボーディング
1. Trendyolセラーアカウント
申請先: partner.trendyol.com。VKN、商業登記官報、署名証明書、ETBİS登録受領書、TR IBANを提出します。承認まで2〜5営業日です。
2. ETBİS + 税務登録
法人を ETBİS に商務省ポータル(etbis.gtb.gov.tr)から登録し、管轄の税務署でKDV登録を確認します。Trendyol Internationalを通じて事業を行う海外セラーは、トルコの代理人を指定するか、Trendyolの輸入者代行プログラムを利用します。
3. APIキー + シークレットを生成
Partnerパネル → アカウント設定 → 連携情報で「APIキーを作成」をクリックします。APIキー(40文字)とAPIシークレット(40文字)を すぐに コピーしてください — 一度しか表示されません。ZunaproのTrendyolタイルに貼り付けると、AES-256で暗号化・マスクされて保存されます。
4. Zunaproパネルから接続
- Zunaproにサインインし、トルコモジュールを開きます
- Supplier ID + APIキー + APIシークレットをTrendyol連携タイルに貼り付けます
- 自動ヘルスチェック(認証情報、住所エンドポイント、サプライヤー情報)を実行します
- 上位100 SKUについて、MLが提案したカテゴリーマッピングを確認します
- 電子インボイスのインテグレーター(Logo、Mikro、Uyumsoft、Foriba、Veriban)を選び、その認証情報を貼り付けます
- 「Trendyol Express」と「FBA Trendyol」(加入している場合)をオンにします
5. テスト注文を実行
stageapi.trendyol.com に対して3〜5件のステージング注文を行い、ピッキング・梱包、ラベル印刷、ステータス遷移、返金のフローをエンドツーエンドで確認します。問題がなければ、トグル1つで連携を本番に切り替えます。Trendyolのレート制限を考慮すると、5,000 SKUのカタログの最初の本番同期はおよそ30〜60分で完了します。
10分でTrendyol APIに接続 — すべてのマーケットプレイスを1つのパネルで管理
Trendyol REST API + Trendyol Express + FBA Trendyol + GİB e-Fatura(Logo / Mikro / Uyumsoft / Foriba / Veriban)— すべてZunaproの1つのタイルに。MLカテゴリーマッピング、10秒未満の在庫プッシュ、重複出品(mükerrer listing)の排除、複数ストアの統合管理を標準搭載。
🇹🇷 今すぐTrendyolに接続 →Trendyolとの3つの連携方法 — 比較
連携アーキテクチャを決める前に、3つの正規の方法を並べて比較しておくと役立ちます。
1. 公式REST API(直接)
api.trendyol.com に対して独自のクライアントを構築 · 完全なリアルタイム制御 · エンジニアリングコストが最も高い · 自社チームで保守
2. XML / CSV一括フィード
XMLまたはCSVのカタログを公開URLでホスト · Trendyolが1〜4時間ごとに取得 · Webhookなし、リアルタイム在庫なし · シンプルだが制約あり
3. 独立系インテグレーター(Zunapro)
Zunaproの中間レイヤー経由で接続 · REST + XML + OAuthをすべて処理 · 複数マーケットプレイスの統合管理 · GİB + KVKK + ETBİSを1つのパネルで
Trendyol連携FAQ 2026
2026年にTrendyolのAPIキーを取得するには?
Trendyol Partnerパネル (partner.trendyol.com) にログインし、 アカウント設定 → 連携情報を開いて「APIキーを作成」をクリックします。TrendyolはSupplier ID + 40文字のAPIキー + 40文字のAPIシークレットの3点セットを生成します。これらの値は 一度だけ 表示されます — すぐにコピーしてください。
認証情報は api.trendyol.com ですぐに有効になります。Zunaproはこれらをマスクし、AES-256で暗号化したシークレットとして保存し、すべてのRESTリクエストにお客様に代わってHTTP Basic認証で署名します。ローテーションはPartnerパネルで1クリック、Zunaproで1クリックです。
TrendyolのOAuth 2.0フローはどのように機能しますか?
ファーストパーティのセラーの場合、TrendyolのMarketplace APIは HTTP Basic認証 を直接使用します — すべてのリクエストでSupplier ID + APIキー + APIシークレットを送り、トークンの取得手順はありません。これが最もシンプルで一般的なパターンです。
複数のサプライヤーに代わって接続する独立系インテグレーター向けには、Trendyolは完全な OAuth 2.0認可コードフローを提供しています。インテグレーターが client_id / client_secretを登録し、サプライヤーがPartnerパネルからインテグレーターを承認すると、インテグレーターは1時間有効のアクセストークンと30日間有効のリフレッシュトークンを受け取ります。Zunaproは、多数のTrendyolストアを管理するエンタープライズ顧客向けにこの方法を使用しています。
XMLとREST API — どちらのTrendyol連携を使うべきですか?
アクティブなイベント駆動型の連携にはREST API を使用してください — リアルタイムの在庫・価格プッシュ、Webhookによる注文取り込み、在庫変更の1秒未満での反映、マルチチャネル同期。現代のTrendyolセラーのほぼすべてにとって、これが正解です。
XMLまたはCSVは、シンプルで動きの少ないカタログにのみ 使用してください(500 SKU未満、週次または月次の更新、注文側の双方向通信なし)。他のマーケットプレイスからの初期移行における単発の手段としても有用です。Zunaproは標準でRESTを使用し、XML/CSVはレガシーERPからのETL取り込み元としてのみ使用します。
TrendyolのAPIレート制限にはどう対処すればよいですか?
Trendyolはエンドポイントごと・Supplier IDごとにレート制限を設けています — 通常、 商品エンドポイントは毎分60リクエスト, 注文エンドポイントは毎分600リクエスト, 在庫・価格エンドポイントは毎分100リクエスト (1回の呼び出しで最大1,000 SKUをバッチ送信可能)です。すべてのレスポンスには X-RateLimit-Remaining が含まれ、429の場合は Retry-After ヘッダーも返されます。
正しいパターンは、 Supplier IDごとのトークンバケット方式のキュー、HTTP 429に対する指数バックオフ、そしてリクエストあたりのスループットを最大化する積極的なバッチ処理です。Zunaproはこの3つすべてを標準で実装しているため、数千SKU規模の一括送信でも制限に引っかかることはありません。
Trendyol Express FBAは自社のビジネスに適していますか?
FBA Trendyol(Trendyol Lojistik Deposu)が適しているのは、 安定した販売量(倉庫SKUあたり月800〜1,200個超)があり、「Trendyol'dan Gönderim」の当日・翌日配送バッジの恩恵を受ける安定したSKU構成を持ち、当日配送の約束が実現できるイスタンブール、アンカラ、イズミル、ブルサ、アンタルヤで事業を行っている場合です。
その販売量を下回る場合は、Trendyol Expressへの持ち込みと自社のAras / Yurtiçi / DHL契約を組み合わせた自社発送の方が通常は安くなります。損益分岐点はカテゴリーによって大きく変わります — 回転の速いファッションや消耗品は、動きの遅い電子機器よりも早くFBAで採算が取れるようになります。
2026年のTrendyolの手数料はどのように計算されますか?
Trendyolの2026年の手数料体系は カテゴリー別に8%〜22%で、商品ごとの固定手数料はありません。電子機器と大型家電は8〜12%の帯、ホーム&リビング、スポーツ、ペット用品は13〜18%、ファッション、美容、アクセサリーは18〜22%です。
キャンペーン(Trendyol Fast Sale、Trendyol Week、Çarşamba Pazarı)に参加すると、カテゴリー料率に1〜3%のキャンペーン手数料が上乗せされます。手数料はT+14サイクル(セラースコア最上位ならT+7)の入金前に差し引かれます。Zunaproは最新の手数料表を同期し、SKUごとの純利益率をリアルタイムで表示します。
本番稼働前にTrendyolでテスト注文を行うにはどうすればよいですか?
Trendyolは、本番のRESTスキーマを反映したステージング環境を stageapi.trendyol.com で提供しています。ステージング用の認証情報は、Trendyolのアカウントマネージャー、またはPartnerパネルの開発者セクションから申請してください。
Zunaproでは、トグル1つで連携をステージングと本番の間で切り替えられます。標準のオンボーディングフローでは、本番の認証情報を有効化する前に、ピッキング・梱包、配送ラベルの生成、ステータス遷移(Created → Picking → Invoiced → Shipped → Delivered)、そして少なくとも1件のキャンセル + 返金フローを含む3〜5件のステージング注文を行います。
注文Webhookでイベントが欠落しています — 何を確認すべきですか?
まず、PartnerパネルでWebhook URLを確認し、 3秒以内にHTTP 200 を返すことを確認してください — Trendyolは失敗したWebhookを指数バックオフで5回リトライし、その後イベントを保留します。
次に、開発者ドキュメントで公開されているTrendyolの送信元IPレンジがファイアウォールで許可されているか確認してください。3つ目に、TLS証明書の有効期限を確認してください — 気づかないうちに期限切れになった証明書は、「Webhookが突然動かなくなった」原因として最も多いものです。
4つ目にして最も重要なのは、安全策として 5分間隔の照合プル を GET /sapigw/suppliers/{id}/orders?status=Created に対して並行して実行することです。Zunaproはこれを標準で行い、取得した注文をWebhookで届いた注文と冪等にマージします。
複数のTrendyolストアを1つのパネルで管理できますか?
はい。Trendyolは 1つの法人のもとで複数のSupplier ID をサポートしています — ブランド、倉庫、VAT設定をそれぞれ分けられます。Zunaproは各Supplier IDを独立した連携として接続しつつ、注文、在庫、分析を統合ダッシュボードにまとめます。
在庫配分ルールにより、マスターSKUを割合(例:旗艦店に70%、アウトレット店に30%)、地域、またはマーケットプレイスの優先度でストア間に分割できます。MIN在庫重複排除ポリシー(2026-06-06の本番アップデート)により、ストアをまたいだ重複出品で過剰販売が起きることはありません。
Trendyolのカテゴリーマッピングはどのくらい難しいですか?
Trendyolは深く厳格なカテゴリーツリーを運用しており、2026年時点で約 12,000のリーフカテゴリー があり、カテゴリーごとに必須属性セットがあります。誤ったリーフに登録したり、正しいリーフでも必須属性が欠けていたりすると、バッチ結果で商品が何の通知もなく却下されます。
5,000 SKUのカタログを手作業でマッピングすると、現実的には40〜80人時かかります。Zunaproの MLカテゴリーマッパー は、タイトル + ブランド + 既存の自社分類から正しいリーフを提案し、 初回マッチ率は92%以上で、オンボーディングを数日から数時間に短縮します。
海外のセラー(ドイツ、ロシア、UAE)もTrendyolで販売できますか?
はい。 Trendyol International Seller Center は、EU、MENA、CISを拠点とするセラーを受け入れています。トルコ以外の法人には2つの方法があります:
(1) 現地支店または指定代理人を通じてトルコの納税者番号(VKN)を取得し、通常のトルコのサプライヤーアカウントで販売する。(2) Trendyol Internationalの 越境プログラム を通じて販売する。この場合、Trendyolが輸入者代行、通関、ラストワンマイル配送を担当します。法人がどこに設立されていても、トルコの消費者を対象とするセラーにはKVKK(データ保護)とETBİS(Eコマース登録)への準拠が引き続き求められます。
ZunaproでのTrendyol連携にはどのくらい時間がかかりますか?
初回接続はおよそ10分 です:Supplier ID + APIキー + シークレットを貼り付け、認証情報のヘルスチェックを実行し、上位100 SKUについてMLが提案したカテゴリーマッピングを確認します。
Trendyolのレート制限とバッチサイズを考慮すると、 5,000 SKUのショップのカタログ全体の同期は通常30〜60分以内に完了します 。KVKKの同意フロー、ETBİS登録の確認、GİB電子インボイスプロバイダー(Logo、Mikro、Uyumsoft、Foriba、Veriban)との接続がまだの場合は、通常さらに30分ほどかかります。全体として、新しいTrendyolセラーは1営業日以内に自動インボイス発行付きで本番稼働できます。
10分でTrendyol APIに接続し、すべてのマーケットプレイスを1つのパネルで管理
Trendyol · Hepsiburada · Çiçeksepeti · N11 · Amazon TR — 1つのマスターカタログ、1つの在庫、1つのGİB e-Faturaフロー。MLカテゴリーマッピング、10秒未満の在庫プッシュ、Trendyol Express + FBA Trendyol連携、KVKK + ETBİS対応。デモ不要、長期契約なし。
🇹🇷 今すぐTrendyolで販売を開始 →お困りですか?
関連サービス: マーケットプレイス