2026 Hepsiburada 对接指南：REST API、HepsiJet & 集中式卖家管理

1. 2026 Hepsiburada API 架构

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 — listing 的增删改查（价格、库存、上架状态）
• mpop.hepsiburada.com/product/api/products — 商品创建与品类属性
• oms-external.hepsiburada.com — 订单管理（订单、包裹、发货）
• returns-external.hepsiburada.com — 退货与退款
• integration.hepsiburada.com/finance — 发票上传与财务对账

各子域名共用同一套 HTTP Basic 认证方案，但各自暴露不同的速率限制和分页约定。Zunapro 的 HB 连接器将这种扇出式结构抽象在单一规范化接口之后。

认证：基于 HTTPS 的 HTTP Basic

与 Trendyol 稍显宽松的 API 或 Amazon 的 SP-API OAuth 流程不同，Hepsiburada 采用了刻意保持简单的 HTTP Basic 认证方案：Authorization 头携带 Basic base64(username:password)，其中 username 是你的 API key，password 是配对的 secret。每个请求还必须携带一个包含你 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 面板

位于 merchant.hepsiburada.com 的 HMS 面板是与 API 配套的运营网页控制台。每一项 API 能力都有对应的 HMS 操作——listing 编辑、订单接受、退款开具、财务对账——而 HMS 是唯一可以供应 API 密钥、配置 HepsiJet 取件地址和管理用户权限的地方。2024–2026 年的 HMS 改版带来了统一的左侧导航、实时结算报告，以及一个新的“API Health”仪表盘，可按端点展示 4xx/5xx 比率，在调试对接时极为有用。

速率限制与幂等性

Hepsiburada 施加了宽松但严格执行的速率限制——listing 更新通常为每商户约 30 请求/秒，订单端点更低（约 10/秒）。批量商品导入单独限流，会返回带 trackingId 的 202 Accepted；随后你轮询 /import/{trackingId} 以确认完成。订单 API 通过在多次读取间保持稳定的包裹 ID 和订单 ID 来支持幂等性。

2. 通过 REST API 连接 — 分步操作

前提条件：HMS 账户 & ETBİS

在任何 API 调用之前，一家拥有 vergi numarası（税号）、ETBİS 注册（Elektronik Ticaret Bilgi Sistemi——贸易部的电商企业登记系统）和 土耳其 IBAN（TR…）的土耳其注册企业必须通过 HMS 完成接入。对于已在 ETBİS 注册的实体，KYC 审核通常在 1–3 个工作日内通过；未在 ETBİS 注册的卖家会被引导至人工审核队列，可能需要 1–2 周。

API 接入分步流程

1. 创建 HMS 账户，在 merchant.hepsiburada.com 使用你的 vergi numarası 和 IBAN。上传你的 ETBİS 证书、签章通函和税务登记文件。
2. 生成 API 凭据，在 Hesabım → Entegrasyon Bilgileri → API Anahtarı 下。系统会返回一个 username、password 以及你稳定的 Merchant ID。请将 secret 存入保险库——Hepsiburada 不会再次显示 password。
3. 将出站 IP 加入白名单，如果你的对接平台需要。Zunapro 公布了固定的出口 IP 段，卖家可以在 HMS 允许列表中锁定它。
4. 用一次 listing 读取做冒烟测试——调用 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 的目录被组织成一个严格的 三到五级品类树，通过 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”。常见问题包括：

• 品牌（Brand）——必须与 Hepsiburada 的品牌注册表完全匹配；“Apple”和“APPLE”是不同的 ID
• 颜色、尺码、容量——从受控词表中选取，而非自由文本
• 保修期（Warranty period）——电子产品必填，以月为单位、作为枚举表示
• 原产国（Menşei）——化妆品、食品、保健品必填

变体：listing 与 product 的分离

Hepsiburada 采用了比多数竞争对手更严格的 product 与 listing 分离。单个 product（HB-SKU，内部标识符）可以有多个 listing（merchantSku）——每个卖家一个，各有自己的价格、库存、成色（全新/翻新）和保修。对于变体商品（例如 S/M/L × 红/蓝/黑 的 T 恤），每种组合都是一个独立的 product 节点，可选地归入一个 varyantGroupID，以便商品页显示颜色和尺码色板。

通过 trackingId 批量导入

生产环境的目录推送使用 POST /product/api/products/import，每个请求最多包含 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（待处理）——已收到订单，等待接受（大多数品类为 24 小时 SLA，家具为 48 小时）
• InProgress / Picking（处理中 / 拣货）——卖家已确认，正在拣货和打包
• Packaged（已打包）——已通过 API 创建包裹，等待交给承运商
• Shipped（已发货）——承运商已扫描包裹；运单号已激活
• Delivered（已送达）——末端已确认送达
• Cancelled / Returned（已取消 / 已退货）——由客户或商家发起退货流程

Webhook 与轮询

Hepsiburada 同时支持 webhook（首选）和轮询。webhook 在 HMS 中按 Merchant ID 配置，或通过 POST /webhook-subscriptions 配置；平台会将 JSON 事件推送到你的 HTTPS 端点，并在 X-HB-Signature 头中携带 HMAC 签名。轮询作为兜底方式，以 30–60 秒的定时任务调用 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 的标准退货门户（Iade Talepleri）发起，并通过 GET /returns?status=Open 呈现给卖家。卖家有 3 个工作日批准或申诉退货；之后会自动批准。已批准的退货会通过 Hepsiburada 的支付通道触发退款（卖家会在下一次财务结算时看到），并且应通过 PUT /listings/{merchantSku}/stock 将库存重新入账。

5. 库存与价格同步 — 实时、Buy Box、调价器

库存端点

库存通过 listing API 以增量感知的负载进行更新：

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

该端点可在同一次调用中同时接受价格和库存，但 Hepsiburada 的内部缓存可能需要 30–90 秒才能传播到店铺前台。批量更新使用 POST /listings/import，采用与商品导入相同的 trackingId 模式。

实时同步与定时同步

生产级卖家使用事件驱动同步（你 ERP 中的每一次库存变化都会在数秒内向 Hepsiburada 发起一次 PUT），而不是 15 分钟一次的定时任务。仅靠定时同步的风险是在促销高峰期（Ramazan kampanyası、Black Friday、Efsane Cuma）出现超卖。Zunapro 的混合模型会立即发起 PUT，并配以 15 分钟的对账器以防事件丢失——与我们 master→local→targets 价格与库存自动同步架构中记录的模式相同。

赢得 Buy Box

Hepsiburada 的 Buy Box（共享商品页上默认的“Sepete Ekle”报价）由一个加权公式授予，组合了：

• 价格——在最低有效报价的 1–2% 以内保持竞争力
• 库存健康度——深度、时效性、近期无缺货
• 配送承诺——同等条件下 HepsiJet 胜出
• 卖家评分——在配送和服务 KPI 上至少 9.0+
• 订单缺陷率——取消、延迟发货、退货都会被扣分

一台调校良好、每 5–10 分钟重新评估竞品价格的调价器，通常能让竞争激烈 SKU 的 Buy Box 份额提升 15–30%。

6. HepsiJet — 自营快递网络

Hepsiburada 垂直整合的末端配送

HepsiJet 是 Hepsiburada 自营的末端快递网络，于 2017 年推出，以打破在时效敏感 SKU 上对 Yurtiçi 和 Aras Kargo 的依赖。到 2026 年，HepsiJet 在 81 个省运营 1,500 多个自提点，在伊斯坦布尔、安卡拉和伊兹密尔提供当日达，并拥有超过 2,500 辆自有车队以及一个加盟网点（şube）网络。

条码标准与面单格式

每张 HepsiJet 运输面单都带有一个 Code-128 条码，编码一个以 HJ 为前缀的 12 位运单号（例如 HJ73219840TR）。API 生成的 PDF 面单采用适合热敏打印机的 A6 版式；面单可通过集成的 ZPL 队列直接打印。

当日达 & Yarın Kapında

HepsiJet 提供两档在商品页上可见的高级配送等级：

• “Yarın Kapında（明日送达）”——在订单于当地时间 14:00 前发货时，81 个省次日送达
• “Bugün Kapında（今日送达）”——在 11:00 前下单时，于伊斯坦布尔、安卡拉、伊兹密尔、布尔萨、阿达纳当日送达

两种标识都能显著提升转化——Hepsiburada 自身的数据显示，带有这些标识的商品有 15–25% 的转化提升，大致相当于 Trendyol 的“Hızlı Teslimat（快速配送）”效果。

取件 vs Şubeye Bırak（送到网点）

卖家可在 HepsiJet 取件（快递员从仓库揽收，按件收费）和 Şubeye Bırak（送到网点）（卖家将包裹送到最近的 HepsiJet 网点，按件更便宜但操作上更繁重）之间选择。对接 API 两者都支持——包裹响应中包含一个决定路由的 pickupAddressId 字段。

7. HepsiLojistik — FBA 模式

HepsiLojistik 是什么

HepsiLojistik 是 Hepsiburada 的平台履约（fulfillment-by-marketplace）服务——对应 Amazon FBA、Trendyol TFC 和 Allegro One Fulfillment 的土耳其版本。卖家将库存批量发往 Hepsiburada 的履约中心；Hepsiburada 负责仓储、拣货、打包、末端配送（通过 HepsiJet）和退货。HepsiLojistik 订单带有独特的 “Hepsiburada Garanti（Hepsiburada 保障）”标识，并在 Buy Box 公式中获得最高的曝光权重。

履约中心网络

• Gebze（Kocaeli）——旗舰履约中心，约 150,000 平方米，服务伊斯坦布尔 + 马尔马拉地区
• Çorlu（Tekirdağ）——2023 年新增，聚焦土耳其西部 + 巴尔干跨境
• Kemalpaşa（Izmir）——爱琴海地区覆盖，2024 年启用，服务土耳其西南部
• Ankara（Polatlı）——中安纳托利亚枢纽，为首都地区配送而优化

费用结构

HepsiLojistik 定价以每件履约费加每月仓储费的形式发布：

• 每件履约费——通常为 ₺25–₺75，取决于重量段和品类
• 每月仓储费——按每立方米每月计费，并按周转率分级（长尾 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ığı——税收管理局）已要求所有年营业额超过阈值的公司（目前约 ₺300 万，根据 2026 年修订案对电商卖家有所降低）开具 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 合规层

在发票管道中流转的客户 PII 受土耳其 KVKK（Kişisel Verilerin Korunması Kanunu——个人数据保护法）约束，这是由 KVKK Kurumu（数据保护局）执行的、与 GDPR 等价的本地法规。卖家是订单侧 PII 的共同控制者，在适用时必须在 VERBİS 上登记处理活动。

9. 常见错误与解决方案

常见的生产环境错误

HTTP / 代码	症状	根本原因	修复方法
401 Unauthorized	所有请求被拒绝	缺失或格式错误的 User-Agent 头	显式设置 User-Agent: {MERCHANT_ID} - {AppName}
403 Forbidden	特定端点被阻止	API key 缺少权限范围；商户未获批该模块	在 HMS 中以完整权限范围重新签发密钥，联系 Merchant Support
VALIDATION_ERROR	商品卡在 WAITING_FOR_APPROVAL	缺失必填品类属性或查找值无效	获取 /categories/{id}/attributes，用有效的枚举值填写必填字段
BRAND_NOT_FOUND	商品导入被拒绝	品牌字符串与 HB 品牌注册表不完全匹配	查询 /brands?name=...，使用返回的 ID，若缺失则申请创建品牌
429 Too Many Requests	突发流量被限流	超过 listing 约 30 请求/秒或订单约 10/秒	实现支持 Retry-After 头的指数退避
STOCK_UPDATE_DELAY	店铺前台显示过期库存 30–90 秒	缓存传播延迟，并非 bug	在有超卖风险时预先减少库存；延迟后再对账
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-auth 凭据
3. 检查失败响应中的 X-Request-Id 头——Hepsiburada Merchant Support 需要它来追踪工单
4. 对照 developers.hepsiburada.com 的更新日志查看近期的结构变更

10. 2026 Hepsiburada 佣金 — 8% 至 22%

Hepsiburada 2026 年的佣金方案按品类分级，每季度发布在 HMS 的 Hesabım → Komisyon Oranları 下，分为三个大区间，外加几个特殊品类（黄金、汽车、大家电）。

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

2026 增值税（KDV）税率

土耳其的增值税——KDV（Katma Değer Vergisi）——在 2026 年采用三档法定税率：

• 20% 标准税率——大多数消费品、电子产品、时尚、家居生活
• 10% 优惠税率——基本食品杂货、某些品类的纺织品、图书、餐饮住宿
• 1% 超低税率——主食（面包、牛奶、鸡蛋）、农业投入品、某些医疗

平台卖家通过所在地区的 Vergi Dairesi（税务局）登记 KDV；跨境卖家在 2024 年之后可使用土耳其近期扩展的电商特别增值税制度。

e-Fatura & e-Arşiv — GİB 强制要求

• e-Fatura——提交至 GİB 的结构化 XML 发票，年营业额超过阈值时强制，且根据 2026 年修订案对所有电商卖家强制
• 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 对齐的过程中收紧，用于规范个人数据处理。平台卖家是订单侧 PII（姓名、地址、电话、相关时的 IBAN）的共同控制者，必须：

• 在超过阈值时于 VERBİS（Veri Sorumluları Sicil Bilgi Sistemi）登记
• 维护一份客户可访问的书面隐私政策（Aydınlatma Metni）
• 在 30 天内履行数据主体权利（访问、更正、删除）
• 在 72 小时内向 KVKK Kurumu 报告数据泄露

ETBİS — 电商企业登记系统

ETBİS（Elektronik Ticaret Bilgi Sistemi）由 贸易部（Ticaret Bakanlığı）运营，是每一家在土耳其经营的电商企业的强制登记系统。注册免费且在线进行；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 公斤以上的包裹回退到 Aras。所选承运商通过同一个 Hepsiburada 包裹端点推送，因此客户看到的是统一的物流追踪体验。

如何开始在 Hepsiburada 上销售 — 2026 分步指南

5 步启动

1. 在 ETBİS & HMS 上注册——通过 etbis.ticaret.gov.tr 建立你的 ETBİS 记录，然后用 vergi numarası、IBAN 和签章通函在 merchant.hepsiburada.com 完成接入。KYC 在 1–3 个工作日内通过。
2. 生成 API 凭据——Hesabım → Entegrasyon Bilgileri → API Anahtarı。将 username/password 存入你的保险库；记下用于 User-Agent 头的 Merchant ID。
3. 接通 e-Fatura——选择你的 GİB 整合商（Logo、Mikro、Foriba、izibiz），并确认 Hepsiburada 的发票上传端点可达。用一笔 B2C 订单测试。
4. 选择你的物流方案——HepsiJet 取件 vs Şubeye Bırak，加上针对不覆盖邮编的 Yurtiçi/Aras 备用。预先准备好面单和包装材料。
5. 通过 Zunapro 连接（10 分钟）——将 API 凭据粘贴到 Hepsiburada 卡片中，映射你的主目录，启用 HepsiJet 自动面单和 e-Fatura，切换上线。

Zunapro 连接流程

1. 登录 Zunapro 并打开 Turkey 模块
2. 点击“连接 Hepsiburada”——粘贴 API username、password 和 Merchant ID
3. 自动品类映射——Zunapro 的机器学习为每个主 SKU 提议叶级品类映射；点几下即可确认
4. 启用 HepsiJet 自动面单 + e-Fatura——各一个开关
5. 正式上线——一个 1,000-SKU 目录的首次 listing 同步大约 10 分钟完成；webhook 自动注册

2026 Hepsiburada 对接常见问题