新增预订
说明:下单购买产品
请求方式: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 预定失败