对接1688分销严选
以下内容全部基于 2025-09 仍在执行的官方接口文档与规则，把「对接 1688 分销严选」的准入→协议→接口→价格→下单→密文→售后」全流程一次讲清，可直接照抄落地。
一、准入与协议（第一步必须先做）
角色：拥有开发能力的下游平台/ISV/ERP
签署：
登录 阿里巴巴开放平台 → 解决方案 → 订购「1688分销严选采购解决方案」
在线签署《信息共享协议》（定向邀约接口，不签无法调用）
白名单：加密下单（抖音/淘宝）需额外找运营申请白名单，目前仅白名单开放
二、核心接口一览（官方已稳定）
| 目的 | 接口英文名 | 说明 |
|---|---|---|
| 批量选货 | alibaba.distribution.yx.product.list | 返回带严选标的SKU，只含retailPrice的SKU |
| 详情查询 | alibaba.distribution.yx.product.detail | 取严选价、库存、标签、面单支持类型 |
| 下单 | alibaba.trade.fastCreateOrder | 1件/多件均支持，必须带指定flow |
| 预览价格 | alibaba.trade.preview | 校验真实成交价，避免价格漂移 |
| 订单回流 | alibaba.trade.order.get | 拉取上游发货状态+物流单号 |
三、必传字段与价格逻辑
统一用接口返回的retailPrice铺货与展示，不要改价
偏远地区（海南/内蒙古/甘青宁/新疆/西藏/港澳台/海外）（不包邮）需在详情页提前声明
严选商品按SKU维度报名，只铺有retailPrice的SKU，否则下单会失败
四、下单 flow 必须配对（否则无法享严选价）
| 严选类型 | 字段特征 | 1件 flow | 多件 flow | 混用拆单 |
|---|---|---|---|---|
| 老严选 | isPftOffer=true | ttpft | ttpft | — |
| 新严选 | isJxhyOffer=true | boutiquefenxiao | boutiquepifa | flow=fenxiao&isSplitJxhy=true |
预览订单也必须用对应flow，否则价格不一致
五、密文下单（抖音/淘宝已上线）
下游加密地址直接传入encryptOutOrderInfo（省市区明文+姓名手机脱敏）
上游自动打印「抖音/淘宝密文面单」，全程不占用解密额度
目前仅白名单ISV可调用，申请通道：对接群→提交appKey→运营开通
六、订单回流与售后
供应商发货后，运单号通过alibaba.trade.order.get实时回写下游平台
支持7天无理由，退货地址由供应商提供，平台自动退款，纠纷率不计入分销商店铺
七、常见接入坑
| 现象 | 原因 | 秒解 |
|---|---|---|
| 下单失败“无retailPrice” | 该SKU未报名严选 | 只铺retailPrice存在的SKU |
| 价格高于预期 | flow传错 | 检查isJxhyOffer字段，新严选必用boutiquefenxiao |
| 密文下单权限拒绝 | 未在白名单 | 找运营申请加密单权限 |
一句话总结
对接1688分销严选=先签协议+订购解决方案→用官方retailPrice+指定flow（boutiquefenxiao/boutiquepifa）下单→密文地址直接回流→自动发货+售后；全程按SKU维度操作，只铺有retailPrice的SKU，就能0库存、高佣金、密文发货跑通全链路。祝你对接顺利，天天爆单！