tt.confirmFulfillment

更新时间 2024-07-24 02:58:49

我的收藏

基础库 2.85.0.0 开始支持本方法

调用该 API 后，弹窗展示履约相关内容，用户点击后返回调用结果。

查看接入规范，不涉及履约流程的商品类型，无需调用该API。

最低支持版本上注明行业 SDK ，表示仅在行业 SDK 上才支持，需要在代码中配置行业 SDK 的权限：行业 SDK 的权限配置。当完成行业 SDK 的权限配置后，可通过 tt.canIUse('confirmFulfillment') 判断该 API 是否可用。

JavaScript复制
tt.confirmFulfillment(options);

object 类型，属性如下：

属性名	类型	默认值	必填	说明
serviceId	string	无	是	履约弹窗模板，不同的serviceId会对应不同的弹窗文案传参逻辑详见下文描述
orderId	string	无	是	抖音平台交易单号
toStatus	string	无	是	目标履约状态
itemOrderIdList	string[]	无	是	抖音平台item单号

serviceId信息

serviceId 的值，需根据当前订单调用tt.requestOrder时的SkuList.tagGroupId参数决定，具体关系如下：

toStatus 信息

toStatus代表用户在弹窗中点击确认后，订单将流转到的履约状态。

传参需根据当前订单的商品类型决定，具体关系如下：

订单商品类型	toStatus	含义	使用场景
普通咨询	fulfilling	履约中	业务流程由“服务开始前”流转到“服务开始中“后，引导用户通过弹窗进行确认，从而将履约状态驱动到“履约中”。
代写文书	fulfill_done	履约完成	业务流程由“服务开始中”流转到“服务结束“后，引导用户通过弹窗进行确认，从而将履约状态驱动到“履约完成”。
虚拟运营商靓号	fulfilling	履约中	业务流程由“准备发货环节”流转到“物流中“后，引导用户通过弹窗进行确认，从而将履约状态驱动到“履约中”。
三大运营商靓号
标准号卡
非标准流量卡

errNo	errMsg	说明
20000	confirmFulfillment:fail params.serviceId should be string, but got undefined	serviceId 未传。其他字段校验错误也会有类似错误信息
12001	confirmFulfillment:fail 操作过于频繁，请稍后再试	操作过于频繁，请稍后再试
10000	confirmFulfillment:fail 参数错误	参数错误
10401	confirmFulfillment:fail internal error	请求异常，可重试或升级APP
12001	confirmFulfillment:fail 操作过于频繁，请稍后再试	操作过于频繁，请稍后再试
13000	confirmFulfillment:fail 系统错误，请重试	系统错误，请重试
21550	confirmFulfillment:fail not login	请用真机调试或者参考常见问题
27017	confirmFulfillment:fail 订单存在退款记录	订单存在退款记录
27018	confirmFulfillment:fail 当前已在该指定状态,无需操作	当前已在该指定状态,无需操作
27019	confirmFulfillment:fail 当前指定状态无效,请检查参数	当前指定状态无效,请检查参数
27020	confirmFulfillment:fail 当前不允许流转到指定状态	当前不允许流转到指定状态
27021	confirmFulfillment:fail 不允许使用该方式进行调用,请检查是否使用组件或openapi	不允许使用该方式进行调用,请检查是否使用组件或openapi
27022	confirmFulfillment:fail 当前请求的订单状态不相同,请检查参数	当前请求的订单状态不相同,请检查参数