抖音开放平台Logo
开发者文档
小程序
控制台
  • 行业插件介绍
  • 申请行业插件
  • 使用行业插件
  • 电商插件
  • 跳转引导
  • plugin.openEcShop
  • plugin.openEcShopCustom
  • plugin.openEcOrderDetail
  • plugin.openDouyinOrderList
  • plugin.openEcIm
  • plugin.openEcGood
  • plugin.openEcCart
  • 导购成交
  • 通用查询
  • 会员运营
  • 电商组件
    • 基础库 3.43.0.0 开始支持本接口。
    提供跳转抖音小店店铺页能力。
    支持具有小时达能力店铺，定向跳转进指定小时达店铺。

    前置条件

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

    语法

    plugin.openEcShop(options);

    参数说明

    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    shopId
    string
    --
    是
    当前小程序绑定的抖音小店 ID，可从 抖店店铺信息设置 中获得
    2.56.0.0
    storeId
    string
    --
    否
    小时达门店 ID（不同分店有不同的 ID），可从 抖店到家商家信息设置 中获得
    注意：跳转小时达店铺时该参数必传
    行业 SDK
    tabType
    number
    3
    否
    指定跳转店铺 tab 页，默认为商品 tab，tabType 合法值说明见下文
    2.56.0.0
    success
    function
    --
    否
    接口调用成功的回调函数
    2.56.0.0
    fail
    function
    --
    否
    接口调用失败的回调函数
    2.56.0.0
    complete
    function
    --
    否
    接口调用结束的回调函数（调用成功、失败都会执行）
    2.56.0.0

    tabType 合法值说明

    合法值
    说明
    最低支持版本
    1
    精选
    2.56.0.0
    2
    分类
    2.56.0.0
    3
    商品
    2.56.0.0
    4
    大促
    2.56.0.0
    5
    旧 ISV
    2.56.0.0
    6
    会员
    2.56.0.0
    7
    新 ISV
    2.56.0.0

    成功回调

    参数
    参数类型
    说明
    最低支持版本
    errMsg
    string
    回调信息
    2.56.0.0

    回调失败

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

    错误码说明

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

    代码示例

    // 代码示例
const plugin = tt.requirePlugin('tt95aee3130ae1cbe911');
Page({
  openEcShop() {
    tt.login({
      success: () => {
        plugin.openEcShop({
          shopId: '1111116433',
          tabType: 1,
          success: (res) => {
            console.log('openEcShop', res)
          },
          fail: (res) => {
            console.log("调用失败", res);
          }
        })
      },
      fail: (err) => {
        console.log(err)
      }
    })
  },
  // 跳转小时达店铺
  openHourArriveShop() {
    plugin.openEcShop({
      shopId: 'xxxxxxxx',
      storeId: 'xxxxxxxx',
      success(res){
        console.log(res)
      },
      fail(err){
        console.log(err);
      }
    });
  }
});

    Bug & Tip

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