淘宝开放平台

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

交易API

qimen.taobao.life.reservation.item.order.reserve (商品购后预约提交)

商品购后预约提交，例如用户购买体检套餐，在线预约，外调isv

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
store_id String 必须 1003494005 淘宝门店id
shop_id String 必须 2020061700077000000024295398 口碑门店id
amount String 必须 119.00 单份下单价，单位：元。举例：订单总金额100，购买2份，单份50.
reserve_end_time String 必须 2021-01-21 23:00 预约结束时间，格式：yyyy-MM-dd HH:mm
reserve_start_time String 必须 2021-01-21 00:00 预约开始时间，格式：yyyy-MM-dd HH:mm
contact Contact 必须 联系人
  • └ contact_name
  • String
  • 必须
  • 姓名
  • 联系人姓名
  • └ cert_no
  • String
  • 必须
  • 12341235
  • 身份证
  • └ contact_phone
  • String
  • 必须
  • 13866668888
  • 手机号
  • └ gender
  • String
  • 必须
  • MAN
  • 性别。枚举值：MAN：男；WOMAN：女
  • └ married
  • Boolean
  • 必须
  • true
  • 是否已婚。true/false
  • └ relation
  • String
  • 必须
  • 父母
  • 关系
trade_no String 必须 31243 订单主单号。当前长度19位，建议25位(预留6位)
tb_item_id String 必须 2300953237937 商品id。当前长度12位，建议16位(预留4位)
ticket_id String 必须 1241431 凭证ID
request_id String 必须 e98da7d2-580c-47f2-8b2f-689c2d848bf4 请求标识 用于排查问题

响应参数

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

请求示例

{"store_id":"1003494005","shop_id":"2020061700077000000024295398","amount":"119.00","reserve_end_time":"2021-01-21 23:00","reserve_start_time":"2021-01-21 00:00","contact":{"contact_name":"姓名","cert_no":"12341235","contact_phone":"13866668888","gender":"MAN","married":true,"relation":"父母"},"trade_no":"31243","tb_item_id":"2300953237937","ticket_id":"1241431","request_id":"e98da7d2-580c-47f2-8b2f-689c2d848bf4"}

响应示例

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

验签示例

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

错误码解释

错误码 错误描述 解决方案
isp.http-read-timeout

API工具

错误码查询工具 SDK下载

FAQ

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