淘宝开放平台

登录
文档中心 > API类目 > 交易API

交易API

qimen.taobao.life.reservation.order.door.create (到家商品购后预约创单)

本地生活创建预约单时，外调同步给isv预约单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tb_item_id String 必须 2300953237937 淘宝商品ID
trade_no String 必须 214321453125123451 淘宝主单号，同商户下购买多商品，淘宝主单号一致
trade_sub_no String 可选 214321453125123451 淘宝子单号，同商品购买多份，淘宝子单号一致
reservation_order_id String 必须 2021052655511123 预约单号，每次预约生成的唯一ID。相同的reservation_order_id号，外部应只处理一次，因接口超时/返回可重试异常码/网络抖动等造成的失败，系统会在大约1min后重新发起同步，外部要做好幂等处理
merchant_pid String 必须 20881234567889 蚂蚁商户id，2088开头
store_id String 可选 34210948 核销店铺ID(淘侧门店ID)
shop_id String 可选 20198120431258908135 核销店铺ID(口碑门店ID)
reserve_time_list ReservationTime [] 必须
  • 最大列表长度：999
    		•  预约时间列表(上门时间或取送时间等)
    • └ type
    • String
    • 必须
    • DEFAULT
    • 预约时间类型
    • └ start_time
    • String
    • 必须
    • 2021-07-27 20:00
    • 开始时间
    • └ end_time
    • String
    • 必须
    • 2021-07-27 20:30
    • 结束时间
    address_list ReservationAddress [] 必须
  • 最大列表长度：999
    		•  预约地址列表
    • └ type
    • String
    • 必须
    • DEFAULT
    • 预约地址类型
    • └ detail_address
    • String
    • 必须
    • xx街道xx小区xxx
    • 为用户页面填写的详细地址
    • └ contact_name
    • String
    • 必须
    • 张三
    • 联系人姓名
    • └ contact_phone
    • String
    • 必须
    • 10086
    • 联系人号码
    • └ district_id_list
    • String []
    • 必须
    • 区域ID列表（省、市、区）
    • └ district_name_list
    • String []
    • 必须
    • 区域名称列表（省、市、区），与区域ID一一对应
    • └ district
    • String
    • 必须
    • 浙江省杭州市西湖区
    • 区域信息，省市区三个拼接在一起的字符串
    reservation_detail ReservationDetail 必须 预约详情
    • └ item_count
    • Number
    • 必须
    • 2
    • 预约商品份数
    • └ tb_item_name
    • String
    • 可选
    • 测试商品
    • 商品名称
    • └ single_real_amount
    • String
    • 可选
    • 99.99
    • 单份实收金额，单位元，精度2位
    • └ single_origin_amount
    • String
    • 可选
    • 99.99
    • 单份原始金额，单位分，精度2位
    • └ item_category_name
    • String
    • 可选
    • 箱包清洗
    • 商品叶子类目名称
    • └ memo
    • String
    • 可选
    • 用户备注
    • 用户备注
    • └ contact_phone
    • String
    • 必须
    • 10010
    • 联系人电话
    request_id String 必须 e98da7d2-580c-47f2-8b2f-689c2d848bf4 请求标识-外调异常重试会保持一致，建议isv对此参数做幂等处理

    响应参数

    名称 类型 示例值 描述
    biz_success Boolean true 是否成功
    error_code String SYSTEM_ERROR 错误码
    error_message String 系统错误 错误描述
    out_order_id String 123234234324 外部关联预约单ID

    请求示例

    {"merchant_pid":"20881234567889","store_id":"34210948","shop_id":"20198120431258908135","trade_sub_no":"214321453125123451","address_list":[{"contact_name":"张三","contact_phone":"10086","detail_address":"xx街道xx小区xxx","district":"浙江省杭州市西湖区","district_name_list":[""],"district_id_list":[""],"type":"DEFAULT"}],"reservation_detail":{"item_count":2,"single_real_amount":"99.99","item_category_name":"箱包清洗","contact_phone":"10010","memo":"用户备注","tb_item_name":"测试商品","single_origin_amount":"99.99"},"reserve_time_list":[{"start_time":"2021-07-27 20:00","end_time":"2021-07-27 20:30","type":"DEFAULT"}],"trade_no":"214321453125123451","tb_item_id":"2300953237937","reservation_order_id":"2021052655511123","request_id":"e98da7d2-580c-47f2-8b2f-689c2d848bf4"}

    响应示例

    {
    "biz_success":true,
    "error_code":"SYSTEM_ERROR",
    "error_message":"系统错误",
    "out_order_id":"123234234324"
}

    验签示例

    {"error_message":"Illegal request","biz_success":"false","error_code":"sign-check-failure"}

    错误码解释

    错误码 错误描述 解决方案

    API工具

    错误码查询工具 SDK下载

    FAQ

    有用( 0 ) 我要提问
    返回
    顶部