plugin.openEcOrder
收藏
我的收藏

基础库 3.43.0.0 开始支持本接口。
提供从小程序跳转到抖音小店提交订单页能力,仅支持抖音 App 和抖音极速版 App。
支持具有小时达能力店铺,定向跳转进指定小时达店铺。

前置条件

在使用电商插件中的组件和 API 前,需要对行业插件有一个基本了解,可以参考文档:行业插件介绍,然后按照以下步骤及顺序使用电商插件中的能力:
    1.参考 电商小程序接入指南 完成小程序及资质的准备;
    2.参考 申请行业插件 完成插件的申请,注意只有小程序拥有电商类目资质才可见申请入口;
    3.参考 使用行业插件 进行能力的调用;
行业插件在抖音 App 版本 31.8.0 及以上,小程序基础库版本 3.4x.0.0 及以上时支持。

语法

plugin.openEcOrder(options);

参数说明

options 为 Object 类型,属性如下:
属性名
类型
默认值
必填
说明
最低支持版本
shopId
string
--
当前小程序绑定的抖音小店 ID,可从 抖店店铺信息设置 中获得
2.44.0.0
productId
string
--
要提交订单的商品 ID,来自当前小程序绑定的抖音小店,可从 抖店商品管理模块 获得,确保商品售卖中且有库存
2.44.0.0
skuId
string
--
要提交订单的商品 SKU ID,来自当前小程序绑定的抖音小店,可从 抖店库存管理模块 获得,确保商品售卖中有库存,且 productId 与 skuId 匹配
2.44.0.0
skuAmount
number
--
要提交订单的商品 SKU 数量
2.44.0.0
success
function
--
接口调用成功的回调函数
2.44.0.0
fail
function
--
接口调用失败的回调函数
2.44.0.0
complete
function
--
接口调用结束的回调函数(调用成功、失败都会执行)
2.44.0.0

回调成功

参数为 Object 类型,属性如下:
参数
参数类型
说明
最低支持版本
errMsg
string
回调信息
2.44.0.0

回调失败

参数为 Object 类型,属性如下:
参数
参数类型
说明
最低支持版本
errNo
number
错误码
2.44.0.0
errMsg
string
错误信息
2.44.0.0

错误码说明

errNo
errMsg
说明
最低支持版本
10101
Platform auth deny
权限错误,不在白名单内
2.44.0.0
10301
The feature is only support in Douyin and DonyinLite
仅支持在抖音、抖音极速版中使用,当前 App 不支持这个功能
2.44.0.0
20000
xxx should be string, but got xxx
参数类型校验错误,请检查参数类型
2.44.0.0
21500
Invalid login status, please check login status
获取宿主登录信息失败,用户未登录
2.44.0.0
21501
Network error
网络错误,请检查网络状况
2.44.0.0
21502
Server error
服务端网关错误(如 404、502 等),请联系客服助手
2.44.0.0

代码示例

<!-- ttml --> <button type="default" size="default" bindtap="openEcOrder"> 跳转提交订单页 </button>
// js const plugin = tt.requirePlugin('tt95aee3130ae1cbe911'); Page({ openEcCart(e) { plugin.openEcOrder({ shopId: "1234354", productId: "11122", skuId: "12200", skuAmount: 2, success(res) { console.log("调用成功", res); }, fail(res) { console.log("调用失败", res); }, }); }, });

Bug & Tip

    Tip:使用该接口时需要用户身份信息,请确保在调用接口前,用户已经登录宿主 App;
    Tip:目前该接口只支持抖音 App 和抖音极速版 App,所以请在抖音 App 和抖音极速版 App 中调用。