新增预订
说明:下单购买产品
请求方式:POST(HTTPS)
请求地址:https://btbapi.sctt.net/v1/booking
请求包体:
{ "trade_number":"202300036", "merchant_id":203457, "request_time":"2023-02-15 09:48:00", "sign":"EDB2682D46C15CBBF2749228B69FF20E", "isreserve":1, "language":"en-us", "booking_data":{ "product_id":6211105209, "travel_day":"2023-03-31", "total_price":16, "pickup_id":4, "dropoff_id":3, "goods_list":[ { "goods_id":5211105585, "sku_list":[ { "sku_id":521110558501, "quantity":1, "price":4 } ] } ], "booking":[ { "id":19458, "name":"", "value":"TEST TEST" }, { "id":19459, "name":"", "value":"TEST TEST" }, { "id":19461, "name":"", "value":"745756832@qq.com" }, { "id":19462, "name":"", "value":"+86 18739411685" } ], "traveler_list":[ { "sku_id":521110558501, "entry_item":[ { "id":19458, "name":"", "value":"TEST TEST" }, { "id":19459, "name":"", "value":"TEST TEST" }, { "id":19461, "name":"", "value":"745756832@qq.com" }, { "id":19462, "name":"", "value":"+86 18739411685" } ] } ], "remarks":"string" }, "subjoin":{ "processing":"", "itemid":"", "number":"", "cancel_id":null, "cancel_number":null } }
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
trade_number | 是 | string | 商户订单编号(商户订单编号不可重复) |
merchant_id | 是 | bigint | 商户编号 |
request_time | 是 | string | 请求时间,格式:“yyyy-MM-dd HH:mm:ss” |
language | 是 | string | 语言标识(en-us,zh-cn |
sign | 是 | string | 签名 |
isreserve | 否 | int | 是否预定(1-是,2-否 默认1,如果为否,下单成功后还需调用订单预定确认接口 |
booking_data | 是 | object | 预定对象 |
- product_id | 是 | bigint | 产品编号 |
- travel_day | 否 | string | 出行日(yyyy-MM-dd |
- session | 否 | string | 场次时间(例:08:00 |
- total_price | 是 | float | 订单总额 |
- pickup_id | 否 | bigint | 接送点 |
- dropoff_id | 否 | bigint | 下车点 |
- goods_list | 是 | list | 购买资源List |
- - goods_id | 是 | bigint | 资源编号 |
- - sku_list | 是 | list | SKU List |
- - - sku_id | 是 | bigint | SKU编号 |
- - - quantity | 是 | int | 数量 |
---price | 是 | float | 单价 |
- booking | 是 | list | 预订人 |
- - id | 是 | int | id |
- - name | 是 | string | 填写项标题 (有id此字段不需要赋值,没id 赋值对应标题,如:Last Name,First Name,Email,Mobile |
- - value | 是 | string | 填写值/选择值 |
- traveler_list | 否 | list | 出行人List |
- - sku_id | 是 | bigint | 出行人对应SKU CODE |
- - entry_item | 是 | list | 填写数据结构 |
- - - id | 是 | int | id |
- - - name | 是 | string | 填写项标题 (有id此字段不需要赋值,没id 赋值对应标题,如:Last Name,First Name,Email,Mobile |
- - - value | 是 | string | 填写值/选择值 |
- remarks | 否 | string | 订单备注 |
subjoin | 是 | object | 附加信息 |
- processing | 是 | string | 预定使用 |
- itemid | 是 | string | 预定使用 |
- number | 是 | string | 预定使用 |
- cancel_id | 是 | string | 取消使用 |
- cancel_number | 是 | string | 取消使用 |
返回结果:
{ "code": 0, "msg": "ok", "data": { "trade_number": "202300023", "order_code": 72302098055, "total_price": 56, "order_currency": "A$", "order_status": 2, "certificate_mode": 1, "travel_itinerary_url": "", "surplus_quota": 933.13, "cancel_type": 1, "cancels": [], "vouchers": [ { "confirmation_url": "https://sctt-image.sctt.net/ConfirmationSheet/72302098055-1676023914885.pdf", "confirm_remarks": "", "voucherlist": [ { "voucher_type": 1, "voucher_url": "https://sctt-image.sctt.net/Voucher/300529/4221116685/1671080674535.pdf", "voucher_confirmation": "", "voucher_verification": "" }, { "voucher_type": 1, "voucher_url": "https://sctt-image.sctt.net/Voucher/300529/4221116685/1671080674536.pdf", "voucher_confirmation": "", "voucher_verification": "" } ] } ] } }
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 状态码 |
msg | string | 接口返回信息 |
data | object | 接口返回数据 |
- trade_number | string | 同行订单编号 |
- order_code | bigint | 订单编号 |
- total_price | float | 总金额 |
- order_currency | string | 币种三字码 |
- order_status | int | 订单状态(1-预定等待 ,2-已确认, |
- certificate_mode | int | 凭证方式(1立刻获取、2异步获取 |
- travel_itinerary_url | string | 行程单地址 |
- surplus_quota | float | 剩余可用额度 |
- cancel_type | int | 取消类型(1-不可取消 2-人工取消退款 3-按规则取消退款 4-不可退改 5-预约前免费取消,预约后不可取消 |
- cancels | list | 取消规则 |
- - canr_type | string | 类型(1,2,3,4,5 |
- - canr_startday | string | 开始天/天前 |
- - canr_endday | string | 结束天 |
- - canr_percent | string | 值 |
- - canr_text | string | 文本说明(多语言 |
- vouchers | list | 凭证 |
- - confirmation_url | string | 确认单地址 |
- - confirm_remarks | string | 确认备注(文件,文本等 |
- - voucherlist | list | 凭证列表 |
- - - voucher_type | int | 凭证类型(1PDF,2条形码,3二维码,4确认编号,5URL |
- - - voucher_url | string | 文件地址 |
- - - voucher_confirmation | string | 确认编号 |
- - - voucher_verification | string | 验证编号 |
状态码说明:
状态码 | 说明 |
---|---|
0 | 下单成功 |
4001 | 报文错误 |
4002 | 签名错误 |
4003 | 账号停用(商户账号,商户主账号 |
7003 | 产品不存在(下架,不在售 |
7004 | 资源错误 (不存在,下架,不在售 |
7005 | sku错误(不存在,不在售 |
7006 | 产品销售价格错误(不存在,不在售 |
7007 | 日期错误(日期格式错误,请求日期周期错误 |
7008 | 填写项错误(填写项字符类型错误(填写项为英文字符),填写项为空 |
7009 | 缺少必填项 |
7010 | 产品库存不足 |
7011 | 商户额度不足 |
7013 | 此产品接送点必填 |
7014 | 预定失败 |