Trendyol 集成指南 2026：REST API、XML 连接与集中式店铺管理

1. Trendyol API 架构 2026

Trendyol 的 Marketplace API 是一个 RESTful、JSON-over-HTTPS 接口，发布在单一生产基础 URL——https://api.trendyol.com——并在 https://stageapi.trendyol.com 提供独立的预发布环境。每个 API 调用都使用 HTTP Basic Auth 认证：Authorization 标头携带 base64 编码的 ApiKey:ApiSecret 对，Supplier ID 作为路径参数传入每个供应商作用域的端点。第一方卖家没有单独的访问令牌往返——每个请求都检查 Basic Auth——这使集成保持简单，但意味着泄露的凭据需要通过合作伙伴面板立即轮换。

基础 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,000 个 SKU
• 类目与属性查询 — 通常为每分钟 30 次请求（这些变动缓慢，因此预期会进行激进缓存）

每个响应都包含 X-RateLimit-Limit、X-RateLimit-Remaining，以及在 429 时的 Retry-After 标头。构建良好的集成会为每个 Supplier ID 使用令牌桶队列，并在 429 时以指数退避进行背压；Zunapro 默认实现这一点，因此即便是数千 SKU 的批量推送也绝不会触及限制。

面向独立集成商的 OAuth 2.0

对于独立的中间层集成商（Zunapro 及代表众多供应商行事的类似 SaaS 平台），Trendyol 提供 OAuth 2.0 授权码流程而非直接的 Basic Auth。集成商向 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 年起对任何土耳其电商经营者强制要求
• 以法人实体名义开立、用于市场结算的银行账户（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 Auth 标头有误；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 透明地处理全部四个步骤，因此供应商只看到一个「连接到 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 目录的卖家，这是一小时接入与多天接入之间的区别。每次调用返回一个 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 像素、白色背景
• 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（空操作）
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 返回一个 PDF（并可选返回用于热敏打印机的 ZPL），其中包含 Trendyol Express 条码、买家地址和货运跟踪号。该条码是唯一的承运路由凭证——打印、粘贴、扫描进你的 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 支持一个 XML 数据源模型作为 REST POST 流程的替代方案。卖家在一个公开的 HTTPS URL 上托管一个描述目录的 XML 文件；Trendyol 以可配置的节奏拉取它（通常每 1–4 小时一次）。XML 架构在合作伙伴面板中公布，并与 REST 端点的商品对象形状一致——barcode、title、brandId、categoryId、attributes、images、price、stock。

对于其 ERP 导出 CSV 比 XML 更自然的卖家，同样的模式也通过 CSV（每个 SKU 一行）支持。

对比：REST API vs 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 年推出，如今运营着土耳其密度最高的电商原生包裹网络。到 2026 年，它覆盖 50,000+ 自助自提柜和取件点以及自有快递车队，触达 81 个省份，在伊斯坦布尔、安卡拉、伊兹密尔、布尔萨和安塔利亚提供当日达，并向土耳其大陆其余地区提供次日达。买家会在符合条件的商品上看到「Hızlı Teslimat」（快速配送）标识，Trendyol 的搜索排名对其加权极高。

FBA Trendyol — Trendyol 物流仓库

FBA Trendyol（有时称为「Trendyol Lojistik Deposu」或「Trendyol Mağaza Plus」）是 Amazon-FBA 的等价物：卖家将库存运至 Trendyol 在 Çorlu（旗舰设施，位于伊斯坦布尔附近，25 万平方米）、Sancaktepe 和 Ankara 的履约中心，由 Trendyol 处理仓储、拣货、打包、通过 Trendyol Express 进行最后一公里配送以及退货。FBA 商品带有独特的「Trendyol'dan Gönderim」标识，并在搜索中获得优先可见度加权。

FBA Trendyol 费用与资格

• 接入 — 通过合作伙伴面板申请；Trendyol 的商务团队会审查月销量、SKU 尺寸和类目契合度
• 仓储费 — 按占用的每立方米仓库空间每月计费；随季节而变化（第四季度仓储成本更高）
• 拣货打包费 — 每单固定费率，随包裹重量段变化（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 — 税务管理局）已将 e-Fatura 对年营业额超过 GİB 公布门槛（每年修订；2026 年约为 300 万土耳其里拉）的任何企业强制要求，并将 e-Arşiv Fatura 对所有超过约 30,000 土耳其里拉的 B2C 发票强制要求（每年修订）。对于 2026 年的活跃 Trendyol 卖家，e-Fatura / e-Arşiv 覆盖实际上是普遍性的——几乎每笔市场订单都必须在订单状态窗口内生成一张 GİB 盖章的电子发票，否则将面临罚款。

五家 GİB 认证集成商

卖家可以直接使用 GİB 的门户（在市场量级下不切实际），或与一家 GİB 认证的 Özel Entegratör（特殊集成商）签约。2026 年的五大主导者是：

• 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 将发票草稿 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 在单一配置界面后集成了全部五家——选择集成商，粘贴 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 的生产更新中引入）会将同一条码下的所有重复商品折叠为一个，并跟踪它们之间的最小库存值，防止经典的「在两个商品上卖了两次、只承诺一件配送」的灾难。

10. Trendyol 佣金与卖家费用 2026

Trendyol 2026 年的佣金表按类目分级，分为三大区间，无固定的单件费用。参与活动（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 年适用三档税率：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）。卖家对在订单状态窗口内的签发负有责任。在市场量级下手动签发不切实际——选择五家 GİB 集成商之一并实现自动化。

KVKK — 土耳其版 GDPR

KVKK (Kişisel Verilerin Korunması Kanunu — 第 6698 号法律) 是土耳其的数据保护制度，结构上类似于 GDPR，由 KVKK Kurumu 执行。市场平台处理买家侧的同意和处理，但对于任何直接的客服联系、营销或购后沟通，卖家仍是共同控制者。视违规类别，不合规的处罚从 6 万土耳其里拉到 300 万+ 土耳其里拉不等。

ETBİS — 强制电商注册

ETBİS (Elektronik Ticaret Bilgi Sistemi) 是贸易部对土耳其任何电商经营者的强制注册系统，自 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 订单上是默认承运商。买家看到免费或低成本配送，在主要都市区提供当日或次日达，加上 50,000+ 自助自提柜（Trendyol Hızlı Teslimat Noktaları），购物者可 24/7 全天候取件。卖家要么将包裹投递到 Trendyol Express 收件点，要么安排快递上门取件；路由单携带从订单标签 API 获取的 Trendyol Express 条码。

其他集成的承运商

• Yurtiçi Kargo — 历史悠久的土耳其快递，B2C 和 B2B 网络强大，已为 Trendyol 订单集成
• Aras Kargo — 具有强大安纳托利亚覆盖的竞争对手，常用于自履约的 Trendyol 订单
• DHL Kargo — 第三大土耳其快递，高销量卖家常用的后备选择
• PTT Kargo — 国营邮政运营商，农村覆盖最广，SLA 较慢
• Sürat Kargo — 区域性参与者，在马尔马拉和爱琴海地区具有竞争力

务实的 2026 年配送组合

Trendyol 卖家务实的 2026 年组合：Trendyol Express 作为默认（这是买家的预期），Yurtiçi 或 Aras 作为卖家侧后备，用于错过 Trendyol Express 取件窗口的自履约订单，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 分钟内完成。

三种 Trendyol 集成路径 — 对比

在敲定一种集成架构之前，将三种合法路径并排比较会有所帮助。

Trendyol 集成常见问题 2026