1688代采代购下单API全解析

1688代采代购下单API全解析：从选品到代发，跨境供应链如何跑通

做反向海淘、跨境代采的业务，最痛的不是找不到货源，而是有了货源之后，怎么把"选品—下单—代发"这条链路自动化跑起来。人工复制链接、手动填地址、一个个等客服报价的模式，在订单量上来之后会迅速崩盘。本文系统拆解 1688 代采代购下单 API 的对接思路、核心功能模块、典型场景和避坑要点，帮你判断"什么时候该上 API、怎么上、上哪一段"。

一、为什么 1688 代采代购这件事越来越火

海外买家对"中国制造"商品的需求持续走高，但 1688 本身不直接面向海外终端消费者，也不提供完善的跨境履约能力。这就催生了一批中间角色：

• 代采公司：替海外买家在 1688 上采购、集货、打包、出口
• 反向海淘独立站：搭一个中文/外文站点，让海外用户像淘宝一样下单，后端自动转 1688 采购
• 跨境 ERP / SCM 系统：帮中小卖家管理多平台选品、库存、物流

这三类业务的共同点是：订单不能靠人工一单一单处理。一天 50 单靠人能扛，一天 500 单就一定要 API 介入。这就是 1688 代采代购下单 API 的市场基础。

二、什么是 1688 代采代购下单 API

简单说，它是一组程序可调用的接口，把 1688 上"人能做的事"封装成"机器能做的事"：

人工操作	API 对应能力
在 1688 搜索关键词、挑商品	item_search / item_get 商品搜索与详情
复制商品链接、看 SKU 规格	item_sku / item_spec 规格获取
加购物车、选规格、填数量	cart_add / order_prepare 下单预处理
提交订单、选收货地址	order_create / order_pay 下单与支付
查订单状态、等发货	order_logistics 物流追踪
退款 / 售后	order_refund 售后接口

注意：1688 官方对这类接口的开放是有限度的——官方有 1688 Open Platform，但权限申请门槛较高、部分代采场景需要通过第三方数据服务商来走。这也是为什么市面上的代采 API 服务商良莠不齐，后文会展开。

三、下单 API 的核心功能模块拆解

一个完整的"代采代购下单 API"链路，至少要覆盖下面 6 个模块，缺一不可。

1. 商品搜索与详情

入口能力。给一个关键词或 1688 商品 ID，返回结构化数据：标题、价格区间、起订量、规格、主图、详情图、店铺信息。

GET /item_search?q=蓝牙耳机&page=1
GET /item_get?item_id=712345678

踩坑点：很多 API 返回的"价格"是区间价（1-99 件 / 100-999 件 / 1000+ 件），下单时按数量阶梯算。如果你的下单接口不支持按 SKU 选规格 + 选阶梯价，就会出现"搜索看到 9.9，下单时变成 19.9"的尴尬。

2. SKU 规格与库存查询

下单前必查的接口。1688 商品的 SKU 维度比淘宝复杂：颜色 + 尺码 + 容量 + 定制属性都可能组合成独立 SKU。API 必须能精确返回：

• 每个 SKU 的唯一 ID
• 每个规格组合的实际下单价
• 实时库存（很多供应商会标"9999 库存"但实际只有 200）
• 是否支持定制 / 是否需要打样

业务判断：如果一个 API 只能返回"最低价"或"主 SKU 价"，基本可以判定它不是为代采场景设计的，只能用来做选品参考，不能直接下单。

3. 购物车与下单预处理

代采业务最容易被忽略的环节。下单预处理（pre-order）的作用是：

• 校验收货地址是否在供应商发货范围
• 计算运费（1688 运费模板极其复杂，按体积、重量、地区、件数都可能不同）
• 计算优惠、满减、阶梯价后的最终金额
• 返回可用的支付方式

很多"下单失败"问题都出在这一步——地址不在范围内、运费超预期、SKU 已下架，全是预处理没做或做不好导致。

4. 下单与支付

核心接口。下完单后还要触发支付，否则订单只是"待支付"状态，供应商不会发货。支付方式一般有两种：

• 余额支付：适合代采公司，提前给供应商打款到账户，下单时扣余额
• 担保交易：通过支付宝担保下单，收货后供应商才能拿钱

代采场景下更推荐担保交易——能保护资金安全，纠纷时能退款；缺点是每单单独支付，自动化对接复杂度高。

5. 物流追踪

下单成功 ≠ 履约完成。代采公司还要追踪：

• 供应商是否真的发货了
• 发到哪个集货仓
• 集货仓是否签收
• 是否需要二次打包出口
• 国际段物流单号

一个完整的代采 API 应该支持多段物流：1688 国内段 + 集运仓段 + 国际段，而不只是返回一个快递单号。

6. 售后与退款

跨境代采的售后场景比国内电商复杂得多——海外买家收到货发现质量不行，要退；但货已经在海外，退回国内不现实。所以代采公司的售后 API 要能支持：

• 部分退款（不退货，折价赔付）
• 换货补发（重新下一单发到海外）
• 纠纷证据上传

这块功能市场上做得完整的供应商不多，选型时要重点问。

四、典型业务场景：谁在用、怎么用

场景 A：反向海淘独立站

一位海外华人想在独立站下单买 1688 上的窗帘。独立站后端的流程是：

1. 用户在站点选好 1688 商品（站点维护一份商品库，定时用 item_search 拉新）
2. 用户下单付款到独立站（用站内币种结算）
3. 独立站后端自动调用 1688 下单 API，向 1688 供应商下单
4. 收货地址填成自己的集货仓
5. 供应商发货 → 集货仓签收 → 集货仓二次打包 → 国际物流发到海外用户

这个场景下，下单 API 是核心生产力——没有它，独立站就没法做"自动化履约"，只能靠人工客服一单一单代采，规模化无望。

场景 B：代采公司 ERP

一家专做东南亚代采的公司，每天要处理 800-1500 单。客服从前端接单 → 后端去 1688 下单 → 跟物流 → 处理售后。靠人工 3 人组只能扛 200 单/天，上 API 后同样人力能扛 1500 单/天。效率提升 7 倍以上，这是 To B 业务最直接的成本结构优化。

场景 C：跨境选品 SaaS

做选品工具的开发者，不一定需要"下单"能力，但需要 item_search 和 item_get 来给客户展示 1688 货源、提供价格趋势、销量估算。这种场景下，下单 API 可以作为增值模块，按需开放给客户。

五、API 对接的技术实现示例

以一个最常见的"根据 1688 商品链接自动下单"流程为例，展示完整的对接链路。

步骤 1：解析商品链接拿到 item_id

1688 商品链接格式不统一，常见三种：

https://detail.1688.com/offer/712345678.html
https://m.1688.com/offer/712345678.html
https://qr.1688.com/s/abcdef（短链接）

短链接需要先调 expand_url 接口拿真实 URL，再正则提取 offer 后的数字 ID。

步骤 2：拉取商品详情 + SKU 列表

import requests

url = "https://api.example.com/1688/item_get"
params = {
    "item_id": "712345678",
    "fields": "title,price,skus,images,desc"
}
headers = {"Authorization": "Bearer YOUR_TOKEN"}
resp = requests.get(url, params=params, headers=headers, timeout=10)
data = resp.json()

# 关键校验：库存、起订量、规格是否齐全
skus = data.get("skus", [])
if not skus:
    # 走人工兜底，不能盲目下单
    raise Exception("SKU 列表为空，疑似商品已下架或接口异常")

步骤 3：下单预处理（运费 + 地址校验）

preorder = requests.post(
    "https://api.example.com/1688/order_prepare",
    json={
        "item_id": "712345678",
        "sku_id": skus[0]["sku_id"],
        "quantity": 10,
        "address_id": "ADDRESS_001",  # 集货仓地址
        "pay_method": "alipay担保"
    },
    headers=headers
).json()

# 校验最终金额、运费、是否可发货
total = preorder["total_amount"]
shipping = preorder["shipping_fee"]
if preorder["can_deliver"] is False:
    # 地址不在范围内，走备用供应商
    fallback_to_alternative_supplier()

步骤 4：正式下单 + 触发支付

order = requests.post(
    "https://api.example.com/1688/order_create",
    json={
        "preorder_id": preorder["preorder_id"],
        "remark": "代采订单-客户001-请发中通"
    },
    headers=headers
).json()

# 触发支付
requests.post(
    "https://api.example.com/1688/order_pay",
    json={"order_id": order["order_id"]},
    headers=headers
)

步骤 5：轮询物流状态

# 每天 cron 跑一次
logistics = requests.get(
    f"https://api.example.com/1688/order_logistics?order_id={order_id}",
    headers=headers
).json()

status = logistics["status"]
# status: unshipped / domestic_shipping / warehouse_received / international_shipping / delivered

整个流程跑通之后，前端业务方只需要给一个商品链接 + 数量 + 收货地址，后端就能自动完成下单到代发的全链路。这才是真正意义上的"代采自动化"。

六、API 选型避坑指南

市面上提供 1688 代采下单 API 的服务商鱼龙混杂，从我们对接过的客户反馈来看，最容易踩的 5 个坑：

坑 1：只覆盖搜索和详情，没有下单能力

很多 API 商家挂着"1688 全接口"的招牌，实际只有 item_search / item_get，下单、支付、物流接口根本没有。判断方法：要求对方提供 demo 跑通全链路，看是否能从下单到查物流一个 token 走到底。

坑 2：价格数据不准，“搜索看到 9.9，下单变 19.9”

原因是只返回了"最低阶梯价"或"促销价"，没有按真实 SKU + 数量算。判断方法：随机抽 20 个商品，对比 API 返回价和 1688 页面实际下单价，差异 >5% 就不能用。

坑 3：下单成功率低，失败后无重试机制

稳定的 API 下单成功率应在 95% 以上。低于这个数字的服务商，不是接口稳定性问题，是底层逻辑没做对——SKU 校验、库存预判、地址范围预处理全没做。判断方法：跑 100 单测试，看失败原因分布。如果失败原因集中在"SKU 不存在"或"地址不发货"，说明预处理根本没做。

坑 4：客服响应慢，技术问题没人接

这个不是技术问题，但对 To B 客户体验是致命的。下单 API 跑出异常时，你能不能找到一个懂技术的对接人 5 分钟内回复？很多服务商只有销售没有技术，出了问题让你提工单等 24 小时——这种在订单高峰期就是灾难。判断方法：测试期故意制造 3 个异常场景，看响应速度和解决方案质量。

坑 5：数据合规性存疑，接口随时可能挂

1688 对第三方数据抓取态度是有限的容忍。不合规的接口可能今天能用明天就被风控。判断方法：问服务商是否走 1688 Open Platform 官方授权，还是有自己的数据采集渠道。前者稳定但贵，后者便宜但风险高。建议：核心业务走官方授权接口，选品/比价场景可以用第三方接口兜底。

七、什么时候该上 API，什么时候不该上

不是所有做 1688 业务的都需要立刻上 API。判断逻辑很简单：

业务阶段	推荐方案
日订单 < 30 单，SKU 不固定	人工代采 + Excel 跟单
日订单 30-200 单，稳定品类	上搜索/详情 API，下单仍人工
日订单 200-1000 单	全链路 API 自动化，含下单
日订单 > 1000 单	全链路 + 多供应商容灾 + 客服工单 API

很多客户一上来就要"全自动化"，结果订单量没起来，API 月费把利润吃光。先用最小集 API 解决最痛的那个环节，再逐步扩展，才是 To B 业务健康的迭代节奏。

八、写在最后：代采 API 不是"接上就能赚钱"

很多人把对接 API 当成业务跑通的标志，其实它只是履约能力的底座。真正决定代采业务能不能赚钱的，是这 3 件事：

1. 供应商质量：同样的 API，背后接的是优质工厂还是二道贩子，决定了订单的履约质量和利润率
2. 集货仓能力：国内段是否高效集货、二次打包，直接影响跨境物流成本
3. 售后闭环：跨境售后没有兜底，客户复购率会断崖式下跌

API 解决的是"自动化"问题，不是"业务模式"问题。如果你已经有稳定的代采业务，想往规模化走，这时候上 API 才是真正的杠杆点。

---

关于我们：我们提供电商平台数据 API 与反向海淘独立站整体解决方案，覆盖 1688 商品搜索、SKU 查询、下单、物流、售后全链路接口，支持担保交易与余额支付双通道，已服务多家跨境代采公司、独立站和跨境 ERP 团队。

如果你正在搭建反向海淘系统或代采 ERP，想评估哪些接口适合你现在这一阶段接入、对接成本和稳定性预期如何——欢迎联系我们做一次免费的需求诊断和技术方案沟通。我们不卖标准套餐，只针对你的真实业务规模给方案。