@mongoui/skills 0.2.0 → 0.2.1

package/skills/bms-api/references/openapi.json

@@ -0,0 +1 @@
+{"openapi":"3.0.3","info":{"title":"TMC-BMS API","version":"1.4.0","description":"提供 131 个公开接口，包含 CBT 客户注册；一级分销开户仍由 Open 应用开通流程内部调用。更新供应商订单确认状态和客户机票行程单配置暂不接入。酒店支付订单按现有接入保留。调用方使用 X-OP-* 签名，下游签名由 Open 生成；Token 接口 externalUserId 为当前环境的 Open App ID；CBT 客户注册无需 token，externalUserId 为新客户管理员的外部 ID。"},"servers":[{"url":"/"}],"tags":[{"name":"员工"},{"name":"酒店财务"},{"name":"酒店订单"},{"name":"酒店报表"},{"name":"认证"},{"name":"客户管理"},{"name":"机票订单"},{"name":"机票报表"},{"name":"公共"},{"name":"平台订单与审批"},{"name":"CBT 客户注册"}],"paths":{"/openapi/v1/bms/employee/employeePage":{"post":{"operationId":"bms.postEmployeeEmployeePage","x-api-code":"bms.postEmployeeEmployeePage","x-open-platform-sort":1,"summary":"企业员工分页","description":"**接口：** `POST /bms/employee/employeePage`\n\n按企业编码、角色、邮箱、会员状态等条件分页查询客户企业员工。","tags":["员工"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-1000；不传默认 25; 不可为 null；≥ 1；≤ 1000；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":1000},"agentCode":{"type":"string","description":"企业编码","x-java-type":"String"},"roleId":{"type":"integer","description":"角色id; > 0","x-java-type":"Long","format":"int64"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"isMember":{"type":"integer","description":"是否会员，0-否，1-是; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsEmployeeEmployeePageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"userId":{"type":"integer","description":"用户ID","x-java-type":"Long","format":"int64"},"agentName":{"type":"string","description":"企业名称","x-java-type":"String"},"name":{"type":"string","description":"姓名","x-java-type":"String"},"deptName":{"type":"string","description":"部门名称","x-java-type":"String"},"roleName":{"type":"string","description":"角色名称","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"enable":{"type":"integer","description":"是否激活，0-未激活，1-已激活","x-java-type":"Integer","format":"int32"},"isMember":{"type":"integer","description":"是否会员，0-否，1-是","x-java-type":"Integer","format":"int32"},"memberValidTime":{"type":"string","description":"会员有效日期","x-java-type":"LocalDate","format":"date"},"lastLoginTime":{"type":"string","description":"上次登录时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"balance":{"type":"number","description":"余额","x-java-type":"BigDecimal"},"settlementCurrency":{"type":"integer","description":"结算币种 ID，取值参考币种列表接口","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"币种","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/employee/guestList":{"post":{"operationId":"bms.postEmployeeGuestList","x-api-code":"bms.postEmployeeGuestList","x-open-platform-sort":2,"summary":"入住人列表（兼容机票业务）","description":"**接口：** `POST /bms/employee/guestList`\n\n查询可选入住人或乘机人列表，兼容酒店和机票业务。","tags":["员工"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"keyword":{"type":"string","description":"姓名或邮箱关键字；不传默认查询该客户全部可用人员; 不传时默认值：`\"\"`","x-java-type":"String","default":""},"businessType":{"type":"integer","description":"业务类型：0-酒店业务，1-机票业务；不传默认 0; ≥ 0；≤ 1；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":1}},"required":["agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsEmployeeGuestListResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"userId":{"type":"integer","description":"用户id","x-java-type":"Long","format":"int64"},"guestId":{"type":"integer","description":"常用旅客id","x-java-type":"Integer","format":"int32"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"phoneAreaCode":{"type":"string","description":"手机号区号","x-java-type":"String"},"phone":{"type":"string","description":"手机号","x-java-type":"String"},"lastName":{"type":"string","description":"姓","x-java-type":"String"},"firstName":{"type":"string","description":"名","x-java-type":"String"},"roleId":{"type":"integer","description":"角色id","x-java-type":"Long","format":"int64"},"roleName":{"type":"string","description":"角色名称","x-java-type":"String"},"deptId":{"type":"integer","description":"组织id","x-java-type":"Integer","format":"int32"},"deptName":{"type":"string","description":"组织名称","x-java-type":"String"},"memberId":{"type":"string","description":"员工id","x-java-type":"String"},"enable":{"type":"integer","description":"是否激活，0-未激活，1-已激活","x-java-type":"Integer","format":"int32"},"lastLoginTime":{"type":"string","description":"上次登录时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"isMember":{"type":"integer","description":"是否为会员，0-否，1-是","x-java-type":"Integer","format":"int32"},"memberValidTime":{"type":"string","description":"会员过期时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"travelPolicyId":{"type":"integer","description":"差标政策id","x-java-type":"Integer","format":"int32"},"policyName":{"type":"string","description":"差标政策名称","x-java-type":"String"},"avatar":{"type":"string","description":"头像","x-java-type":"String"},"userType":{"type":"integer","description":"用户类型 0-员工 1-常用旅客","x-java-type":"Integer","format":"int32"},"keyword":{"type":"string","description":"关键字","x-java-type":"String"},"balance":{"type":"number","description":"余额","x-java-type":"BigDecimal"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"nonLegalFirstName":{"type":"string","description":"非法定姓","x-java-type":"String"},"nonLegalLastName":{"type":"string","description":"非法定名","x-java-type":"String"},"dateOfBirth":{"type":"string","description":"生日","x-java-type":"LocalDate","format":"date"},"gender":{"type":"integer","description":"性别 0-男 1-女 2-其他","x-java-type":"Integer","format":"int32"},"passengerType":{"type":"string","description":"乘客类型 PassengerTypeEnum；枚举取值：adult-成人、child-儿童、infant-婴儿","x-java-type":"String"},"userCertificate":{"type":"object","description":"用户证件","x-java-type":"UserCertificateResp","properties":{"id":{"type":"integer","description":"主键","x-java-type":"Integer","format":"int32"},"nationalityRegionCode":{"type":"string","description":"国籍/地区编码","x-java-type":"String"},"idType":{"type":"integer","description":"证件类型；枚举取值：0-中国居民身份证、1-护照、2-回乡证(港澳居民来往内地通行证)、3-台胞证(台湾居民来往大陆通行证)、4-港澳通行证(中华人民共和国往来港澳通行证)、5-台湾通行证(大陆居民往来台湾通行证)、6-港澳台居民居住证、7-中华人民共和国外国人永久居民身份证、8-政府签发证件(附照片)","x-java-type":"Integer","format":"int32"},"idNumber":{"type":"string","description":"证件号","x-java-type":"String"},"firstName":{"type":"string","description":"名","x-java-type":"String"},"lastName":{"type":"string","description":"姓","x-java-type":"String"},"placeOfIssue":{"type":"string","description":"签发地","x-java-type":"String"},"dateOfIssue":{"type":"string","description":"签发日期","x-java-type":"LocalDate","format":"date"},"dateOfExpiration":{"type":"string","description":"证件有效期","x-java-type":"LocalDate","format":"date"},"fileUrl":{"type":"string","description":"文件地址","x-java-type":"String"}}},"lineManagerUserId":{"type":"integer","description":"直属领导ID","x-java-type":"Long","format":"int64"},"lineManagerName":{"type":"string","description":"直属领导姓名","x-java-type":"String"},"lineManagerEmail":{"type":"string","description":"直属领导手机号","x-java-type":"String"}}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/noGenerateBill":{"post":{"operationId":"bms.postFinanceHotelNoGenerateBill","x-api-code":"bms.postFinanceHotelNoGenerateBill","x-open-platform-sort":3,"summary":"未出账客户账单分页","description":"**接口：** `POST /bms/finance/hotel/noGenerateBill`\n\n分页查询尚未出账客户的账单候选数据。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"searchType":{"type":"integer","description":"查询类型：0-下单日期，1-入住日期，2-离店日期；不传默认 0; 不可为 null；≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"startDate":{"type":"string","description":"开始日期","x-java-type":"String"},"endDate":{"type":"string","description":"结束日期","x-java-type":"String"}},"required":["currentPage","pageSize","searchType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceUnbilledCustomerBillPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<NoGenerateBillResp>","items":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"totalCount":{"type":"integer","description":"账单订单总数","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"账单总金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"账单币种","x-java-type":"String"},"settlementStatus":{"type":"integer","description":"账单状态，0-未出账; 对象初值：`0`","x-java-type":"Integer","format":"int32"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/generateBill":{"post":{"operationId":"bms.postFinanceHotelGenerateBill","x-api-code":"bms.postFinanceHotelGenerateBill","x-open-platform-sort":4,"summary":"生成账单","description":"**接口：** `POST /bms/finance/hotel/generateBill`\n\n按请求条件生成客户账单。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"searchType":{"type":"integer","description":"查询类型：0-下单日期，1-入住日期，2-离店日期；不传默认 0; 不可为 null；≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"startDate":{"type":"string","description":"开始日期，格式 yyyy-MM-dd; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"endDate":{"type":"string","description":"结束日期，格式 yyyy-MM-dd; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"billName":{"type":"string","description":"账单名称; 不可为空白字符串；长度/元素数：最大 200","x-java-type":"String","maxLength":200},"settlementDate":{"type":"string","description":"应结算日期; 不可为 null","x-java-type":"LocalDate","format":"date"}},"required":["agentCode","searchType","startDate","endDate","billName","settlementDate"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillGenerateResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billPage":{"post":{"operationId":"bms.postFinanceHotelBillPage","x-api-code":"bms.postFinanceHotelBillPage","x-open-platform-sort":5,"summary":"已出账账单分页","description":"**接口：** `POST /bms/finance/hotel/billPage`\n\n分页查询已经生成的账单。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"startDate":{"type":"string","description":"开始日期","x-java-type":"String"},"endDate":{"type":"string","description":"结束日期","x-java-type":"String"},"billCode":{"type":"string","description":"账单编码","x-java-type":"String"},"billStatus":{"type":"integer","description":"账单状态，0-未对账，1-对账中，2-已对账; ≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"settlementStatus":{"type":"integer","description":"0-未结算，1-已结算; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"overdue":{"type":"integer","description":"0-未逾期，1-已逾期; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceIssuedBillPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<BillResp>","items":{"type":"object","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"billCode":{"type":"string","description":"账单编码","x-java-type":"String"},"billName":{"type":"string","description":"账单名称","x-java-type":"String"},"billStatus":{"type":"integer","description":"账单状态，0-未对账，1-对账中，2-已对账","x-java-type":"Integer","format":"int32"},"isPushAgent":{"type":"integer","description":"是否推送账单给客户，0-未推送，1-已推送","x-java-type":"Integer","format":"int32"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"billAmount":{"type":"number","description":"账单金额","x-java-type":"BigDecimal"},"receiveAmount":{"type":"number","description":"账单已收金额","x-java-type":"BigDecimal"},"dueInAmount":{"type":"number","description":"账单未收金额","x-java-type":"BigDecimal"},"toBeConfirmedAmount":{"type":"number","description":"收款待确认金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"settlementStatus":{"type":"integer","description":"结算状态，0-未结算，1-已结算","x-java-type":"Integer","format":"int32"},"settlementDate":{"type":"string","description":"应结算日期","x-java-type":"LocalDate","format":"date"},"overdueDays":{"type":"integer","description":"逾期天数","x-java-type":"Integer","format":"int32"},"startDate":{"type":"string","description":"周期开始日期","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"周期结束日期","x-java-type":"LocalDate","format":"date"},"dateType":{"type":"integer","description":"日期类型：0-下单日期，1-入住日期，2-离店日期","x-java-type":"Integer","format":"int32"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billDetail":{"get":{"operationId":"bms.getFinanceHotelBillDetail","x-api-code":"bms.getFinanceHotelBillDetail","x-open-platform-sort":6,"summary":"账单详情","description":"**接口：** `GET /bms/finance/hotel/billDetail`\n\n按账单编码读取账单详情。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillDetailResp","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"billCode":{"type":"string","description":"账单编码","x-java-type":"String"},"billName":{"type":"string","description":"账单名称","x-java-type":"String"},"billStatus":{"type":"integer","description":"账单状态，0-未对账，1-对账中，2-已对账","x-java-type":"Integer","format":"int32"},"isPushAgent":{"type":"integer","description":"是否推送账单给客户，0-未推送，1-已推送","x-java-type":"Integer","format":"int32"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"billAmount":{"type":"number","description":"账单金额","x-java-type":"BigDecimal"},"receiveAmount":{"type":"number","description":"账单已收金额","x-java-type":"BigDecimal"},"dueInAmount":{"type":"number","description":"账单未收金额","x-java-type":"BigDecimal"},"toBeConfirmedAmount":{"type":"number","description":"收款待确认金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"settlementStatus":{"type":"integer","description":"结算状态，0-未结算，1-已结算","x-java-type":"Integer","format":"int32"},"settlementDate":{"type":"string","description":"应结算日期","x-java-type":"LocalDate","format":"date"},"overdueDays":{"type":"integer","description":"逾期天数","x-java-type":"Integer","format":"int32"},"startDate":{"type":"string","description":"周期开始日期","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"周期结束日期","x-java-type":"LocalDate","format":"date"},"dateType":{"type":"integer","description":"日期类型：0-下单日期，1-入住日期，2-离店日期","x-java-type":"Integer","format":"int32"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/startReconcile":{"get":{"operationId":"bms.getFinanceHotelStartReconcile","x-api-code":"bms.getFinanceHotelStartReconcile","x-open-platform-sort":7,"summary":"开始对账","description":"**接口：** `GET /bms/finance/hotel/startReconcile`\n\n将指定账单推进到对账流程；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/confirmBill":{"get":{"operationId":"bms.getFinanceHotelConfirmBill","x-api-code":"bms.getFinanceHotelConfirmBill","x-open-platform-sort":8,"summary":"确认账单","description":"**接口：** `GET /bms/finance/hotel/confirmBill`\n\n确认指定账单；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/cancelBill":{"get":{"operationId":"bms.getFinanceHotelCancelBill","x-api-code":"bms.getFinanceHotelCancelBill","x-open-platform-sort":9,"summary":"取消账单","description":"**接口：** `GET /bms/finance/hotel/cancelBill`\n\n取消指定账单；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/exportBill":{"get":{"operationId":"bms.getFinanceHotelExportBill","x-api-code":"bms.getFinanceHotelExportBill","x-open-platform-sort":10,"summary":"导出账单","description":"**接口：** `GET /bms/finance/hotel/exportBill`\n\n按账单编码及语言导出账单文件。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"language","required":false,"schema":{"type":"string","description":"语言：en-US-英文，zh-CN-中文；不传默认 en-US; 不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"}}],"responses":{"200":{"description":"文件字节；业务失败时可能返回 JSON","headers":{"Content-Disposition":{"schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}},"/openapi/v1/bms/finance/hotel/updateBillName":{"put":{"operationId":"bms.putFinanceHotelUpdateBillName","x-api-code":"bms.putFinanceHotelUpdateBillName","x-open-platform-sort":11,"summary":"修改账单名称","description":"**接口：** `PUT /bms/finance/hotel/updateBillName`\n\n修改指定账单的名称；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"billName","required":true,"schema":{"type":"string","description":"账单名称; 不可为空白字符串；长度/元素数：最大 200","x-java-type":"String","maxLength":200}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/notifyCashier":{"get":{"operationId":"bms.getFinanceHotelNotifyCashier","x-api-code":"bms.getFinanceHotelNotifyCashier","x-open-platform-sort":12,"summary":"通知收款","description":"**接口：** `GET /bms/finance/hotel/notifyCashier`\n\n通知收款人员处理指定账单，可附带备注；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"remark","required":false,"schema":{"type":"string","description":"备注; 长度/元素数：最大 500","x-java-type":"String","maxLength":500}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/agentPayRecord":{"get":{"operationId":"bms.getFinanceHotelAgentPayRecord","x-api-code":"bms.getFinanceHotelAgentPayRecord","x-open-platform-sort":13,"summary":"收款记录","description":"**接口：** `GET /bms/finance/hotel/agentPayRecord`\n\n查询指定账单对应的客户收款记录。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinancePaymentRecordResp","properties":{"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<AgentPayRecordResp>","items":{"type":"object","properties":{"settlementCode":{"type":"string","description":"结算单编码","x-java-type":"String"},"settlementAmount":{"type":"number","description":"结算金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"payType":{"type":"integer","description":"0-线下转账","x-java-type":"Integer","format":"int32"},"settlementStatus":{"type":"integer","description":"结算状态，0-未结算，1-已结算","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"}}}}},"required":["items"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/updateBillSettlementDate":{"put":{"operationId":"bms.putFinanceHotelUpdateBillSettlementDate","x-api-code":"bms.putFinanceHotelUpdateBillSettlementDate","x-open-platform-sort":14,"summary":"更新账单应结算日","description":"**接口：** `PUT /bms/finance/hotel/updateBillSettlementDate`\n\n修改指定账单的应结算日期；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"settlementDate","required":true,"schema":{"type":"string","description":"应结算日期，格式 yyyy-MM-dd; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billOrderPage":{"post":{"operationId":"bms.postFinanceHotelBillOrderPage","x-api-code":"bms.postFinanceHotelBillOrderPage","x-open-platform-sort":15,"summary":"账单明细列表分页","description":"**接口：** `POST /bms/finance/hotel/billOrderPage`\n\n分页查询已纳入账单的订单明细。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"billCode":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},"required":["currentPage","pageSize","billCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillOrderPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<BillOrderResp>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"createdDt":{"type":"string","description":"下单日期","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"cityNameCn":{"type":"string","description":"中文城市名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"guestName":{"type":"string","description":"入住人","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"nightNum":{"type":"integer","description":"夜数","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"orderAmount":{"type":"number","description":"应收金额","x-java-type":"BigDecimal"},"receiveAmount":{"type":"number","description":"已收金额; 对象初值：`BigDecimal.ZERO`","x-java-type":"BigDecimal"},"dueInAmount":{"type":"number","description":"未收金额; 对象初值：`BigDecimal.ZERO`","x-java-type":"BigDecimal"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"orderServiceFee":{"type":"number","description":"订单服务费","x-java-type":"BigDecimal"},"salesPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billOrderAddPage":{"post":{"operationId":"bms.postFinanceHotelBillOrderAddPage","x-api-code":"bms.postFinanceHotelBillOrderAddPage","x-open-platform-sort":16,"summary":"添加明细列表分页","description":"**接口：** `POST /bms/finance/hotel/billOrderAddPage`\n\n分页查询可添加到账单的订单明细。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"searchType":{"type":"integer","description":"查询类型：0-下单日期，1-入住日期，2-离店日期；不传默认 0; 不可为 null；≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"startDate":{"type":"string","description":"开始日期，格式 yyyy-MM-dd; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"endDate":{"type":"string","description":"结束日期，格式 yyyy-MM-dd; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"}},"required":["currentPage","pageSize","agentCode","searchType","startDate","endDate"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillOrderAddPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<BillOrderResp>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"createdDt":{"type":"string","description":"下单日期","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"cityNameCn":{"type":"string","description":"中文城市名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"guestName":{"type":"string","description":"入住人","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"nightNum":{"type":"integer","description":"夜数","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"orderAmount":{"type":"number","description":"应收金额","x-java-type":"BigDecimal"},"receiveAmount":{"type":"number","description":"已收金额; 对象初值：`BigDecimal.ZERO`","x-java-type":"BigDecimal"},"dueInAmount":{"type":"number","description":"未收金额; 对象初值：`BigDecimal.ZERO`","x-java-type":"BigDecimal"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"orderServiceFee":{"type":"number","description":"订单服务费","x-java-type":"BigDecimal"},"salesPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/addBillOrder":{"post":{"operationId":"bms.postFinanceHotelAddBillOrder","x-api-code":"bms.postFinanceHotelAddBillOrder","x-open-platform-sort":17,"summary":"添加明细","description":"**接口：** `POST /bms/finance/hotel/addBillOrder`\n\n将选中的订单明细添加到账单；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"billCode":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"},"orderCodeList":{"type":"array","description":"订单编码集合; 不可为空集合或空值","x-java-type":"List<@NotBlank(message = \"ORDER_CODE_NOT_EMPTY\") String>","items":{"type":"string"}}},"required":["billCode","orderCodeList"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billOrderDeletePage":{"post":{"operationId":"bms.postFinanceHotelBillOrderDeletePage","x-api-code":"bms.postFinanceHotelBillOrderDeletePage","x-open-platform-sort":18,"summary":"移除明细列表分页","description":"**接口：** `POST /bms/finance/hotel/billOrderDeletePage`\n\n分页查询可从账单移除的订单明细。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"billCode":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"},"searchType":{"type":"integer","description":"查询类型：0-下单日期，1-入住日期，2-离店日期；不传默认 0; 不可为 null；≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"startDate":{"type":"string","description":"开始日期; 正则：`^$&#124;^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^$|^\\d{4}-\\d{2}-\\d{2}$"},"endDate":{"type":"string","description":"结束日期; 正则：`^$&#124;^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^$|^\\d{4}-\\d{2}-\\d{2}$"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"}},"required":["currentPage","pageSize","billCode","searchType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillOrderRemovalPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<BillOrderResp>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"createdDt":{"type":"string","description":"下单日期","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"cityNameCn":{"type":"string","description":"中文城市名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"guestName":{"type":"string","description":"入住人","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"nightNum":{"type":"integer","description":"夜数","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"orderAmount":{"type":"number","description":"应收金额","x-java-type":"BigDecimal"},"receiveAmount":{"type":"number","description":"已收金额; 对象初值：`BigDecimal.ZERO`","x-java-type":"BigDecimal"},"dueInAmount":{"type":"number","description":"未收金额; 对象初值：`BigDecimal.ZERO`","x-java-type":"BigDecimal"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"orderServiceFee":{"type":"number","description":"订单服务费","x-java-type":"BigDecimal"},"salesPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/deleteBillOrder":{"post":{"operationId":"bms.postFinanceHotelDeleteBillOrder","x-api-code":"bms.postFinanceHotelDeleteBillOrder","x-open-platform-sort":19,"summary":"移除明细","description":"**接口：** `POST /bms/finance/hotel/deleteBillOrder`\n\n将选中的订单明细从账单移除；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"billCode":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"},"orderCodeList":{"type":"array","description":"订单编码集合; 不可为空集合或空值","x-java-type":"List<@NotBlank(message = \"ORDER_CODE_NOT_EMPTY\") String>","items":{"type":"string"}}},"required":["billCode","orderCodeList"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billOrderUpdatePage":{"post":{"operationId":"bms.postFinanceHotelBillOrderUpdatePage","x-api-code":"bms.postFinanceHotelBillOrderUpdatePage","x-open-platform-sort":20,"summary":"更新明细列表分页","description":"**接口：** `POST /bms/finance/hotel/billOrderUpdatePage`\n\n分页查询账单明细更新记录。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"billCode":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},"required":["currentPage","pageSize","billCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillOrderUpdatePageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<BillOrderUpdateLogPageResp>","items":{"type":"object","properties":{"content":{"type":"string","description":"日志内容","x-java-type":"String"},"logCode":{"type":"string","description":"日志编码","x-java-type":"String"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"logType":{"type":"integer","description":"日志类型，0-订单金额变更，1-账单明细添加，2-账单明细移除，3-账单金额更新","x-java-type":"Integer","format":"int32"},"changeBeforeAmount":{"type":"number","description":"修改前金额","x-java-type":"BigDecimal"},"changeAfterAmount":{"type":"number","description":"修改后金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/updateBillAmount":{"put":{"operationId":"bms.putFinanceHotelUpdateBillAmount","x-api-code":"bms.putFinanceHotelUpdateBillAmount","x-open-platform-sort":21,"summary":"更新账单金额","description":"**接口：** `PUT /bms/finance/hotel/updateBillAmount`\n\n更新指定账单的金额；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"billCode","required":true,"schema":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/billOrderLogPage":{"post":{"operationId":"bms.postFinanceHotelBillOrderLogPage","x-api-code":"bms.postFinanceHotelBillOrderLogPage","x-open-platform-sort":22,"summary":"账单明细日志分页","description":"**接口：** `POST /bms/finance/hotel/billOrderLogPage`\n\n分页查询账单明细操作日志。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"billCode":{"type":"string","description":"账单编码; 不可为空白字符串","x-java-type":"String"}},"required":["currentPage","pageSize","billCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceBillOrderLogPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<BillOrderLogPageResp>","items":{"type":"object","properties":{"content":{"type":"string","description":"日志内容","x-java-type":"String"},"logCode":{"type":"string","description":"日志编码","x-java-type":"String"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"logType":{"type":"integer","description":"日志类型，0-订单金额变更，1-账单明细添加，2-账单明细移除，3-账单金额更新","x-java-type":"Integer","format":"int32"},"changeBeforeAmount":{"type":"number","description":"修改前金额","x-java-type":"BigDecimal"},"changeAfterAmount":{"type":"number","description":"修改后金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/orderLockPage":{"post":{"operationId":"bms.postFinanceHotelOrderLockPage","x-api-code":"bms.postFinanceHotelOrderLockPage","x-open-platform-sort":23,"summary":"订单锁列表分页","description":"**接口：** `POST /bms/finance/hotel/orderLockPage`\n\n分页查询账单相关订单锁记录。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"isLock":{"type":"integer","description":"0-未锁定，1-已锁定; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceOrderLockPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<OrderLockResp>","items":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"createdDt":{"type":"string","description":"下单日期","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"英文房型名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"guestName":{"type":"string","description":"入住人","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"isLock":{"type":"integer","description":"0-未锁定，1-已锁定","x-java-type":"Integer","format":"int32"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/orderLockEdit":{"put":{"operationId":"bms.putFinanceHotelOrderLockEdit","x-api-code":"bms.putFinanceHotelOrderLockEdit","x-open-platform-sort":24,"summary":"开关订单锁","description":"**接口：** `PUT /bms/finance/hotel/orderLockEdit`\n\n切换指定订单的锁定状态；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"orderCode","required":true,"schema":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/settlementPage":{"post":{"operationId":"bms.postFinanceHotelSettlementPage","x-api-code":"bms.postFinanceHotelSettlementPage","x-open-platform-sort":25,"summary":"结算单列表分页","description":"**接口：** `POST /bms/finance/hotel/settlementPage`\n\n分页查询结算单。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"settlementCode":{"type":"string","description":"结算单编码","x-java-type":"String"},"settlementStatus":{"type":"integer","description":"结算状态，0-未结算，1-已结算; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"startDate":{"type":"string","description":"开始日期","x-java-type":"String"},"endDate":{"type":"string","description":"结束日期","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceSettlementPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<SettlementPageResp>","items":{"type":"object","properties":{"id":{"type":"integer","description":"记录 ID","x-java-type":"Integer","format":"int32"},"settlementCode":{"type":"string","description":"结算单编码","x-java-type":"String"},"billCode":{"type":"string","description":"账单编码","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"settlementAmount":{"type":"number","description":"结算金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"deadlineTime":{"type":"string","description":"应处理完时间","x-java-type":"String"},"overdueDays":{"type":"integer","description":"逾期天数","x-java-type":"Integer","format":"int32"},"settlementStatus":{"type":"integer","description":"0-未结算，1-已结算","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"创建时间","x-java-type":"String"},"tradingTime":{"type":"string","description":"交易时间","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"remark":{"type":"string","description":"备注","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/handleSettlement":{"post":{"operationId":"bms.postFinanceHotelHandleSettlement","x-api-code":"bms.postFinanceHotelHandleSettlement","x-open-platform-sort":26,"summary":"记账","description":"**接口：** `POST /bms/finance/hotel/handleSettlement`\n\n记录账单结算或收款记账信息；成功时 data 为 null。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"记录 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"payAccount":{"type":"string","description":"付款方账号","x-java-type":"String"},"payeeAccount":{"type":"string","description":"收款方账号","x-java-type":"String"},"settlementAmount":{"type":"number","description":"收款金额; 不可为 null","x-java-type":"BigDecimal"},"tradingTime":{"type":"string","description":"交易时间，格式 yyyy-MM-dd HH:mm:ss; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"},"serialNumber":{"type":"string","description":"流水号","x-java-type":"String"},"remark":{"type":"string","description":"备注; 长度/元素数：最大 500","x-java-type":"String","maxLength":500},"voucherList":{"type":"array","description":"付款凭证列表; 长度/元素数：最大 10","x-java-type":"List<@NotBlank(message = \"VOUCHER_URL_NOT_EMPTY\") String>","items":{"type":"string"},"maxItems":10}},"required":["id","settlementAmount","tradingTime"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/finance/hotel/settlementDetail":{"get":{"operationId":"bms.getFinanceHotelSettlementDetail","x-api-code":"bms.getFinanceHotelSettlementDetail","x-open-platform-sort":27,"summary":"结算单详情","description":"**接口：** `GET /bms/finance/hotel/settlementDetail`\n\n按结算单 ID 查询结算详情。","tags":["酒店财务"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"id","required":true,"schema":{"type":"integer","description":"结算记录 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelFinanceSettlementDetailResp","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"settlementCode":{"type":"string","description":"财务记账编码","x-java-type":"String"},"billCode":{"type":"string","description":"账单编码","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"settlementAmount":{"type":"number","description":"结算单应收金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"deadlineTime":{"type":"string","description":"截止时间","x-java-type":"String"},"overdueDays":{"type":"integer","description":"逾期天数","x-java-type":"Integer","format":"int32"},"settlementStatus":{"type":"integer","description":"结算状态，0-未结算，1-已结算","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"创建时间","x-java-type":"String"},"tradingTime":{"type":"string","description":"交易时间","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"payType":{"type":"integer","description":"0-线下转账","x-java-type":"Integer","format":"int32"},"payAccount":{"type":"string","description":"付款方账号","x-java-type":"String"},"payeeAccount":{"type":"string","description":"收款方账号","x-java-type":"String"},"serialNumber":{"type":"string","description":"流水号","x-java-type":"String"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"voucherList":{"type":"array","description":"付款凭证列表; 对象初值：`new ArrayList<>()`","x-java-type":"List<String>","items":{"type":"string"}},"updatedDt":{"type":"string","description":"更新时间","x-java-type":"String"},"updatedBy":{"type":"string","description":"更新人","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/order":{"post":{"operationId":"bms.postOrderHotelOrder","x-api-code":"bms.postOrderHotelOrder","x-open-platform-sort":28,"summary":"酒店订单列表","description":"**接口：** `POST /bms/order/hotel/order`\n\n分页查询酒店订单；控制器注入当前人员的数据范围及关联客户编码。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"searchType":{"type":"integer","description":"日期查询类型，0-下单日期，1-入住日期，2-离店日期; ≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"createBeginTime":{"type":"string","description":"下单开始时间","x-java-type":"String"},"createEndTime":{"type":"string","description":"下单结束时间","x-java-type":"String"},"guestName":{"type":"string","description":"入住人","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名","x-java-type":"String"},"supplierOrderCode":{"type":"string","description":"供应商订单号","x-java-type":"String"},"supplyOrderCode":{"type":"string","description":"供货单号","x-java-type":"String"},"hotelConfirmCode":{"type":"string","description":"酒店确认号","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"payType":{"type":"integer","description":"支付方式：支付类型：0信用卡 1挂账; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"payAtHotelFlag":{"type":"integer","description":"支付类型：0预付 1到店付; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"payStatus":{"type":"integer","description":"支付状态:0待支付 1已支付 2已取消; ≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消 4取消申请中 5待出行 6房型映射 7退房申请 8无供应商订单号 9未发单; ≥ 0；≤ 9","x-java-type":"Integer","format":"int32","minimum":0,"maximum":9},"supplyOrderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消 4待确认异常订单 5退款失败; ≥ 0；≤ 5","x-java-type":"Integer","format":"int32","minimum":0,"maximum":5},"currentPage":{"type":"integer","description":"当前页码，从 1 开始; 不可为 null；≥ 1","x-java-type":"Integer","format":"int32","minimum":1},"pageSize":{"type":"integer","description":"每页条数; 不可为 null；≥ 1；≤ 100","x-java-type":"Integer","format":"int32","minimum":1,"maximum":100},"operationId":{"type":"integer","description":"运营用户id","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id","x-java-type":"Integer","format":"int32"},"productLabel":{"type":"integer","description":"产品标签：1协议 2平台协议 3团房 4固定价协议 5折扣价协议 6打包价等，不传则不限","x-java-type":"Integer","format":"int32"},"approvalNo":{"type":"string","description":"审批单号 Approval NO，模糊查询","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelOrderListResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<SystemOrderListResp>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"createdDt":{"type":"string","description":"下单日期","x-java-type":"String"},"payType":{"type":"string","description":"支付方式：支付类型：0信用卡 1挂账","x-java-type":"String"},"payAtHotelFlag":{"type":"string","description":"支付类型：0预付 1到店付","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"payStatus":{"type":"integer","description":"支付状态:0待支付 1已支付 2已取消","x-java-type":"Integer","format":"int32"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"supplyOrderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"supplyName":{"type":"string","description":"供应商名称","x-java-type":"String"},"supplierOrderCode":{"type":"string","description":"供应商单号","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"productName":{"type":"string","description":"产品名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"guestName":{"type":"string","description":"入住人","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"nightNum":{"type":"integer","description":"夜数","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"订单金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"supplyTotalAmount":{"type":"number","description":"供应商金额","x-java-type":"BigDecimal"},"supplyCurrency":{"type":"string","description":"供应商币种","x-java-type":"String"},"rapidProcessing":{"type":"integer","description":"是否快速处理","x-java-type":"Integer","format":"int32"},"modificationStatus":{"type":"integer","description":"修改状态：0无，1取消中，2取消成功，3取消失败","x-java-type":"Integer","format":"int32"},"handleResult":{"type":"integer","description":"订单处理结果：0未处理，1已处理","x-java-type":"Integer","format":"int32"},"requestType":{"type":"integer","description":"订单申请类型，0取消单申请，1退款失败处理","x-java-type":"Integer","format":"int32"},"orderLabel":{"type":"array","description":"订单标签","x-java-type":"List<Integer>","items":{"type":"integer"}},"manualOrder":{"type":"integer","description":"是否手工单,0-否，1-是","x-java-type":"Integer","format":"int32"},"proxyBooking":{"type":"integer","description":"是否代订：0否1是","x-java-type":"Integer","format":"int32"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"countryNameCn":{"type":"string","description":"中文国家名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"cityNameCn":{"type":"string","description":"中文城市名称","x-java-type":"String"},"productNameType":{"type":"integer","description":"产品类型，0-仅房间，1-含早餐，2-免费取消，3-含早餐和免费取消","x-java-type":"Integer","format":"int32"},"productLabel":{"type":"integer","description":"产品标签：0或空-无标签 1协议 2平台协议 3团房 4固定价协议 5折扣价协议 6打包价","x-java-type":"Integer","format":"int32"},"realRoomId":{"type":"integer","description":"真实房型id","x-java-type":"Long","format":"int64"},"realRoomName":{"type":"string","description":"真实房型名称","x-java-type":"String"},"realRoomNameCn":{"type":"string","description":"中文真实房型名称","x-java-type":"String"},"orderTransactionFee":{"type":"number","description":"订单交易手续费","x-java-type":"BigDecimal"},"orderServiceFee":{"type":"number","description":"订单服务费","x-java-type":"BigDecimal"},"totalPayAmount":{"type":"number","description":"总支付金额","x-java-type":"BigDecimal"},"supplierOrderConfirmed":{"type":"boolean","description":"是否完成对供应商订单的确认：0-未确认，1-已确认","x-java-type":"Boolean"},"label":{"type":"integer","description":"标签：4-支付异常","x-java-type":"Integer","format":"int32"},"approvalNo":{"type":"string","description":"审批单号 Approval NO","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}},"get":{"operationId":"bms.getOrderHotelOrder","x-api-code":"bms.getOrderHotelOrder","x-open-platform-sort":30,"summary":"酒店订单详情","description":"**接口：** `GET /bms/order/hotel/order`\n\n按订单编码读取酒店订单详情，并附加订单备注列表。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"orderCode","required":true,"schema":{"type":"string","description":"订单编码; 不可为空白字符串；长度/元素数：最大 255","x-java-type":"String","maxLength":255}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelOrderDetailResp","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账","x-java-type":"Integer","format":"int32"},"payStatus":{"type":"integer","description":"订单支付状态：0待支付 1已支付 2已取消","x-java-type":"Integer","format":"int32"},"refundStatus":{"type":"integer","description":"退款状态，0-退款成功，1-退款失败，2-退款中","x-java-type":"Integer","format":"int32"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentId":{"type":"integer","description":"客户id","x-java-type":"Integer","format":"int32"},"confirmCode":{"type":"string","description":"酒店确认号","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号 Approval NO","x-java-type":"String"},"totalAmount":{"type":"number","description":"订单总金额","x-java-type":"BigDecimal"},"orderAmount":{"type":"number","description":"订单应收金额","x-java-type":"BigDecimal"},"orderServiceFee":{"type":"number","description":"TMC 订单服务费，无则 0","x-java-type":"BigDecimal"},"markupAmount":{"type":"number","description":"产品加幅金额（平台订单详情展示）","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"订单币种","x-java-type":"String"},"payAtHotelFee":{"type":"number","description":"到店付金额","x-java-type":"BigDecimal"},"payAtHotelCurrency":{"type":"string","description":"到店付币种","x-java-type":"String"},"modificationStatus":{"type":"integer","description":"修改状态：0无，1取消中，2取消成功，3取消失败","x-java-type":"Integer","format":"int32"},"settlementType":{"type":"integer","description":"结算方式：0月结 1半月结 2周结 3单结 4日结","x-java-type":"Integer","format":"int32"},"hotelId":{"type":"integer","description":"酒店id","x-java-type":"Long","format":"int64"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"roomId":{"type":"integer","description":"房型id","x-java-type":"Long","format":"int64"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"productName":{"type":"string","description":"产品名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"nightNum":{"type":"integer","description":"夜数","x-java-type":"Integer","format":"int32"},"contactName":{"type":"string","description":"联系人名称","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱","x-java-type":"String"},"cancellationTerm":{"type":"string","description":"取消政策","x-java-type":"String"},"otherTerm":{"type":"string","description":"其他政策","x-java-type":"String"},"arriveTime":{"type":"string","description":"到店时间","x-java-type":"String"},"productLabel":{"type":"integer","description":"产品标签：0或空-无标签1协议 2平台协议 3团房 4固定价协议 5折扣价协议 6打包价","x-java-type":"Integer","format":"int32"},"rapidProcessing":{"type":"integer","description":"快速处理标签：0/空 否 1是","x-java-type":"Integer","format":"int32"},"payAtHotelFlag":{"type":"integer","description":"是否到店付：0/空 否 1是","x-java-type":"Integer","format":"int32"},"guestList":{"type":"array","description":"入住人信息","x-java-type":"List<GuestResp>","items":{"type":"object","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"guestName":{"type":"string","description":"姓名","x-java-type":"String"},"firstName":{"type":"string","description":"名","x-java-type":"String"},"lastName":{"type":"string","description":"姓","x-java-type":"String"},"email":{"type":"string","description":"电子邮箱","x-java-type":"String"},"phoneAreaCode":{"type":"string","description":"手机号区号","x-java-type":"String"},"phone":{"type":"string","description":"电话","x-java-type":"String"},"roomNumber":{"type":"integer","description":"房间号","x-java-type":"Integer","format":"int32"},"memberId":{"type":"string","description":"员工id","x-java-type":"String"}}}},"orderProductPriceList":{"type":"array","description":"房费明细","x-java-type":"List<SystemOrderProductPriceResp>","items":{"type":"object","properties":{"roomNumber":{"type":"integer","description":"房间号","x-java-type":"int","format":"int32"},"adultQty":{"type":"integer","description":"成人数量","x-java-type":"Integer","format":"int32"},"childrenQty":{"type":"integer","description":"儿童数量","x-java-type":"Integer","format":"int32"},"roomPersons":{"type":"string","description":"入住人信息","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"payAtHotelFee":{"type":"number","description":"到店付金额","x-java-type":"BigDecimal"},"payAtHotelCurrency":{"type":"string","description":"到店付币种","x-java-type":"String"},"priceItemList":{"type":"array","description":"价格明细列表","x-java-type":"List<PriceItem>","items":{"type":"object","properties":{"saleDate":{"type":"string","description":"日期","x-java-type":"String"},"salePrice":{"type":"number","description":"售价","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"roomPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"},"roomMarkupAmount":{"type":"number","description":"该晚产品加幅金额","x-java-type":"BigDecimal"},"totalTax":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"timeTax":{"type":"number","description":"按次税费","x-java-type":"BigDecimal"},"timeTaxDetail":{"type":"object","description":"按次税费明细","x-java-type":"TotalTax","properties":{"currency":{"type":"string","description":"币种","x-java-type":"String"},"tax":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"saleTax":{"type":"number","description":"销售税","x-java-type":"BigDecimal"},"otherTax":{"type":"number","description":"其他税","x-java-type":"BigDecimal"}}},"totalTaxDetail":{"type":"object","description":"税费明细","x-java-type":"TotalTax","properties":{"currency":{"type":"string","description":"币种","x-java-type":"String"},"tax":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"saleTax":{"type":"number","description":"销售税","x-java-type":"BigDecimal"},"otherTax":{"type":"number","description":"其他税","x-java-type":"BigDecimal"}}},"breakfastQty":{"type":"integer","description":"早餐数量","x-java-type":"Integer","format":"int32"},"basePriceCurrency":{"type":"string","description":"底价币种","x-java-type":"String"},"basePrice":{"type":"number","description":"底价","x-java-type":"BigDecimal"},"discount":{"type":"number","description":"折扣","x-java-type":"BigDecimal"}}}}},"required":["roomNumber"]}},"supplyOrderStatus":{"type":"integer","description":"供货单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"supplySendStatus":{"type":"integer","description":"发单状态: 0未发单 1已发单 2已重发预定单 3已发取消单","x-java-type":"Integer","format":"int32"},"supplyOrderCode":{"type":"string","description":"供货单号","x-java-type":"String"},"supplierOrderCode":{"type":"string","description":"供应商订单号","x-java-type":"String"},"SupplyConfirmCode":{"type":"string","description":"供应商酒店确认号","x-java-type":"String"},"supplyPayAtHotelFee":{"type":"number","description":"供应商到店付","x-java-type":"BigDecimal"},"supplyPayAtHotelCurrency":{"type":"string","description":"供应商到店另付","x-java-type":"String"},"supplyTotalAmount":{"type":"number","description":"供货单金额","x-java-type":"BigDecimal"},"supplyOrderProductPriceRespList":{"type":"array","description":"供应商房费明细","x-java-type":"List<SupplyOrderProductPriceResp>","items":{"type":"object","properties":{"roomNumber":{"type":"integer","description":"房间号","x-java-type":"int","format":"int32"},"adultQty":{"type":"integer","description":"成人数量","x-java-type":"Integer","format":"int32"},"childrenQty":{"type":"integer","description":"儿童数量","x-java-type":"Integer","format":"int32"},"roomPersons":{"type":"string","description":"入住人信息","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"payAtHotelFee":{"type":"number","description":"到店付金额","x-java-type":"BigDecimal"},"payAtHotelCurrency":{"type":"string","description":"到店付币种","x-java-type":"String"},"priceItemList":{"type":"array","description":"价格明细列表","x-java-type":"List<PriceItem>","items":{"type":"object","properties":{"saleDate":{"type":"string","description":"日期","x-java-type":"String"},"salePrice":{"type":"number","description":"售价","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"roomPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"},"roomMarkupAmount":{"type":"number","description":"该晚产品加幅金额","x-java-type":"BigDecimal"},"totalTax":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"timeTax":{"type":"number","description":"按次税费","x-java-type":"BigDecimal"},"timeTaxDetail":{"type":"object","description":"按次税费明细","x-java-type":"TotalTax","properties":{"currency":{"type":"string","description":"币种","x-java-type":"String"},"tax":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"saleTax":{"type":"number","description":"销售税","x-java-type":"BigDecimal"},"otherTax":{"type":"number","description":"其他税","x-java-type":"BigDecimal"}}},"totalTaxDetail":{"type":"object","description":"税费明细","x-java-type":"TotalTax","properties":{"currency":{"type":"string","description":"币种","x-java-type":"String"},"tax":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"saleTax":{"type":"number","description":"销售税","x-java-type":"BigDecimal"},"otherTax":{"type":"number","description":"其他税","x-java-type":"BigDecimal"}}},"breakfastQty":{"type":"integer","description":"早餐数量","x-java-type":"Integer","format":"int32"},"basePriceCurrency":{"type":"string","description":"底价币种","x-java-type":"String"},"basePrice":{"type":"number","description":"底价","x-java-type":"BigDecimal"},"discount":{"type":"number","description":"折扣","x-java-type":"BigDecimal"}}}}},"required":["roomNumber"]}},"adultQty":{"type":"integer","description":"成人数","x-java-type":"Integer","format":"int32"},"childrenQty":{"type":"integer","description":"儿童数","x-java-type":"Integer","format":"int32"},"guestName":{"type":"string","description":"客人姓名","x-java-type":"String"},"orderLogRespList":{"type":"array","description":"订单操作日志","x-java-type":"List<OrderLogResp>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"logCode":{"type":"string","description":"日志编码","x-java-type":"String"},"content":{"type":"string","description":"操作内容","x-java-type":"String"},"startStatus":{"type":"integer","description":"订单状态改变之前的状态；枚举取值：按日志类型区分：订单状态（0-待确认、1-已确认、2-已完成、3-已取消）；支付状态（0-待支付、1-已支付、2-已取消、3-支付失败、4-退款成功、5-退款失败）","x-java-type":"Integer","format":"int32"},"endStatus":{"type":"integer","description":"订单状态改变之后的状态；枚举取值：按日志类型区分：订单状态（0-待确认、1-已确认、2-已完成、3-已取消）；支付状态（0-待支付、1-已支付、2-已取消、3-支付失败、4-退款成功、5-退款失败）","x-java-type":"Integer","format":"int32"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"username":{"type":"string","description":"姓名","x-java-type":"String"},"amount":{"type":"string","description":"金额","x-java-type":"String"},"ext":{"type":"string","description":"扩展字段","x-java-type":"String"},"logValue":{"type":"string","description":"数据值","x-java-type":"String"},"logValues":{"type":"array","description":"值列表","x-java-type":"List<String>","items":{"type":"string"}}}}},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"},"unsubscribeFee":{"type":"number","description":"退订费","x-java-type":"BigDecimal"},"telephone":{"type":"string","description":"酒店电话","x-java-type":"String"},"breakfastQty":{"type":"integer","description":"早餐数量","x-java-type":"Integer","format":"int32"},"treatOrderInfoList":{"type":"array","description":"订单详情提示信息","x-java-type":"List<TreatOrderInfo>","items":{"type":"object","properties":{"requestId":{"type":"integer","description":"处理请求id","x-java-type":"Integer","format":"int32"},"requestType":{"type":"integer","description":"订单申请类型，0取消单申请，1退款失败处理","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"时间：为空不展示，不为空展示取消描述; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"},"remark":{"type":"string","description":"备注","x-java-type":"String"}}}},"cancelReason":{"type":"integer","description":"取消原因；枚举取值：0-行程变更、1-支付失败、2-酒店位置不合适、3-不愿告知原因、4-错误预订、5-不可力抗因素、6-通过其他途径预订、7-支付超时、8-审批被拒绝","x-java-type":"Integer","format":"int32"},"refundAmount":{"type":"number","description":"订单实退金额","x-java-type":"BigDecimal"},"refundLogList":{"type":"array","description":"退款记录","x-java-type":"List<OrderRefundLog>","items":{"type":"object","properties":{"refundType":{"type":"integer","description":"退款类型，0-线上退款，1-线下协商退款","x-java-type":"Integer","format":"int32"},"refundStatus":{"type":"integer","description":"退款状态，0-退款成功，1-退款失败，2-退款中","x-java-type":"Integer","format":"int32"},"tradingDate":{"type":"string","description":"退款时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"amount":{"type":"number","description":"退款金额","x-java-type":"BigDecimal"},"remainingAmount":{"type":"number","description":"剩余退款金额","x-java-type":"BigDecimal"},"remark":{"type":"string","description":"退款原因","x-java-type":"String"}}}},"cancelPenalties":{"type":"array","description":"取消罚金","x-java-type":"List<OrderCancelPenalties>","items":{"type":"object","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"penaltiesType":{"type":"integer","description":"罚金类型 1. *晚 2. 固定金额 3. 百分比 4. 首晚百分比","x-java-type":"Integer","format":"int32"},"startDate":{"type":"string","description":"开始时间 yyyy-MM-dd'T'HH:mm:ss.SSSXXX 带有时区偏移量的日期时间字符串 酒店当地时间","x-java-type":"String"},"endData":{"type":"string","description":"结束时间 yyyy-MM-dd'T'HH:mm:ss.SSSXXX 带有时区偏移量的日期时间字符串 酒店当地时间","x-java-type":"String"},"penaltiesValue":{"type":"string","description":"罚金值","x-java-type":"String"},"currency":{"type":"string","description":"罚金币种","x-java-type":"String"}}}},"isLock":{"type":"integer","description":"0-未锁定，1-已锁定","x-java-type":"Integer","format":"int32"},"receiveAmount":{"type":"number","description":"订单已收金额","x-java-type":"BigDecimal"},"dueInAmount":{"type":"number","description":"订单未收金额","x-java-type":"BigDecimal"},"settlementStatus":{"type":"integer","description":"0-未结算，1-已结算","x-java-type":"Integer","format":"int32"},"operationName":{"type":"string","description":"运营人员姓名","x-java-type":"String"},"operationId":{"type":"integer","description":"运营人员姓名","x-java-type":"Integer","format":"int32"},"operationEmail":{"type":"string","description":"运营人员邮箱","x-java-type":"String"},"businessId":{"type":"integer","description":"商务人员id","x-java-type":"Integer","format":"int32"},"businessName":{"type":"string","description":"商务人员姓名","x-java-type":"String"},"businessEmail":{"type":"string","description":"商务人员邮箱","x-java-type":"String"},"supplyOrderPenalty":{"type":"number","description":"供货单退订费","x-java-type":"BigDecimal"},"manualOrder":{"type":"integer","description":"是否手动下单，0-否，1-是","x-java-type":"Integer","format":"int32"},"proxyBooking":{"type":"integer","description":"是否代订：0否1是","x-java-type":"Integer","format":"int32"},"showPayButton":{"type":"integer","description":"是否显示支付按钮：0否1是","x-java-type":"Integer","format":"int32"},"supplierType":{"type":"integer","description":"供应商类型：0-SG-GLink，1-其他供应商","x-java-type":"Integer","format":"int32"},"discountAmount":{"type":"number","description":"优惠金额","x-java-type":"BigDecimal"},"ccEmail":{"type":"string","description":"抄送邮箱","x-java-type":"String"},"discount":{"type":"number","description":"折扣","x-java-type":"BigDecimal"},"productNameType":{"type":"integer","description":"产品类型：0-仅房间，1-含早餐，2-免费取消，3-含早餐和免费取消","x-java-type":"Integer","format":"int32"},"chargeNumber":{"type":"string","description":"Stripe支付交易号","x-java-type":"String"},"orderHotelPolicyRespVO":{"type":"object","description":"订单政策信息","x-java-type":"OrderHotelPolicyRespVO","properties":{"checkInTime":{"type":"string","description":"酒店规定最早入住时间","x-java-type":"String"},"checkInLateTime":{"type":"string","description":"酒店规定最晚入住时间","x-java-type":"String"},"checkOutTime":{"type":"string","description":"酒店规定最晚离店时间","x-java-type":"String"},"checkOutEarlyTime":{"type":"string","description":"酒店规定最早离店时间","x-java-type":"String"},"instructions":{"type":"string","description":"入住说明","x-java-type":"String"},"instructionsCn":{"type":"string","description":"中文入住说明","x-java-type":"String"},"specialInstructions":{"type":"string","description":"特别入住说明","x-java-type":"String"},"specialInstructionsCn":{"type":"string","description":"中文特别入住说明","x-java-type":"String"},"hotelPolicy":{"type":"string","description":"酒店政策","x-java-type":"String"},"applicableGuest":{"type":"string","description":"可接待人群，3：仅接待大陆客人；4：仅接待大陆和港澳台客人；5：全球客人；","x-java-type":"String"}}},"specialDemand":{"type":"string","description":"特殊要求，填写客人对酒店的特殊要求","x-java-type":"String"},"realRoomId":{"type":"integer","description":"真实房型 id","x-java-type":"Long","format":"int64"},"realRoomName":{"type":"string","description":"虚拟房型名称","x-java-type":"String"},"realRoomNameCn":{"type":"string","description":"中文真实房型名称","x-java-type":"String"},"membershipCardNumber":{"type":"string","description":"会员卡号","x-java-type":"String"},"showMembershipCardNumber":{"type":"integer","description":"是否可填写会员卡号","x-java-type":"Integer","format":"int32"},"orderTransactionFee":{"type":"number","description":"订单交易手续费","x-java-type":"BigDecimal"},"feeCalculationType":{"type":"string","description":"手续费计算类型：percentage-按比例、fixed-固定金额；枚举取值：percentage-按比例、fixed-固定金额","x-java-type":"String"},"feeValue":{"type":"number","description":"手续费计费值","x-java-type":"BigDecimal"},"feePayer":{"type":"string","description":"手续费承担方：customer/platform/waived","x-java-type":"String"},"percentageCalculationMode":{"type":"integer","description":"比例计算模式：reverse_gross / markup_on_base（仅按比例时有值）","x-java-type":"Integer","format":"int32"},"totalPayAmount":{"type":"number","description":"总支付金额","x-java-type":"BigDecimal"},"earlyCheckoutApplyDetail":{"type":"object","description":"退房申请详情，无则为null","x-java-type":"EarlyCheckoutApplyResp","properties":{"applyNo":{"type":"string","description":"申请单号","x-java-type":"String"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"applyTime":{"type":"string","description":"申请时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"checkoutNightCount":{"type":"integer","description":"退房晚数（所有房间之和）","x-java-type":"Integer","format":"int32"},"reason":{"type":"string","description":"退房原因","x-java-type":"String"},"checkoutVoucherList":{"type":"array","description":"退房凭证base64列表，最多3张","x-java-type":"List<String>","items":{"type":"string"}},"status":{"type":"integer","description":"申请状态 0处理中 1已通过 2已拒绝","x-java-type":"Integer","format":"int32"},"supplierTaskNo":{"type":"string","description":"供应商任务单号","x-java-type":"String"},"supplierMessage":{"type":"string","description":"供应商拒绝原因","x-java-type":"String"},"checkoutRoomList":{"type":"array","description":"退房房间明细","x-java-type":"List<EarlyCheckoutRoomItemResp>","items":{"type":"object","properties":{"roomIndex":{"type":"integer","description":"房间序号","x-java-type":"Integer","format":"int32"},"guestName":{"type":"string","description":"入住人姓名","x-java-type":"String"},"checkoutNightCount":{"type":"integer","description":"该房间退房晚数","x-java-type":"Integer","format":"int32"},"receivableRefundPrice":{"type":"number","description":"应收退款金额（房间汇总，由 o_early_checkout_apply_room_day 按日汇总）","x-java-type":"BigDecimal"},"refundPrice":{"type":"number","description":"退房手续费（房间汇总，由按日明细汇总）","x-java-type":"BigDecimal"},"refundDailyList":{"type":"array","description":"按日退款明细，每项为该房间某日的应退金额与退房手续费","x-java-type":"List<RefundDayItem>","items":{"type":"object","properties":{"refundDate":{"type":"string","description":"退款日期 yyyy-MM-dd","x-java-type":"LocalDate","format":"date"},"receivableRefundPrice":{"type":"number","description":"该日应退金额","x-java-type":"BigDecimal"},"refundPrice":{"type":"number","description":"该日退房手续费","x-java-type":"BigDecimal"}}}}}}},"refundSummary":{"type":"object","description":"退款摘要","x-java-type":"EarlyCheckoutRefundSummaryResp","properties":{"refundNo":{"type":"string","description":"退款单号","x-java-type":"String"},"refundAmount":{"type":"number","description":"退款金额","x-java-type":"BigDecimal"},"actualRefundAmount":{"type":"number","description":"实际退款金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"refundStatus":{"type":"integer","description":"退款状态 0-处理中 1-成功 2-失败","x-java-type":"Integer","format":"int32"},"refundChannel":{"type":"integer","description":"退款渠道：0-信用卡 1-额度","x-java-type":"Integer","format":"int32"},"refundTime":{"type":"string","description":"退款时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"failReason":{"type":"string","description":"退款失败原因","x-java-type":"String"}}}}},"supplierOrderConfirmed":{"type":"boolean","description":"是否完成对供应商订单的确认：0-未确认，1-已确认","x-java-type":"Boolean"},"roomTotalPrice":{"type":"number","description":"房费总金额","x-java-type":"BigDecimal"},"supplyRoomTotalPrice":{"type":"number","description":"供货单房费总金额","x-java-type":"BigDecimal"},"orderFeeAdjustment":{"type":"object","description":"订单人工展示费用详情","x-java-type":"HotelOrderFeeAdjustmentResp","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"targetType":{"type":"string","description":"调整对象：order-订单、supply-供货单","x-java-type":"String"},"targetCode":{"type":"string","description":"调整对象编号","x-java-type":"String"},"version":{"type":"integer","description":"版本号，首次调整前为0","x-java-type":"Integer","format":"int32"},"adjusted":{"type":"boolean","description":"是否已经发生过人工调整","x-java-type":"Boolean"},"adjustmentDelta":{"type":"number","description":"参与应收计算的调整差额","x-java-type":"BigDecimal"},"displayTotalAmount":{"type":"number","description":"调整后的展示总额","x-java-type":"BigDecimal"},"displayReceivableAmount":{"type":"number","description":"调整后的展示应收或应付金额","x-java-type":"BigDecimal"},"items":{"type":"array","description":"费用项列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"feeCode":{"type":"string","description":"费用编码","x-java-type":"String"},"feeName":{"type":"string","description":"费用名称","x-java-type":"String"},"feeGroup":{"type":"string","description":"费用分组：base-基础费用、additional-附加费用","x-java-type":"String"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"amount":{"type":"number","description":"金额","x-java-type":"BigDecimal"},"affectsReceivable":{"type":"boolean","description":"是否参与订单应收或供货单应付计算","x-java-type":"Boolean"},"calculationFactor":{"type":"integer","description":"汇总计算方向：1-加计、0-不计、-1-扣减","x-java-type":"Integer","format":"int32"}}}}}},"supplyFeeAdjustment":{"type":"object","description":"供货单人工展示费用详情","x-java-type":"HotelOrderFeeAdjustmentResp","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"targetType":{"type":"string","description":"调整对象：order-订单、supply-供货单","x-java-type":"String"},"targetCode":{"type":"string","description":"调整对象编号","x-java-type":"String"},"version":{"type":"integer","description":"版本号，首次调整前为0","x-java-type":"Integer","format":"int32"},"adjusted":{"type":"boolean","description":"是否已经发生过人工调整","x-java-type":"Boolean"},"adjustmentDelta":{"type":"number","description":"参与应收计算的调整差额","x-java-type":"BigDecimal"},"displayTotalAmount":{"type":"number","description":"调整后的展示总额","x-java-type":"BigDecimal"},"displayReceivableAmount":{"type":"number","description":"调整后的展示应收或应付金额","x-java-type":"BigDecimal"},"items":{"type":"array","description":"费用项列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"feeCode":{"type":"string","description":"费用编码","x-java-type":"String"},"feeName":{"type":"string","description":"费用名称","x-java-type":"String"},"feeGroup":{"type":"string","description":"费用分组：base-基础费用、additional-附加费用","x-java-type":"String"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"amount":{"type":"number","description":"金额","x-java-type":"BigDecimal"},"affectsReceivable":{"type":"boolean","description":"是否参与订单应收或供货单应付计算","x-java-type":"Boolean"},"calculationFactor":{"type":"integer","description":"汇总计算方向：1-加计、0-不计、-1-扣减","x-java-type":"Integer","format":"int32"}}}}}},"orderRemarkRespList":{"type":"array","description":"BMS订单备注列表，按最新备注优先排序","x-java-type":"List<OrderRemarkResp>","items":{"type":"object","properties":{"id":{"type":"integer","description":"备注ID","x-java-type":"Long","format":"int64"},"orderCode":{"type":"string","description":"酒店订单编码","x-java-type":"String"},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注","x-java-type":"Integer","format":"int32"},"content":{"type":"string","description":"备注内容","x-java-type":"String"},"operatorEmail":{"type":"string","description":"备注人邮箱","x-java-type":"String"},"createdDt":{"type":"string","description":"备注时间; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"}}}}},"required":["orderRemarkRespList"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemOrderStatistics":{"get":{"operationId":"bms.getOrderHotelSystemOrderStatistics","x-api-code":"bms.getOrderHotelSystemOrderStatistics","x-open-platform-sort":29,"summary":"酒店订单状态统计","description":"**接口：** `GET /bms/order/hotel/systemOrderStatistics`\n\n统计可见酒店订单的各状态数量。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelOrderStatisticsResp","properties":{"orderUpcomingOrderQty":{"type":"integer","description":"待出行订单","x-java-type":"Integer","format":"int32"},"orderPendingOrderQty":{"type":"integer","description":"待确认订单","x-java-type":"Integer","format":"int32"},"supplyPendingOrderQty":{"type":"integer","description":"待确认供货单","x-java-type":"Integer","format":"int32"},"pendingOrderErrorQty":{"type":"integer","description":"待确认异常订单","x-java-type":"Integer","format":"int32"},"toBeCancelOrderQty":{"type":"integer","description":"取消申请","x-java-type":"Integer","format":"int32"},"refundFailQty":{"type":"integer","description":"退款失败","x-java-type":"Integer","format":"int32"},"roomMappingQty":{"type":"integer","description":"Ai映射数量","x-java-type":"Integer","format":"int32"},"earlyCheckoutApplyOrderQty":{"type":"integer","description":"退房申请订单数","x-java-type":"Integer","format":"int32"},"noSupplierOrderCodeQty":{"type":"integer","description":"无供应商订单号的订单数量","x-java-type":"Integer","format":"int32"},"unsentOrderQty":{"type":"integer","description":"未发单数量","x-java-type":"Integer","format":"int32"}},"required":["orderUpcomingOrderQty","orderPendingOrderQty","supplyPendingOrderQty","pendingOrderErrorQty","toBeCancelOrderQty","refundFailQty","roomMappingQty","earlyCheckoutApplyOrderQty","noSupplierOrderCodeQty","unsentOrderQty"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/order/remark/add":{"post":{"operationId":"bms.postOrderHotelOrderRemarkAdd","x-api-code":"bms.postOrderHotelOrderRemarkAdd","x-open-platform-sort":31,"summary":"新增酒店订单备注","description":"**接口：** `POST /bms/order/hotel/order/remark/add`\n\n为酒店订单新增备注记录。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"备注目标编码：正单/改签单传订单编码，退票单传退票申请单号; 不可为空白字符串；长度/元素数：最大 255","x-java-type":"String","maxLength":255},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3},"content":{"type":"string","description":"备注内容，去除首尾空格后最大500字符; 不可为空白字符串；长度/元素数：最大 500","x-java-type":"String","maxLength":500}},"required":["orderCode","remarkType","content"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelOrderRemarkAddResp","properties":{"id":{"type":"integer","description":"备注ID","x-java-type":"Long","format":"int64"},"orderCode":{"type":"string","description":"备注目标编码：机票订单号或退票申请单号","x-java-type":"String"},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注","x-java-type":"Integer","format":"int32"},"content":{"type":"string","description":"备注内容","x-java-type":"String"},"operatorEmail":{"type":"string","description":"备注人邮箱","x-java-type":"String"},"createdDt":{"type":"string","description":"备注时间; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemCancelOrder":{"post":{"operationId":"bms.postOrderHotelSystemCancelOrder","x-api-code":"bms.postOrderHotelSystemCancelOrder","x-open-platform-sort":32,"summary":"酒店取消订单","description":"**接口：** `POST /bms/order/hotel/systemCancelOrder`\n\n平台取消酒店订单，传入取消原因及可选退订费用。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"orderCode","required":true,"schema":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"cancelReason","required":true,"schema":{"type":"integer","description":"取消原因；枚举取值：0-行程变更、1-支付失败、2-酒店位置不合适、3-不愿告知原因、4-错误预订、5-不可力抗因素、6-通过其他途径预订、7-支付超时、8-审批被拒绝; 不可为 null；≥ 0；≤ 8","x-java-type":"Integer","format":"int32","minimum":0,"maximum":8}},{"in":"query","name":"unsubscribeFee","required":false,"schema":{"type":"number","description":"退订费; ≥ 0","x-java-type":"BigDecimal","minimum":0}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelCancelOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/synOrderStatus":{"post":{"operationId":"bms.postOrderHotelSynOrderStatus","x-api-code":"bms.postOrderHotelSynOrderStatus","x-open-platform-sort":33,"summary":"酒店同步订单状态","description":"**接口：** `POST /bms/order/hotel/synOrderStatus`\n\n按供货单号同步供应商订单状态，可指定同步类型。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"supplyOrderCode","required":true,"schema":{"type":"string","description":"供货单号; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"syncType","required":false,"schema":{"type":"integer","description":"同步类型；枚举取值：0-查询同步供货单状态、1-查询同步并修改供货单状态，默认0; ≥ 0；≤ 1；不传时默认值：`0`；示例：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":1}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelSyncOrderStatusResp","properties":{"supplyOrderStatus":{"type":"integer","description":"供货单状态；枚举取值：0-待确认、1-已确认、2-已完成、3-已取消","x-java-type":"Integer","format":"int32"},"supplierOrderStatus":{"type":"integer","description":"供应商订单状态；枚举取值：0-待确认、1-已确认、2-已完成、3-已取消","x-java-type":"Integer","format":"int32"}},"required":["supplyOrderStatus","supplierOrderStatus"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemCancelSupplyOrder":{"post":{"operationId":"bms.postOrderHotelSystemCancelSupplyOrder","x-api-code":"bms.postOrderHotelSystemCancelSupplyOrder","x-open-platform-sort":34,"summary":"酒店取消供货单","description":"**接口：** `POST /bms/order/hotel/systemCancelSupplyOrder`\n\n取消指定供货单，可传入退订费用。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"supplyOrder","required":true,"schema":{"type":"string","description":"供货单号; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"unsubscribeFee","required":false,"schema":{"type":"number","description":"退订费; ≥ 0","x-java-type":"BigDecimal","minimum":0}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelCancelSupplyOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/treatOrder":{"post":{"operationId":"bms.postOrderHotelTreatOrder","x-api-code":"bms.postOrderHotelTreatOrder","x-open-platform-sort":35,"summary":"酒店处理顶部订单提示","description":"**接口：** `POST /bms/order/hotel/treatOrder`\n\n按处理请求 ID 处理订单顶部提示事项。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"requestId","required":true,"schema":{"type":"integer","description":"幂等请求ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelTreatOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemSendOrder":{"put":{"operationId":"bms.putOrderHotelSystemSendOrder","x-api-code":"bms.putOrderHotelSystemSendOrder","x-open-platform-sort":36,"summary":"酒店发预定单","description":"**接口：** `PUT /bms/order/hotel/systemSendOrder`\n\n向供应商发送酒店预订单。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"supplyOrderCode","required":true,"schema":{"type":"string","description":"供货单号; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelSendOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/hotelDetail/{hotelId}":{"get":{"operationId":"bms.getOrderHotelHotelDetailHotelId","x-api-code":"bms.getOrderHotelHotelDetailHotelId","x-open-platform-sort":37,"summary":"酒店酒店详情","description":"**接口：** `GET /bms/order/hotel/hotelDetail/{hotelId}`\n\n读取酒店详情，为订单详情或手工录单提供酒店资料。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"path","name":"hotelId","required":true,"schema":{"type":"integer","description":"酒店 ID","x-java-type":"Long","format":"int64"}},{"in":"query","name":"language","required":false,"schema":{"type":"string","description":"语言，默认 en-US; 不传时默认值：`\"en-US\"`；示例：`en-US`","x-java-type":"String","default":"en-US"}},{"in":"query","name":"agentCode","required":true,"schema":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelDetailResp","properties":{"hotelId":{"type":"integer","description":"酒店id","x-java-type":"Long","format":"int64"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"酒店中文名称","x-java-type":"String"},"address":{"type":"string","description":"酒店地址","x-java-type":"String"},"addressCn":{"type":"string","description":"酒店中文地址","x-java-type":"String"},"appearancePicUrl":{"type":"string","description":"酒店主图","x-java-type":"String"},"hotelIntroduce":{"type":"string","description":"酒店描述","x-java-type":"String"},"hotelIntroduceCn":{"type":"string","description":"酒店中文描述","x-java-type":"String"},"telephone":{"type":"string","description":"电话","x-java-type":"String"},"fax":{"type":"string","description":"传真","x-java-type":"String"},"hotelStar":{"type":"integer","description":"星级","x-java-type":"Integer","format":"int32"},"praciceDate":{"type":"string","description":"开业日期","x-java-type":"String"},"fitmentDate":{"type":"string","description":"装修日期","x-java-type":"String"},"parentHotelGroupName":{"type":"string","description":"集团名称","x-java-type":"String"},"parentHotelGroupNameCn":{"type":"string","description":"集团中文名称","x-java-type":"String"},"plateName":{"type":"string","description":"品牌名称","x-java-type":"String"},"plateNameCn":{"type":"string","description":"品牌中文名称","x-java-type":"String"},"hotelBrandCode":{"type":"string","description":"品牌码","x-java-type":"String"},"plateCode":{"type":"string","description":"集团码","x-java-type":"String"},"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"countryNameCn":{"type":"string","description":"国家中文名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"cityNameCn":{"type":"string","description":"城市中文名称","x-java-type":"String"},"cityCode":{"type":"string","description":"城市编码","x-java-type":"String"},"distinctName":{"type":"string","description":"行政区名称","x-java-type":"String"},"distinctNameCn":{"type":"string","description":"行政区中文名称","x-java-type":"String"},"businessName":{"type":"string","description":"商业区名称","x-java-type":"String"},"businessNameCn":{"type":"string","description":"商业区中文名称","x-java-type":"String"},"lngGoogle":{"type":"string","description":"谷歌经度","x-java-type":"String"},"latGoogle":{"type":"string","description":"谷歌纬度","x-java-type":"String"},"longitude":{"type":"string","description":"经度","x-java-type":"String"},"latitude":{"type":"string","description":"纬度","x-java-type":"String"},"checkInTime":{"type":"string","description":"酒店规定入住时间","x-java-type":"String"},"checkOutTime":{"type":"string","description":"酒店规定离店时间","x-java-type":"String"},"checkInLateTime":{"type":"string","description":"提前入住时间","x-java-type":"String"},"checkOutEarlyTime":{"type":"string","description":"提前离店时间","x-java-type":"String"},"roomNum":{"type":"string","description":"客房数量","x-java-type":"String"},"hotelScore":{"type":"string","description":"酒店评分","x-java-type":"String"},"hotelFacilityNew":{"type":"array","description":"设施--设施类别categoryType(1-酒店设施 2-房型设施)","x-java-type":"List<HotelFacilityNewRespVO>","items":{"type":"object","properties":{"featureId":{"type":"string","description":"设施特征 ID","x-java-type":"String"},"name":{"type":"string","description":"姓名","x-java-type":"String"},"typeCode":{"type":"string","description":"类型编码","x-java-type":"String"},"typeName":{"type":"string","description":"类型名称","x-java-type":"String"},"categoryType":{"type":"string","description":"分类类型","x-java-type":"String"},"status":{"type":"integer","description":"状态","x-java-type":"Integer","format":"int32"},"applicableRoomTypeIDs":{"type":"array","description":"适用房型 ID 列表","x-java-type":"List<ApplicableRoomTypeID>","items":{"type":"object","properties":{"roomTypeId":{"type":"integer","description":"房型 ID","x-java-type":"Long","format":"int64"},"facilityDesc":{"type":"string","description":"设施说明","x-java-type":"String"}}}},"nameCn":{"type":"string","description":"中文名称","x-java-type":"String"}}}},"hotFacility":{"type":"object","description":"热门设施","x-java-type":"HotFacility","properties":{"swimmingPool":{"type":"integer","description":"游泳池","x-java-type":"Integer","format":"int32"},"fitnessCenter":{"type":"integer","description":"健身中心","x-java-type":"Integer","format":"int32"},"spaAndWellnessCenter":{"type":"integer","description":"水疗及康体中心","x-java-type":"Integer","format":"int32"},"restaurant":{"type":"integer","description":"餐厅","x-java-type":"Integer","format":"int32"},"hourFrontDesk_24":{"type":"integer","description":"是否提供 24 小时前台服务","x-java-type":"Integer","format":"int32"},"bar":{"type":"integer","description":"酒吧","x-java-type":"Integer","format":"int32"},"freeBreakfast":{"type":"integer","description":"是否提供免费早餐","x-java-type":"Integer","format":"int32"},"parkingLot":{"type":"integer","description":"停车场","x-java-type":"Integer","format":"int32"},"freeWiFi":{"type":"integer","description":"是否提供免费无线网络","x-java-type":"Integer","format":"int32"},"petFriendly":{"type":"integer","description":"是否允许携带宠物","x-java-type":"Integer","format":"int32"},"chargingStation":{"type":"integer","description":"充电设施","x-java-type":"Integer","format":"int32"},"currencyExchange":{"type":"integer","description":"货币兑换服务","x-java-type":"Integer","format":"int32"},"meetingRoom":{"type":"integer","description":"会议室","x-java-type":"Integer","format":"int32"},"laundryFacilities":{"type":"integer","description":"洗衣设施","x-java-type":"Integer","format":"int32"},"shuttleService":{"type":"integer","description":"接送服务","x-java-type":"Integer","format":"int32"},"luggageStorage":{"type":"integer","description":"行李寄存服务","x-java-type":"Integer","format":"int32"}}},"hotelTextPolicies":{"type":"array","description":"酒店政策","x-java-type":"List<HotelTextPoliciesRespVO>","items":{"type":"object","properties":{"code":{"type":"string","description":"国籍二字码","x-java-type":"String"},"codeName":{"type":"string","description":"代码名称","x-java-type":"String"},"text":{"type":"string","description":"文本内容","x-java-type":"String"},"textCn":{"type":"string","description":"中文内容","x-java-type":"String"}}}},"applicableGuest":{"type":"string","description":"可接待人群，3：仅接待大陆客人；4：仅接待大陆和港澳台客人；5：全球客人；","x-java-type":"String"},"hotelImages":{"type":"array","description":"酒店图片","x-java-type":"List<HotelImage>","items":{"type":"object","properties":{"hotelId":{"type":"integer","description":"酒店id","x-java-type":"Long","format":"int64"},"images":{"type":"array","description":"图片列表","x-java-type":"List<Image>","items":{"type":"object","properties":{"imageId":{"type":"integer","description":"图片 ID","x-java-type":"Long","format":"int64"},"imageType":{"type":"integer","description":"图片类型","x-java-type":"Integer","format":"int32"},"isMain":{"type":"integer","description":"是否为主图","x-java-type":"Integer","format":"int32"},"url":{"type":"string","description":"链接","x-java-type":"String"}}}},"roomImages":{"type":"array","description":"房间图片数组","x-java-type":"List<RoomImage>","items":{"type":"object","properties":{"roomId":{"type":"integer","description":"房间id","x-java-type":"Long","format":"int64"},"images":{"type":"array","description":"图片列表","x-java-type":"List<Image>","items":{"type":"object","properties":{"imageId":{"type":"integer","description":"图片 ID","x-java-type":"Long","format":"int64"},"imageType":{"type":"integer","description":"图片类型","x-java-type":"Integer","format":"int32"},"isMain":{"type":"integer","description":"是否为主图","x-java-type":"Integer","format":"int32"},"url":{"type":"string","description":"链接","x-java-type":"String"}}}}}}},"meetingImages":{"type":"array","description":"会议室图片列表","x-java-type":"List<MeetingImage>","items":{"type":"object","properties":{"meetingId":{"type":"integer","description":"会议室 ID","x-java-type":"Long","format":"int64"},"images":{"type":"array","description":"图片列表","x-java-type":"List<Image>","items":{"type":"object","properties":{"imageId":{"type":"integer","description":"图片 ID","x-java-type":"Long","format":"int64"},"imageType":{"type":"integer","description":"图片类型","x-java-type":"Integer","format":"int32"},"isMain":{"type":"integer","description":"是否为主图","x-java-type":"Integer","format":"int32"},"url":{"type":"string","description":"链接","x-java-type":"String"}}}}}}}}}},"hotelCategory":{"type":"string","description":"酒店一级分类","x-java-type":"String"},"hotelSubCategory":{"type":"string","description":"酒店二级分类","x-java-type":"String"},"facilityIdentification":{"description":"设施点亮标识; 动态 JSON；DTO 未声明固定子字段，键名及层级以实际数据为准","x-java-type":"JsonNode"},"isCollect":{"type":"integer","description":"是否收藏 0-否 1-是","x-java-type":"Integer","format":"int32"},"roomInfos":{"type":"array","description":"房型信息","x-java-type":"List<RoomInfoRespVO>","items":{"type":"object","properties":{"roomId":{"type":"integer","description":"房间id","x-java-type":"Long","format":"int64"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomEngName":{"type":"string","description":"房型英文名称","x-java-type":"String"},"roomAcreage":{"type":"string","description":"房间面积","x-java-type":"String"},"roomFloor":{"type":"string","description":"所在楼层","x-java-type":"String"},"maxPerson":{"type":"integer","description":"最多入住人数","x-java-type":"Integer","format":"int32"},"maxChild":{"type":"integer","description":"最大儿童数","x-java-type":"Integer","format":"int32"},"wiredBroadnet":{"type":"integer","description":"有线宽带","x-java-type":"Integer","format":"int32"},"wirelessBroadnet":{"type":"integer","description":"无线宽带","x-java-type":"Integer","format":"int32"},"windowDetail":{"type":"integer","description":"是否含窗：0-无窗1-部分有窗2-有窗4-内窗5-天窗","x-java-type":"Integer","format":"int32"},"isAllowSmoking":{"type":"integer","description":"是否允许吸烟","x-java-type":"Integer","format":"int32"},"addBedflag":{"type":"integer","description":"是否允许加床","x-java-type":"Integer","format":"int32"},"addCribFlag":{"type":"integer","description":"是否允许加婴儿床","x-java-type":"Integer","format":"int32"},"roomBedTypeInfos":{"type":"object","description":"房间床型信息","x-java-type":"BedTypesDetails","properties":{"roomBeds":{"type":"array","description":"房间床铺列表","x-java-type":"List<RoomBed>","items":{"type":"object","properties":{"bedGroups":{"type":"array","description":"床铺组合列表","x-java-type":"List<BedGroup>","items":{"type":"object","properties":{"bedInfos":{"type":"array","description":"床型信息列表","x-java-type":"List<HotelBedInfo>","items":{"type":"object","properties":{"bedTypeCode":{"type":"string","description":"床型编码","x-java-type":"String"},"bedName":{"type":"string","description":"床铺名称","x-java-type":"String"},"bedWidth":{"type":"string","description":"床铺宽度","x-java-type":"String"},"bedNum":{"type":"string","description":"床数量","x-java-type":"String"}}}}}}},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"}}}},"livingRoomBeds":{"type":"array","description":"客厅床铺列表","x-java-type":"List<RoomBed>","items":{"type":"object","properties":{"bedGroups":{"type":"array","description":"床铺组合列表","x-java-type":"List<BedGroup>","items":{"type":"object","properties":{"bedInfos":{"type":"array","description":"床型信息列表","x-java-type":"List<HotelBedInfo>","items":{"type":"object","properties":{"bedTypeCode":{"type":"string","description":"床型编码","x-java-type":"String"},"bedName":{"type":"string","description":"床铺名称","x-java-type":"String"},"bedWidth":{"type":"string","description":"床铺宽度","x-java-type":"String"},"bedNum":{"type":"string","description":"床数量","x-java-type":"String"}}}}}}},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"}}}}}},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"}}}},"hotelLabelNameList":{"type":"array","description":"标签列表","x-java-type":"Set<String>","items":{"type":"object","properties":{}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/roomDetail/{hotelId}":{"get":{"operationId":"bms.getOrderHotelRoomDetailHotelId","x-api-code":"bms.getOrderHotelRoomDetailHotelId","x-open-platform-sort":38,"summary":"酒店房型详情","description":"**接口：** `GET /bms/order/hotel/roomDetail/{hotelId}`\n\n读取指定酒店的房型详情，可按房型 ID 查询。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"path","name":"hotelId","required":true,"schema":{"type":"integer","description":"酒店 ID","x-java-type":"Long","format":"int64"}},{"in":"query","name":"roomId","required":true,"schema":{"type":"integer","description":"房间id; 不可为 null；> 0","x-java-type":"Long","format":"int64"}},{"in":"query","name":"agentCode","required":true,"schema":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"language","required":false,"schema":{"type":"string","description":"语言，默认 en-US; 不传时默认值：`\"en-US\"`；示例：`en-US`","x-java-type":"String","default":"en-US"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelRoomDetailResp","properties":{"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"roomAcreage":{"type":"string","description":"房间面积","x-java-type":"String"},"roomFloor":{"type":"string","description":"所在楼层","x-java-type":"String"},"maxPerson":{"type":"integer","description":"最多入住人数","x-java-type":"Integer","format":"int32"},"maxChild":{"type":"integer","description":"最多入住儿童数","x-java-type":"Integer","format":"int32"},"roomBedTypeInfos":{"type":"object","description":"房间床型信息","x-java-type":"BedTypesDetails","properties":{"roomBeds":{"type":"array","description":"房间床铺列表","x-java-type":"List<RoomBed>","items":{"type":"object","properties":{"bedGroups":{"type":"array","description":"床铺组合列表","x-java-type":"List<BedGroup>","items":{"type":"object","properties":{"bedInfos":{"type":"array","description":"床型信息列表","x-java-type":"List<HotelBedInfo>","items":{"type":"object","properties":{"bedTypeCode":{"type":"string","description":"床型编码","x-java-type":"String"},"bedName":{"type":"string","description":"床铺名称","x-java-type":"String"},"bedWidth":{"type":"string","description":"床铺宽度","x-java-type":"String"},"bedNum":{"type":"string","description":"床数量","x-java-type":"String"}}}}}}},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"}}}},"livingRoomBeds":{"type":"array","description":"客厅床铺列表","x-java-type":"List<RoomBed>","items":{"type":"object","properties":{"bedGroups":{"type":"array","description":"床铺组合列表","x-java-type":"List<BedGroup>","items":{"type":"object","properties":{"bedInfos":{"type":"array","description":"床型信息列表","x-java-type":"List<HotelBedInfo>","items":{"type":"object","properties":{"bedTypeCode":{"type":"string","description":"床型编码","x-java-type":"String"},"bedName":{"type":"string","description":"床铺名称","x-java-type":"String"},"bedWidth":{"type":"string","description":"床铺宽度","x-java-type":"String"},"bedNum":{"type":"string","description":"床数量","x-java-type":"String"}}}}}}},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"}}}}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/handleRefund":{"post":{"operationId":"bms.postOrderHotelHandleRefund","x-api-code":"bms.postOrderHotelHandleRefund","x-open-platform-sort":39,"summary":"酒店手动退款","description":"**接口：** `POST /bms/order/hotel/handleRefund`\n\n人工处理酒店订单退款；成功时 data 为 null。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串；长度/元素数：最大 255","x-java-type":"String","maxLength":255},"refundReason":{"type":"string","description":"退款原因; 长度/元素数：最大 50","x-java-type":"String","maxLength":50},"fileUrl":{"type":"string","description":"附件地址","x-java-type":"String"},"refundAmount":{"type":"number","description":"退款金额，必须大于 0，且不能超过剩余可退金额; 不可为 null；> 0","x-java-type":"BigDecimal"}},"required":["orderCode","refundAmount"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemConfirmSupplyOrder":{"put":{"operationId":"bms.putOrderHotelSystemConfirmSupplyOrder","x-api-code":"bms.putOrderHotelSystemConfirmSupplyOrder","x-open-platform-sort":40,"summary":"酒店手动确认供货单","description":"**接口：** `PUT /bms/order/hotel/systemConfirmSupplyOrder`\n\n人工确认供货单，填写供应商订单号及酒店确认号；成功时 data 为 null。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"supplyOrderCode","required":true,"schema":{"type":"string","description":"供货单号; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"supplierOrderCode","required":true,"schema":{"type":"string","description":"供应商订单号; 不可为空白字符串；长度/元素数：最大 50","x-java-type":"String","maxLength":50}},{"in":"query","name":"confirmCode","required":false,"schema":{"type":"string","description":"酒店确认号; 长度/元素数：最大 200","x-java-type":"String","maxLength":200}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/updateSupplyOrderCode":{"put":{"operationId":"bms.putOrderHotelUpdateSupplyOrderCode","x-api-code":"bms.putOrderHotelUpdateSupplyOrderCode","x-open-platform-sort":41,"summary":"酒店更新供应商订单号","description":"**接口：** `PUT /bms/order/hotel/updateSupplyOrderCode`\n\n按订单编码修改供应商订单号；成功时 data 为 null。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"orderCode","required":true,"schema":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"supplierOrderCode","required":true,"schema":{"type":"string","description":"供应商订单号，最长 50 个字符; 不可为空白字符串；长度/元素数：最大 50","x-java-type":"String","maxLength":50}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/updateConfirmCode":{"put":{"operationId":"bms.putOrderHotelUpdateConfirmCode","x-api-code":"bms.putOrderHotelUpdateConfirmCode","x-open-platform-sort":42,"summary":"酒店更新酒店确认号","description":"**接口：** `PUT /bms/order/hotel/updateConfirmCode`\n\n按订单编码修改酒店确认号；成功时 data 为 null。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"orderCode","required":true,"schema":{"type":"string","description":"订单号; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"confirmCode","required":true,"schema":{"type":"string","description":"酒店确认号，最长 200 个字符; 不可为空白字符串；长度/元素数：最大 200","x-java-type":"String","maxLength":200}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/updateOrderGuest":{"post":{"operationId":"bms.postOrderHotelUpdateOrderGuest","x-api-code":"bms.postOrderHotelUpdateOrderGuest","x-open-platform-sort":43,"summary":"酒店更新订单客人信息","description":"**接口：** `POST /bms/order/hotel/updateOrderGuest`\n\n修改酒店订单的客人信息；成功时 data 为 null。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"},"guestList":{"type":"array","description":"订单客人信息，至少一人; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<GuestResp>","items":{"type":"object","properties":{"id":{"type":"integer","description":"客人主键 ID，用于定位要更新的原客人; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"firstName":{"type":"string","description":"名（英文字母，可包含空格）; 不可为空白字符串；正则：`^[A-Za-z]+(?: [A-Za-z]+)*$`","x-java-type":"String","pattern":"^[A-Za-z]+(?: [A-Za-z]+)*$"},"lastName":{"type":"string","description":"姓（英文字母，可包含空格）; 不可为空白字符串；正则：`^[A-Za-z]+(?: [A-Za-z]+)*$`","x-java-type":"String","pattern":"^[A-Za-z]+(?: [A-Za-z]+)*$"},"email":{"type":"string","description":"电子邮箱; 不可为空白字符串；邮箱格式","x-java-type":"String"},"phoneAreaCode":{"type":"string","description":"手机号区号","x-java-type":"String"},"phone":{"type":"string","description":"电话; 长度/元素数：最大 20；正则：`^\\d*$`","x-java-type":"String","pattern":"^\\d*$","maxLength":20},"roomNumber":{"type":"integer","description":"房间号; 不可为 null；> 0","x-java-type":"Integer","format":"int32"}},"required":["id","firstName","lastName","email","roomNumber"]}}},"required":["orderCode","guestList"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/addManualOrder":{"post":{"operationId":"bms.postOrderHotelAddManualOrder","x-api-code":"bms.postOrderHotelAddManualOrder","x-open-platform-sort":44,"summary":"酒店新增手工单","description":"**接口：** `POST /bms/order/hotel/addManualOrder`\n\n后台创建酒店手工单。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"supplierOrderCode":{"type":"string","description":"供应商单号; 长度/元素数：最大 50","x-java-type":"String","maxLength":50},"supplierType":{"type":"integer","description":"供应商，0-SG-GLink，1-其他供应商; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"hotelId":{"type":"integer","description":"酒店id; 不可为 null；> 0","x-java-type":"Long","format":"int64"},"roomId":{"type":"integer","description":"房间id；选择已有房型时传入，手工输入房型时可不传; > 0","x-java-type":"Long","format":"int64"},"roomName":{"type":"string","description":"房间名称; 不可为空白字符串","x-java-type":"String"},"ratePlanId":{"type":"string","description":"价格计划id；选择实时产品时传入，手工输入产品时可不传","x-java-type":"String"},"ratePlanName":{"type":"string","description":"产品名称; 不可为空白字符串","x-java-type":"String"},"breakfastNum":{"type":"integer","description":"早餐数量; 不可为 null；≥ 0","x-java-type":"Integer","format":"int32","minimum":0},"checkInDate":{"type":"string","description":"入住日期; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`；格式：`yyyy-MM-dd`；时区：GMT+8","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"checkOutDate":{"type":"string","description":"离店日期; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`；格式：`yyyy-MM-dd`；时区：GMT+8","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"roomNum":{"type":"integer","description":"房间数量; 不可为 null；≥ 1；≤ 10","x-java-type":"Integer","format":"int32","minimum":1,"maximum":10},"guestInfos":{"type":"array","description":"入住人信息; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<Guest>","items":{"type":"object","properties":{"userId":{"type":"integer","description":"用户id; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"lastName":{"type":"string","description":"入住人姓; 不可为空白字符串","x-java-type":"String"},"firstName":{"type":"string","description":"入住人名; 不可为空白字符串","x-java-type":"String"},"email":{"type":"string","description":"入住人邮箱; 邮箱格式","x-java-type":"String"},"phoneAreaCode":{"type":"string","description":"手机号区号","x-java-type":"String"},"phone":{"type":"string","description":"入住人电话; 长度/元素数：最大 20；正则：`^\\d*$`","x-java-type":"String","pattern":"^\\d*$","maxLength":20},"roomNumber":{"type":"integer","description":"入住人房间号; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"memberId":{"type":"string","description":"入住人员工id","x-java-type":"String"}},"required":["userId","lastName","firstName","roomNumber"]}},"linkMan":{"type":"string","description":"联系人姓名; 不可为空白字符串","x-java-type":"String"},"phoneAreaCode":{"type":"string","description":"手机号区号; 不可为空白字符串","x-java-type":"String"},"linkPhone":{"type":"string","description":"联系人电话; 不可为空白字符串；长度/元素数：最大 20；正则：`^\\d+$`","x-java-type":"String","pattern":"^\\d+$","maxLength":20},"email":{"type":"string","description":"联系人邮箱; 不可为空白字符串；邮箱格式","x-java-type":"String"},"orderPriceList":{"type":"array","description":"产品价格; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<OrderPrice>","items":{"type":"object","properties":{"roomNumber":{"type":"integer","description":"房间号; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"payAtHotelFee":{"type":"number","description":"到店另付金额; ≥ 0","x-java-type":"BigDecimal","minimum":0},"payAtHotelCurrency":{"type":"string","description":"到店另付币种","x-java-type":"String"},"basePriceCurrency":{"type":"string","description":"底价币种; 不可为空白字符串","x-java-type":"String"},"timeTaxFee":{"type":"number","description":"按次税费; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"systemOrderPriceItems":{"type":"array","description":"每日价格详情; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<SystemOrderPriceItem>","items":{"type":"object","properties":{"saleDate":{"type":"string","description":"售卖日期; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"salePrice":{"type":"number","description":"售价; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"basePrice":{"type":"number","description":"底价; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"roomPrice":{"type":"number","description":"房费; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"texFee":{"type":"number","description":"税费; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"discount":{"type":"number","description":"折扣; ≥ 0","x-java-type":"BigDecimal","minimum":0}},"required":["saleDate","salePrice","basePrice","roomPrice","texFee"]}}},"required":["roomNumber","basePriceCurrency","timeTaxFee","systemOrderPriceItems"]}},"payStatus":{"type":"integer","description":"支付状态：0待支付，1已支付；信用卡客户必传，挂账客户可不传; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"language":{"type":"string","description":"语言; 不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"},"productNameType":{"type":"integer","description":"产品名称类型；枚举取值：0-仅房间、1-含早餐、2-免费取消、3-含早餐和免费取消; ≥ 0；≤ 3","x-java-type":"Integer","format":"int32","minimum":0,"maximum":3}},"required":["agentCode","supplierType","hotelId","roomName","ratePlanName","breakfastNum","checkInDate","checkOutDate","roomNum","guestInfos","linkMan","phoneAreaCode","linkPhone","email","orderPriceList"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelManualOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemPayOrder":{"put":{"operationId":"bms.putOrderHotelSystemPayOrder","x-api-code":"bms.putOrderHotelSystemPayOrder","x-open-platform-sort":45,"summary":"酒店支付订单","description":"**接口：** `PUT /bms/order/hotel/systemPayOrder`\n\n平台对指定酒店订单执行支付。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"orderCode","required":true,"schema":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelPayOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/systemSendCancelOrder":{"post":{"operationId":"bms.postOrderHotelSystemSendCancelOrder","x-api-code":"bms.postOrderHotelSystemSendCancelOrder","x-open-platform-sort":46,"summary":"酒店手动发取消单","description":"**接口：** `POST /bms/order/hotel/systemSendCancelOrder`\n\n人工向供应商发送酒店取消单；手工单取消申请成功时 data 为 null，其他成功分支的 data.value 为订单编码。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"supplyOrderCode":{"type":"string","description":"供货单号; 不可为空白字符串","x-java-type":"String"},"cancelReason":{"type":"integer","description":"取消原因；枚举取值：0-行程变更、1-支付失败、2-酒店位置不合适、3-不愿告知原因、4-错误预订、5-不可力抗因素、6-通过其他途径预订、7-支付超时、8-审批被拒绝; 不可为 null；≥ 0；≤ 8","x-java-type":"Integer","format":"int32","minimum":0,"maximum":8}},"required":["supplyOrderCode","cancelReason"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelSendCancelOrderResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/hotel/destinationList":{"get":{"operationId":"bms.getOrderHotelHotelDestinationList","x-api-code":"bms.getOrderHotelHotelDestinationList","x-open-platform-sort":48,"summary":"酒店获取目的地列表","description":"**接口：** `GET /bms/order/hotel/hotel/destinationList`\n\n按关键词、目的地类型、客户及数据来源查询酒店目的地。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"keyword","required":true,"schema":{"type":"string","description":"关键字，可传空字符串查询默认列表; 不可为 null","x-java-type":"String"}},{"in":"query","name":"destinationType","required":true,"schema":{"type":"integer","description":"目的地类型：1酒店，2城市，3行政区，4商业区，5旅游区，6城市及周边，7比城市小的区，8地点/地铁站; 不可为 null；≥ 1；≤ 8","x-java-type":"Integer","format":"int32","minimum":1,"maximum":8}},{"in":"query","name":"agentCode","required":true,"schema":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"useGoogle","required":false,"schema":{"type":"integer","description":"是否使用 Google 地图数据：0否，1是；默认 0; ≥ 0；≤ 1；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":1}},{"in":"query","name":"source","required":false,"schema":{"type":"integer","description":"数据来源：0我方，1谷歌，2百度；默认 0; ≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelDestinationListResp","properties":{"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"destinationId":{"type":"string","description":"目的地id","x-java-type":"String"},"dataType":{"type":"integer","description":"目的地类型","x-java-type":"Integer","format":"int32"},"hotelId":{"type":"integer","description":"酒店id","x-java-type":"Long","format":"int64"},"name":{"type":"string","description":"名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"countryCode":{"type":"string","description":"国家代码","x-java-type":"String"},"provinceCode":{"type":"string","description":"省份代码","x-java-type":"String"},"cityCode":{"type":"string","description":"城市代码","x-java-type":"String"},"language":{"type":"string","description":"语言","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"provinceName":{"type":"string","description":"省份名称","x-java-type":"String"},"latGoogle":{"type":"number","description":"谷歌纬度","x-java-type":"BigDecimal"},"lngGoogle":{"type":"number","description":"谷歌经度","x-java-type":"BigDecimal"}}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/hotel/product/productList":{"post":{"operationId":"bms.postOrderHotelProductProductList","x-api-code":"bms.postOrderHotelProductProductList","x-open-platform-sort":49,"summary":"实时查询产品","description":"**接口：** `POST /bms/order/hotel/product/productList`\n\n按酒店产品查询条件实时获取产品，辅助手工录单。","tags":["酒店订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"hotelId":{"type":"integer","description":"酒店id; 不可为 null；> 0","x-java-type":"Long","format":"int64"},"checkInDate":{"type":"string","description":"入住日期; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"checkOutDate":{"type":"string","description":"离店日期; 不可为空白字符串；正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"roomNum":{"type":"integer","description":"房间数量; 不可为 null；≥ 1","x-java-type":"Integer","format":"int32","minimum":1},"language":{"type":"string","description":"语言; 不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"}},"required":["agentCode","hotelId","checkInDate","checkOutDate","roomNum"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelProductListResp","properties":{"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"roomId":{"type":"integer","description":"房间id","x-java-type":"Long","format":"int64"},"roomName":{"type":"string","description":"房间名称","x-java-type":"String"},"roomImage":{"type":"string","description":"房间主图","x-java-type":"String"},"products":{"type":"array","description":"产品信息","x-java-type":"List<SystemProduct>","items":{"type":"object","properties":{"ratePlanId":{"type":"string","description":"价格计划id","x-java-type":"String"},"ratePlanName":{"type":"string","description":"价格计划名称","x-java-type":"String"},"supplyCode":{"type":"string","description":"供应商编码","x-java-type":"String"},"bookType":{"type":"integer","description":"预定类型","x-java-type":"Integer","format":"int32"},"payAtHotelFlag":{"type":"integer","description":"是否到店付标志：1-是，0 或其它-否","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"roomPrice":{"type":"number","description":"订单总房费（不含税费）","x-java-type":"BigDecimal"},"avgPrice":{"type":"number","description":"平均价","x-java-type":"BigDecimal"},"supplyClass":{"type":"string","description":"供应商类型","x-java-type":"String"},"payAtHotelFee":{"type":"number","description":"到店另付费用","x-java-type":"BigDecimal"},"payAtHotelFeeCurrency":{"type":"string","description":"到店另付费用币种","x-java-type":"String"},"totalSalePrice":{"type":"number","description":"订单总价（含税费）","x-java-type":"BigDecimal"},"baseCurrency":{"type":"string","description":"供应商底价币种（面付产品才有）","x-java-type":"String"},"roomItemDetails":{"type":"array","description":"房间详情","x-java-type":"List<SystemRoomItemDetail>","items":{"type":"object","properties":{"roomIndex":{"type":"integer","description":"房间号","x-java-type":"Integer","format":"int32"},"adultNum":{"type":"integer","description":"成人数量","x-java-type":"Integer","format":"int32"},"childAges":{"type":"string","description":"儿童数量","x-java-type":"String"},"payInStoreCurrencyCode":{"type":"string","description":"到店另付币种(酒店当地币种)","x-java-type":"String"},"payInStorePrice":{"type":"number","description":"到店另付价格(酒店当地价格)","x-java-type":"BigDecimal"},"supplyPayInStoreCurrencyCode":{"type":"string","description":"供应商侧到店另付币种","x-java-type":"String"},"supplyPayInStorePrice":{"type":"number","description":"供应商侧到店另付价格","x-java-type":"BigDecimal"},"taxDetail":{"type":"object","description":"按次税费","x-java-type":"SystemTaxDetail","properties":{"roomPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"},"taxFee":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"salesTax":{"type":"number","description":"销售税费","x-java-type":"BigDecimal"},"otherTax":{"type":"number","description":"其他税费","x-java-type":"BigDecimal"}}},"priceItems":{"type":"array","description":"房间价格详情","x-java-type":"List<SystemPriceDetailItem>","items":{"type":"object","properties":{"saleDate":{"type":"string","description":"售卖日期","x-java-type":"String"},"salePrice":{"type":"number","description":"售卖价格","x-java-type":"BigDecimal"},"breakfastType":{"type":"integer","description":"早餐类型","x-java-type":"Integer","format":"int32"},"breakfastNum":{"type":"integer","description":"早餐数量","x-java-type":"Integer","format":"int32"},"bookRestrictionType":{"type":"integer","description":"预订限制类型","x-java-type":"Integer","format":"int32"},"bookRestrictionDay":{"type":"integer","description":"预订限制天数","x-java-type":"Integer","format":"int32"},"bookRestrictionTime":{"type":"string","description":"预订限制时间","x-java-type":"String"},"cancelRestrictionType":{"type":"integer","description":"取消限制类型；枚举取值：1-不可退款、2-分时段退款、3-固定时间退款","x-java-type":"Integer","format":"int32"},"cancelRestrictionDay":{"type":"integer","description":"取消限制天数","x-java-type":"Integer","format":"int32"},"cancelRestrictionTime":{"type":"string","description":"取消限制时间","x-java-type":"String"},"roomStatus":{"type":"integer","description":"房型状态","x-java-type":"Integer","format":"int32"},"quotaNum":{"type":"integer","description":"库存数量","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"售价币种","x-java-type":"String"},"basePrice":{"type":"number","description":"基础协议价","x-java-type":"BigDecimal"},"taxDetail":{"type":"object","description":"税费","x-java-type":"SystemTaxDetail","properties":{"roomPrice":{"type":"number","description":"房费","x-java-type":"BigDecimal"},"taxFee":{"type":"number","description":"税费","x-java-type":"BigDecimal"},"salesTax":{"type":"number","description":"销售税费","x-java-type":"BigDecimal"},"otherTax":{"type":"number","description":"其他税费","x-java-type":"BigDecimal"}}},"discount":{"type":"number","description":"折扣","x-java-type":"BigDecimal"}}}}}}}}}}}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/report/hotel/saleReport":{"post":{"operationId":"bms.postReportHotelSaleReport","x-api-code":"bms.postReportHotelSaleReport","x-open-platform-sort":50,"summary":"酒店销售统计报表","description":"**接口：** `POST /bms/report/hotel/saleReport`\n\n按日期、酒店、订单、客户及人员等条件分页查询酒店销售报表；注入部门数据范围。","tags":["酒店报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"searchType":{"type":"integer","description":"日期查询类型：0-下单日期，1-入住日期，2-离店日期；不传默认 0; 不可为 null；≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"createBeginTime":{"type":"string","description":"下单开始时间","x-java-type":"String"},"createEndTime":{"type":"string","description":"下单结束时间","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消; ≥ 0；≤ 3","x-java-type":"Integer","format":"int32","minimum":0,"maximum":3},"payStatus":{"type":"integer","description":"支付状态：0-待支付，1-已支付; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"confirmCode":{"type":"string","description":"酒店确认号","x-java-type":"String"},"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100}},"required":["searchType","currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelReportSalesPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FinanceListResp>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消","x-java-type":"Integer","format":"int32"},"payStatus":{"type":"integer","description":"订单支付状态：0待支付 1已支付 2已取消","x-java-type":"Integer","format":"int32"},"confirmCode":{"type":"string","description":"酒店确认号","x-java-type":"String"},"totalAmount":{"type":"number","description":"订单总金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"订单币种","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账","x-java-type":"Integer","format":"int32"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"roomName":{"type":"string","description":"房型名称","x-java-type":"String"},"roomNameCn":{"type":"string","description":"中文房型名称","x-java-type":"String"},"productName":{"type":"string","description":"产品名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"roomNum":{"type":"integer","description":"房间数量","x-java-type":"Integer","format":"int32"},"nightNum":{"type":"integer","description":"夜数","x-java-type":"Integer","format":"int32"},"isProtocol":{"type":"integer","description":"是否协议：0否 1是","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"下单日期","x-java-type":"String"},"guestName":{"type":"string","description":"入住人信息","x-java-type":"String"},"employeeId":{"type":"string","description":"入住人员工ID","x-java-type":"String"},"operationName":{"type":"string","description":"运营人员姓名","x-java-type":"String"},"businessName":{"type":"string","description":"商务人员姓名","x-java-type":"String"},"productNameType":{"type":"integer","description":"产品类型，0-仅房间，1-含早餐，2-免费取消，3-含早餐和免费取消","x-java-type":"Integer","format":"int32"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/report/hotel/saleReportExport":{"post":{"operationId":"bms.postReportHotelSaleReportExport","x-api-code":"bms.postReportHotelSaleReportExport","x-open-platform-sort":51,"summary":"酒店销售统计报表导出","description":"**接口：** `POST /bms/report/hotel/saleReportExport`\n\n导出酒店销售统计报表；请求对象为 OrderPageReqVO，与查询接口不同。","tags":["酒店报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"searchType":{"type":"integer","description":"日期查询类型：0-下单日期，1-入住日期，2-离店日期；不传默认 0; 不可为 null；≥ 0；≤ 2；不传时默认值：`0`","x-java-type":"Integer","format":"int32","default":0,"minimum":0,"maximum":2},"createBeginTime":{"type":"string","description":"下单开始时间","x-java-type":"String"},"createEndTime":{"type":"string","description":"下单结束时间","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态：0待确认 1已确认 2已完成 3已取消; ≥ 0；≤ 3","x-java-type":"Integer","format":"int32","minimum":0,"maximum":3},"payStatus":{"type":"integer","description":"支付状态：0-待支付，1-已支付; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"confirmCode":{"type":"string","description":"酒店确认号","x-java-type":"String"},"language":{"type":"string","description":"语言","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"},"deptId":{"type":"integer","description":"组织id; > 0","x-java-type":"Integer","format":"int32"}},"required":["searchType"]}}}},"responses":{"200":{"description":"文件字节；业务失败时可能返回 JSON","headers":{"Content-Disposition":{"schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}},"/openapi/v1/bms/report/hotel/transactionPage":{"post":{"operationId":"bms.postReportHotelTransactionPage","x-api-code":"bms.postReportHotelTransactionPage","x-open-platform-sort":52,"summary":"酒店财务交易分页","description":"**接口：** `POST /bms/report/hotel/transactionPage`\n\n按筛选条件分页查询酒店财务交易记录。","tags":["酒店报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"startDate":{"type":"string","description":"开始日期","x-java-type":"String"},"endDate":{"type":"string","description":"结束日期","x-java-type":"String"},"language":{"type":"string","description":"语言，英文-en-US，中文-zh-CN; 不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"},"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 15; 不可为 null；≥ 1；≤ 100；不传时默认值：`15`","x-java-type":"Integer","format":"int32","default":15,"minimum":1,"maximum":100},"deptId":{"type":"integer","description":"组织id; > 0","x-java-type":"Integer","format":"int32"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsHotelReportTransactionPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<TransactionRespVO>","items":{"type":"object","properties":{"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"hotelNameCn":{"type":"string","description":"中文酒店名称","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"cityNameCn":{"type":"string","description":"中文城市名称","x-java-type":"String"},"checkInDate":{"type":"string","description":"入住日期","x-java-type":"String"},"checkOutDate":{"type":"string","description":"离店日期","x-java-type":"String"},"guests":{"type":"string","description":"入住人姓名","x-java-type":"String"},"amount":{"type":"number","description":"交易金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"cardType":{"type":"string","description":"卡类型","x-java-type":"String"},"cardLastFourDigit":{"type":"string","description":"卡后四位","x-java-type":"String"},"tradingTime":{"type":"string","description":"交易时间","x-java-type":"String"},"transactionType":{"type":"integer","description":"交易类型，0-扣款，1-退款","x-java-type":"Integer","format":"int32"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"operationName":{"type":"string","description":"运营人员姓名","x-java-type":"String"},"businessName":{"type":"string","description":"商务人员姓名","x-java-type":"String"},"cardBodyType":{"type":"integer","description":"卡主体类型 0-公司 1-个人","x-java-type":"Integer","format":"int32"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/report/hotel/transactionExport":{"post":{"operationId":"bms.postReportHotelTransactionExport","x-api-code":"bms.postReportHotelTransactionExport","x-open-platform-sort":53,"summary":"酒店财务交易导出","description":"**接口：** `POST /bms/report/hotel/transactionExport`\n\n按筛选条件导出酒店财务交易记录。","tags":["酒店报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"hotelName":{"type":"string","description":"酒店名称","x-java-type":"String"},"startDate":{"type":"string","description":"开始日期","x-java-type":"String"},"endDate":{"type":"string","description":"结束日期","x-java-type":"String"},"language":{"type":"string","description":"语言，英文-en-US，中文-zh-CN; 不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"},"deptId":{"type":"integer","description":"组织id; > 0","x-java-type":"Integer","format":"int32"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"}}}}}},"responses":{"200":{"description":"文件字节；业务失败时可能返回 JSON","headers":{"Content-Disposition":{"schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}},"/openapi/v1/bms/auth/token":{"post":{"operationId":"bms.postAuthToken","x-api-code":"bms.postAuthToken","x-open-platform-sort":55,"summary":"换取 BMS 登录 Token","description":"**接口：** `POST /bms/auth/token`\n\n使用已启用的 BMS appId 和对接方用户 ID 换取 OpenAPI 映射 Token。appId 通过 `X-App-Id` 请求头传入。\nexternalUserId 必须等于当前环境的 Open App ID（开户时绑定的身份），token 请求头不需要传。","tags":["认证"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"externalUserId":{"type":"string","description":"对接方用户 ID; 不可为空白字符串；最大长度 64","x-java-type":"String"}},"required":["externalUserId"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用; 失败时为 null","x-java-type":"BmsTokenResp","properties":{"token":{"type":"string","description":"OpenAPI 映射 token，用于调用 BMS 接口; 后续调用 BMS 接口时放入 `token` 请求头","x-java-type":"String"}},"required":["token"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent":{"post":{"operationId":"bms.postCustomerAgent","x-api-code":"bms.postCustomerAgent","x-open-platform-sort":56,"summary":"新增客户信息","description":"**接口：** `POST /bms/customer/agent`\n\n创建客户档案，返回新增客户标识。\n\n业务规则：\n- 新增、编辑客户及审核通过时，酒店客户类型和机票客户类型分别校验真实存在与业务类型，不能混用。\n- 挂账（payType=1）须提供 creditLine、settlementEntityId；信用卡（payType=0）不能设置 settlementEntityId。客户协议 GDS 与协议编码须成对填写。\n- password 在当前 DTO 的 Swagger 注解中仍为 required=true，但非空校验已注释，实际下游允许 sourceType=2（API，默认值）不传密码。本表按当前实际业务规则标为 false；其他来源仍需提供密码。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentTypeId":{"type":"integer","description":"客户类型id; 不可为 null；> 0；必须真实存在，且业务类型为酒店（businessType=0）","x-java-type":"Integer","format":"int32"},"flightAgentTypeId":{"type":"integer","description":"机票客户类型id; 非 null 时必须真实存在，且业务类型为机票（businessType=1）","x-java-type":"Integer","format":"int32"},"agentName":{"type":"string","description":"客户名称; 不可为空白字符串","x-java-type":"String"},"memberIsPay":{"type":"integer","description":"会员是否需要付费，0-收费，1-免费; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"cityCode":{"type":"string","description":"城市编码","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"settlementType":{"type":"integer","description":"结算方式：0月结 1半月结 2周结 3单结 4日结; 不可为 null；≥ 0；≤ 4","x-java-type":"Integer","format":"int32","minimum":0,"maximum":4},"settlementCurrency":{"type":"integer","description":"结算币种; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"creditLine":{"type":"number","description":"挂账信用额度; ≥ 0；payType=1（挂账）时必填","x-java-type":"BigDecimal","minimum":0},"companyLogo":{"type":"string","description":"公司logo地址","x-java-type":"String"},"remark":{"type":"string","description":"备注; 长度/元素数：最大 500","x-java-type":"String","maxLength":500},"firstName":{"type":"string","description":"名; 不可为空白字符串","x-java-type":"String"},"lastName":{"type":"string","description":"姓; 不可为空白字符串","x-java-type":"String"},"userAccount":{"type":"string","description":"管理员账号; 不可为空白字符串；管理员邮箱账号；下游校验邮箱格式及账号唯一性","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"address":{"type":"string","description":"客户地址","x-java-type":"String"},"correspondentEmail":{"type":"string","description":"联系人邮箱; 邮箱格式","x-java-type":"String"},"phoneNumber":{"type":"string","description":"手机号; 不可为空白字符串；长度/元素数：最大 20；正则：`^\\d+$`","x-java-type":"String","pattern":"^\\d+$","maxLength":20},"clientIdentificationGds":{"type":"string","description":"客户协议编码对应的GDS：Amadeus、Sabre、Travelport; 正则：`^$&#124;Amadeus&#124;Sabre&#124;Travelport`；与另一客户协议字段同时有值或同时为空；空白按未填写处理","x-java-type":"String","pattern":"^$|Amadeus|Sabre|Travelport"},"clientIdentificationNumber":{"type":"string","description":"客户协议编码; 长度/元素数：最大 100；与另一客户协议字段同时有值或同时为空；空白按未填写处理","x-java-type":"String","maxLength":100},"settlementEntityId":{"type":"integer","description":"结算主体ID; > 0；payType=1（挂账）时必填；payType=0（信用卡）时不能设置","x-java-type":"Integer","format":"int32"}},"required":["agentTypeId","agentName","memberIsPay","payType","settlementType","settlementCurrency","firstName","lastName","userAccount","operationId","businessId","phoneNumber"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentAddResp","properties":{"value":{"type":"integer","description":"客户 ID","x-java-type":"Integer","format":"int32"}},"nullable":true}},"required":["code","message"]}}}}}},"put":{"operationId":"bms.putCustomerAgent","x-api-code":"bms.putCustomerAgent","x-open-platform-sort":57,"summary":"编辑客户信息","description":"**接口：** `PUT /bms/customer/agent`\n\n修改已有客户的基础信息及关联配置。\n\n业务规则：\n- 这是完整资料编辑请求，按表格提供必填字段；支付方式不在当前请求 DTO 中。flightAgentTypeId 可清空，清空时会关闭机票服务；酒店和机票服务须至少保留一项启用。\n- 编辑客户时 creditLine 始终必填，须提供大于或等于 0 的数值；operateType 为 0、1、2 时分别表示增加、减少和设置额度。\n- 客户类型须分别为真实存在的酒店类型与机票类型；协议 GDS 与协议编码须成对填写。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"客户 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"agentTypeId":{"type":"integer","description":"客户类型id; 不可为 null；> 0；必须真实存在，且业务类型为酒店（businessType=0）","x-java-type":"Integer","format":"int32"},"flightAgentTypeId":{"type":"integer","description":"机票客户类型id; 非 null 时必须真实存在，且业务类型为机票（businessType=1）","x-java-type":"Integer","format":"int32"},"agentName":{"type":"string","description":"客户名称; 不可为空白字符串","x-java-type":"String"},"memberIsPay":{"type":"integer","description":"会员是否需要付费，0-收费，1-免费; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"cityCode":{"type":"string","description":"城市编码","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"settlementType":{"type":"integer","description":"结算方式：0月结 1半月结 2周结 3单结 4日结; 不可为 null；≥ 0；≤ 4","x-java-type":"Integer","format":"int32","minimum":0,"maximum":4},"creditLine":{"type":"number","description":"信用额度调整值；结合 operateType 执行增加、减少或设置; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"companyLogo":{"type":"string","description":"公司logo地址","x-java-type":"String"},"remark":{"type":"string","description":"备注; 长度/元素数：最大 500","x-java-type":"String","maxLength":500},"address":{"type":"string","description":"客户地址","x-java-type":"String"},"correspondentEmail":{"type":"string","description":"联系人邮箱; 邮箱格式","x-java-type":"String"},"phoneNumber":{"type":"string","description":"手机号; 不可为空白字符串；长度/元素数：最大 20；正则：`^\\d+$`","x-java-type":"String","pattern":"^\\d+$","maxLength":20},"clientIdentificationGds":{"type":"string","description":"客户协议编码对应的GDS：Amadeus、Sabre、Travelport; 正则：`^$&#124;Amadeus&#124;Sabre&#124;Travelport`；与另一客户协议字段同时有值或同时为空；空白按未填写处理","x-java-type":"String","pattern":"^$|Amadeus|Sabre|Travelport"},"clientIdentificationNumber":{"type":"string","description":"客户协议编码; 长度/元素数：最大 100；与另一客户协议字段同时有值或同时为空；空白按未填写处理","x-java-type":"String","maxLength":100},"settlementEntityId":{"type":"integer","description":"结算主体ID; > 0","x-java-type":"Integer","format":"int32"},"operateType":{"type":"integer","description":"操作额度类型；枚举取值：0-增加、1-减少、2-等于; 不可为 null；≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"operationId":{"type":"integer","description":"运营用户id; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; 不可为 null；> 0","x-java-type":"Integer","format":"int32"}},"required":["id","agentTypeId","agentName","memberIsPay","settlementType","creditLine","phoneNumber","operateType","operationId","businessId"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentEditResp","properties":{"value":{"type":"integer","description":"客户 ID","x-java-type":"Integer","format":"int32"}},"nullable":true}},"required":["code","message"]}}}}}},"get":{"operationId":"bms.getCustomerAgent","x-api-code":"bms.getCustomerAgent","x-open-platform-sort":58,"summary":"客户信息详情","description":"**接口：** `GET /bms/customer/agent`\n\n按客户 ID 查询档案详情，供详情页或编辑页回显。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"id","required":true,"schema":{"type":"integer","description":"客户主键 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentDetailResp","properties":{"id":{"type":"integer","description":"客户 ID","x-java-type":"Integer","format":"int32"},"agentTypeId":{"type":"integer","description":"客户类型id","x-java-type":"Integer","format":"int32"},"flightAgentTypeId":{"type":"integer","description":"机票客户类型id","x-java-type":"Integer","format":"int32"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"flightAgentTypeName":{"type":"string","description":"机票客户类型名称","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"memberIsPay":{"type":"integer","description":"会员是否需要付费，0-收费，1-免费","x-java-type":"Integer","format":"int32"},"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"cityCode":{"type":"string","description":"城市编码","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账","x-java-type":"Integer","format":"int32"},"settlementType":{"type":"integer","description":"结算方式：0月结 1半月结 2周结 3单结 4日结","x-java-type":"Integer","format":"int32"},"creditLine":{"type":"number","description":"信用卡总额度","x-java-type":"BigDecimal"},"balance":{"type":"number","description":"剩余额度","x-java-type":"BigDecimal"},"companyLogo":{"type":"string","description":"公司logo地址","x-java-type":"String"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"referralCode":{"type":"string","description":"推荐码","x-java-type":"String"},"flightEnable":{"type":"integer","description":"机票是否启用 0-否 1-是","x-java-type":"Integer","format":"int32"},"systemName":{"type":"string","description":"系统名称","x-java-type":"String"},"flightItineraryLanguage":{"type":"string","description":"机票出行单语言","x-java-type":"String"},"flightItineraryShowPrice":{"type":"integer","description":"机票行程单是否显示价格：0否,1是","x-java-type":"Integer","format":"int32"},"address":{"type":"string","description":"客户地址","x-java-type":"String"},"correspondentEmail":{"type":"string","description":"联系人邮箱","x-java-type":"String"},"phoneNumber":{"type":"string","description":"手机号","x-java-type":"String"},"clientIdentificationGds":{"type":"string","description":"客户协议编码对应的GDS：Amadeus、Sabre、Travelport","x-java-type":"String"},"clientIdentificationNumber":{"type":"string","description":"客户协议编码","x-java-type":"String"},"settlementEntityId":{"type":"integer","description":"结算主体ID","x-java-type":"Integer","format":"int32"},"settlementCurrency":{"type":"integer","description":"结算币种","x-java-type":"Integer","format":"int32"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"hotelEnable":{"type":"integer","description":"酒店是否启用 0-否 1-是","x-java-type":"Integer","format":"int32"},"settlementCurrencyName":{"type":"string","description":"结算币种名称","x-java-type":"String"},"operation":{"type":"object","description":"运营人员信息","x-java-type":"PlatformUserInfo","properties":{"userId":{"type":"integer","description":"用户id","x-java-type":"Integer","format":"int32"},"username":{"type":"string","description":"姓名","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"keyword":{"type":"string","description":"姓名 +邮箱拼接","x-java-type":"String"}}},"business":{"type":"object","description":"商务人员信息","x-java-type":"PlatformUserInfo","properties":{"userId":{"type":"integer","description":"用户id","x-java-type":"Integer","format":"int32"},"username":{"type":"string","description":"姓名","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"keyword":{"type":"string","description":"姓名 +邮箱拼接","x-java-type":"String"}}},"createdUser":{"type":"object","description":"创建人","x-java-type":"PlatformUserInfo","properties":{"userId":{"type":"integer","description":"用户id","x-java-type":"Integer","format":"int32"},"username":{"type":"string","description":"姓名","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"keyword":{"type":"string","description":"姓名 +邮箱拼接","x-java-type":"String"}}},"updatedUser":{"type":"object","description":"更新人","x-java-type":"PlatformUserInfo","properties":{"userId":{"type":"integer","description":"用户id","x-java-type":"Integer","format":"int32"},"username":{"type":"string","description":"姓名","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"keyword":{"type":"string","description":"姓名 +邮箱拼接","x-java-type":"String"}}},"createdDt":{"type":"string","description":"创建时间","x-java-type":"String"},"updatedDt":{"type":"string","description":"更新时间","x-java-type":"String"},"systemConfigId":{"type":"integer","description":"系统配置id","x-java-type":"Integer","format":"int32"},"settlementEntityNameEn":{"type":"string","description":"结算主体名称（英文）","x-java-type":"String"},"settlementEntityNameCn":{"type":"string","description":"结算主体名称（中文）","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentList":{"get":{"operationId":"bms.getCustomerAgentList","x-api-code":"bms.getCustomerAgentList","x-open-platform-sort":59,"summary":"客户信息列表","description":"**接口：** `GET /bms/customer/agentList`\n\n按名称、编码及启用状态查询客户列表，供选择客户等场景使用。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"agentName","required":false,"schema":{"type":"string","description":"客户名称","x-java-type":"String"}},{"in":"query","name":"agentCode","required":false,"schema":{"type":"string","description":"客户编码","x-java-type":"String"}},{"in":"query","name":"enable","required":false,"schema":{"type":"integer","description":"客户启用状态：0-禁用，1-启用; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentListResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"settlementCurrency":{"type":"string","description":"客户币种","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账","x-java-type":"Integer","format":"int32"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentEnable":{"post":{"operationId":"bms.postCustomerAgentEnable","x-api-code":"bms.postCustomerAgentEnable","x-open-platform-sort":60,"summary":"客户启用禁用","description":"**接口：** `POST /bms/customer/agentEnable`\n\n切换客户整体启用或禁用状态。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"客户主键 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"启用状态：0-禁用，1-启用; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["id","enable"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentEnableResp","properties":{"id":{"type":"integer","description":"客户 ID; 示例：`1001`","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"客户启用状态：0-禁用，1-启用; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["id","enable"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentPage":{"post":{"operationId":"bms.postCustomerAgentPage","x-api-code":"bms.postCustomerAgentPage","x-open-platform-sort":61,"summary":"客户信息分页","description":"**接口：** `POST /bms/customer/agentPage`\n\n按筛选条件分页查询客户档案。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 25; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"agentTypeId":{"type":"integer","description":"客户类型id; > 0","x-java-type":"Integer","format":"int32"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"status":{"type":"integer","description":"是否有效：0否 1是; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"启用状态 0-禁用 1-启用; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"feeConfigured":{"type":"integer","description":"交易手续费配置：0-否 1-是; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"orderServiceFeeConfigured":{"type":"integer","description":"订单服务费是否配置：0-否 1-是; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"客户 ID","x-java-type":"Integer","format":"int32"},"agentTypeId":{"type":"integer","description":"客户类型id","x-java-type":"Integer","format":"int32"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"flightAgentTypeId":{"type":"integer","description":"机票客户类型id","x-java-type":"Integer","format":"int32"},"flightAgentTypeName":{"type":"string","description":"机票客户类型名称","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账","x-java-type":"Integer","format":"int32"},"settlementCurrency":{"type":"integer","description":"结算币种","x-java-type":"Integer","format":"int32"},"settlementCurrencyName":{"type":"string","description":"结算币种名称","x-java-type":"String"},"creditLine":{"type":"number","description":"信用卡总额度","x-java-type":"BigDecimal"},"balance":{"type":"number","description":"剩余额度","x-java-type":"BigDecimal"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"memberIsPay":{"type":"integer","description":"会员是否需要付费，0-收费，1-免费","x-java-type":"Integer","format":"int32"},"operationName":{"type":"string","description":"运营人员姓名","x-java-type":"String"},"businessName":{"type":"string","description":"商务人员姓名","x-java-type":"String"},"updatedBy":{"type":"string","description":"更新人","x-java-type":"String"},"updatedDt":{"type":"string","description":"更新时间","x-java-type":"String"},"enable":{"type":"integer","description":"启用状态 0-禁用 1-启用","x-java-type":"Integer","format":"int32"},"referralCode":{"type":"string","description":"推荐码","x-java-type":"String"},"feeConfigured":{"type":"integer","description":"是否已配置手续费 0-未配置 1-已配置","x-java-type":"Integer","format":"int32"},"orderServiceFeeConfigured":{"type":"integer","description":"是否已配置订单服务费：0-否 1-是","x-java-type":"Integer","format":"int32"},"address":{"type":"string","description":"客户地址","x-java-type":"String"}},"required":["orderServiceFeeConfigured"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/queryCountryList":{"get":{"operationId":"bms.getCustomerQueryCountryList","x-api-code":"bms.getCustomerQueryCountryList","x-open-platform-sort":62,"summary":"获取国家列表","description":"**接口：** `GET /bms/customer/queryCountryList`\n\n按语言和地区名称查询国家选项，辅助填写客户地址。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"language","required":true,"schema":{"type":"string","description":"语言；不传默认 en-US; 不可为空白字符串；不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"}},{"in":"query","name":"areaName","required":false,"schema":{"type":"string","description":"国家名称关键词；不传查询全部; 不传时默认值：`\"\"`","x-java-type":"String","default":""}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCountryListResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/queryCityList":{"get":{"operationId":"bms.getCustomerQueryCityList","x-api-code":"bms.getCustomerQueryCityList","x-open-platform-sort":63,"summary":"获取城市信息","description":"**接口：** `GET /bms/customer/queryCityList`\n\n按国家编码、城市名称和语言查询城市选项。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"language","required":true,"schema":{"type":"string","description":"语言；不传默认 en-US; 不可为空白字符串；不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US"}},{"in":"query","name":"countryCode","required":true,"schema":{"type":"string","description":"国家编码; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"cityName","required":false,"schema":{"type":"string","description":"城市名称关键词；不传查询该国家全部城市; 不传时默认值：`\"\"`","x-java-type":"String","default":""}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCityListResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"cityCode":{"type":"string","description":"城市编码","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentFlightEnable":{"post":{"operationId":"bms.postCustomerAgentFlightEnable","x-api-code":"bms.postCustomerAgentFlightEnable","x-open-platform-sort":64,"summary":"客户机票服务启用禁用","description":"**接口：** `POST /bms/customer/agentFlightEnable`\n\n单独开启或关闭客户的机票服务。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"客户主键 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"启用状态：0-禁用，1-启用; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["id","enable"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentFlightEnableResp","properties":{"id":{"type":"integer","description":"客户 ID; 示例：`1001`","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"机票服务启用状态：0-禁用，1-启用; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["id","enable"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentHotelEnable":{"post":{"operationId":"bms.postCustomerAgentHotelEnable","x-api-code":"bms.postCustomerAgentHotelEnable","x-open-platform-sort":65,"summary":"客户酒店服务启用禁用","description":"**接口：** `POST /bms/customer/agentHotelEnable`\n\n单独开启或关闭客户的酒店服务。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"客户主键 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"启用状态：0-禁用，1-启用; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["id","enable"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentHotelEnableResp","properties":{"id":{"type":"integer","description":"客户 ID; 示例：`1001`","x-java-type":"Integer","format":"int32"},"enable":{"type":"integer","description":"酒店服务启用状态：0-禁用，1-启用; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["id","enable"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentReview":{"put":{"operationId":"bms.putCustomerAgentReview","x-api-code":"bms.putCustomerAgentReview","x-open-platform-sort":67,"summary":"客户审核信息编辑","description":"**接口：** `PUT /bms/customer/agentReview`\n\n更新客户审核信息；status=1 表示通过，status=2 表示拒绝，拒绝时 rejectReason 必填且最长50个字符；成功时 data 为 null。\n\n业务规则：\n- status=1（通过）时：agentTypeId、agentName、payType、settlementType、settlementCurrency、memberIsPay、operationId、businessId 必填；agentName 不能是空白字符串。类型 ID 须真实存在且匹配酒店/机票业务。\n- 通过且 payType=1（挂账）时 creditLine 必填；通过且 payType=0（信用卡）时不能设置 settlementEntityId。\n- status=2（拒绝）时 rejectReason 必填且不能为空白，最长 50 个字符。审核成功返回 data:null。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"审核id; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"status":{"type":"integer","description":"审核状态，1-已通过，2-已拒绝; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2},"rejectReason":{"type":"string","description":"驳回原因；status=2（拒绝）时必填，最长50个字符; 长度/元素数：最大 50","x-java-type":"String","maxLength":50},"agentTypeId":{"type":"integer","description":"客户类型id；审核通过时必填; > 0；必须真实存在，且业务类型为酒店（businessType=0）；审核接口仅在通过时校验","x-java-type":"Integer","format":"int32"},"agentName":{"type":"string","description":"客户名称；审核通过时必填","x-java-type":"String"},"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"cityCode":{"type":"string","description":"城市编码","x-java-type":"String"},"cityName":{"type":"string","description":"城市名称","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡 1挂账；审核通过时必填; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"settlementType":{"type":"integer","description":"结算方式：0月结 1半月结 2周结 3单结 4日结；审核通过时必填; ≥ 0；≤ 4","x-java-type":"Integer","format":"int32","minimum":0,"maximum":4},"settlementCurrency":{"type":"integer","description":"结算币种；审核通过时必填; > 0","x-java-type":"Integer","format":"int32"},"creditLine":{"type":"number","description":"挂账信用额度；status=1 且 payType=1 时必填; ≥ 0；仅 status=1 且 payType=1 时必填","x-java-type":"BigDecimal","minimum":0},"memberIsPay":{"type":"integer","description":"会员是否需要付费，0-收费，1-免费；审核通过时必填; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"companyLogo":{"type":"string","description":"公司logo地址","x-java-type":"String"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; > 0；status=1（通过）时必填","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0；status=1（通过）时必填","x-java-type":"Integer","format":"int32"},"flightAgentTypeId":{"type":"integer","description":"机票客户类型id; > 0；非 null 时必须真实存在，且业务类型为机票（businessType=1）；审核接口仅在通过时校验","x-java-type":"Integer","format":"int32"},"settlementEntityId":{"type":"integer","description":"结算主体ID; > 0；status=1 且 payType=0 时不能设置","x-java-type":"Integer","format":"int32"}},"required":["id","status"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"description":"业务数据；成功时固定为 null","x-java-type":"Void","nullable":true,"enum":[null]}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentReviewPage":{"post":{"operationId":"bms.postCustomerAgentReviewPage","x-api-code":"bms.postCustomerAgentReviewPage","x-open-platform-sort":68,"summary":"客户审核信息分页","description":"**接口：** `POST /bms/customer/agentReviewPage`\n\n分页查询客户审核申请及审核状态。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 25; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"status":{"type":"integer","description":"审核状态，0-待审核，1-已通过，2-已拒绝; ≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"startDate":{"type":"string","description":"开始日期，格式 yyyy-MM-dd; 正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"endDate":{"type":"string","description":"结束日期，格式 yyyy-MM-dd; 正则：`^\\d{4}-\\d{2}-\\d{2}$`","x-java-type":"String","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentReviewPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"客户 ID","x-java-type":"Integer","format":"int32"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"agentName":{"type":"string","description":"公司名称","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"status":{"type":"integer","description":"审核状态，0-待审核，1-已通过，2-已拒绝","x-java-type":"Integer","format":"int32"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"referralCode":{"type":"string","description":"推荐码","x-java-type":"String"},"settlementCurrency":{"type":"integer","description":"结算币种","x-java-type":"Integer","format":"int32"},"sourceType":{"type":"integer","description":"客户来源：0-BMS,1-CBT,2-API","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"agentTypeId":{"type":"integer","description":"客户类型id","x-java-type":"Integer","format":"int32"},"approvalTime":{"type":"string","description":"审核通过/拒绝时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"approvalDurationSeconds":{"type":"integer","description":"审批耗时（秒数）","x-java-type":"Long","format":"int64"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentType":{"post":{"operationId":"bms.postCustomerAgentType","x-api-code":"bms.postCustomerAgentType","x-open-platform-sort":69,"summary":"客户类型添加","description":"**接口：** `POST /bms/customer/agentType`\n\n创建客户类型，用于客户分类。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentTypeName":{"type":"string","description":"客户类型名称; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"businessType":{"type":"integer","description":"业务类型 0-酒店业务 1-机票业务; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"supplyPartnerCode":{"type":"string","description":"供应商的合作商编码","x-java-type":"String"},"supplyApiSecret":{"type":"string","description":"供应商的API密钥","x-java-type":"String"}},"required":["agentTypeName","businessType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentTypeAddResp","properties":{"value":{"type":"integer","description":"客户类型 ID","x-java-type":"Integer","format":"int32"}},"nullable":true}},"required":["code","message"]}}}}}},"put":{"operationId":"bms.putCustomerAgentType","x-api-code":"bms.putCustomerAgentType","x-open-platform-sort":70,"summary":"客户类型编辑","description":"**接口：** `PUT /bms/customer/agentType`\n\n修改已有客户类型的配置。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"客户类型 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"agentTypeName":{"type":"string","description":"客户类型名称; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"supplyPartnerCode":{"type":"string","description":"供应商的合作商编码","x-java-type":"String"},"supplyApiSecret":{"type":"string","description":"供应商的API密钥","x-java-type":"String"}},"required":["id","agentTypeName"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentTypeEditResp","properties":{"value":{"type":"integer","description":"客户类型 ID","x-java-type":"Integer","format":"int32"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentTypeList":{"post":{"operationId":"bms.postCustomerAgentTypeList","x-api-code":"bms.postCustomerAgentTypeList","x-open-platform-sort":71,"summary":"客户类型列表","description":"**接口：** `POST /bms/customer/agentTypeList`\n\n查询客户类型选项列表。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"businessType":{"type":"integer","description":"业务类型 0-酒店业务 1-机票业务; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"agentTypeCode":{"type":"string","description":"客户类型编码","x-java-type":"String"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"supplyAgentCode":{"type":"string","description":"供应商的客户编码","x-java-type":"String"},"supplyPartnerCode":{"type":"string","description":"供应商的合作商编码","x-java-type":"String"}}}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentTypeListResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"businessType":{"type":"integer","description":"业务类型 0-酒店业务 1-机票业务","x-java-type":"Integer","format":"int32"},"supplyPartnerCode":{"type":"string","description":"供应商的合作商编码","x-java-type":"String"},"supplyApiSecret":{"type":"string","description":"供应商的API密钥","x-java-type":"String"},"agentTypeCode":{"type":"string","description":"客户类型编码","x-java-type":"String"},"updatedDt":{"type":"string","description":"更新时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"updatedBy":{"type":"string","description":"更新人","x-java-type":"String"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentTypePage":{"post":{"operationId":"bms.postCustomerAgentTypePage","x-api-code":"bms.postCustomerAgentTypePage","x-open-platform-sort":72,"summary":"客户类型分页","description":"**接口：** `POST /bms/customer/agentTypePage`\n\n分页查询客户类型配置。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 25; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"businessType":{"type":"integer","description":"业务类型 0-酒店业务 1-机票业务; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"agentTypeCode":{"type":"string","description":"客户类型编码","x-java-type":"String"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"supplyPartnerCode":{"type":"string","description":"供应商的合作商编码","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerAgentTypePageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"agentTypeName":{"type":"string","description":"客户类型名称","x-java-type":"String"},"businessType":{"type":"integer","description":"业务类型 0-酒店业务 1-机票业务","x-java-type":"Integer","format":"int32"},"supplyPartnerCode":{"type":"string","description":"供应商的合作商编码","x-java-type":"String"},"supplyApiSecret":{"type":"string","description":"供应商的API密钥","x-java-type":"String"},"agentTypeCode":{"type":"string","description":"客户类型编码","x-java-type":"String"},"updatedDt":{"type":"string","description":"更新时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"updatedBy":{"type":"string","description":"更新人","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agentQuotaLog/agentQuotaLogPage":{"post":{"operationId":"bms.postCustomerAgentQuotaLogAgentQuotaLogPage","x-api-code":"bms.postCustomerAgentQuotaLogAgentQuotaLogPage","x-open-platform-sort":73,"summary":"客户额度变更记录分页","description":"**接口：** `POST /bms/customer/agentQuotaLog/agentQuotaLogPage`\n\n分页查询客户额度变更历史。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Long","format":"int64","default":10,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},"required":["currentPage","pageSize","agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerQuotaLogPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"logType":{"type":"integer","description":"日志类型，0-修改，1-账单结算返还","x-java-type":"Integer","format":"int32"},"updateBeforeCreditLine":{"type":"number","description":"修改前总额度","x-java-type":"BigDecimal"},"updateAfterCreditLine":{"type":"number","description":"修改后总额度","x-java-type":"BigDecimal"},"updateBeforeBalance":{"type":"number","description":"修改前剩余额度","x-java-type":"BigDecimal"},"updateAfterBalance":{"type":"number","description":"修改后剩余额度","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent/product-markup/summary":{"post":{"operationId":"bms.postCustomerAgentProductMarkupSummary","x-api-code":"bms.postCustomerAgentProductMarkupSummary","x-open-platform-sort":74,"summary":"查询客户产品加幅摘要","description":"**接口：** `POST /bms/customer/agent/product-markup/summary`\n\n查询客户酒店及机票产品加幅配置的摘要。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串；长度/元素数：最大 64","x-java-type":"String","maxLength":64}},"required":["agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerMarkupSummaryResp","properties":{"hotelEnabled":{"type":"integer","description":"酒店加幅是否启用。","x-java-type":"Integer","format":"int32"},"hotelMarkupType":{"type":"integer","description":"酒店加幅类型：1-百分比，2-固定金额。","x-java-type":"Integer","format":"int32"},"hotelGlobalMarkupValue":{"type":"number","description":"酒店全局加幅值。","x-java-type":"BigDecimal"},"hotelRuleCount":{"type":"integer","description":"酒店例外规则数量。","x-java-type":"Integer","format":"int32"},"flightEnabled":{"type":"integer","description":"机票加幅是否启用。","x-java-type":"Integer","format":"int32"},"flightMarkupType":{"type":"integer","description":"机票加幅类型：1-百分比，2-固定金额。","x-java-type":"Integer","format":"int32"},"flightGlobalMarkupValue":{"type":"number","description":"机票全局加幅值。","x-java-type":"BigDecimal"},"flightRuleCount":{"type":"integer","description":"机票例外规则数量。","x-java-type":"Integer","format":"int32"}},"required":["hotelEnabled","hotelRuleCount","flightEnabled","flightRuleCount"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent/product-markup/hotel/get":{"post":{"operationId":"bms.postCustomerAgentProductMarkupHotelGet","x-api-code":"bms.postCustomerAgentProductMarkupHotelGet","x-open-platform-sort":75,"summary":"查询酒店加幅配置详情","description":"**接口：** `POST /bms/customer/agent/product-markup/hotel/get`\n\n读取客户酒店产品加幅规则，供配置页面回显。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串；长度/元素数：最大 64","x-java-type":"String","maxLength":64}},"required":["agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerMarkupHotelGetResp","properties":{"agentCode":{"type":"string","description":"客户编码。","x-java-type":"String"},"enabled":{"type":"integer","description":"是否启用。","x-java-type":"Integer","format":"int32"},"markupType":{"type":"integer","description":"加幅类型：1-百分比，2-固定金额。","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"固定金额币种。","x-java-type":"String"},"globalMarkupValue":{"type":"number","description":"全局加幅值。","x-java-type":"BigDecimal"},"fixedAmountScope":{"type":"integer","description":"固定金额维度：0-按单 1-按间夜；百分比时返回 0。","x-java-type":"Integer","format":"int32"},"ruleList":{"type":"array","description":"酒店例外规则列表。","x-java-type":"List<HotelMarkupRuleRespVO>","items":{"type":"object","properties":{"id":{"type":"integer","description":"规则主键。","x-java-type":"Long","format":"int64"},"markupValue":{"type":"number","description":"规则加幅值。","x-java-type":"BigDecimal"},"hotelList":{"type":"array","description":"命中酒店列表。","x-java-type":"List<HotelItemVO>","items":{"type":"object","properties":{"hotelId":{"type":"string","description":"酒店 ID。","x-java-type":"String"},"hotelNameZhCn":{"type":"string","description":"酒店中文简体名。","x-java-type":"String"},"hotelNameEnUs":{"type":"string","description":"酒店英文名。","x-java-type":"String"},"hotelNameZhHk":{"type":"string","description":"酒店中文繁体名。","x-java-type":"String"}}}},"bookingDateRangeList":{"type":"array","description":"预订日期范围列表。","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}}}},"stayDateRangeList":{"type":"array","description":"入住日期范围列表。","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}}}},"minStayNight":{"type":"integer","description":"最小入住间夜。","x-java-type":"Integer","format":"int32"},"maxStayNight":{"type":"integer","description":"最大入住间夜。","x-java-type":"Integer","format":"int32"},"supplyCodeList":{"type":"array","description":"供应商编码条件列表。","x-java-type":"List<String>","items":{"type":"string"}}}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent/product-markup/hotel/save":{"post":{"operationId":"bms.postCustomerAgentProductMarkupHotelSave","x-api-code":"bms.postCustomerAgentProductMarkupHotelSave","x-open-platform-sort":76,"summary":"保存酒店加幅配置","description":"**接口：** `POST /bms/customer/agent/product-markup/hotel/save`\n\n保存客户酒店产品加幅规则。\n\n业务规则：\n- 固定金额（markupType=2）时 fixedAmountScope 必填。保存采用整包替换，调用方无需提交旧规则 ID。\n- 每条 ruleList 规则至少提供一种有效条件：酒店、预订日期、入住日期、入住间夜或供应商；条件列表须非空才计为有效条件。minStayNight 与 maxStayNight 须同时填写或同时省略，填写时最小值不得大于最大值。\n- 所有日期范围的起止日期均必填，结束日期不得早于开始日期。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串；长度/元素数：最大 64","x-java-type":"String","maxLength":64},"enabled":{"type":"integer","description":"是否启用：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"markupType":{"type":"integer","description":"加幅类型：1-百分比 2-固定金额; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2},"globalMarkupValue":{"type":"number","description":"全局加幅值; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"fixedAmountScope":{"type":"integer","description":"固定金额维度：0-按单 1-按间夜（markupType=2 时必填）; ≥ 0；≤ 1；markupType=2 时必填","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"ruleList":{"type":"array","description":"酒店例外规则列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<HotelMarkupRuleSaveVO>","items":{"type":"object","properties":{"markupValue":{"type":"number","description":"规则加幅值; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"hotelList":{"type":"array","description":"命中酒店列表（仅需传 hotelId，名称由后端拉取详情填充）; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<HotelItemVO>","items":{"type":"object","properties":{"hotelId":{"type":"string","description":"酒店 ID; 不可为空白字符串","x-java-type":"String"}},"required":["hotelId"]}},"bookingDateRangeList":{"type":"array","description":"预订日期范围列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 不可为 null；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 不可为 null；不得早于 startDate；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}},"required":["startDate","endDate"]}},"stayDateRangeList":{"type":"array","description":"入住日期范围列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 不可为 null；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 不可为 null；不得早于 startDate；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}},"required":["startDate","endDate"]}},"minStayNight":{"type":"integer","description":"最小入住间夜; ≥ 1；与 maxStayNight 同时填写或同时省略，且 minStayNight ≤ maxStayNight","x-java-type":"Integer","format":"int32","minimum":1},"maxStayNight":{"type":"integer","description":"最大入住间夜; ≥ 1；与 minStayNight 同时填写或同时省略，且 minStayNight ≤ maxStayNight","x-java-type":"Integer","format":"int32","minimum":1},"supplyCodeList":{"type":"array","description":"供应商编码列表（手工录入，多值 OR）; 数组元素：不可为空白字符串，长度 ≤ 64","x-java-type":"List<String>","items":{"type":"string"}}},"required":["markupValue"]}}},"required":["agentCode","enabled","markupType","globalMarkupValue"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerMarkupHotelSaveResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent/product-markup/flight/get":{"post":{"operationId":"bms.postCustomerAgentProductMarkupFlightGet","x-api-code":"bms.postCustomerAgentProductMarkupFlightGet","x-open-platform-sort":77,"summary":"查询机票加幅配置详情","description":"**接口：** `POST /bms/customer/agent/product-markup/flight/get`\n\n读取客户机票产品加幅规则，供配置页面回显。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串；长度/元素数：最大 64","x-java-type":"String","maxLength":64}},"required":["agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerMarkupFlightGetResp","properties":{"agentCode":{"type":"string","description":"客户编码。","x-java-type":"String"},"enabled":{"type":"integer","description":"是否启用。","x-java-type":"Integer","format":"int32"},"markupType":{"type":"integer","description":"加幅类型：1-百分比，2-固定金额。","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"固定金额币种。","x-java-type":"String"},"globalMarkupValue":{"type":"number","description":"全局加幅值。","x-java-type":"BigDecimal"},"ruleList":{"type":"array","description":"机票例外规则列表。","x-java-type":"List<FlightMarkupRuleRespVO>","items":{"type":"object","properties":{"id":{"type":"integer","description":"规则主键。","x-java-type":"Long","format":"int64"},"markupValue":{"type":"number","description":"规则加幅值。","x-java-type":"BigDecimal"},"airlineList":{"type":"array","description":"航司条件列表。","x-java-type":"List<AirlineItemVO>","items":{"type":"object","properties":{"airlineCode":{"type":"string","description":"航司二字码","x-java-type":"String"},"airlineNameZh":{"type":"string","description":"航司名称（简体中文）","x-java-type":"String"},"airlineNameEn":{"type":"string","description":"航司名称（英文）","x-java-type":"String"},"airlineNameTc":{"type":"string","description":"航司名称（繁体中文）","x-java-type":"String"}}}},"routeList":{"type":"array","description":"航线条件列表。","x-java-type":"List<RouteConditionVO>","items":{"type":"object","properties":{"departureType":{"type":"integer","description":"出发地类型；枚举取值：1-城市、2-国家、3-大洲","x-java-type":"Integer","format":"int32"},"departureCodes":{"type":"array","description":"出发地编码列表","x-java-type":"List<String>","items":{"type":"string"}},"arrivalType":{"type":"integer","description":"目的地类型；枚举取值：1-城市、2-国家、3-大洲","x-java-type":"Integer","format":"int32"},"arrivalCodes":{"type":"array","description":"目的地编码列表","x-java-type":"List<String>","items":{"type":"string"}}}}},"cabinClassList":{"type":"array","description":"舱位列表。","x-java-type":"List<Integer>","items":{"type":"integer"}},"bookingDateRangeList":{"type":"array","description":"预订日期范围列表。","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}}}},"departureDateRangeList":{"type":"array","description":"出发日期范围列表（结构与 DateRangeVO 一致）。","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}}}},"childParticipate":{"type":"integer","description":"儿童是否参与加幅。","x-java-type":"Integer","format":"int32"},"infantParticipate":{"type":"integer","description":"婴儿是否参与加幅。","x-java-type":"Integer","format":"int32"}}}}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent/product-markup/flight/save":{"post":{"operationId":"bms.postCustomerAgentProductMarkupFlightSave","x-api-code":"bms.postCustomerAgentProductMarkupFlightSave","x-open-platform-sort":78,"summary":"保存机票加幅配置","description":"**接口：** `POST /bms/customer/agent/product-markup/flight/save`\n\n保存客户机票产品加幅规则。\n\n业务规则：\n- 保存采用整包替换，调用方无需提交旧规则 ID。每条例外规则至少提供一个非空条件列表：航司、航线、舱位、预订日期或出发日期。\n- 日期范围起止日期均必填，结束日期不得早于开始日期。出发日期匹配按月日执行，仍需提交完整日期。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串；长度/元素数：最大 64","x-java-type":"String","maxLength":64},"enabled":{"type":"integer","description":"是否启用：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"markupType":{"type":"integer","description":"加幅类型：1-百分比 2-固定金额; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2},"globalMarkupValue":{"type":"number","description":"全局加幅值; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"ruleList":{"type":"array","description":"机票例外规则列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<FlightMarkupRuleSaveVO>","items":{"type":"object","properties":{"markupValue":{"type":"number","description":"规则加幅值; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"airlineList":{"type":"array","description":"适用航司列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<AirlineItemVO>","items":{"type":"object","properties":{"airlineCode":{"type":"string","description":"航司二字码; 不可为空白字符串；正则：`^[A-Za-z0-9]{2}$`","x-java-type":"String","pattern":"^[A-Za-z0-9]{2}$"}},"required":["airlineCode"]}},"routeList":{"type":"array","description":"适用航线条件列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<RouteConditionVO>","items":{"type":"object","properties":{"departureType":{"type":"integer","description":"出发地类型；枚举取值：1-城市、2-国家、3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3},"departureCodes":{"type":"array","description":"出发地编码列表; 不可为空集合或空值；数组元素：不可为空白字符串","x-java-type":"List<String>","items":{"type":"string"}},"arrivalType":{"type":"integer","description":"目的地类型；枚举取值：1-城市、2-国家、3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3},"arrivalCodes":{"type":"array","description":"目的地编码列表; 不可为空集合或空值；数组元素：不可为空白字符串","x-java-type":"List<String>","items":{"type":"string"}}},"required":["departureType","departureCodes","arrivalType","arrivalCodes"]}},"cabinClassList":{"type":"array","description":"适用舱位列表; 数组元素：不可为 null，≥ 0，≤ 3","x-java-type":"List<Integer>","items":{"type":"integer"}},"bookingDateRangeList":{"type":"array","description":"预订日期范围列表; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 不可为 null；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 不可为 null；不得早于 startDate；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}},"required":["startDate","endDate"]}},"departureDateRangeList":{"type":"array","description":"出发日期范围（与预订日期同为 startDate/endDate；匹配时仅取月日，跨年由起止月日关系自动判定）; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<DateRangeVO>","items":{"type":"object","properties":{"startDate":{"type":"string","description":"开始日期; 不可为 null；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"endDate":{"type":"string","description":"结束日期; 不可为 null；不得早于 startDate；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}},"required":["startDate","endDate"]}},"childParticipate":{"type":"integer","description":"儿童是否参与加幅：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"infantParticipate":{"type":"integer","description":"婴儿是否参与加幅：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["markupValue","childParticipate","infantParticipate"]}}},"required":["agentCode","enabled","markupType","globalMarkupValue"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerMarkupFlightSaveResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/agent/order-service-fee/config":{"get":{"operationId":"bms.getCustomerAgentOrderServiceFeeConfig","x-api-code":"bms.getCustomerAgentOrderServiceFeeConfig","x-open-platform-sort":79,"summary":"查询客户订单服务费配置","description":"**接口：** `GET /bms/customer/agent/order-service-fee/config`\n\n按客户 ID 读取酒店、机票订单服务费（TMC）配置。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"agentId","required":true,"schema":{"type":"integer","description":"客户主键 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerOrderServiceFeeGetResp","properties":{"agentId":{"type":"integer","description":"客户主键 ID","x-java-type":"Integer","format":"int32"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"hotel":{"type":"object","description":"酒店侧服务费规则，无记录时为 null","x-java-type":"HotelOrderServiceFeeRuleDTO","properties":{"enabled":{"type":"integer","description":"是否启用：0-否 1-是","x-java-type":"Integer","format":"int32"},"billingType":{"type":"integer","description":"计费方式序号：0-按单固定 / 1-按单百分比 / 2-按间夜固定","x-java-type":"Integer","format":"int32"},"currency":{"type":"string","description":"服务费币种","x-java-type":"String"},"fixedAmount":{"type":"number","description":"按单固定金额（billingType=0 时）","x-java-type":"BigDecimal"},"percentageRate":{"type":"number","description":"按单百分比费率 0～100（billingType=1 时）","x-java-type":"BigDecimal"},"minFee":{"type":"number","description":"百分比模式下限（可选）","x-java-type":"BigDecimal"},"maxFee":{"type":"number","description":"百分比模式上限（可选）","x-java-type":"BigDecimal"},"perRoomNightAmount":{"type":"number","description":"每间夜固定金额（billingType=2 时）","x-java-type":"BigDecimal"}}},"flight":{"type":"object","description":"机票侧服务费规则，无记录时为 null","x-java-type":"FlightOrderServiceFeeRuleDTO","properties":{"enabled":{"type":"integer","description":"是否启用：0-否 1-是","x-java-type":"Integer","format":"int32"},"globalEnabled":{"type":"integer","description":"是否启用全局固定金额：0-否 1-是","x-java-type":"Integer","format":"int32"},"referenceCountryCode":{"type":"string","description":"全局启用时：参考国家二字码；传空串 `\"\"` 或省略后落库为空表示「全部」——全局固定费取 domesticGlobalAmount（境内档）。","x-java-type":"String"},"domesticGlobalAmount":{"type":"number","description":"全局启用时：境内航线固定服务费","x-java-type":"BigDecimal"},"internationalGlobalAmount":{"type":"number","description":"全局启用时：境外航线固定服务费","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"服务费币种","x-java-type":"String"},"regionalEnabled":{"type":"integer","description":"是否启用按大洲区域计费：0-否 1-是","x-java-type":"Integer","format":"int32"},"regionalMode":{"type":"integer","description":"区域计费模式序号：0-固定金额 / 1-百分比","x-java-type":"Integer","format":"int32"},"regions":{"type":"array","description":"大洲区域规则列表","x-java-type":"List<FlightRegionRuleDTO>","items":{"type":"object","properties":{"continentCode":{"type":"string","description":"大洲编码；传空串 `\"\"` 表示「全部」大洲，该规则行对任意航程均参与区域择优（与其它洲行取金额最大）。","x-java-type":"String"},"fixedAmount":{"type":"number","description":"regionalMode=0（固定金额）时该洲固定服务费","x-java-type":"BigDecimal"},"percentageRate":{"type":"number","description":"regionalMode=1（百分比）时该洲百分比费率 0～100","x-java-type":"BigDecimal"},"minFee":{"type":"number","description":"区域百分比下限（可选）","x-java-type":"BigDecimal"},"maxFee":{"type":"number","description":"区域百分比上限（可选）","x-java-type":"BigDecimal"},"countryExceptions":{"type":"array","description":"该洲下国家例外列表，可空","x-java-type":"List<FlightRegionExceptionDTO>","items":{"type":"object","properties":{"countryCode":{"type":"string","description":"国家二字码（须具体国家；不支持「全部」语义）","x-java-type":"String"},"fixedAmount":{"type":"number","description":"固定金额模式下的国家固定服务费","x-java-type":"BigDecimal"},"percentageRate":{"type":"number","description":"百分比模式下的国家百分比费率 0～100","x-java-type":"BigDecimal"},"minFee":{"type":"number","description":"百分比下限（可选）","x-java-type":"BigDecimal"},"maxFee":{"type":"number","description":"百分比上限（可选）","x-java-type":"BigDecimal"}}}}}}}}}},"required":["agentId"],"nullable":true}},"required":["code","message"]}}}}}},"post":{"operationId":"bms.postCustomerAgentOrderServiceFeeConfig","x-api-code":"bms.postCustomerAgentOrderServiceFeeConfig","x-open-platform-sort":80,"summary":"保存客户订单服务费配置","description":"**接口：** `POST /bms/customer/agent/order-service-fee/config`\n\n整包保存客户订单服务费规则，服务端按业务类型新增或更新。\n\n业务规则：\n- hotel 与 flight 至少提供一个，按业务类型新增或更新配置。表格的子字段必填性只在相应对象或数组元素存在时适用；enabled=0 时对象内标为 true 的基础字段仍需提交。\n- 酒店规则启用后，按 billingType 分别要求 fixedAmount（0）、percentageRate（1）或 perRoomNightAmount（2）；百分比上下限均填写时须 minFee ≤ maxFee。\n- 机票规则启用后，globalEnabled 与 regionalEnabled 至少一个为 1。启用全局固定费时，境内、境外金额都必填；启用区域规则时 regions 非空，按 regionalMode 要求每条区域和国家例外的固定金额（0）或百分比（1），百分比上下限均填写时须 minFee ≤ maxFee。\n- referenceCountryCode 为空表示全部，使用境内全局固定费；continentCode 为空表示全部大洲；国家例外 countryCode 必须是具体国家。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"integer","description":"客户主键 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"hotel":{"type":"object","description":"酒店规则; 校验嵌套对象/数组元素；与 flight 至少提供一个对象","x-java-type":"HotelOrderServiceFeeRuleDTO","properties":{"enabled":{"type":"integer","description":"是否启用：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"billingType":{"type":"integer","description":"计费方式序号：0-按单固定 / 1-按单百分比 / 2-按间夜固定; 不可为 null；≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"currency":{"type":"string","description":"服务费币种; 不可为空白字符串","x-java-type":"String"},"fixedAmount":{"type":"number","description":"按单固定金额（billingType=0 时）; ≥ 0；≤ 999999999.99；hotel.enabled=1 且 billingType=0 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"percentageRate":{"type":"number","description":"按单百分比费率 0～100（billingType=1 时）; ≥ 0；≤ 100；hotel.enabled=1 且 billingType=1 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":100},"minFee":{"type":"number","description":"百分比模式下限（可选）; ≥ 0；≤ 999999999.99；hotel.enabled=1 且 billingType=1 时，若上下限均填写，须 minFee ≤ maxFee","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"maxFee":{"type":"number","description":"百分比模式上限（可选）; ≥ 0；≤ 999999999.99；hotel.enabled=1 且 billingType=1 时，若上下限均填写，须 minFee ≤ maxFee","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"perRoomNightAmount":{"type":"number","description":"每间夜固定金额（billingType=2 时）; ≥ 0；≤ 999999999.99；hotel.enabled=1 且 billingType=2 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99}},"required":["enabled","billingType","currency"]},"flight":{"type":"object","description":"机票规则; 校验嵌套对象/数组元素；与 hotel 至少提供一个对象","x-java-type":"FlightOrderServiceFeeRuleDTO","properties":{"enabled":{"type":"integer","description":"是否启用：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"globalEnabled":{"type":"integer","description":"是否启用全局固定金额：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"referenceCountryCode":{"type":"string","description":"全局启用时：参考国家二字码；传空串 `\"\"` 或省略后落库为空表示「全部」——全局固定费取 domesticGlobalAmount（境内档）。","x-java-type":"String"},"domesticGlobalAmount":{"type":"number","description":"全局启用时：境内航线固定服务费; ≥ 0；≤ 999999999.99；flight.enabled=1 且 globalEnabled=1 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"internationalGlobalAmount":{"type":"number","description":"全局启用时：境外航线固定服务费; ≥ 0；≤ 999999999.99；flight.enabled=1 且 globalEnabled=1 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"currency":{"type":"string","description":"服务费币种; 不可为空白字符串","x-java-type":"String"},"regionalEnabled":{"type":"integer","description":"是否启用按大洲区域计费：0-否 1-是; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"regionalMode":{"type":"integer","description":"区域计费模式序号：0-固定金额 / 1-百分比; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"regions":{"type":"array","description":"大洲区域规则列表; 校验嵌套对象/数组元素；flight.enabled=1 且 regionalEnabled=1 时必须为非空列表；数组元素：不可为 null","x-java-type":"List<FlightRegionRuleDTO>","items":{"type":"object","properties":{"continentCode":{"type":"string","description":"大洲编码；传空串 `\"\"` 表示「全部」大洲，该规则行对任意航程均参与区域择优（与其它洲行取金额最大）。","x-java-type":"String"},"fixedAmount":{"type":"number","description":"regionalMode=0（固定金额）时该洲固定服务费; ≥ 0；≤ 999999999.99；flight.enabled=1 且 regionalEnabled=1 且 regionalMode=0 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"percentageRate":{"type":"number","description":"regionalMode=1（百分比）时该洲百分比费率 0～100; ≥ 0；≤ 100；flight.enabled=1 且 regionalEnabled=1 且 regionalMode=1 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":100},"minFee":{"type":"number","description":"区域百分比下限（可选）; ≥ 0；≤ 999999999.99；启用区域百分比规则时，若上下限均填写，须 minFee ≤ maxFee","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"maxFee":{"type":"number","description":"区域百分比上限（可选）; ≥ 0；≤ 999999999.99；启用区域百分比规则时，若上下限均填写，须 minFee ≤ maxFee","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"countryExceptions":{"type":"array","description":"该洲下国家例外列表，可空; 校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<FlightRegionExceptionDTO>","items":{"type":"object","properties":{"countryCode":{"type":"string","description":"国家二字码（须具体国家；不支持「全部」语义）; 不可为空白字符串","x-java-type":"String"},"fixedAmount":{"type":"number","description":"固定金额模式下的国家固定服务费; ≥ 0；≤ 999999999.99；flight.enabled=1 且 regionalEnabled=1 且 regionalMode=0 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"percentageRate":{"type":"number","description":"百分比模式下的国家百分比费率 0～100; ≥ 0；≤ 100；flight.enabled=1 且 regionalEnabled=1 且 regionalMode=1 时必填","x-java-type":"BigDecimal","minimum":0,"maximum":100},"minFee":{"type":"number","description":"百分比下限（可选）; ≥ 0；≤ 999999999.99；启用区域百分比规则时，若上下限均填写，须 minFee ≤ maxFee","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99},"maxFee":{"type":"number","description":"百分比上限（可选）; ≥ 0；≤ 999999999.99；启用区域百分比规则时，若上下限均填写，须 minFee ≤ maxFee","x-java-type":"BigDecimal","minimum":0,"maximum":999999999.99}},"required":["countryCode"]}}}}}},"required":["enabled","globalEnabled","currency","regionalEnabled","regionalMode"]}},"required":["agentId"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerOrderServiceFeeSaveResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/add":{"post":{"operationId":"bms.postCustomerCorporateCodeAdd","x-api-code":"bms.postCustomerCorporateCodeAdd","x-open-platform-sort":81,"summary":"新增大客户协议","description":"**接口：** `POST /bms/customer/corporateCode/add`\n\n新增大客户航空协议配置。\n\n业务规则：\n- 销售期、出行期均可不设结束日期；提供结束日期时必须同时提供开始日期，且结束日期不得早于开始日期。\n- blackoutDates 每项起止日期都必填且 start ≤ end；设置出行期边界后，不可用日期范围须位于出行期内。\n- trackingCode 使用英文逗号分隔；每项去除两端空白后长度为 1–100，不允许连续逗号或首尾逗号造成空项。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"agreementName":{"type":"string","description":"协议名称; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"accountCode":{"type":"string","description":"账户编码; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"protocolCode":{"type":"string","description":"协议编码; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"carrier":{"type":"string","description":"航司列表; 不可为空白字符串；长度/元素数：最大 500","x-java-type":"String","maxLength":500},"salesPeriodStart":{"type":"string","description":"销售期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"salesPeriodEnd":{"type":"string","description":"销售期结束日期; 可省略结束日期；提供时 salesPeriodStart 必须有值，且结束日期不得早于开始日期；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodStart":{"type":"string","description":"出行期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodEnd":{"type":"string","description":"出行期结束日期; 可省略结束日期；提供时 travelPeriodStart 必须有值，且结束日期不得早于开始日期；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"blackoutDates":{"type":"array","description":"不可用日期范围; 校验嵌套对象/数组元素；每项起止日期均必填且 start ≤ end；已设置出行期边界时，不可用日期须位于该范围内；数组元素：不可为 null","x-java-type":"List<BlackoutDateRange>","items":{"type":"object","properties":{"start":{"type":"string","description":"开始日期; 不可为 null；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"end":{"type":"string","description":"结束日期; 不可为 null；不得早于同项 start；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}},"required":["start","end"]}},"origins":{"type":"array","description":"出发地列表; 长度/元素数：最大 100；校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）; 不可为空白字符串；长度/元素数：最大 10","x-java-type":"String","maxLength":10},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3}},"required":["code","type"]},"maxItems":100},"destinations":{"type":"array","description":"目的地列表; 长度/元素数：最大 100；校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）; 不可为空白字符串；长度/元素数：最大 10","x-java-type":"String","maxLength":10},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3}},"required":["code","type"]},"maxItems":100},"status":{"type":"integer","description":"状态；枚举取值：0-停用、1-启用; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"trackingCode":{"type":"string","description":"追踪代码(多个由逗号分隔存储); 英文逗号分隔；每项去除两端空白后为 1–100 个字符，不允许空项","x-java-type":"String"}},"required":["agentCode","agreementName","accountCode","protocolCode","carrier","status"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeAddResp","properties":{"value":{"type":"integer","description":"新增协议 ID","x-java-type":"Integer","format":"int32"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/edit":{"post":{"operationId":"bms.postCustomerCorporateCodeEdit","x-api-code":"bms.postCustomerCorporateCodeEdit","x-open-platform-sort":82,"summary":"编辑大客户协议","description":"**接口：** `POST /bms/customer/corporateCode/edit`\n\n修改已有航空协议配置。\n\n业务规则：\n- 销售期、出行期均可不设结束日期；提供结束日期时必须同时提供开始日期，且结束日期不得早于开始日期。\n- blackoutDates 每项起止日期都必填且 start ≤ end；设置出行期边界后，不可用日期范围须位于出行期内。\n- trackingCode 使用英文逗号分隔；每项去除两端空白后长度为 1–100，不允许连续逗号或首尾逗号造成空项。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"id":{"type":"integer","description":"协议 ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"agreementName":{"type":"string","description":"协议名称; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"accountCode":{"type":"string","description":"账户编码; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"protocolCode":{"type":"string","description":"协议编码; 不可为空白字符串；长度/元素数：最大 100","x-java-type":"String","maxLength":100},"carrier":{"type":"string","description":"航司列表; 不可为空白字符串；长度/元素数：最大 500","x-java-type":"String","maxLength":500},"salesPeriodStart":{"type":"string","description":"销售期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"salesPeriodEnd":{"type":"string","description":"销售期结束日期; 可省略结束日期；提供时 salesPeriodStart 必须有值，且结束日期不得早于开始日期；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodStart":{"type":"string","description":"出行期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodEnd":{"type":"string","description":"出行期结束日期; 可省略结束日期；提供时 travelPeriodStart 必须有值，且结束日期不得早于开始日期；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"blackoutDates":{"type":"array","description":"不可用日期范围; 校验嵌套对象/数组元素；每项起止日期均必填且 start ≤ end；已设置出行期边界时，不可用日期须位于该范围内；数组元素：不可为 null","x-java-type":"List<BlackoutDateRange>","items":{"type":"object","properties":{"start":{"type":"string","description":"开始日期; 不可为 null；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"end":{"type":"string","description":"结束日期; 不可为 null；不得早于同项 start；日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}},"required":["start","end"]}},"origins":{"type":"array","description":"出发地列表; 长度/元素数：最大 100；校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）; 不可为空白字符串；长度/元素数：最大 10","x-java-type":"String","maxLength":10},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3}},"required":["code","type"]},"maxItems":100},"destinations":{"type":"array","description":"目的地列表; 长度/元素数：最大 100；校验嵌套对象/数组元素；数组元素：不可为 null","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）; 不可为空白字符串；长度/元素数：最大 10","x-java-type":"String","maxLength":10},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3}},"required":["code","type"]},"maxItems":100},"status":{"type":"integer","description":"状态；枚举取值：0-停用、1-启用; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"trackingCode":{"type":"string","description":"追踪代码(多个由逗号分隔存储); 英文逗号分隔；每项去除两端空白后为 1–100 个字符，不允许空项","x-java-type":"String"}},"required":["agentCode","id","agreementName","accountCode","protocolCode","carrier","status"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeEditResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/del":{"post":{"operationId":"bms.postCustomerCorporateCodeDel","x-api-code":"bms.postCustomerCorporateCodeDel","x-open-platform-sort":83,"summary":"删除大客户协议","description":"**接口：** `POST /bms/customer/corporateCode/del`\n\n按协议 ID 删除协议配置。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"协议ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},"required":["id","agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeDeleteResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/detail":{"post":{"operationId":"bms.postCustomerCorporateCodeDetail","x-api-code":"bms.postCustomerCorporateCodeDetail","x-open-platform-sort":84,"summary":"大客户协议详情","description":"**接口：** `POST /bms/customer/corporateCode/detail`\n\n读取航空协议详情，供编辑页面回显。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"协议ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},"required":["id","agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeDetailResp","properties":{"id":{"type":"integer","description":"协议 ID","x-java-type":"Integer","format":"int32"},"agreementName":{"type":"string","description":"协议名称","x-java-type":"String"},"accountCode":{"type":"string","description":"账户编码","x-java-type":"String"},"protocolCode":{"type":"string","description":"协议编码","x-java-type":"String"},"carrier":{"type":"string","description":"航司列表","x-java-type":"String"},"salesPeriodStart":{"type":"string","description":"销售期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"salesPeriodEnd":{"type":"string","description":"销售期结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodStart":{"type":"string","description":"出行期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodEnd":{"type":"string","description":"出行期结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"blackoutDates":{"type":"array","description":"不可用日期范围","x-java-type":"List<BlackoutDateRange>","items":{"type":"object","properties":{"start":{"type":"string","description":"开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"end":{"type":"string","description":"结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}}}},"origins":{"type":"array","description":"出发地列表","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）","x-java-type":"String"},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲","x-java-type":"Integer","format":"int32"}}}},"destinations":{"type":"array","description":"目的地列表","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）","x-java-type":"String"},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲","x-java-type":"Integer","format":"int32"}}}},"status":{"type":"integer","description":"状态；枚举取值：0-停用、1-启用","x-java-type":"Integer","format":"int32"},"createTime":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"updateTime":{"type":"string","description":"更新时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"trackingCode":{"type":"string","description":"追踪代码(多个由逗号分隔存储)","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/page":{"post":{"operationId":"bms.postCustomerCorporateCodePage","x-api-code":"bms.postCustomerCorporateCodePage","x-open-platform-sort":85,"summary":"大客户协议分页查询","description":"**接口：** `POST /bms/customer/corporateCode/page`\n\n按筛选条件分页查询航空协议。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 50; 不可为 null；≥ 1；≤ 100；不传时默认值：`50`","x-java-type":"Long","format":"int64","default":50,"minimum":1,"maximum":100},"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},"required":["currentPage","pageSize","agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodePageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"协议 ID","x-java-type":"Integer","format":"int32"},"agreementName":{"type":"string","description":"协议名称","x-java-type":"String"},"accountCode":{"type":"string","description":"账户编码","x-java-type":"String"},"protocolCode":{"type":"string","description":"协议编码","x-java-type":"String"},"carrier":{"type":"string","description":"航司列表","x-java-type":"String"},"salesPeriodStart":{"type":"string","description":"销售期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"salesPeriodEnd":{"type":"string","description":"销售期结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodStart":{"type":"string","description":"出行期开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"travelPeriodEnd":{"type":"string","description":"出行期结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"blackoutDates":{"type":"array","description":"不可用日期范围","x-java-type":"List<BlackoutDateRange>","items":{"type":"object","properties":{"start":{"type":"string","description":"开始日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"},"end":{"type":"string","description":"结束日期; 日期格式：`yyyy-MM-dd`","x-java-type":"LocalDate","format":"date"}}}},"origins":{"type":"array","description":"出发地列表","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）","x-java-type":"String"},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲","x-java-type":"Integer","format":"int32"}}}},"destinations":{"type":"array","description":"目的地列表","x-java-type":"List<LocationItem>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲二字码）","x-java-type":"String"},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲","x-java-type":"Integer","format":"int32"}}}},"status":{"type":"integer","description":"状态；枚举取值：0-停用、1-启用","x-java-type":"Integer","format":"int32"},"createTime":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"updateTime":{"type":"string","description":"更新时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"trackingCode":{"type":"string","description":"追踪代码(多个由逗号分隔存储)","x-java-type":"String"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/status":{"post":{"operationId":"bms.postCustomerCorporateCodeStatus","x-api-code":"bms.postCustomerCorporateCodeStatus","x-open-platform-sort":86,"summary":"大客户协议启停用","description":"**接口：** `POST /bms/customer/corporateCode/status`\n\n切换航空协议的启用状态。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"协议ID; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"status":{"type":"integer","description":"目标状态：1-启用，0-停用; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"}},"required":["id","status","agentCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeStatusResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/airlines":{"get":{"operationId":"bms.getCustomerCorporateCodeAirlines","x-api-code":"bms.getCustomerCorporateCodeAirlines","x-open-platform-sort":87,"summary":"航司查询","description":"**接口：** `GET /bms/customer/corporateCode/airlines`\n\n查询航司选项，辅助配置协议适用范围。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"keyword","required":true,"schema":{"type":"string","description":"关键字；空字符串查询全部; 不可为 null；不传时默认值：`\"\"`","x-java-type":"String","default":""}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeAirlinesResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"airlineCode":{"type":"string","description":"航司二字码; 示例：`SQ`","x-java-type":"String"},"airlineNameZh":{"type":"string","description":"航司名称（中文）; 示例：`新加坡航空`","x-java-type":"String"},"airlineNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Singapore Airlines`","x-java-type":"String"},"logo":{"type":"string","description":"航司图标 URL; 示例：`https://cdn.example.com/airlines/SQ.png`","x-java-type":"String"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/corporateCode/locations":{"get":{"operationId":"bms.getCustomerCorporateCodeLocations","x-api-code":"bms.getCustomerCorporateCodeLocations","x-open-platform-sort":88,"summary":"地理位置查询","description":"**接口：** `GET /bms/customer/corporateCode/locations`\n\n按关键词、位置类型及可选洲编码查询地理位置选项。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"keyword","required":true,"schema":{"type":"string","description":"关键字；空字符串查询全部; 不可为 null；不传时默认值：`\"\"`","x-java-type":"String","default":""}},{"in":"query","name":"type","required":true,"schema":{"type":"integer","description":"类型；枚举取值：1-城市、2-国家、3-大洲; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3}},{"in":"query","name":"continentCode","required":false,"schema":{"type":"string","description":"大洲代码","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerCorporateCodeLocationsResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"code":{"type":"string","description":"编码（城市三字码/国家二字码/大洲代码）","x-java-type":"String"},"type":{"type":"integer","description":"类型：1-城市，2-国家，3-大洲","x-java-type":"Integer","format":"int32"},"cityNameZh":{"type":"string","description":"城市名称（中文），type=1 时有值","x-java-type":"String"},"cityNameEn":{"type":"string","description":"城市名称（英文），type=1 时有值","x-java-type":"String"},"countryCode":{"type":"string","description":"国家二字码，type=1,2 时有值","x-java-type":"String"},"countryNameZh":{"type":"string","description":"国家名称（中文），type=1,2 时有值","x-java-type":"String"},"countryNameEn":{"type":"string","description":"国家名称（英文），type=1,2 时有值","x-java-type":"String"},"continentCode":{"type":"string","description":"大洲代码","x-java-type":"String"},"continentNameZh":{"type":"string","description":"大洲名称（中文）","x-java-type":"String"},"continentNameEn":{"type":"string","description":"大洲名称（英文）","x-java-type":"String"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/customer/settlementEntity/list":{"get":{"operationId":"bms.getCustomerSettlementEntityList","x-api-code":"bms.getCustomerSettlementEntityList","x-open-platform-sort":89,"summary":"结算主体列表","description":"**接口：** `GET /bms/customer/settlementEntity/list`\n\n按可选关键词查询发票结算主体选项。","tags":["客户管理"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"keyword","required":true,"schema":{"type":"string","description":"关键字；空字符串查询全部; 不可为 null；不传时默认值：`\"\"`","x-java-type":"String","default":""}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCustomerSettlementEntityListResp","properties":{"list":{"type":"array","description":"列表数据","x-java-type":"List<Item>","items":{"type":"object","properties":{"id":{"type":"integer","description":"结算主体ID","x-java-type":"Integer","format":"int32"},"entityNameCn":{"type":"string","description":"中文名称","x-java-type":"String"},"entityNameEn":{"type":"string","description":"英文名称","x-java-type":"String"}}}}},"required":["list"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/order/statistics":{"get":{"operationId":"bms.getOrderFlightOrderStatistics","x-api-code":"bms.getOrderFlightOrderStatistics","x-open-platform-sort":90,"summary":"机票订单统计","description":"**接口：** `GET /bms/order/flight/order/statistics`\n\n统计机票订单状态数量。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderStatisticsResp","properties":{"toPay":{"type":"integer","description":"待支付","x-java-type":"Integer","format":"int32"},"toTicket":{"type":"integer","description":"待出票","x-java-type":"Integer","format":"int32"},"ticketed":{"type":"integer","description":"已出票","x-java-type":"Integer","format":"int32"},"cancelled":{"type":"integer","description":"已取消","x-java-type":"Integer","format":"int32"}},"required":["toPay","toTicket","ticketed","cancelled"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/order/list":{"post":{"operationId":"bms.postOrderFlightOrderList","x-api-code":"bms.postOrderFlightOrderList","x-open-platform-sort":91,"summary":"订单列表","description":"**接口：** `POST /bms/order/flight/order/list`\n\n按查询条件分页读取机票订单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数；不传默认 25，最大 100; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"supplier":{"type":"string","description":"供应商; 示例：`SUP001`","x-java-type":"String"},"supplierOrderId":{"type":"string","description":"供应商订单ID; 示例：`SUP202501010001`","x-java-type":"String"},"orderId":{"type":"string","description":"订单id; 示例：`FO202501010001`","x-java-type":"String"},"customerCode":{"type":"string","description":"客户编码; 示例：`AGT001`","x-java-type":"String"},"paymentMethod":{"type":"string","description":"支付类型：0信用卡，1挂账; 正则：`^[01]$`；示例：`0`","x-java-type":"String","pattern":"^[01]$"},"ticketNo":{"type":"string","description":"票号; 示例：`999-1234567890`","x-java-type":"String"},"orderStartTime":{"type":"string","description":"预定起始时间; 示例：`2025-01-01 00:00:00`","x-java-type":"String"},"orderEndTime":{"type":"string","description":"预定结束时间; 示例：`2025-01-31 23:59:59`","x-java-type":"String"},"orderSource":{"type":"integer","description":"订单来源：0-PC端，1-移动端; 示例：`0`","x-java-type":"Integer","format":"int32"},"passengerName":{"type":"string","description":"乘机人姓名; 示例：`ZHANG/SAN`","x-java-type":"String"},"orderName":{"type":"string","description":"预定人姓名; 示例：`admin`","x-java-type":"String"},"orderType":{"type":"integer","description":"行程类型：1单程，2往返，3多程; 示例：`1`","x-java-type":"Integer","format":"int32"},"orderStatus":{"type":"integer","description":"订单状态：1提交中，2待支付，3待出票，4已出票，5部分出票，6已取消，7部分退票，8部分改签，9全部退票，10全部改签; 示例：`4`","x-java-type":"Integer","format":"int32"},"language":{"type":"string","description":"语言类型; 示例：`zh-CN`","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号; 示例：`AP202501010001`","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; 示例：`0`","x-java-type":"Integer","format":"int32"},"isManualOrder":{"type":"integer","description":"是否手工单：0-否，1-是; 示例：`0`","x-java-type":"Integer","format":"int32"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderListResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FlightOrderListResult>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单ID; 示例：`FO202501010001`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号（1-供应商第一程订单号,2-供应商第二程订单号,...）; 示例：`SUP001,SUP002`","x-java-type":"String"},"supplierName":{"type":"string","description":"供应商名称; 示例：`供应商A`","x-java-type":"String"},"supplierDisplayName":{"type":"string","description":"供应商展示名称; 示例：`供应商A`","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码; 示例：`AGENT001`","x-java-type":"String"},"companyName":{"type":"string","description":"公司名称; 示例：`测试公司`","x-java-type":"String"},"deptName":{"type":"string","description":"组织名称; 示例：`技术部`","x-java-type":"String"},"orderName":{"type":"string","description":"预定人; 示例：`admin`","x-java-type":"String"},"passengerName":{"type":"string","description":"乘机人（乘机人1、乘机人2....）; 示例：`ZHANG/SAN, LI/SI`","x-java-type":"String"},"orderTime":{"type":"string","description":"预定时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"payTime":{"type":"string","description":"支付时间; 示例：`2025-01-01 12:05:00`","x-java-type":"String"},"flightNo":{"type":"string","description":"航班号（第一程、第二程。。。。）; 示例：`CA1234, CA5678`","x-java-type":"String"},"flightInfoEn":{"type":"string","description":"航班信息（英文）; 示例：`Beijing - Shanghai (Round Trip)`","x-java-type":"String"},"flightInfoZh":{"type":"string","description":"航班信息（中文）; 示例：`北京 - 上海（往返）`","x-java-type":"String"},"flightInfoTc":{"type":"string","description":"航班信息（繁体）; 示例：`北京 - 上海（往返）`","x-java-type":"String"},"flightTime":{"type":"string","description":"出发到达时间（第一程出发-到达、第二程出发-到达。。。）; 示例：`08:00-10:30, 18:00-20:30`","x-java-type":"String"},"totalAmount":{"type":"string","description":"总金额（USD 2500）; 示例：`CNY 2500`","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; 示例：`4`","x-java-type":"Integer","format":"int32"},"approvalNo":{"type":"string","description":"审批单号; 示例：`AP202501010001`","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; 示例：`0`","x-java-type":"Integer","format":"int32"},"proxyBooking":{"type":"integer","description":"是否代订：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"isManualOrder":{"type":"integer","description":"是否手工单：0-否，1-是; 示例：`0`","x-java-type":"Integer","format":"int32"},"farePriceType":{"type":"integer","description":"报价类型：0公布运价，1私有运价，2大客户协议运价; 示例：`0`","x-java-type":"Integer","format":"int32"}},"required":["orderCode","supplierOrderNo","supplierName","supplierDisplayName","agentCode","companyName","deptName","orderName","passengerName","orderTime","payTime","flightNo","flightInfoEn","flightInfoZh","flightInfoTc","flightTime","totalAmount","orderStatus","travelType","proxyBooking","isManualOrder","farePriceType"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/order/detail":{"post":{"operationId":"bms.postOrderFlightOrderDetail","x-api-code":"bms.postOrderFlightOrderDetail","x-open-platform-sort":92,"summary":"订单详情","description":"**接口：** `POST /bms/order/flight/order/detail`\n\n读取机票后台订单详情。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串；示例：`FO202501010001`","x-java-type":"String"}},"required":["orderCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderDetailResp","properties":{"orderDetail":{"type":"object","description":"订单信息","x-java-type":"OrderInfoVo","properties":{"orderCode":{"type":"string","description":"订单编号; 示例：`FO202501010001`","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; 示例：`4`","x-java-type":"Integer","format":"int32"},"payStatus":{"type":"integer","description":"支付状态；枚举取值：0-待支付、1-已支付、2-支付失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"bookingPerson":{"type":"string","description":"预定人; 示例：`admin`","x-java-type":"String"},"companyName":{"type":"string","description":"企业名称; 示例：`测试公司`","x-java-type":"String"},"orderSource":{"type":"integer","description":"订单来源：0-PC端，1-移动端; 示例：`0`","x-java-type":"Integer","format":"int32"},"submitTime":{"type":"string","description":"提交时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"payTime":{"type":"string","description":"支付时间（未支付为空）; 示例：`2025-01-01 12:05:00`","x-java-type":"String"},"supplierInfo":{"type":"object","description":"供应商信息","x-java-type":"SupplierInfoVo","properties":{"supplierId":{"type":"string","description":"供应商ID; 示例：`1`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"supplierName":{"type":"string","description":"供应商名称; 示例：`供应商A`","x-java-type":"String"},"supplierCode":{"type":"string","description":"供应商代码; 示例：`SUP001`","x-java-type":"String"},"supplierType":{"type":"string","description":"供应商类型; 示例：`GDS`","x-java-type":"String"}},"required":["supplierId","supplierOrderNo","supplierName","supplierCode","supplierType"]},"tripType":{"type":"integer","description":"行程类型：1单程，2往返，3多程; 示例：`1`","x-java-type":"Integer","format":"int32"},"farePriceType":{"type":"integer","description":"报价类型：0公布运价，1私有运价，2大客户协议运价; 示例：`0`","x-java-type":"Integer","format":"int32"},"contactPhone":{"type":"string","description":"联系人手机号; 示例：`13800138000`","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱; 示例：`example@test.com`","x-java-type":"String"},"contactName":{"type":"string","description":"联系人姓名; 示例：`Zhang San`","x-java-type":"String"},"bookingPersonEmail":{"type":"string","description":"预订人邮箱; 示例：`admin@test.com`","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号; 示例：`AP202501010001`","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; 示例：`0`","x-java-type":"Integer","format":"int32"},"tripPurposeCode":{"type":"integer","description":"出行目的枚举值：0-19，仅正单返回；枚举取值：0-CLIENT_MEETING、1-SALES_VISIT、2-BUSINESS_DEVELOPMENT、3-CONFERENCE、4-EXHIBITION_TRADE_SHOW、5-TRAINING、6-WORKSHOP_SEMINAR、7-INTERNAL_MEETING、8-TEAM_OFFSITE、9-PROJECT_WORK、10-SITE_VISIT、11-AUDIT_INSPECTION、12-INSTALLATION_IMPLEMENTATION、13-CUSTOMER_SUPPORT、14-SUPPLIER_VENDOR_MEETING、15-CONTRACT_NEGOTIATION、16-RECRUITMENT、17-MARKET_RESEARCH、18-OFFICE_VISIT、19-OTHER; 示例：`0`","x-java-type":"Integer","format":"int32"},"tripPurposeRemark":{"type":"string","description":"出行目的其他说明，仅正单选择 Other (please specify) 时返回; 示例：`客户现场交流`","x-java-type":"String"},"isManualOrder":{"type":"integer","description":"是否手工单：0-否，1-是; 示例：`0`","x-java-type":"Integer","format":"int32"},"isPayFailed":{"type":"integer","description":"是否支付失败 0-否，1-是; 示例：`0`","x-java-type":"Integer","format":"int32"},"payFailReason":{"type":"string","description":"支付失败原因","x-java-type":"String"},"changeReasonDesc":{"type":"string","description":"改签原因描述（仅改签单有值）; 示例：`航变改签`","x-java-type":"String"},"changeAttachmentUrls":{"type":"array","description":"改签附件URL集合（仅改签单有值）","x-java-type":"List<String>","items":{"type":"string"}},"orderType":{"type":"integer","description":"订单类型：0-正单，1-改签单，2-退票单","x-java-type":"Integer","format":"int32"},"orderSourceType":{"type":"integer","description":"订单来源类型：0-来源于正单，1-来源于改签单（仅改签单返回）; 示例：`0`","x-java-type":"Integer","format":"int32"}},"required":["orderCode","orderStatus","payStatus","bookingPerson","companyName","orderSource","submitTime","payTime","supplierInfo","tripType","farePriceType","contactPhone","contactEmail","contactName","bookingPersonEmail","travelType","isManualOrder","isPayFailed","orderType"]},"orderLogs":{"type":"array","description":"操作日志","x-java-type":"List<OrderLogVo>","items":{"type":"object","properties":{"logType":{"type":"string","description":"日志类型；枚举取值：ORDER_CREATE-订单创建、ORDER_PAY-订单支付、ORDER_CANCEL-订单取消、ORDER_ISSUED-订单出票、SCHEDULE_CHANGE-航班变动、REFUND-退票、CHANGE-改签、STATUS_CHANGE-订单状态变更、ORDER_INFO_UPDATE-订单信息修改、PAY_FAILED-支付失败、REFUND_FAILED-退款失败、PAYMENT_EXCEPTION-支付异常、SYSTEM_ERROR-系统异常、EXCEPTION_HANDLED-异常单已处理、SCHEDULE_CHANGE_EMAIL_RESEND-航变邮件重发; 示例：`ORDER_CREATE`","x-java-type":"String"},"logContent":{"type":"string","description":"日志内容; 示例：`订单创建成功`","x-java-type":"String"},"operator":{"type":"string","description":"操作人; 示例：`admin`","x-java-type":"String"},"operatorType":{"type":"integer","description":"操作人类型；枚举取值：1-系统、2-用户、3-管理员; 示例：`1`","x-java-type":"Integer","format":"int32"},"relationId":{"type":"string","description":"关联id（如改签申请ID、退票申请ID等）; 示例：`REF001`","x-java-type":"String"},"beforeStatus":{"type":"string","description":"操作前状态; 示例：`1`","x-java-type":"String"},"afterStatus":{"type":"string","description":"操作后状态; 示例：`2`","x-java-type":"String"},"operateTime":{"type":"string","description":"操作时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"logCode":{"type":"string","description":"日志编码；枚举取值：CREATE_ORDER_SUCCESS-订单创建成功、PAY_SUCCESS-订单支付成功、PAY_FAIL-订单支付失败、ORDER_ISSUED-订单已出票、CANCEL_TIMEOUT-订单超时取消、CANCEL_USER_REQUEST-用户取消订单、CANCEL_SUPPLIER-供应商取消订单、CANCEL_FAIL-取消订单失败、REFUND_SUCCESS-退款成功、REFUND_FAIL-退款失败、REFUND_OFFLINE-线下退款、SCHEDULE_CHANGE-航变通知、EMAIL_SEND_SUCCESS-邮件发送成功、EMAIL_SEND_FAIL-邮件发送失败、SCHEDULE_CHANGE_PROCESSED-航变已处理、SCHEDULE_CHANGE_IGNORED-航变已忽略、MANUAL_ISSUE-手工出票、REFUND_APPLY_SUBMITTED-退票申请已提交、CHANGE_APPLY_SUBMITTED-改签申请已提交、CHANGE_ORDER_PAY_SUCCESS-改签订单支付成功、CHANGE_ORDER_PAY_FAIL-改签订单支付失败、CHANGE_PAY_TIMEOUT_AUTO_CANCEL-改签支付超时自动取消、CHANGE_USER_CANCEL_PENDING_PAYMENT-用户取消改签（待支付）、CHANGE_USER_CANCEL_PENDING_AUDIT-用户取消改签（待审核）、REFUND_USER_CONFIRM_TO_REFUNDING-用户确认退票、REFUND_USER_CANCEL_FROM_PENDING_CONFIRM-用户取消退票（待确认）、REFUND_USER_CANCEL_FROM_PENDING_AUDIT-用户取消退票（待审核）、CHANGE_ADMIN_AUDIT_PASS-后台改签审核通过、CHANGE_ADMIN_AUDIT_REJECT-后台改签审核拒绝、CHANGE_ADMIN_TICKET_ISSUED-后台改签出票完成、CHANGE_ADMIN_ORDER_CANCELLED-后台取消改签单、REFUND_ADMIN_AUDIT_PASS-后台退票审核通过、REFUND_ADMIN_AUDIT_REJECT-后台退票审核拒绝、REFUND_ADMIN_REFUND_COMPLETED-后台退票完单、REFUND_ADMIN_REFUND_ABORT-后台取消退票中、CHANGE_SUPPLIER_AUDIT_PASS-供应商改签审核通过、CHANGE_SUPPLIER_AUDIT_REJECT-供应商改签审核拒绝、CHANGE_SUPPLIER_TICKET_ISSUED-供应商改签出票完成、CHANGE_SUPPLIER_ORDER_CANCELLED-供应商取消改签单、REFUND_SUPPLIER_AUDIT_PASS-供应商退票审核通过、REFUND_SUPPLIER_AUDIT_REJECT-供应商退票审核拒绝、REFUND_SUPPLIER_REFUND_COMPLETED-供应商退票完成、REFUND_SUPPLIER_REFUND_ABORT-供应商退票终止/失败、ORDER_FEE_ADJUSTED-调整订单展示费用、SUPPLIER_ORDER_NO_UPDATED-修改供应商订单号、SUPPLIER_CHANGE_ORDER_NO_UPDATED-修改供应商改签单号、SUPPLIER_REFUND_ORDER_NO_UPDATED-修改供应商退票单号; 示例：`CREATE_ORDER_SUCCESS`","x-java-type":"String"},"logParams":{"type":"string","description":"日志参数; 示例：`123`","x-java-type":"String"}},"required":["logType","logContent","operator","operatorType","operateTime","logCode","logParams"]}},"orderPayInfo":{"type":"object","description":"支付信息","x-java-type":"OrderPayInfoVo","properties":{"paymentMethod":{"type":"integer","description":"支付方式：0信用卡，1额度; 示例：`0`","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"订单总收入; 示例：`1180.00`","x-java-type":"BigDecimal"},"refundAmount":{"type":"number","description":"订单退还金额; 示例：`0.00`","x-java-type":"BigDecimal"},"payAmount":{"type":"number","description":"订单支付金额; 示例：`1180.00`","x-java-type":"BigDecimal"},"payDetailList":{"type":"object","description":"订单支付明细","x-java-type":"AdminOrderFeeVo","properties":{"totalFee":{"type":"number","description":"总费用; 示例：`1180.00`","x-java-type":"BigDecimal"},"totalRefund":{"type":"number","description":"总退款金额; 示例：`0.00`","x-java-type":"BigDecimal"},"payCurrency":{"type":"string","description":"支付币种; 示例：`CNY`","x-java-type":"String"},"payTime":{"type":"string","description":"支付时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"payLateTime":{"type":"string","description":"最晚支付时间; 示例：`2025-01-01 14:00:00`","x-java-type":"String"},"payStatus":{"type":"integer","description":"支付状态；枚举取值：0-待支付、1-已支付、2-支付失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"payMethod":{"type":"integer","description":"支付方式；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`0`","x-java-type":"Integer","format":"int32"},"payDetailList":{"type":"array","description":"支付明细","x-java-type":"List<AdminOrderPayDetailVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票价; 示例：`1000.00`","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"税费; 示例：`100.00`","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"服务费; 示例：`30.00`","x-java-type":"BigDecimal"},"totalAmount":{"type":"number","description":"总金额（票价+税费）; 示例：`1130.00`","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"passengerCount":{"type":"integer","description":"人数; 示例：`1`","x-java-type":"Integer","format":"int32"},"markupAmount":{"type":"number","description":"产品加幅金额（按乘客类型分摊）; 示例：`40.00`","x-java-type":"BigDecimal"},"fareDiff":{"type":"number","description":"票税差。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"改签手续费。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用。","x-java-type":"BigDecimal"}},"required":["passengerType","ticketPrice","tax","serviceFee","totalAmount","currency","passengerCount","markupAmount"]}},"refundDetailList":{"type":"array","description":"退款列表","x-java-type":"List<AdminOrderRefundDetailVo>","items":{"type":"object","properties":{"refundAmount":{"type":"number","description":"退改金额; 示例：`500.00`","x-java-type":"BigDecimal"},"refundTime":{"type":"string","description":"退改时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"refundStatus":{"type":"integer","description":"退改状态：3-退款成功; 示例：`3`","x-java-type":"Integer","format":"int32"},"refundMethod":{"type":"integer","description":"退改方式：0-信用卡，1-挂账; 示例：`0`","x-java-type":"Integer","format":"int32"}}}},"orderTransactionFee":{"type":"number","description":"订单交易手续费; 示例：`50.00`","x-java-type":"BigDecimal"},"feeCalculationType":{"type":"string","description":"手续费计算类型：percentage-按比例、fixed-固定金额；枚举取值：percentage-按比例、fixed-固定金额; 示例：`percentage`","x-java-type":"String"},"feeValue":{"type":"number","description":"手续费计费值; 示例：`3.00`","x-java-type":"BigDecimal"},"feePayer":{"type":"string","description":"手续费承担方：customer/platform/waived; 示例：`customer`","x-java-type":"String"},"totalPayAmount":{"type":"number","description":"总支付金额（含手续费）; 示例：`1230.00`","x-java-type":"BigDecimal"},"orderServiceFee":{"type":"number","description":"订单服务费; 示例：`50.00`","x-java-type":"BigDecimal"}},"required":["totalFee","totalRefund","payCurrency","payTime","payLateTime","payStatus","payMethod","payDetailList","refundDetailList","orderTransactionFee","totalPayAmount","orderServiceFee"]},"payRecordList":{"type":"array","description":"订单支付流水","x-java-type":"List<PayRecordVo>","items":{"type":"object","properties":{"payRecordType":{"type":"integer","description":"支付记录类型；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`1`","x-java-type":"Integer","format":"int32"},"payRecordAmount":{"type":"number","description":"流水金额; 示例：`1180.00`","x-java-type":"BigDecimal"},"payRecordNumber":{"type":"string","description":"交易号; 示例：`PAY202501010001`","x-java-type":"String"},"payRecordChannel":{"type":"integer","description":"支付渠道；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`1`","x-java-type":"Integer","format":"int32"},"payRecordStatus":{"type":"integer","description":"状态；枚举取值：1-已支付、2-支付失败、3-退款成功、4-退款失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"payRecordRemark":{"type":"string","description":"备注; 示例：`支付成功`","x-java-type":"String"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"payFailReason":{"type":"string","description":"失败原因","x-java-type":"String"}},"required":["payRecordType","payRecordAmount","payRecordChannel","payRecordStatus","payRecordRemark","currency"]}},"fareDiff":{"type":"number","description":"票税差（仅改签单有值）; 示例：`120.00`","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费（仅改签单有值）; 示例：`30.00`","x-java-type":"BigDecimal"},"changeTaxFee":{"type":"number","description":"改签税费（仅改签单有值）; 示例：`50.00`","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用（仅改签单有值）; 示例：`10.00`","x-java-type":"BigDecimal"}},"required":["paymentMethod","totalAmount","refundAmount","payAmount","payDetailList","payRecordList"]},"orderTripInfo":{"type":"array","description":"行程信息","x-java-type":"List<OrderTripInfoVo>","items":{"type":"object","properties":{"segment":{"type":"array","description":"行程段信息","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","takeOffTerminal","arrivalTerminal","stopoverInfos","cabin","cabinClass","supplierOrderNo","pnr","aircraftCode"]}},"originZh":{"type":"string","description":"出发地（中文）; 示例：`北京`","x-java-type":"String"},"originEn":{"type":"string","description":"出发地（英文）; 示例：`Beijing`","x-java-type":"String"},"originTc":{"type":"string","description":"出发地（繁体）; 示例：`北京`","x-java-type":"String"},"destinationZh":{"type":"string","description":"目的地（中文）; 示例：`上海`","x-java-type":"String"},"destinationEn":{"type":"string","description":"目的地（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationTc":{"type":"string","description":"目的地（繁体）; 示例：`上海`","x-java-type":"String"},"journeysTime":{"type":"string","description":"行程耗时; 示例：`150`","x-java-type":"String"},"baggageChangeRefundRuleVo":{"type":"object","description":"退改条件","x-java-type":"AdminBaggageChangeRefundRuleVo","properties":{"baggageChangeRefundRuleList":{"type":"array","description":"行李额规则列表","x-java-type":"List<AdminBaggageRuleItemVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"depTime":{"type":"string","description":"航段始发日期+时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"depCityZh":{"type":"string","description":"航段出发地（中文）; 示例：`北京`","x-java-type":"String"},"depCityEn":{"type":"string","description":"航段出发地（英文）; 示例：`Beijing`","x-java-type":"String"},"depCityTc":{"type":"string","description":"航段出发地（繁体）; 示例：`北京`","x-java-type":"String"},"depCityCode":{"type":"string","description":"航段出发地三字码; 示例：`PEK`","x-java-type":"String"},"arrCityZh":{"type":"string","description":"航段目的地（中文）; 示例：`上海`","x-java-type":"String"},"arrCityEn":{"type":"string","description":"航段目的地（英文）; 示例：`Shanghai`","x-java-type":"String"},"arrCityTc":{"type":"string","description":"航段目的地（繁体）; 示例：`上海`","x-java-type":"String"},"arrCityCode":{"type":"string","description":"航段目的地三字码; 示例：`SHA`","x-java-type":"String"},"flightNo":{"type":"string","description":"航段航班号; 示例：`CA1234`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierCode":{"type":"string","description":"航司二字码; 示例：`CA`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"baggageList":{"type":"array","description":"行李额列表","x-java-type":"List<AdminBaggageItemVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"carryOnPieces":{"type":"integer","description":"手提行李件数; 示例：`1`","x-java-type":"int","format":"int32"},"carryOnWeight":{"type":"integer","description":"手提行李重量; 示例：`7`","x-java-type":"int","format":"int32"},"carryOnWeightUnit":{"type":"string","description":"手提行李重量单位; 示例：`KG`","x-java-type":"String"},"carryOnSize":{"type":"string","description":"手提行李尺寸; 示例：`55x40x20cm`","x-java-type":"String"},"carryOnDescriptionEn":{"type":"string","description":"手提行李描述（英文）; 示例：`1 piece, 7kg`","x-java-type":"String"},"carryOnDescriptionTc":{"type":"string","description":"手提行李描述（繁体）; 示例：`1件，7公斤`","x-java-type":"String"},"carryOnDescriptionZh":{"type":"string","description":"手提行李描述（中文）; 示例：`1件，7公斤`","x-java-type":"String"},"checkedPieces":{"type":"integer","description":"托运行李件数; 示例：`1`","x-java-type":"int","format":"int32"},"checkedWeight":{"type":"integer","description":"托运行李重量; 示例：`23`","x-java-type":"int","format":"int32"},"checkedWeightUnit":{"type":"string","description":"托运行李重量单位; 示例：`KG`","x-java-type":"String"},"checkedSize":{"type":"string","description":"托运行李尺寸; 示例：`158cm`","x-java-type":"String"},"checkedDescriptionZh":{"type":"string","description":"托运行李描述（中文）; 示例：`1件，23公斤`","x-java-type":"String"},"checkedDescriptionTc":{"type":"string","description":"托运行李描述（繁体）; 示例：`1件，23公斤`","x-java-type":"String"},"checkedDescriptionEn":{"type":"string","description":"托运行李描述（英文）; 示例：`1 piece, 23kg`","x-java-type":"String"}},"required":["passengerType","carryOnPieces","carryOnWeight","carryOnWeightUnit","carryOnSize","carryOnDescriptionEn","carryOnDescriptionTc","carryOnDescriptionZh","checkedPieces","checkedWeight","checkedWeightUnit","checkedSize","checkedDescriptionZh","checkedDescriptionTc","checkedDescriptionEn"]}}},"required":["segmentId","depTime","depCityZh","depCityEn","depCityTc","depCityCode","arrCityZh","arrCityEn","arrCityTc","arrCityCode","flightNo","carrierNameZh","carrierNameEn","carrierNameTc","carrierCode","carrierLogo","baggageList"]}},"changeRuleList":{"type":"array","description":"改签规则列表","x-java-type":"List<RefundSegmentVo>","items":{"type":"object","properties":{"nodeTime":{"type":"string","description":"节点时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"beforeAfter":{"type":"boolean","description":"是否为节点前; 示例：`true`","x-java-type":"Boolean"},"adultChargeFee":{"type":"number","description":"成人手续费; 示例：`200.00`","x-java-type":"BigDecimal"},"childChargeFee":{"type":"number","description":"儿童手续费; 示例：`100.00`","x-java-type":"BigDecimal"},"infantChargeFee":{"type":"number","description":"婴儿手续费; 示例：`0.00`","x-java-type":"BigDecimal"},"dayCount":{"type":"integer","description":"天数; 示例：`1`","x-java-type":"Integer","format":"int32"},"hourCount":{"type":"integer","description":"小时; 示例：`8`","x-java-type":"Integer","format":"int32"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"changeOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段号","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号","x-java-type":"String"}},"required":["nodeTime","beforeAfter","adultChargeFee","dayCount","hourCount","changeOriginalText","segmentId","segmentIndex","flightNumber"]}},"refundRuleList":{"type":"array","description":"退票规则列表","x-java-type":"List<RefundSegmentVo>","items":{"type":"object","properties":{"nodeTime":{"type":"string","description":"节点时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"beforeAfter":{"type":"boolean","description":"是否为节点前; 示例：`true`","x-java-type":"Boolean"},"adultChargeFee":{"type":"number","description":"成人手续费; 示例：`200.00`","x-java-type":"BigDecimal"},"childChargeFee":{"type":"number","description":"儿童手续费; 示例：`100.00`","x-java-type":"BigDecimal"},"infantChargeFee":{"type":"number","description":"婴儿手续费; 示例：`0.00`","x-java-type":"BigDecimal"},"dayCount":{"type":"integer","description":"天数; 示例：`1`","x-java-type":"Integer","format":"int32"},"hourCount":{"type":"integer","description":"小时; 示例：`8`","x-java-type":"Integer","format":"int32"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"changeOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段号","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号","x-java-type":"String"}},"required":["nodeTime","beforeAfter","adultChargeFee","dayCount","hourCount","changeOriginalText","segmentId","segmentIndex","flightNumber"]}},"flightChangeRuleVOList":{"type":"array","description":"改签规则列表","x-java-type":"List<FlightChangeRuleVo>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"changeOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segment":{"type":"object","description":"航段实体对象","x-java-type":"SegmentVo","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}}}},"required":["passengerType","changeOriginalText","segmentId"]}},"flightRefundRuleVoList":{"type":"array","description":"退票规则列表","x-java-type":"List<FlightRefundRuleVo>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"refundOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segment":{"type":"object","description":"航段实体对象","x-java-type":"SegmentVo","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}}}},"required":["passengerType","refundOriginalText","segmentId"]}}},"required":["baggageChangeRefundRuleList","changeRuleList","refundRuleList","flightChangeRuleVOList","flightRefundRuleVoList"]}},"required":["segment","originZh","originEn","originTc","destinationZh","destinationEn","destinationTc","baggageChangeRefundRuleVo"]}},"orderQuoteInfo":{"type":"array","description":"报价信息","x-java-type":"List<OrderQuoteInfoVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票价; 示例：`1000.00`","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"税费; 示例：`100.00`","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"服务费; 示例：`30.00`","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"totalPrice":{"type":"number","description":"总价（票面价+税费+服务费）; 示例：`1130.00`","x-java-type":"BigDecimal"},"productMarkupAmount":{"type":"number","description":"产品加幅金额（按乘客类型分摊）; 示例：`40.00`","x-java-type":"BigDecimal"}},"required":["passengerType","ticketPrice","tax","serviceFee","currency","totalPrice","productMarkupAmount"]}},"orderPassengerInfo":{"type":"array","description":"乘客信息","x-java-type":"List<OrderPassengerInfoVo>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘客ID; 示例：`101`","x-java-type":"Long","format":"int64"},"passengerName":{"type":"string","description":"乘机人姓名; 示例：`ZHANG/SAN`","x-java-type":"String"},"firstName":{"type":"string","description":"乘机人姓; 示例：`ZHANG`","x-java-type":"String"},"lastName":{"type":"string","description":"乘机人名; 示例：`SAN`","x-java-type":"String"},"passengerType":{"type":"string","description":"乘机人类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"country":{"type":"string","description":"国籍; 示例：`CN`","x-java-type":"String"},"sex":{"type":"integer","description":"性别：0男，1女; 示例：`0`","x-java-type":"Integer","format":"int32"},"certificate":{"type":"string","description":"证件号码; 示例：`E12345678`","x-java-type":"String"},"certificateType":{"type":"integer","description":"证件类型；枚举取值：1-身份证、2-护照、3-军官证、4-国际海员证、5-港澳通行证、6-台湾通行证、7-台胞证、8-回乡证、9-学生证、10-外国人居留证、11-其他; 示例：`1`","x-java-type":"Integer","format":"int32"},"certificateValidity":{"type":"string","description":"证件有效期; 示例：`2030-01-01`","x-java-type":"String"},"birthDate":{"type":"string","description":"出生日期; 示例：`1990-01-01`","x-java-type":"String"},"phone":{"type":"string","description":"手机号; 示例：`13800138000`","x-java-type":"String"},"email":{"type":"string","description":"邮箱; 示例：`example@test.com`","x-java-type":"String"},"cardCode":{"type":"string","description":"常旅客卡航司; 示例：`CA`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"常旅客卡航司名称（简体中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"常旅客卡航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"常旅客卡航司名称（繁体中文）; 示例：`中國國際航空`","x-java-type":"String"},"cardNumber":{"type":"string","description":"常旅客卡号; 示例：`123456789`","x-java-type":"String"},"ticketNumber":{"type":"string","description":"票号; 示例：`999-1234567890`","x-java-type":"String"},"ticketStatus":{"type":"integer","description":"票状态；枚举取值：0-待出票、1-已出票、2-已退票、3-已改签; 示例：`1`","x-java-type":"Integer","format":"int32"},"ticketDetails":{"type":"array","description":"按航段的票号明细列表","x-java-type":"List<TicketDetailVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"ticketNo":{"type":"string","description":"票号; 示例：`999-1234567890`","x-java-type":"String"},"ticketStatus":{"type":"integer","description":"票号状态：1已出票 2已退票 3已改签; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["segmentId","ticketStatus"]}}},"required":["passengerId","passengerName","passengerType","country","sex","certificate","certificateType","certificateValidity","birthDate","phone","email","cardCode","carrierNameZh","carrierNameEn","carrierNameTc","cardNumber","ticketNumber","ticketStatus","ticketDetails"]}},"orderChangeInfo":{"type":"array","description":"改签记录","x-java-type":"List<OrderChangeInfoVo>","items":{"type":"object","properties":{"changeOrderNo":{"type":"string","description":"改签单号; 示例：`CHG202501010001`","x-java-type":"String"},"applicantName":{"type":"string","description":"申请人; 示例：`张三`","x-java-type":"String"},"beforeSegmentInfo":{"type":"string","description":"改签前航段信息; 示例：`PEK-SHA`","x-java-type":"String"},"beforeSegmentDetailList":{"type":"array","description":"改签前航段明细","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","takeOffTerminal","arrivalTerminal","stopoverInfos","cabin","cabinClass","supplierOrderNo","pnr","aircraftCode"]}},"afterSegmentInfo":{"type":"string","description":"改签后航段信息; 示例：`PEK-CAN`","x-java-type":"String"},"afterSegmentDetailList":{"type":"array","description":"改签后航段明细","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","takeOffTerminal","arrivalTerminal","stopoverInfos","cabin","cabinClass","supplierOrderNo","pnr","aircraftCode"]}},"changePassengerName":{"type":"string","description":"改签乘客; 示例：`ZHANG/SAN`","x-java-type":"String"},"applyTime":{"type":"string","description":"申请时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"changeFee":{"type":"number","description":"改签费用; 示例：`200.00`","x-java-type":"BigDecimal"},"changeStatus":{"type":"integer","description":"改签状态；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; 示例：`1`","x-java-type":"Integer","format":"int32"}}}},"orderRefundInfo":{"type":"array","description":"退票记录","x-java-type":"List<OrderRefundInfoVo>","items":{"type":"object","properties":{"refundOrderNo":{"type":"string","description":"退票订单号; 示例：`REF202501010001`","x-java-type":"String"},"applicantName":{"type":"string","description":"申请人; 示例：`张三`","x-java-type":"String"},"refundTrip":{"type":"string","description":"退票行程; 示例：`北京-上海`","x-java-type":"String"},"refundSegmentDetailList":{"type":"array","description":"退票航段明细","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","takeOffTerminal","arrivalTerminal","stopoverInfos","cabin","cabinClass","supplierOrderNo","pnr","aircraftCode"]}},"refundPassengerName":{"type":"string","description":"退票乘客姓名; 示例：`ZHANG/SAN`","x-java-type":"String"},"refundApplyTime":{"type":"string","description":"退票申请时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"refundAmount":{"type":"number","description":"退款金额; 示例：`180.00`","x-java-type":"BigDecimal"},"refundStatus":{"type":"integer","description":"退票状态；枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票; 示例：`1`","x-java-type":"Integer","format":"int32"}}}},"orderScheduleChangeInfo":{"type":"array","description":"航变记录","x-java-type":"List<OrderScheduleChangeInfoVo>","items":{"type":"object","properties":{"changeType":{"type":"integer","description":"航变类型；枚举取值：1-航班延误、2-航班取消、3-航班提前、4-航班变更、5-航班待定、6-恢复; 示例：`1`","x-java-type":"Integer","format":"int32"},"segmentId":{"type":"string","description":"航程id; 示例：`SEG001`","x-java-type":"String"},"originalAirlineLogo":{"type":"string","description":"原航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"originalAirlineNameEn":{"type":"string","description":"原航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"originalAirlineNameZh":{"type":"string","description":"原航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"originalFlightNameTc":{"type":"string","description":"原航班名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"originalFlightNumber":{"type":"string","description":"原航班号; 示例：`CA1234`","x-java-type":"String"},"originalTakeOffTime":{"type":"string","description":"原起飞时间; 示例：`2025-01-15 08:00:00`","x-java-type":"String"},"originalArrivalTime":{"type":"string","description":"原到达时间; 示例：`2025-01-15 10:30:00`","x-java-type":"String"},"originalFromCityEn":{"type":"string","description":"原出发城市（英文）; 示例：`Beijing`","x-java-type":"String"},"originalFromCityZh":{"type":"string","description":"原出发城市（中文）; 示例：`北京`","x-java-type":"String"},"originalFromCityTc":{"type":"string","description":"原出发城市（繁体）; 示例：`北京`","x-java-type":"String"},"originalToCityEn":{"type":"string","description":"原到达城市（英文）; 示例：`Shanghai`","x-java-type":"String"},"originalToCityZh":{"type":"string","description":"原到达城市（中文）; 示例：`上海`","x-java-type":"String"},"originalToCityTc":{"type":"string","description":"原到达城市（繁体）; 示例：`上海`","x-java-type":"String"},"originalFromCityCode":{"type":"string","description":"原出发城市三字码; 示例：`PEK`","x-java-type":"String"},"originalToCityCode":{"type":"string","description":"原到达城市三字码; 示例：`SHA`","x-java-type":"String"},"originalDepartureAirportCode":{"type":"string","description":"原出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originalArrivalAirportCode":{"type":"string","description":"原到达机场三字码; 示例：`SHA`","x-java-type":"String"},"originalTakeOffAirportEn":{"type":"string","description":"原起飞机场（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"originalTakeOffAirportZh":{"type":"string","description":"原起飞机场（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originalTakeOffAirportTc":{"type":"string","description":"原起飞机场（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"originalTakeOffTerminal":{"type":"string","description":"原出发航站楼; 示例：`T3`","x-java-type":"String"},"originalArrivalTerminal":{"type":"string","description":"原到达航站楼; 示例：`T2`","x-java-type":"String"},"originalAircraftModel":{"type":"string","description":"原机型; 示例：`B738`","x-java-type":"String"},"originalFlightTime":{"type":"string","description":"原飞行时间; 示例：`150`","x-java-type":"String"},"originalCabinClass":{"type":"string","description":"原舱等; 示例：`Y`","x-java-type":"String"},"originalArrivalAirportEn":{"type":"string","description":"原到达机场（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"originalArrivalAirportZh":{"type":"string","description":"原到达机场（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"originalArrivalAirportTc":{"type":"string","description":"原到达机场（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"newAirlineLogo":{"type":"string","description":"新航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"newAirlineNameEn":{"type":"string","description":"新航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"newFlightNameZh":{"type":"string","description":"新航班名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"newFlightNameTc":{"type":"string","description":"新航班名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"newFlightNumber":{"type":"string","description":"新航班号; 示例：`CA5678`","x-java-type":"String"},"newTakeOffTime":{"type":"string","description":"新起飞时间; 示例：`2025-01-15 10:00:00`","x-java-type":"String"},"newArrivalTime":{"type":"string","description":"新到达时间; 示例：`2025-01-15 12:30:00`","x-java-type":"String"},"newFromCityEn":{"type":"string","description":"新出发城市（英文）; 示例：`Beijing`","x-java-type":"String"},"newFromCityZh":{"type":"string","description":"新出发城市（中文）; 示例：`北京`","x-java-type":"String"},"newFromCityTc":{"type":"string","description":"新出发城市（繁体）; 示例：`北京`","x-java-type":"String"},"newToCityEn":{"type":"string","description":"新到达城市（英文）; 示例：`Shanghai`","x-java-type":"String"},"newToCityZh":{"type":"string","description":"新到达城市（中文）; 示例：`上海`","x-java-type":"String"},"newToCityTc":{"type":"string","description":"新到达城市（繁体）; 示例：`上海`","x-java-type":"String"},"newFromCityCode":{"type":"string","description":"新出发城市三字码; 示例：`PEK`","x-java-type":"String"},"newDepartureAirportCode":{"type":"string","description":"新出发机场三字码; 示例：`PEK`","x-java-type":"String"},"newToCityCode":{"type":"string","description":"新到达城市三字码; 示例：`SHA`","x-java-type":"String"},"newArrivalAirportCode":{"type":"string","description":"新到达机场三字码; 示例：`SHA`","x-java-type":"String"},"newTakeOffAirportEn":{"type":"string","description":"新起飞机场（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"newTakeOffAirportZh":{"type":"string","description":"新起飞机场（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"newTakeOffAirportTc":{"type":"string","description":"新起飞机场（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"newArrivalAirportEn":{"type":"string","description":"新到达机场（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"newArrivalAirportZh":{"type":"string","description":"新到达机场（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"newArrivalAirportTc":{"type":"string","description":"新到达机场（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"newTakeOffTerminal":{"type":"string","description":"新出发航站楼; 示例：`T3`","x-java-type":"String"},"newArrivalTerminal":{"type":"string","description":"新到达航站楼; 示例：`T2`","x-java-type":"String"},"newAircraftModel":{"type":"string","description":"新机型; 示例：`B738`","x-java-type":"String"},"newFlightTime":{"type":"string","description":"新飞行时间; 示例：`150`","x-java-type":"String"},"newCabinClass":{"type":"string","description":"新舱等; 示例：`Y`","x-java-type":"String"},"changeDescriptionEn":{"type":"string","description":"航变原因（英文）; 示例：`Flight delayed due to weather`","x-java-type":"String"},"changeDescriptionZh":{"type":"string","description":"航变原因（中文）; 示例：`因天气原因航班延误`","x-java-type":"String"},"changeDescriptionTc":{"type":"string","description":"航变原因（繁体）; 示例：`因天氣原因航班延誤`","x-java-type":"String"},"createTime":{"type":"string","description":"创建时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"}}}},"orderRemarkRespList":{"type":"array","description":"BMS机票订单或退票单备注列表，按最新备注优先排序","x-java-type":"List<FlightOrderRemarkResult>","items":{"type":"object","properties":{"id":{"type":"integer","description":"备注ID","x-java-type":"Long","format":"int64"},"orderCode":{"type":"string","description":"备注目标编码：机票订单号或退票申请单号","x-java-type":"String"},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注","x-java-type":"Integer","format":"int32"},"content":{"type":"string","description":"备注内容","x-java-type":"String"},"operatorEmail":{"type":"string","description":"备注人邮箱","x-java-type":"String"},"createdDt":{"type":"string","description":"备注时间; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"}}}},"feeAdjustment":{"type":"object","description":"机票订单人工调整后的展示费用","x-java-type":"FlightOrderFeeAdjustmentRespDTO","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"version":{"type":"integer","description":"版本号，首次调整前为0","x-java-type":"Integer","format":"int32"},"adjusted":{"type":"boolean","description":"是否已经发生过人工调整","x-java-type":"Boolean"},"totalAmount":{"type":"number","description":"调整后的售价总计","x-java-type":"BigDecimal"},"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿","x-java-type":"String"},"passengerCount":{"type":"integer","description":"人数","x-java-type":"Integer","format":"int32"},"ticketPrice":{"type":"number","description":"单人票面价","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"单人税费及附加费","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"单人服务费","x-java-type":"BigDecimal"},"subtotal":{"type":"number","description":"乘客类型小计","x-java-type":"BigDecimal"}},"required":["passengerType","passengerCount","ticketPrice","tax","serviceFee","subtotal"]}}},"required":["orderCode","currency","version","adjusted","totalAmount","items"]}},"required":["orderDetail","orderLogs","orderPayInfo","orderTripInfo","orderQuoteInfo","orderPassengerInfo","orderChangeInfo","orderRefundInfo","orderScheduleChangeInfo","orderRemarkRespList","feeAdjustment"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/order/supplier-order-no":{"put":{"operationId":"bms.putOrderFlightOrderSupplierOrderNo","x-api-code":"bms.putOrderFlightOrderSupplierOrderNo","x-open-platform-sort":93,"summary":"修改正单供应商订单号","description":"**接口：** `PUT /bms/order/flight/order/supplier-order-no`\n\n修改机票正单对应的供应商订单号。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"正单订单号; 不可为空白字符串","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 不可为空白字符串；长度/元素数：最大 128","x-java-type":"String","maxLength":128}},"required":["orderCode","supplierOrderNo"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderSupplierNoUpdateResp","properties":{"orderCode":{"type":"string","description":"正单订单号; 示例：`FO202610190001`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"更新后的供应商订单号; 示例：`SUP202610190001`","x-java-type":"String"}},"required":["orderCode","supplierOrderNo"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/order/remark/add":{"post":{"operationId":"bms.postOrderFlightOrderRemarkAdd","x-api-code":"bms.postOrderFlightOrderRemarkAdd","x-open-platform-sort":94,"summary":"新增机票订单或退票单备注","description":"**接口：** `POST /bms/order/flight/order/remark/add`\n\n给机票订单或退票单新增备注。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"备注目标编码：正单/改签单传订单编码，退票单传退票申请单号; 不可为空白字符串；长度/元素数：最大 64","x-java-type":"String","maxLength":64},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注; 不可为 null；≥ 1；≤ 3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3},"content":{"type":"string","description":"备注内容，去除首尾空格后最大500字符; 不可为空白字符串；长度/元素数：最大 500","x-java-type":"String","maxLength":500}},"required":["orderCode","remarkType","content"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderRemarkAddResp","properties":{"id":{"type":"integer","description":"备注ID","x-java-type":"Long","format":"int64"},"orderCode":{"type":"string","description":"备注目标编码：机票订单号或退票申请单号","x-java-type":"String"},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注","x-java-type":"Integer","format":"int32"},"content":{"type":"string","description":"备注内容","x-java-type":"String"},"operatorEmail":{"type":"string","description":"备注人邮箱","x-java-type":"String"},"createdDt":{"type":"string","description":"备注时间; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"}},"required":["id","orderCode","remarkType","content","operatorEmail","createdDt"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/issue":{"put":{"operationId":"bms.putOrderFlightIssue","x-api-code":"bms.putOrderFlightIssue","x-open-platform-sort":95,"summary":"手工出票","description":"**接口：** `PUT /bms/order/flight/issue`\n\n对订单执行人工出票操作。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"},"targetStatus":{"type":"integer","description":"目标订单状态：4-已出票; 不可为 null；≥ 4；≤ 4","x-java-type":"Integer","format":"int32","minimum":4,"maximum":4},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 长度/元素数：最大 20","x-java-type":"String","maxLength":20},"airlineCodes":{"type":"array","description":"航空公司记录编号列表","x-java-type":"List<String>","items":{"type":"string"}},"tickets":{"type":"array","description":"票号信息列表; 校验嵌套对象/数组元素","x-java-type":"List<ManualIssueTicketDTO>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘客ID; 不可为 null","x-java-type":"Long","format":"int64"},"segmentId":{"type":"string","description":"航段ID; 不可为空白字符串","x-java-type":"String"},"ticketNo":{"type":"string","description":"票号; 不可为空白字符串","x-java-type":"String"}},"required":["passengerId","segmentId","ticketNo"]}}},"required":["orderCode","targetStatus"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderManualIssueResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/admin-cancel":{"put":{"operationId":"bms.putOrderFlightAdminCancel","x-api-code":"bms.putOrderFlightAdminCancel","x-open-platform-sort":96,"summary":"管理端取消订单","description":"**接口：** `PUT /bms/order/flight/admin-cancel`\n\n由管理后台取消机票订单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串；示例：`FO202501010001`","x-java-type":"String"},"cancelReason":{"type":"string","description":"取消原因; 示例：`行程变更`","x-java-type":"String"}},"required":["orderCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightOrderAdminCancelResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/create":{"post":{"operationId":"bms.postOrderFlightCreate","x-api-code":"bms.postOrderFlightCreate","x-open-platform-sort":97,"summary":"创建机票手工单","description":"**接口：** `POST /bms/order/flight/create`\n\n后台录入机票手工订单，支持语言请求头。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"header","name":"language","required":false,"schema":{"type":"string","description":"语言代码","x-java-type":"String"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentCode":{"type":"string","description":"客户编码; 不可为空白字符串","x-java-type":"String"},"tripType":{"type":"integer","description":"行程类型；枚举取值：1-单程、2-往返、3-多程; 不可为 null；≥ 1；≤ 3；允许值：1,2,3","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3},"orderStatus":{"type":"integer","description":"订单状态；枚举取值：2-待支付、3-待出票、4-已出票、6-已取消; 不可为 null；允许值：2,3,4,6；自定义订单状态校验：仅允许 2、3、4、6","x-java-type":"Integer","format":"int32"},"supplierOrderNo":{"type":"string","description":"供应商单号","x-java-type":"String"},"pnr":{"type":"string","description":"PNR编码","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号","x-java-type":"String"},"remark":{"type":"string","description":"备注","x-java-type":"String"},"journeys":{"type":"array","description":"航程列表; 不可为空集合或空值；长度/元素数：最小 1，最大 5；校验嵌套对象/数组元素","x-java-type":"List<FlightManualJourneyDTO>","items":{"type":"object","properties":{"origin":{"type":"string","description":"出发机场三字码; 不可为空白字符串","x-java-type":"String"},"destination":{"type":"string","description":"到达机场三字码; 不可为空白字符串","x-java-type":"String"},"isStopOver":{"type":"integer","description":"是否中转：0-否，1-是; 不可为 null；≥ 0；≤ 1；允许值：0,1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"segments":{"type":"array","description":"航段列表; 不可为空集合或空值；长度/元素数：最小 1，最大 5；校验嵌套对象/数组元素","x-java-type":"List<FlightManualSegmentDTO>","items":{"type":"object","properties":{"flightNumber":{"type":"string","description":"航班号; 不可为空白字符串","x-java-type":"String"},"airlineCode":{"type":"string","description":"航司二字码; 不可为空白字符串","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 不可为空白字符串","x-java-type":"String"},"departureDate":{"type":"string","description":"出发日期; 不可为 null；日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"departureTime":{"type":"string","description":"出发时间; 不可为 null","x-java-type":"LocalTime"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 不可为空白字符串","x-java-type":"String"},"arrivalDate":{"type":"string","description":"到达日期; 不可为 null；日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"arrivalTime":{"type":"string","description":"到达时间; 不可为 null","x-java-type":"LocalTime"},"cabinClass":{"type":"string","description":"舱位等级；枚举取值：economy-经济舱、business-商务舱、first-头等舱、premium_economy-超级经济舱; 不可为空白字符串；正则：`^(economy&#124;business&#124;first&#124;premium_economy)$`；允许值：economy,business,first,premium_economy","x-java-type":"String","pattern":"^(economy|business|first|premium_economy)$"},"cabin":{"type":"string","description":"舱位代码","x-java-type":"String"},"departureTerminal":{"type":"string","description":"出发航站楼","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长","x-java-type":"String"},"baggageRules":{"type":"array","description":"行李规则，按乘客类型保存; 校验嵌套对象/数组元素","x-java-type":"List<FlightManualBaggageRuleDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 不可为空白字符串；正则：`^(adult&#124;child&#124;infant)$`；允许值：adult,child,infant","x-java-type":"String","pattern":"^(adult|child|infant)$"},"carryOnAllowanceType":{"type":"string","description":"手提行李规则类型；枚举取值：PIECE_WEIGHT-按件且限制每件重量、WEIGHT_ONLY-仅限制总重量、NOT_INCLUDED-不包含行李、AIRLINE_STANDARD-以航司客规为准; 不可为空白字符串；正则：`^(PIECE_WEIGHT&#124;WEIGHT_ONLY&#124;NOT_INCLUDED&#124;AIRLINE_STANDARD)$`；允许值：PIECE_WEIGHT,WEIGHT_ONLY,NOT_INCLUDED,AIRLINE_STANDARD","x-java-type":"String","pattern":"^(PIECE_WEIGHT|WEIGHT_ONLY|NOT_INCLUDED|AIRLINE_STANDARD)$"},"carryOnPieces":{"type":"integer","description":"手提行李件数","x-java-type":"Integer","format":"int32"},"carryOnWeight":{"type":"integer","description":"手提行李重量","x-java-type":"Integer","format":"int32"},"carryOnWeightUnit":{"type":"string","description":"手提行李重量单位；枚举取值：KG-千克、LB-磅; 允许值：KG,LB","x-java-type":"String"},"carryOnSize":{"type":"string","description":"手提行李尺寸","x-java-type":"String"},"checkedAllowanceType":{"type":"string","description":"托运行李规则类型；枚举取值：PIECE_WEIGHT-按件且限制每件重量、WEIGHT_ONLY-仅限制总重量、NOT_INCLUDED-不包含行李、AIRLINE_STANDARD-以航司客规为准; 不可为空白字符串；正则：`^(PIECE_WEIGHT&#124;WEIGHT_ONLY&#124;NOT_INCLUDED&#124;AIRLINE_STANDARD)$`；允许值：PIECE_WEIGHT,WEIGHT_ONLY,NOT_INCLUDED,AIRLINE_STANDARD","x-java-type":"String","pattern":"^(PIECE_WEIGHT|WEIGHT_ONLY|NOT_INCLUDED|AIRLINE_STANDARD)$"},"checkedPieces":{"type":"integer","description":"托运行李件数","x-java-type":"Integer","format":"int32"},"checkedWeight":{"type":"integer","description":"托运行李重量","x-java-type":"Integer","format":"int32"},"checkedWeightUnit":{"type":"string","description":"托运行李重量单位；枚举取值：KG-千克、LB-磅; 允许值：KG,LB","x-java-type":"String"},"checkedSize":{"type":"string","description":"托运行李尺寸","x-java-type":"String"}},"required":["passengerType","carryOnAllowanceType","checkedAllowanceType"]}}},"required":["flightNumber","airlineCode","departureAirport","departureDate","departureTime","arrivalAirport","arrivalDate","arrivalTime","cabinClass"]}}},"required":["origin","destination","isStopOver","segments"]}},"passengers":{"type":"array","description":"乘机人列表; 不可为空集合或空值；长度/元素数：最小 1，最大 9；校验嵌套对象/数组元素","x-java-type":"List<FlightManualPassengerDTO>","items":{"type":"object","properties":{"userId":{"type":"integer","description":"企业员工ID","x-java-type":"Long","format":"int64"},"guestId":{"type":"integer","description":"常旅客ID","x-java-type":"Long","format":"int64"},"passengerType":{"type":"string","description":"乘机人类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 不可为空白字符串；正则：`^(adult&#124;child&#124;infant)$`；允许值：adult,child,infant","x-java-type":"String","pattern":"^(adult|child|infant)$"},"nationalityRegionCode":{"type":"string","description":"国籍代码; 不可为空白字符串","x-java-type":"String"},"lastName":{"type":"string","description":"姓","x-java-type":"String"},"firstName":{"type":"string","description":"名; 不可为空白字符串","x-java-type":"String"},"gender":{"type":"integer","description":"性别；枚举取值：0-男、1-女; 不可为 null；≥ 0；≤ 1；允许值：0,1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"dateOfBirth":{"type":"string","description":"出生日期; 不可为 null；日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"idType":{"type":"integer","description":"证件类型；枚举取值：1-身份证、2-护照、3-军官证、4-国际海员证、5-港澳通行证、6-台湾通行证、7-台胞证、8-回乡证、9-学生证、10-外国人居留证、11-其他; 不可为 null","x-java-type":"Integer","format":"int32"},"idNumber":{"type":"string","description":"证件号码; 不可为空白字符串","x-java-type":"String"},"dateOfExpiration":{"type":"string","description":"证件有效期; 不可为 null；日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"phoneAreaCode":{"type":"string","description":"手机区号; 不可为空白字符串","x-java-type":"String"},"phone":{"type":"string","description":"手机号码; 不可为空白字符串","x-java-type":"String"},"email":{"type":"string","description":"邮箱; 不可为空白字符串；邮箱格式","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票价; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"taxPrice":{"type":"number","description":"税费; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"servicePrice":{"type":"number","description":"服务费; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"ticketNo":{"type":"string","description":"票号","x-java-type":"String"},"frequentFlyerAirline":{"type":"string","description":"常旅客卡航司","x-java-type":"String"},"frequentFlyerCardNo":{"type":"string","description":"常旅客卡号","x-java-type":"String"},"adultPassengerName":{"type":"string","description":"关联成人姓名","x-java-type":"String"}},"required":["passengerType","nationalityRegionCode","firstName","gender","dateOfBirth","idType","idNumber","dateOfExpiration","phoneAreaCode","phone","email","ticketPrice","taxPrice","servicePrice"]}},"contactInfo":{"type":"object","description":"联系人信息; 不可为 null；校验嵌套对象/数组元素","x-java-type":"ContactInfoDTO","properties":{"contactName":{"type":"string","description":"联系人姓名; 不可为空白字符串","x-java-type":"String"},"contactRegion":{"type":"string","description":"联系人区号; 不可为空白字符串","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话; 不可为空白字符串","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱; 不可为空白字符串；邮箱格式","x-java-type":"String"}},"required":["contactName","contactRegion","contactPhone","contactEmail"]}},"required":["agentCode","tripType","orderStatus","journeys","passengers","contactInfo"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightManualOrderCreateResp","properties":{"orderNo":{"type":"string","description":"订单编号; 示例：`FO202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"PNR编码; 示例：`ABC123`","x-java-type":"String"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"status":{"type":"integer","description":"订单状态；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; 示例：`1`","x-java-type":"Integer","format":"int32"},"priceTotal":{"type":"number","description":"订单总价; 示例：`1180.00`","x-java-type":"BigDecimal"},"payTimeLimit":{"type":"string","description":"最晚支付时间; 示例：`2025-01-01 14:00:00`","x-java-type":"String"}},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/status":{"put":{"operationId":"bms.putOrderFlightStatus","x-api-code":"bms.putOrderFlightStatus","x-open-platform-sort":98,"summary":"变更手工单订单状态","description":"**接口：** `PUT /bms/order/flight/status`\n\n人工变更机票手工订单的状态。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"},"newStatus":{"type":"integer","description":"新的订单状态；枚举取值：3-待出票、4-已出票; 不可为 null；≥ 3；≤ 4；允许值：3,4","x-java-type":"Integer","format":"int32","minimum":3,"maximum":4},"remark":{"type":"string","description":"变更备注","x-java-type":"String"}},"required":["orderCode","newStatus"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightManualOrderStatusUpdateResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/cancel":{"put":{"operationId":"bms.putOrderFlightCancel","x-api-code":"bms.putOrderFlightCancel","x-open-platform-sort":99,"summary":"取消手工单订单","description":"**接口：** `PUT /bms/order/flight/cancel`\n\n取消后台录入的机票手工订单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码; 不可为空白字符串","x-java-type":"String"},"cancelReason":{"type":"string","description":"取消原因","x-java-type":"String"}},"required":["orderCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightManualOrderCancelResp","properties":{"value":{"type":"string","description":"接口返回值","x-java-type":"String"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/apply-source/page":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminApplySourcePage","x-api-code":"bms.postOrderFlightAftersaleAdminApplySourcePage","x-open-platform-sort":100,"summary":"手工申请-可发起订单分页查询","description":"**接口：** `POST /bms/order/flight/aftersale/admin/apply-source/page`\n\n分页查询可以发起手工退改申请的原订单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"businessType":{"type":"integer","description":"业务类型：1改签 2退票; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2},"orderType":{"type":"integer","description":"订单类型：0正常单 1改签单; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号","x-java-type":"String"}},"required":["currentPage","pageSize","businessType","orderType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightApplySourcePageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FlightAdminApplySourcePageItemRespDTO>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号","x-java-type":"String"},"customerName":{"type":"string","description":"客户名称","x-java-type":"String"},"passengerSummary":{"type":"string","description":"乘机人摘要","x-java-type":"String"},"journeySummary":{"type":"string","description":"航程摘要","x-java-type":"String"},"flightNoSummary":{"type":"string","description":"航班号摘要","x-java-type":"String"},"departureArrivalTime":{"type":"string","description":"出发-到达时间","x-java-type":"String"},"segmentList":{"type":"array","description":"航程列表（含航段多语言信息）","x-java-type":"List<FlightDetailVo>","items":{"type":"object","properties":{"departureTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"arrivalTime":{"type":"string","description":"抵达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"origin":{"type":"string","description":"出发地; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）; 示例：`北京`","x-java-type":"String"},"destination":{"type":"string","description":"到达地; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）; 示例：`上海`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"segments":{"type":"array","description":"航段列表","x-java-type":"List<SegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["segmentId","flightNumber","marketingFlightNumber","cabin","carrierNameZh","carrierNameEn","carrierNameTc","carrierLogo","aircraft","origin","originNameZh","originNameEn","originNameTc","departureAirportNameEn","departureAirportNameTc","departureAirportNameZh","originAirportCode","originTerminal","destination","destinationNameZh","destinationNameEn","destinationNameTc","arrivalAirportNameEn","arrivalAirportNameTc","arrivalAirportNameZh","destinationAirportCode","destinationTerminal","isShare","operatingFliCode","operatingFlightNumber","codeshareFlightInfoZh","codeshareFlightInfoTc","codeshareFlightInfoEn","originTime","destinationTime","flightDuration","stopoverList","isChanged"]}},"flightNumbers":{"type":"string","description":"航班号（,拼接）; 示例：`CA1234,CA5678`","x-java-type":"String"},"marketingFlightNumbers":{"type":"string","description":"营销航班号（,拼接，未格式化原始值）; 示例：`CA1234,CA5678`","x-java-type":"String"},"scheduleChangeCount":{"type":"integer","description":"航变条数; 示例：`0`","x-java-type":"Integer","format":"int32"},"journeyId":{"type":"string","description":"行程段id; 示例：`J001`","x-java-type":"String"},"journeyIndex":{"type":"integer","description":"行程段序号; 示例：`1`","x-java-type":"Integer","format":"int32"},"journeysTime":{"type":"string","description":"行程耗时; 示例：`150`","x-java-type":"String"}},"required":["departureTime","arrivalTime","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","cabinClass","segments","flightNumbers","marketingFlightNumbers","scheduleChangeCount","journeyId","journeyIndex","journeysTime"]}},"orderStatus":{"type":"integer","description":"订单状态码；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"canOperate":{"type":"integer","description":"是否可操作：0否 1是","x-java-type":"Integer","format":"int32"}},"required":["orderCode","supplierOrderNo","customerName","passengerSummary","journeySummary","flightNoSummary","departureArrivalTime","segmentList","orderStatus","canOperate"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/apply-source/detail":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminApplySourceDetail","x-api-code":"bms.postOrderFlightAftersaleAdminApplySourceDetail","x-open-platform-sort":101,"summary":"手工申请-原订单详情预填","description":"**接口：** `POST /bms/order/flight/aftersale/admin/apply-source/detail`\n\n读取原订单资料，为手工退改申请表单预填数据。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"来源订单号; 不可为空白字符串","x-java-type":"String"},"businessType":{"type":"integer","description":"业务类型：1改签 2退票; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2}},"required":["orderCode","businessType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightApplySourceDetailResp","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"saleOrderNo":{"type":"string","description":"销售单号","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号","x-java-type":"String"},"customerName":{"type":"string","description":"客户名称","x-java-type":"String"},"orderSource":{"type":"string","description":"订单来源；枚举取值：0-PC端、1-移动端、2-OpenAPI","x-java-type":"String"},"salesChannel":{"type":"string","description":"销售渠道；枚举取值：0-PC端、1-移动端、2-OpenAPI","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态码；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"issuedTime":{"type":"string","description":"出票时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"segmentList":{"type":"array","description":"航程列表","x-java-type":"List<FlightDetailVo>","items":{"type":"object","properties":{"departureTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"arrivalTime":{"type":"string","description":"抵达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"origin":{"type":"string","description":"出发地; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）; 示例：`北京`","x-java-type":"String"},"destination":{"type":"string","description":"到达地; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）; 示例：`上海`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"segments":{"type":"array","description":"航段列表","x-java-type":"List<SegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["segmentId","flightNumber","marketingFlightNumber","cabin","carrierNameZh","carrierNameEn","carrierNameTc","carrierLogo","aircraft","origin","originNameZh","originNameEn","originNameTc","departureAirportNameEn","departureAirportNameTc","departureAirportNameZh","originAirportCode","originTerminal","destination","destinationNameZh","destinationNameEn","destinationNameTc","arrivalAirportNameEn","arrivalAirportNameTc","arrivalAirportNameZh","destinationAirportCode","destinationTerminal","isShare","operatingFliCode","operatingFlightNumber","codeshareFlightInfoZh","codeshareFlightInfoTc","codeshareFlightInfoEn","originTime","destinationTime","flightDuration","stopoverList","isChanged","selectable"]}},"flightNumbers":{"type":"string","description":"航班号（,拼接）; 示例：`CA1234,CA5678`","x-java-type":"String"},"marketingFlightNumbers":{"type":"string","description":"营销航班号（,拼接，未格式化原始值）; 示例：`CA1234,CA5678`","x-java-type":"String"},"scheduleChangeCount":{"type":"integer","description":"航变条数; 示例：`0`","x-java-type":"Integer","format":"int32"},"journeyId":{"type":"string","description":"行程段id; 示例：`J001`","x-java-type":"String"},"journeyIndex":{"type":"integer","description":"行程段序号; 示例：`1`","x-java-type":"Integer","format":"int32"},"journeysTime":{"type":"string","description":"行程耗时; 示例：`150`","x-java-type":"String"}},"required":["departureTime","arrivalTime","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","cabinClass","segments","flightNumbers","marketingFlightNumbers","scheduleChangeCount","journeyId","journeyIndex","journeysTime"]}},"passengerList":{"type":"array","description":"乘机人列表","x-java-type":"List<FlightAdminApplySourcePassengerDTO>","items":{"type":"object","properties":{"passengerIndex":{"type":"integer","description":"序号","x-java-type":"Integer","format":"int32"},"passengerId":{"type":"integer","description":"乘机人ID","x-java-type":"Long","format":"int64"},"passengerCode":{"type":"string","description":"乘机人编码","x-java-type":"String"},"passengerName":{"type":"string","description":"乘机人姓名","x-java-type":"String"},"passengerType":{"type":"string","description":"乘客类型：adult/child/infant","x-java-type":"String"},"passengerTypeName":{"type":"string","description":"乘客类型名称，如成人票","x-java-type":"String"},"nationality":{"type":"string","description":"国籍二字码","x-java-type":"String"},"nationalityNameZh":{"type":"string","description":"国籍名称（中文）","x-java-type":"String"},"nationalityNameEn":{"type":"string","description":"国籍名称（英文）","x-java-type":"String"},"nationalityNameTc":{"type":"string","description":"国籍名称（繁体）","x-java-type":"String"},"gender":{"type":"integer","description":"性别：0男 1女","x-java-type":"Integer","format":"int32"},"genderName":{"type":"string","description":"性别名称","x-java-type":"String"},"idType":{"type":"integer","description":"证件类型码；枚举取值：1-身份证、2-护照、3-军官证、4-国际海员证、5-港澳通行证、6-台湾通行证、7-台胞证、8-回乡证、9-学生证、10-外国人居留证、11-其他","x-java-type":"Integer","format":"int32"},"idTypeName":{"type":"string","description":"证件类型名称","x-java-type":"String"},"idNumber":{"type":"string","description":"证件号码","x-java-type":"String"},"idExpiration":{"type":"string","description":"证件有效期; 日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"birthday":{"type":"string","description":"出生日期; 日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"phoneRegion":{"type":"string","description":"手机区号","x-java-type":"String"},"phone":{"type":"string","description":"手机号码","x-java-type":"String"},"mobilePhone":{"type":"string","description":"手机号码展示（区号-号码）","x-java-type":"String"},"selectable":{"type":"integer","description":"是否可选：0否 1是","x-java-type":"Integer","format":"int32"}},"required":["passengerIndex","passengerId","passengerCode","passengerName","passengerType","passengerTypeName","nationality","nationalityNameZh","nationalityNameEn","nationalityNameTc","gender","genderName","idType","idTypeName","idNumber","idExpiration","birthday","email","phoneRegion","phone","mobilePhone","selectable"]}},"contactName":{"type":"string","description":"联系人姓名","x-java-type":"String"},"contactRegion":{"type":"string","description":"联系人区号","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱","x-java-type":"String"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"canOperate":{"type":"integer","description":"是否可操作：0否 1是","x-java-type":"Integer","format":"int32"}},"required":["orderCode","saleOrderNo","supplierOrderNo","customerName","orderSource","salesChannel","orderStatus","issuedTime","segmentList","passengerList","contactName","contactRegion","contactPhone","contactEmail","currency"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/manual-apply":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangeManualApply","x-api-code":"bms.postOrderFlightAftersaleAdminChangeManualApply","x-open-platform-sort":102,"summary":"提交手工改签申请","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/manual-apply`\n\n提交后台人工录入的改签申请。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceOrderCode":{"type":"string","description":"来源订单号; 不可为空白字符串","x-java-type":"String"},"supplierChangeOrderNo":{"type":"string","description":"供应商改签单号","x-java-type":"String"},"reasonDesc":{"type":"string","description":"改签原因; 不可为空白字符串","x-java-type":"String"},"reasonType":{"type":"integer","description":"原因类型；枚举取值：1-自愿、2-非自愿; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2},"passengerIdList":{"type":"array","description":"改签乘机人ID列表; 不可为空集合或空值","x-java-type":"List<Long>","items":{"type":"integer"}},"oldSegmentIdList":{"type":"array","description":"原改签航段ID列表; 不可为空集合或空值","x-java-type":"List<String>","items":{"type":"string"}},"newSegmentList":{"type":"array","description":"新航程信息; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<FlightAdminManualChangeSegmentDTO>","items":{"type":"object","properties":{"flightNo":{"type":"string","description":"新航班号; 不可为空白字符串","x-java-type":"String"},"departureDate":{"type":"string","description":"新出发日期; 不可为 null；日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"departureTime":{"type":"string","description":"新起飞时间; 不可为 null","x-java-type":"LocalTime"},"arrivalDate":{"type":"string","description":"新到达日期; 不可为 null；日期/时间格式遵循服务端序列化及参数绑定配置","x-java-type":"LocalDate","format":"date"},"arrivalTime":{"type":"string","description":"新到达时间; 不可为 null","x-java-type":"LocalTime"},"cabinClass":{"type":"string","description":"舱位等级：economy/business/first/premium_economy; 不可为空白字符串；正则：`economy&#124;business&#124;first&#124;premium_economy`","x-java-type":"String","pattern":"economy|business|first|premium_economy"},"cabinCode":{"type":"string","description":"新舱位代码","x-java-type":"String"},"departureAirportCode":{"type":"string","description":"出发机场三字码; 不可为空白字符串","x-java-type":"String"},"arrivalAirportCode":{"type":"string","description":"到达机场三字码; 不可为空白字符串","x-java-type":"String"}},"required":["flightNo","departureDate","departureTime","arrivalDate","arrivalTime","cabinClass","departureAirportCode","arrivalAirportCode"]}},"contactName":{"type":"string","description":"联系人姓名; 不可为空白字符串","x-java-type":"String"},"contactRegion":{"type":"string","description":"联系人区号; 不可为空白字符串","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话; 不可为空白字符串","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱; 不可为空白字符串","x-java-type":"String"},"passengerAmountDetailList":{"type":"array","description":"按乘客类型改签费用明细; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<PassengerChangeAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。; 不可为空白字符串；正则：`adult&#124;child&#124;infant`","x-java-type":"String","pattern":"adult|child|infant"},"passengerCount":{"type":"integer","description":"该类型人数，必填。; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"fareDiff":{"type":"number","description":"单人票税差，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"changeFee":{"type":"number","description":"单人改签手续费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"changeServiceFee":{"type":"number","description":"单人改签服务费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"otherFee":{"type":"number","description":"单人其他费用，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"totalAmount":{"type":"number","description":"单人总费用，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"currency":{"type":"string","description":"币种，必填。; 不可为空白字符串","x-java-type":"String"}},"required":["passengerType","passengerCount","fareDiff","changeFee","changeServiceFee","otherFee","totalAmount","currency"]}}},"required":["sourceOrderCode","reasonDesc","reasonType","passengerIdList","oldSegmentIdList","newSegmentList","contactName","contactRegion","contactPhone","contactEmail","passengerAmountDetailList"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeManualApplyResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus","totalAmount"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/manual-apply":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundManualApply","x-api-code":"bms.postOrderFlightAftersaleAdminRefundManualApply","x-open-platform-sort":103,"summary":"提交手工退票申请","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/manual-apply`\n\n提交后台人工录入的退票申请。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceOrderCode":{"type":"string","description":"来源订单号; 不可为空白字符串","x-java-type":"String"},"supplierRefundOrderNo":{"type":"string","description":"供应商退票单号","x-java-type":"String"},"reasonDesc":{"type":"string","description":"退票原因; 不可为空白字符串","x-java-type":"String"},"reasonType":{"type":"integer","description":"原因类型；枚举取值：1-自愿、2-非自愿; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2},"passengerIdList":{"type":"array","description":"退票乘机人ID列表; 不可为空集合或空值","x-java-type":"List<Long>","items":{"type":"integer"}},"segmentIdList":{"type":"array","description":"退票航段ID列表; 不可为空集合或空值","x-java-type":"List<String>","items":{"type":"string"}},"contactName":{"type":"string","description":"联系人姓名","x-java-type":"String"},"contactRegion":{"type":"string","description":"联系人区号","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱","x-java-type":"String"},"passengerAmountDetailList":{"type":"array","description":"按乘客类型退票费用明细; 不可为空集合或空值；校验嵌套对象/数组元素","x-java-type":"List<PassengerRefundAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。; 不可为空白字符串；正则：`adult&#124;child&#124;infant`","x-java-type":"String","pattern":"adult|child|infant"},"passengerCount":{"type":"integer","description":"该类型人数，必填。; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"ticketPrice":{"type":"number","description":"单人票价，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"taxFee":{"type":"number","description":"单人税费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"fuelFee":{"type":"number","description":"单人燃油费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"refundFee":{"type":"number","description":"单人退票手续费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"refundServiceFee":{"type":"number","description":"单人退票服务费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"otherFee":{"type":"number","description":"单人其他费用，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"refundableAmount":{"type":"number","description":"单人可退金额，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"currency":{"type":"string","description":"币种，必填。; 不可为空白字符串","x-java-type":"String"}},"required":["passengerType","passengerCount","ticketPrice","taxFee","fuelFee","refundFee","refundServiceFee","otherFee","refundableAmount","currency"]}}},"required":["sourceOrderCode","reasonDesc","reasonType","passengerIdList","segmentIdList","passengerAmountDetailList"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundManualApplyResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus","totalAmount"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/audit":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangeAudit","x-api-code":"bms.postOrderFlightAftersaleAdminChangeAudit","x-open-platform-sort":104,"summary":"改签人工审核","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/audit`\n\n人工审核机票改签申请。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号。; 不可为空白字符串","x-java-type":"String"},"auditResult":{"type":"integer","description":"审核结果：0驳回 1通过。; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"passengerAmountDetailList":{"type":"array","description":"按乘客类型改签金额明细（审核通过时必填）。; 校验嵌套对象/数组元素","x-java-type":"List<PassengerChangeAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。; 不可为空白字符串；正则：`adult&#124;child&#124;infant`","x-java-type":"String","pattern":"adult|child|infant"},"passengerCount":{"type":"integer","description":"该类型人数，必填。; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"fareDiff":{"type":"number","description":"单人票税差，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"changeFee":{"type":"number","description":"单人改签手续费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"changeServiceFee":{"type":"number","description":"单人改签服务费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"otherFee":{"type":"number","description":"单人其他费用，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"totalAmount":{"type":"number","description":"单人总费用，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"currency":{"type":"string","description":"币种，必填。; 不可为空白字符串","x-java-type":"String"}},"required":["passengerType","passengerCount","fareDiff","changeFee","changeServiceFee","otherFee","totalAmount","currency"]}},"payDeadline":{"type":"string","description":"支付截止时间。; 未来时间；日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"rejectReason":{"type":"string","description":"驳回原因。","x-java-type":"String"}},"required":["changeRequestCode","auditResult"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeAuditResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus","totalAmount"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/cancel":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangeCancel","x-api-code":"bms.postOrderFlightAftersaleAdminChangeCancel","x-open-platform-sort":105,"summary":"改签人工取消","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/cancel`\n\n人工取消机票改签申请。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号。; 不可为空白字符串","x-java-type":"String"},"cancelReason":{"type":"string","description":"取消原因。; 不可为空白字符串","x-java-type":"String"}},"required":["changeRequestCode","cancelReason"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeCancelResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/complete":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangeComplete","x-api-code":"bms.postOrderFlightAftersaleAdminChangeComplete","x-open-platform-sort":106,"summary":"改签人工完单","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/complete`\n\n人工完成机票改签单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号。; 不可为空白字符串","x-java-type":"String"},"ticketNoList":{"type":"array","description":"按乘机人航段填写的新票号列表。; 校验嵌套对象/数组元素","x-java-type":"List<ChangeTicketNoItemDTO>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘机人 ID，必填。; 不可为 null；> 0","x-java-type":"Long","format":"int64"},"segmentId":{"type":"string","description":"航段 ID，必填。; 不可为空白字符串","x-java-type":"String"},"ticketNo":{"type":"string","description":"新票号，必填。; 不可为空白字符串","x-java-type":"String"}},"required":["passengerId","segmentId","ticketNo"]}}},"required":["changeRequestCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeCompleteResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/page":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangePage","x-api-code":"bms.postOrderFlightAftersaleAdminChangePage","x-open-platform-sort":107,"summary":"改签单分页","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/page`\n\n按查询条件分页读取改签单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"orderCode":{"type":"string","description":"订单号; 示例：`FO202501010001`","x-java-type":"String"},"customerCode":{"type":"string","description":"客户编码; 示例：`AGT001`","x-java-type":"String"},"changeRequestCode":{"type":"string","description":"改签申请单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态码。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; ≥ 0；≤ 10","x-java-type":"Integer","format":"int32","minimum":0,"maximum":10},"requestStartTime":{"type":"string","description":"申请开始时间。","x-java-type":"String"},"requestEndTime":{"type":"string","description":"申请结束时间。","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangePageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FlightAdminChangePageItemRespDTO>","items":{"type":"object","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号。","x-java-type":"String"},"supplierChangeOrderNo":{"type":"string","description":"供应商改签单号。","x-java-type":"String"},"orderCode":{"type":"string","description":"订单号。","x-java-type":"String"},"customerName":{"type":"string","description":"客户名称。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"applicantName":{"type":"string","description":"申请人名称。","x-java-type":"String"},"passengerSummary":{"type":"string","description":"乘机人摘要。","x-java-type":"String"},"oldSegmentSummary":{"type":"string","description":"原航段摘要。","x-java-type":"String"},"oldSegmentList":{"type":"array","description":"原航段明细列表。","x-java-type":"List<AdminAftersaleSegmentBriefVo>","items":{"type":"object","properties":{"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发地三字码（机场）; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"目的地三字码（机场）; 示例：`SHA`","x-java-type":"String"},"departureDate":{"type":"string","description":"出发日期（yyyy-MM-dd）; 示例：`2026-05-06`","x-java-type":"String"},"departureTime":{"type":"string","description":"出发时间（HH:mm）; 示例：`08:00`","x-java-type":"String"},"arrivalDate":{"type":"string","description":"到达日期（yyyy-MM-dd）; 示例：`2026-05-06`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"到达时间（HH:mm）; 示例：`10:30`","x-java-type":"String"}},"required":["flightNumber","departureAirport","arrivalAirport","departureDate","departureTime","arrivalDate","arrivalTime"]}},"newSegmentSummary":{"type":"string","description":"新航段摘要。","x-java-type":"String"},"newSegmentList":{"type":"array","description":"新航段明细列表。","x-java-type":"List<AdminAftersaleSegmentBriefVo>","items":{"type":"object","properties":{"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发地三字码（机场）; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"目的地三字码（机场）; 示例：`SHA`","x-java-type":"String"},"departureDate":{"type":"string","description":"出发日期（yyyy-MM-dd）; 示例：`2026-05-06`","x-java-type":"String"},"departureTime":{"type":"string","description":"出发时间（HH:mm）; 示例：`08:00`","x-java-type":"String"},"arrivalDate":{"type":"string","description":"到达日期（yyyy-MM-dd）; 示例：`2026-05-06`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"到达时间（HH:mm）; 示例：`10:30`","x-java-type":"String"}},"required":["flightNumber","departureAirport","arrivalAirport","departureDate","departureTime","arrivalDate","arrivalTime"]}},"totalAmount":{"type":"number","description":"总费用。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种。","x-java-type":"String"},"callbackTime":{"type":"string","description":"最近回调时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"requestTime":{"type":"string","description":"申请时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"canAudit":{"type":"integer","description":"是否可审核：0否 1是。","x-java-type":"Integer","format":"int32"},"canCancel":{"type":"integer","description":"是否可取消：0否 1是。","x-java-type":"Integer","format":"int32"},"canComplete":{"type":"integer","description":"是否可人工完单：0否 1是。","x-java-type":"Integer","format":"int32"},"isManualAftersale":{"type":"integer","description":"是否手工售后单：0否 1是。","x-java-type":"Integer","format":"int32"}},"required":["changeRequestCode","supplierChangeOrderNo","orderCode","customerName","platformStatus","applicantName","passengerSummary","oldSegmentSummary","oldSegmentList","newSegmentList","totalAmount","currency","callbackTime","requestTime","canAudit","canCancel","canComplete","isManualAftersale"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/detail":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangeDetail","x-api-code":"bms.postOrderFlightAftersaleAdminChangeDetail","x-open-platform-sort":108,"summary":"改签单详情","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/detail`\n\n读取改签单详情。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号。; 不可为空白字符串","x-java-type":"String"}},"required":["changeRequestCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeDetailResp","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号。","x-java-type":"String"},"supplierChangeOrderNo":{"type":"string","description":"供应商改签单号。","x-java-type":"String"},"orderCode":{"type":"string","description":"主订单号。","x-java-type":"String"},"sourceOrderCode":{"type":"string","description":"来源订单号。","x-java-type":"String"},"changeOrderType":{"type":"integer","description":"改签单类型：1正单改签 2改签单再改签。","x-java-type":"Integer","format":"int32"},"changeType":{"type":"integer","description":"改签类型：1改期 2升舱 3其他。","x-java-type":"Integer","format":"int32"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"orderStatus":{"type":"integer","description":"改签单订单状态编码。枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签","x-java-type":"Integer","format":"int32"},"orderType":{"type":"integer","description":"订单类型：0正单 1改签单。","x-java-type":"Integer","format":"int32"},"requestTime":{"type":"string","description":"申请时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"auditPassedTime":{"type":"string","description":"审核通过时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"paymentTime":{"type":"string","description":"支付时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"issuedTime":{"type":"string","description":"出票时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"totalScheduleChangeCount":{"type":"integer","description":"订单总航变数量。","x-java-type":"Integer","format":"int32"},"passengerList":{"type":"array","description":"乘机人列表。","x-java-type":"List<FlightPassengerInfoDTO>","items":{"type":"object","properties":{"passengerCode":{"type":"string","description":"乘机人编码; 示例：`PAX123456`","x-java-type":"String"},"userId":{"type":"integer","description":"员工ID; 示例：`1001`","x-java-type":"Long","format":"int64"},"guestId":{"type":"integer","description":"常旅用户ID; 示例：`2001`","x-java-type":"Long","format":"int64"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿; 示例：`adult`","x-java-type":"String"},"nationalityRegionCode":{"type":"string","description":"国籍代码; 示例：`CN`","x-java-type":"String"},"lastName":{"type":"string","description":"姓; 示例：`ZHANG`","x-java-type":"String"},"firstName":{"type":"string","description":"名; 示例：`SAN`","x-java-type":"String"},"ticketNo":{"type":"string","description":"票号; 示例：`999-1234567890`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"userName":{"type":"string","description":"用户名; 示例：`zhangsan`","x-java-type":"String"},"avatar":{"type":"string","description":"用户头像; 示例：`https://example.com/avatar.jpg`","x-java-type":"String"},"gender":{"type":"integer","description":"性别：0男，1女; 示例：`0`","x-java-type":"Integer","format":"int32"},"dateOfBirth":{"type":"string","description":"出生日期; 格式：`yyyy-MM-dd`；时区：GMT+8；示例：`1990-01-01`","x-java-type":"LocalDate","format":"date"},"idType":{"type":"integer","description":"证件类型；枚举取值：1-身份证、2-护照、3-军官证、4-国际海员证、5-港澳通行证、6-台湾通行证、7-台胞证、8-回乡证、9-学生证、10-外国人居留证、11-其他; 示例：`1`","x-java-type":"Integer","format":"int32"},"certificateId":{"type":"integer","description":"证件信息ID，选填; 示例：`1001`","x-java-type":"Integer","format":"int32"},"idNumber":{"type":"string","description":"证件号码; 示例：`E12345678`","x-java-type":"String"},"dateOfExpiration":{"type":"string","description":"证件有效期; 格式：`yyyy-MM-dd`；时区：GMT+8；示例：`2030-01-01`","x-java-type":"LocalDate","format":"date"},"dateOfIssue":{"type":"string","description":"发证日期; 格式：`yyyy-MM-dd`；时区：GMT+8；示例：`2020-01-01`","x-java-type":"LocalDate","format":"date"},"placeOfIssue":{"type":"string","description":"证件签发地; 示例：`CN`","x-java-type":"String"},"phoneAreaCode":{"type":"string","description":"手机区号; 示例：`86`","x-java-type":"String"},"phone":{"type":"string","description":"手机号码; 示例：`13800138000`","x-java-type":"String"},"email":{"type":"string","description":"邮箱; 示例：`example@test.com`","x-java-type":"String"},"cardCode":{"type":"string","description":"常旅客卡航司; 示例：`CA`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"常旅客卡航司名称（简体中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"常旅客卡航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"常旅客卡航司名称（繁体中文）; 示例：`中國國際航空`","x-java-type":"String"},"cardNumber":{"type":"string","description":"常旅客卡号; 示例：`123456789`","x-java-type":"String"},"cardId":{"type":"integer","description":"常旅客卡 ID，选填; 示例：`1001`","x-java-type":"Integer","format":"int32"},"adultPassengerName":{"type":"string","description":"关联成人姓名（儿童/婴儿）; 示例：`ZHANG/SAN`","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票面价; 示例：`1000.00`","x-java-type":"BigDecimal"},"taxPrice":{"type":"number","description":"税费; 示例：`100.00`","x-java-type":"BigDecimal"},"fuelPrice":{"type":"number","description":"燃油费; 示例：`50.00`","x-java-type":"BigDecimal"},"servicePrice":{"type":"number","description":"服务费; 示例：`30.00`","x-java-type":"BigDecimal"},"salePrice":{"type":"number","description":"销售价; 示例：`1180.00`","x-java-type":"BigDecimal"},"ticketMarkupAmount":{"type":"number","description":"票面加幅金额; 示例：`40.00`","x-java-type":"BigDecimal"},"fareDiff":{"type":"number","description":"单人票税差，必填。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"单人改签手续费，必填。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"单人改签服务费，必填。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"单人其他费用，必填。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"价格币种; 示例：`CNY`","x-java-type":"String"},"airlineCardType":{"type":"integer","description":"常旅客卡类型; 示例：`SILVER`","x-java-type":"Integer","format":"int32"}},"required":["passengerCode","userId","passengerType","nationalityRegionCode","lastName","firstName","gender","dateOfBirth","idType","idNumber","dateOfExpiration","phoneAreaCode","phone","email","cardCode","cardNumber","adultPassengerName","ticketPrice","taxPrice","fuelPrice","servicePrice","salePrice","ticketMarkupAmount","currency"]}},"oldSegmentList":{"type":"array","description":"原航段列表。","x-java-type":"List<FlightDetailVo>","items":{"type":"object","properties":{"departureTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"arrivalTime":{"type":"string","description":"抵达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"origin":{"type":"string","description":"出发地; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）; 示例：`北京`","x-java-type":"String"},"destination":{"type":"string","description":"到达地; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）; 示例：`上海`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"segments":{"type":"array","description":"航段列表","x-java-type":"List<SegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["segmentId","flightNumber","marketingFlightNumber","cabin","carrierNameZh","carrierNameEn","carrierNameTc","carrierLogo","aircraft","origin","originNameZh","originNameEn","originNameTc","departureAirportNameEn","departureAirportNameTc","departureAirportNameZh","originAirportCode","destination","destinationNameZh","destinationNameEn","destinationNameTc","arrivalAirportNameEn","arrivalAirportNameTc","arrivalAirportNameZh","destinationAirportCode","originTime","destinationTime","flightDuration","isChanged"]}},"flightNumbers":{"type":"string","description":"航班号（,拼接）; 示例：`CA1234,CA5678`","x-java-type":"String"},"marketingFlightNumbers":{"type":"string","description":"营销航班号（,拼接，未格式化原始值）; 示例：`CA1234,CA5678`","x-java-type":"String"},"scheduleChangeCount":{"type":"integer","description":"航变条数; 示例：`0`","x-java-type":"Integer","format":"int32"},"journeyId":{"type":"string","description":"行程段id; 示例：`J001`","x-java-type":"String"},"journeyIndex":{"type":"integer","description":"行程段序号; 示例：`1`","x-java-type":"Integer","format":"int32"},"journeysTime":{"type":"string","description":"行程耗时; 示例：`150`","x-java-type":"String"}},"required":["departureTime","arrivalTime","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","cabinClass","segments","flightNumbers","journeyId","journeyIndex","journeysTime"]}},"newSegmentList":{"type":"array","description":"新航段列表。","x-java-type":"List<FlightDetailVo>","items":{"type":"object","properties":{"departureTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"arrivalTime":{"type":"string","description":"抵达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"origin":{"type":"string","description":"出发地; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）; 示例：`北京`","x-java-type":"String"},"destination":{"type":"string","description":"到达地; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）; 示例：`上海`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"segments":{"type":"array","description":"航段列表","x-java-type":"List<SegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["segmentId","flightNumber","marketingFlightNumber","cabin","carrierNameZh","carrierNameEn","carrierNameTc","carrierLogo","aircraft","origin","originNameZh","originNameEn","originNameTc","departureAirportNameEn","departureAirportNameTc","departureAirportNameZh","originAirportCode","destination","destinationNameZh","destinationNameEn","destinationNameTc","arrivalAirportNameEn","arrivalAirportNameTc","arrivalAirportNameZh","destinationAirportCode","originTime","destinationTime","flightDuration","isChanged"]}},"flightNumbers":{"type":"string","description":"航班号（,拼接）; 示例：`CA1234,CA5678`","x-java-type":"String"},"marketingFlightNumbers":{"type":"string","description":"营销航班号（,拼接，未格式化原始值）; 示例：`CA1234,CA5678`","x-java-type":"String"},"scheduleChangeCount":{"type":"integer","description":"航变条数; 示例：`0`","x-java-type":"Integer","format":"int32"},"journeyId":{"type":"string","description":"行程段id; 示例：`J001`","x-java-type":"String"},"journeyIndex":{"type":"integer","description":"行程段序号; 示例：`1`","x-java-type":"Integer","format":"int32"},"journeysTime":{"type":"string","description":"行程耗时; 示例：`150`","x-java-type":"String"}},"required":["departureTime","arrivalTime","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","cabinClass","segments","flightNumbers","journeyId","journeyIndex","journeysTime"]}},"reasonType":{"type":"integer","description":"原因类型：1自愿 2非自愿。","x-java-type":"Integer","format":"int32"},"reasonDesc":{"type":"string","description":"原因说明。","x-java-type":"String"},"attachmentUrls":{"type":"array","description":"附件URL列表。","x-java-type":"List<String>","items":{"type":"string"}},"contactName":{"type":"string","description":"联系人姓名。","x-java-type":"String"},"contactRegion":{"type":"string","description":"联系人区号。","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话。","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱。","x-java-type":"String"},"amountDetail":{"type":"object","description":"改签金额明细。","x-java-type":"ChangeAmountDetailVO","properties":{"fareDiff":{"type":"number","description":"票税差。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"改签手续费。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用。","x-java-type":"BigDecimal"},"totalAmount":{"type":"number","description":"总金额。","x-java-type":"BigDecimal"},"paymentDeadline":{"type":"string","description":"支付截止时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"countdownSeconds":{"type":"integer","description":"支付倒计时秒数（支付截止时间-当前时间，最小为0）。","x-java-type":"Long","format":"int64"},"paymentTime":{"type":"string","description":"支付时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"paidAmount":{"type":"number","description":"已支付金额。","x-java-type":"BigDecimal"}},"required":["fareDiff","changeFee","changeServiceFee","otherFee","totalAmount","countdownSeconds","paymentTime","paidAmount"]},"payStatus":{"type":"string","description":"支付状态文案。","x-java-type":"String"},"failureReason":{"type":"string","description":"失败原因。","x-java-type":"String"},"rejectReason":{"type":"string","description":"审核驳回原因。","x-java-type":"String"},"canPay":{"type":"integer","description":"是否可支付：0否 1是。","x-java-type":"Integer","format":"int32"},"canCancel":{"type":"integer","description":"是否可取消：0否 1是。","x-java-type":"Integer","format":"int32"},"callbackTime":{"type":"string","description":"最近回调时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"passengerPriceList":{"type":"array","description":"按乘机人价格明细。","x-java-type":"List<PassengerChangePriceDTO>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘机人主键 ID，必填。","x-java-type":"Long","format":"int64"},"passengerCode":{"type":"string","description":"乘机人编码，非必填。","x-java-type":"String"},"passengerName":{"type":"string","description":"乘机人姓名，必填。","x-java-type":"String"},"passengerType":{"type":"string","description":"乘客类型，必填。枚举取值：adult-成人、child-儿童、infant-婴儿","x-java-type":"String"},"fareDiff":{"type":"number","description":"票税差。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"改签手续费。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用。","x-java-type":"BigDecimal"},"totalAmount":{"type":"number","description":"单人总费用。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种。","x-java-type":"String"}},"required":["passengerId","passengerCode","passengerName","passengerType","fareDiff","changeFee","changeServiceFee","otherFee","totalAmount","currency"]}},"passengerAmountDetailList":{"type":"array","description":"按乘客类型价格明细汇总。","x-java-type":"List<PassengerChangeAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。","x-java-type":"String"},"passengerCount":{"type":"integer","description":"该类型人数，必填。","x-java-type":"Integer","format":"int32"},"fareDiff":{"type":"number","description":"单人票税差，必填。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"单人改签手续费，必填。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"单人改签服务费，必填。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"单人其他费用，必填。","x-java-type":"BigDecimal"},"totalAmount":{"type":"number","description":"单人总费用，必填。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种，必填。","x-java-type":"String"}},"required":["passengerType","passengerCount","fareDiff","changeFee","changeServiceFee","otherFee","totalAmount","currency"]}},"orderFee":{"type":"object","description":"费用对象（与订单详情 orderFee 结构一致）。","x-java-type":"OrderFeeVo","properties":{"totalFee":{"type":"number","description":"总费用; 示例：`1180.00`","x-java-type":"BigDecimal"},"adjustedTotalAmount":{"type":"number","description":"人工调整后的展示总计；未调整时为空，不改变实际支付金额","x-java-type":"BigDecimal"},"totalTicketPrice":{"type":"number","description":"总票价费用; 示例：`1180.00`","x-java-type":"BigDecimal"},"totalRefund":{"type":"number","description":"总退款金额; 示例：`0.00`","x-java-type":"BigDecimal"},"payCurrency":{"type":"string","description":"支付币种; 示例：`CNY`","x-java-type":"String"},"payTime":{"type":"string","description":"支付时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"payLateTime":{"type":"string","description":"最晚支付时间; 示例：`2025-01-01 14:00:00`","x-java-type":"String"},"payStatus":{"type":"integer","description":"支付状态；枚举取值：0-待支付、1-已支付、2-支付失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"payMethod":{"type":"integer","description":"支付方式；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`0`","x-java-type":"int","format":"int32"},"payDetailList":{"type":"array","description":"支付明细","x-java-type":"List<OrderPayDetailVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票价; 示例：`1000.00`","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"税费; 示例：`100.00`","x-java-type":"BigDecimal"},"fuelFee":{"type":"number","description":"燃油费。","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"服务费; 示例：`30.00`","x-java-type":"BigDecimal"},"passengerCount":{"type":"integer","description":"人数; 示例：`1`","x-java-type":"Integer","format":"int32"},"markupAmount":{"type":"number","description":"产品加幅金额（按乘客类型分摊）; 示例：`40.00`","x-java-type":"BigDecimal"},"fareDiff":{"type":"number","description":"票税差。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"改签手续费。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用。","x-java-type":"BigDecimal"},"refundFee":{"type":"number","description":"退票手续费。","x-java-type":"BigDecimal"},"refundServiceFee":{"type":"number","description":"退票服务费。","x-java-type":"BigDecimal"}},"required":["passengerType","ticketPrice","tax","serviceFee","passengerCount","markupAmount","fareDiff","changeFee","changeServiceFee","otherFee"]}},"refundDetailList":{"type":"array","description":"退款列表","x-java-type":"List<OrderRefundDetailVo>","items":{"type":"object","properties":{"refundAmount":{"type":"number","description":"退改金额; 示例：`500.00`","x-java-type":"BigDecimal"},"refundTime":{"type":"string","description":"退改时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"refundStatus":{"type":"integer","description":"退改状态；枚举取值：1-已支付、2-支付失败、3-退款成功、4-退款失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"refundMethod":{"type":"integer","description":"退改方式；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`0`","x-java-type":"Integer","format":"int32"}}}},"orderTransactionFee":{"type":"number","description":"订单交易手续费; 示例：`50.00`","x-java-type":"BigDecimal"},"orderServiceFee":{"type":"number","description":"订单服务费; 示例：`50.00`","x-java-type":"BigDecimal"},"fareDiff":{"type":"number","description":"票税差。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"改签手续费。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用。","x-java-type":"BigDecimal"},"feeCalculationType":{"type":"string","description":"手续费计算类型：percentage-按比例、fixed-固定金额；枚举取值：percentage-按比例、fixed-固定金额; 示例：`percentage`","x-java-type":"String"},"feeValue":{"type":"number","description":"手续费计费值; 示例：`3.00`","x-java-type":"BigDecimal"},"feePayer":{"type":"string","description":"手续费承担方：customer/platform/waived; 示例：`customer`","x-java-type":"String"},"totalPayAmount":{"type":"number","description":"总支付金额; 示例：`1230.00`","x-java-type":"BigDecimal"}},"required":["totalFee","payCurrency","payMethod","payDetailList","orderTransactionFee","orderServiceFee","fareDiff","changeFee","changeServiceFee","otherFee","totalPayAmount"]},"isManualAftersale":{"type":"integer","description":"是否手工售后单：0否 1是。","x-java-type":"Integer","format":"int32"}},"required":["changeRequestCode","supplierChangeOrderNo","orderCode","sourceOrderCode","changeOrderType","changeType","platformStatus","orderStatus","orderType","requestTime","paymentTime","issuedTime","totalScheduleChangeCount","passengerList","oldSegmentList","newSegmentList","reasonType","reasonDesc","attachmentUrls","contactName","contactRegion","contactPhone","contactEmail","amountDetail","canPay","canCancel","passengerPriceList","passengerAmountDetailList","orderFee","isManualAftersale"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/supplier-order-no":{"put":{"operationId":"bms.putOrderFlightAftersaleAdminChangeSupplierOrderNo","x-api-code":"bms.putOrderFlightAftersaleAdminChangeSupplierOrderNo","x-open-platform-sort":109,"summary":"修改供应商改签单号","description":"**接口：** `PUT /bms/order/flight/aftersale/admin/change/supplier-order-no`\n\n修改改签单对应的供应商改签单号。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号; 不可为空白字符串","x-java-type":"String"},"supplierChangeOrderNo":{"type":"string","description":"供应商改签单号; 不可为空白字符串；长度/元素数：最大 128","x-java-type":"String","maxLength":128}},"required":["changeRequestCode","supplierChangeOrderNo"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeSupplierNoUpdateResp","properties":{"changeRequestCode":{"type":"string","description":"改签申请单号; 示例：`FC202610190001`","x-java-type":"String"},"supplierChangeOrderNo":{"type":"string","description":"更新后的供应商改签单号; 示例：`SC202610190001`","x-java-type":"String"}},"required":["changeRequestCode","supplierChangeOrderNo"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/audit":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundAudit","x-api-code":"bms.postOrderFlightAftersaleAdminRefundAudit","x-open-platform-sort":110,"summary":"退票人工审核","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/audit`\n\n人工审核机票退票申请。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号。; 不可为空白字符串","x-java-type":"String"},"auditResult":{"type":"integer","description":"审核结果：0驳回 1通过。; 不可为 null；≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"passengerAmountDetailList":{"type":"array","description":"按乘客类型退票金额明细（审核通过时必填）。; 校验嵌套对象/数组元素","x-java-type":"List<PassengerRefundAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。; 不可为空白字符串；正则：`adult&#124;child&#124;infant`","x-java-type":"String","pattern":"adult|child|infant"},"passengerCount":{"type":"integer","description":"该类型人数，必填。; 不可为 null；> 0","x-java-type":"Integer","format":"int32"},"ticketPrice":{"type":"number","description":"单人票价，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"taxFee":{"type":"number","description":"单人税费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"fuelFee":{"type":"number","description":"单人燃油费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"refundFee":{"type":"number","description":"单人退票手续费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"refundServiceFee":{"type":"number","description":"单人退票服务费，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"otherFee":{"type":"number","description":"单人其他费用，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"refundableAmount":{"type":"number","description":"单人可退金额，必填。; 不可为 null；≥ 0","x-java-type":"BigDecimal","minimum":0},"currency":{"type":"string","description":"币种，必填。; 不可为空白字符串","x-java-type":"String"}},"required":["passengerType","passengerCount","ticketPrice","taxFee","fuelFee","refundFee","refundServiceFee","otherFee","refundableAmount","currency"]}},"rejectReason":{"type":"string","description":"驳回原因。","x-java-type":"String"},"remark":{"type":"string","description":"备注。","x-java-type":"String"}},"required":["refundRequestCode","auditResult"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundAuditResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/cancel":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundCancel","x-api-code":"bms.postOrderFlightAftersaleAdminRefundCancel","x-open-platform-sort":111,"summary":"退票人工取消","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/cancel`\n\n人工取消机票退票申请。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号。; 不可为空白字符串","x-java-type":"String"},"cancelReason":{"type":"string","description":"取消原因。; 不可为空白字符串","x-java-type":"String"},"remark":{"type":"string","description":"备注。","x-java-type":"String"}},"required":["refundRequestCode","cancelReason"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundCancelResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/complete":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundComplete","x-api-code":"bms.postOrderFlightAftersaleAdminRefundComplete","x-open-platform-sort":112,"summary":"退票人工退票","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/complete`\n\n人工完成机票退票处理。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号。; 不可为空白字符串","x-java-type":"String"},"remark":{"type":"string","description":"完单备注。","x-java-type":"String"}},"required":["refundRequestCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundCompleteResp","properties":{"requestCode":{"type":"string","description":"售后单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"费用总额。","x-java-type":"BigDecimal"}},"required":["requestCode","platformStatus"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/page":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundPage","x-api-code":"bms.postOrderFlightAftersaleAdminRefundPage","x-open-platform-sort":113,"summary":"退票单分页","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/page`\n\n按查询条件分页读取退票单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"orderCode":{"type":"string","description":"订单号; 示例：`FO202501010001`","x-java-type":"String"},"customerCode":{"type":"string","description":"客户编码; 示例：`AGT001`","x-java-type":"String"},"refundRequestCode":{"type":"string","description":"退票申请单号。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态码。枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票; ≥ 0；≤ 4","x-java-type":"Integer","format":"int32","minimum":0,"maximum":4},"passengerKeyword":{"type":"string","description":"乘机人关键字。","x-java-type":"String"},"segmentKeyword":{"type":"string","description":"航段关键字。","x-java-type":"String"},"requestStartTime":{"type":"string","description":"申请开始时间。","x-java-type":"String"},"requestEndTime":{"type":"string","description":"申请结束时间。","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FlightAdminRefundPageItemRespDTO>","items":{"type":"object","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号。","x-java-type":"String"},"supplierRefundOrderNo":{"type":"string","description":"供应商退票单号。","x-java-type":"String"},"orderCode":{"type":"string","description":"订单号。","x-java-type":"String"},"customerName":{"type":"string","description":"客户名称。","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台状态枚举值。枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票","x-java-type":"Integer","format":"int32"},"applicantName":{"type":"string","description":"申请人名称。","x-java-type":"String"},"passengerSummary":{"type":"string","description":"乘机人摘要。","x-java-type":"String"},"segmentSummary":{"type":"string","description":"航段摘要。","x-java-type":"String"},"segmentList":{"type":"array","description":"航段明细列表。","x-java-type":"List<AdminAftersaleSegmentBriefVo>","items":{"type":"object","properties":{"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发地三字码（机场）; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"目的地三字码（机场）; 示例：`SHA`","x-java-type":"String"},"departureDate":{"type":"string","description":"出发日期（yyyy-MM-dd）; 示例：`2026-05-06`","x-java-type":"String"},"departureTime":{"type":"string","description":"出发时间（HH:mm）; 示例：`08:00`","x-java-type":"String"},"arrivalDate":{"type":"string","description":"到达日期（yyyy-MM-dd）; 示例：`2026-05-06`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"到达时间（HH:mm）; 示例：`10:30`","x-java-type":"String"}},"required":["flightNumber","departureAirport","arrivalAirport","departureDate","departureTime","arrivalDate","arrivalTime"]}},"refundAmount":{"type":"number","description":"退款金额。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种。","x-java-type":"String"},"callbackTime":{"type":"string","description":"最近回调时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"requestTime":{"type":"string","description":"申请时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"canAudit":{"type":"integer","description":"是否可审核：0否 1是。","x-java-type":"Integer","format":"int32"},"canCancel":{"type":"integer","description":"是否可取消：0否 1是。","x-java-type":"Integer","format":"int32"},"canComplete":{"type":"integer","description":"是否可人工退票：0否 1是。","x-java-type":"Integer","format":"int32"},"isManualAftersale":{"type":"integer","description":"是否手工售后单：0否 1是。","x-java-type":"Integer","format":"int32"}},"required":["refundRequestCode","supplierRefundOrderNo","orderCode","customerName","platformStatus","applicantName","passengerSummary","segmentSummary","segmentList","refundAmount","currency","callbackTime","requestTime","canAudit","canCancel","canComplete","isManualAftersale"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/detail":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundDetail","x-api-code":"bms.postOrderFlightAftersaleAdminRefundDetail","x-open-platform-sort":114,"summary":"退票单详情","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/detail`\n\n读取退票单详情。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号。; 不可为空白字符串","x-java-type":"String"}},"required":["refundRequestCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundDetailResp","properties":{"orderDetail":{"type":"object","description":"订单信息","x-java-type":"OrderInfoVo","properties":{"orderCode":{"type":"string","description":"订单编号; 示例：`FO202501010001`","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; 示例：`4`","x-java-type":"Integer","format":"int32"},"payStatus":{"type":"integer","description":"支付状态；枚举取值：0-待支付、1-已支付、2-支付失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"bookingPerson":{"type":"string","description":"预定人; 示例：`admin`","x-java-type":"String"},"companyName":{"type":"string","description":"企业名称; 示例：`测试公司`","x-java-type":"String"},"orderSource":{"type":"integer","description":"订单来源：0-PC端，1-移动端; 示例：`0`","x-java-type":"Integer","format":"int32"},"submitTime":{"type":"string","description":"提交时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"payTime":{"type":"string","description":"支付时间（未支付为空）; 示例：`2025-01-01 12:05:00`","x-java-type":"String"},"supplierInfo":{"type":"object","description":"供应商信息","x-java-type":"SupplierInfoVo","properties":{"supplierId":{"type":"string","description":"供应商ID; 示例：`1`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"supplierName":{"type":"string","description":"供应商名称; 示例：`供应商A`","x-java-type":"String"},"supplierCode":{"type":"string","description":"供应商代码; 示例：`SUP001`","x-java-type":"String"},"supplierType":{"type":"string","description":"供应商类型; 示例：`GDS`","x-java-type":"String"}},"required":["supplierId","supplierOrderNo","supplierName","supplierCode","supplierType"]},"tripType":{"type":"integer","description":"行程类型：1单程，2往返，3多程; 示例：`1`","x-java-type":"Integer","format":"int32"},"farePriceType":{"type":"integer","description":"报价类型：0公布运价，1私有运价，2大客户协议运价; 示例：`0`","x-java-type":"Integer","format":"int32"},"contactPhone":{"type":"string","description":"联系人手机号; 示例：`13800138000`","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱; 示例：`example@test.com`","x-java-type":"String"},"contactName":{"type":"string","description":"联系人姓名; 示例：`Zhang San`","x-java-type":"String"},"bookingPersonEmail":{"type":"string","description":"预订人邮箱; 示例：`admin@test.com`","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号; 示例：`AP202501010001`","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; 示例：`0`","x-java-type":"Integer","format":"int32"},"tripPurposeCode":{"type":"integer","description":"出行目的枚举值：0-19，仅正单返回；枚举取值：0-CLIENT_MEETING、1-SALES_VISIT、2-BUSINESS_DEVELOPMENT、3-CONFERENCE、4-EXHIBITION_TRADE_SHOW、5-TRAINING、6-WORKSHOP_SEMINAR、7-INTERNAL_MEETING、8-TEAM_OFFSITE、9-PROJECT_WORK、10-SITE_VISIT、11-AUDIT_INSPECTION、12-INSTALLATION_IMPLEMENTATION、13-CUSTOMER_SUPPORT、14-SUPPLIER_VENDOR_MEETING、15-CONTRACT_NEGOTIATION、16-RECRUITMENT、17-MARKET_RESEARCH、18-OFFICE_VISIT、19-OTHER; 示例：`0`","x-java-type":"Integer","format":"int32"},"tripPurposeRemark":{"type":"string","description":"出行目的其他说明，仅正单选择 Other (please specify) 时返回; 示例：`客户现场交流`","x-java-type":"String"},"isManualOrder":{"type":"integer","description":"是否手工单：0-否，1-是; 示例：`0`","x-java-type":"Integer","format":"int32"},"isPayFailed":{"type":"integer","description":"是否支付失败 0-否，1-是; 示例：`0`","x-java-type":"Integer","format":"int32"},"payFailReason":{"type":"string","description":"支付失败原因","x-java-type":"String"},"changeReasonDesc":{"type":"string","description":"改签原因描述（仅改签单有值）; 示例：`航变改签`","x-java-type":"String"},"changeAttachmentUrls":{"type":"array","description":"改签附件URL集合（仅改签单有值）","x-java-type":"List<String>","items":{"type":"string"}},"orderType":{"type":"integer","description":"订单类型：0-正单，1-改签单，2-退票单","x-java-type":"Integer","format":"int32"},"orderSourceType":{"type":"integer","description":"订单来源类型：0-来源于正单，1-来源于改签单（仅改签单返回）; 示例：`0`","x-java-type":"Integer","format":"int32"}}},"orderLogs":{"type":"array","description":"操作日志","x-java-type":"List<OrderLogVo>","items":{"type":"object","properties":{"logType":{"type":"string","description":"日志类型；枚举取值：ORDER_CREATE-订单创建、ORDER_PAY-订单支付、ORDER_CANCEL-订单取消、ORDER_ISSUED-订单出票、SCHEDULE_CHANGE-航班变动、REFUND-退票、CHANGE-改签、STATUS_CHANGE-订单状态变更、ORDER_INFO_UPDATE-订单信息修改、PAY_FAILED-支付失败、REFUND_FAILED-退款失败、PAYMENT_EXCEPTION-支付异常、SYSTEM_ERROR-系统异常、EXCEPTION_HANDLED-异常单已处理、SCHEDULE_CHANGE_EMAIL_RESEND-航变邮件重发; 示例：`ORDER_CREATE`","x-java-type":"String"},"logContent":{"type":"string","description":"日志内容; 示例：`订单创建成功`","x-java-type":"String"},"operator":{"type":"string","description":"操作人; 示例：`admin`","x-java-type":"String"},"operatorType":{"type":"integer","description":"操作人类型；枚举取值：1-系统、2-用户、3-管理员; 示例：`1`","x-java-type":"Integer","format":"int32"},"relationId":{"type":"string","description":"关联id（如改签申请ID、退票申请ID等）; 示例：`REF001`","x-java-type":"String"},"beforeStatus":{"type":"string","description":"操作前状态; 示例：`1`","x-java-type":"String"},"afterStatus":{"type":"string","description":"操作后状态; 示例：`2`","x-java-type":"String"},"operateTime":{"type":"string","description":"操作时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"logCode":{"type":"string","description":"日志编码；枚举取值：CREATE_ORDER_SUCCESS-订单创建成功、PAY_SUCCESS-订单支付成功、PAY_FAIL-订单支付失败、ORDER_ISSUED-订单已出票、CANCEL_TIMEOUT-订单超时取消、CANCEL_USER_REQUEST-用户取消订单、CANCEL_SUPPLIER-供应商取消订单、CANCEL_FAIL-取消订单失败、REFUND_SUCCESS-退款成功、REFUND_FAIL-退款失败、REFUND_OFFLINE-线下退款、SCHEDULE_CHANGE-航变通知、EMAIL_SEND_SUCCESS-邮件发送成功、EMAIL_SEND_FAIL-邮件发送失败、SCHEDULE_CHANGE_PROCESSED-航变已处理、SCHEDULE_CHANGE_IGNORED-航变已忽略、MANUAL_ISSUE-手工出票、REFUND_APPLY_SUBMITTED-退票申请已提交、CHANGE_APPLY_SUBMITTED-改签申请已提交、CHANGE_ORDER_PAY_SUCCESS-改签订单支付成功、CHANGE_ORDER_PAY_FAIL-改签订单支付失败、CHANGE_PAY_TIMEOUT_AUTO_CANCEL-改签支付超时自动取消、CHANGE_USER_CANCEL_PENDING_PAYMENT-用户取消改签（待支付）、CHANGE_USER_CANCEL_PENDING_AUDIT-用户取消改签（待审核）、REFUND_USER_CONFIRM_TO_REFUNDING-用户确认退票、REFUND_USER_CANCEL_FROM_PENDING_CONFIRM-用户取消退票（待确认）、REFUND_USER_CANCEL_FROM_PENDING_AUDIT-用户取消退票（待审核）、CHANGE_ADMIN_AUDIT_PASS-后台改签审核通过、CHANGE_ADMIN_AUDIT_REJECT-后台改签审核拒绝、CHANGE_ADMIN_TICKET_ISSUED-后台改签出票完成、CHANGE_ADMIN_ORDER_CANCELLED-后台取消改签单、REFUND_ADMIN_AUDIT_PASS-后台退票审核通过、REFUND_ADMIN_AUDIT_REJECT-后台退票审核拒绝、REFUND_ADMIN_REFUND_COMPLETED-后台退票完单、REFUND_ADMIN_REFUND_ABORT-后台取消退票中、CHANGE_SUPPLIER_AUDIT_PASS-供应商改签审核通过、CHANGE_SUPPLIER_AUDIT_REJECT-供应商改签审核拒绝、CHANGE_SUPPLIER_TICKET_ISSUED-供应商改签出票完成、CHANGE_SUPPLIER_ORDER_CANCELLED-供应商取消改签单、REFUND_SUPPLIER_AUDIT_PASS-供应商退票审核通过、REFUND_SUPPLIER_AUDIT_REJECT-供应商退票审核拒绝、REFUND_SUPPLIER_REFUND_COMPLETED-供应商退票完成、REFUND_SUPPLIER_REFUND_ABORT-供应商退票终止/失败、ORDER_FEE_ADJUSTED-调整订单展示费用、SUPPLIER_ORDER_NO_UPDATED-修改供应商订单号、SUPPLIER_CHANGE_ORDER_NO_UPDATED-修改供应商改签单号、SUPPLIER_REFUND_ORDER_NO_UPDATED-修改供应商退票单号; 示例：`CREATE_ORDER_SUCCESS`","x-java-type":"String"},"logParams":{"type":"string","description":"日志参数; 示例：`123`","x-java-type":"String"}},"required":["logType","logContent","operator","operatorType","operateTime","logCode","logParams"]}},"orderPayInfo":{"type":"object","description":"支付信息","x-java-type":"OrderPayInfoVo","properties":{"paymentMethod":{"type":"integer","description":"支付方式：0信用卡，1额度; 示例：`0`","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"订单总收入; 示例：`1180.00`","x-java-type":"BigDecimal"},"refundAmount":{"type":"number","description":"订单退还金额; 示例：`0.00`","x-java-type":"BigDecimal"},"payAmount":{"type":"number","description":"订单支付金额; 示例：`1180.00`","x-java-type":"BigDecimal"},"payDetailList":{"type":"object","description":"订单支付明细","x-java-type":"AdminOrderFeeVo","properties":{"totalFee":{"type":"number","description":"总费用; 示例：`1180.00`","x-java-type":"BigDecimal"},"totalRefund":{"type":"number","description":"总退款金额; 示例：`0.00`","x-java-type":"BigDecimal"},"payCurrency":{"type":"string","description":"支付币种; 示例：`CNY`","x-java-type":"String"},"payTime":{"type":"string","description":"支付时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"},"payLateTime":{"type":"string","description":"最晚支付时间; 示例：`2025-01-01 14:00:00`","x-java-type":"String"},"payStatus":{"type":"integer","description":"支付状态；枚举取值：0-待支付、1-已支付、2-支付失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"payMethod":{"type":"integer","description":"支付方式；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`0`","x-java-type":"Integer","format":"int32"},"payDetailList":{"type":"array","description":"支付明细","x-java-type":"List<AdminOrderPayDetailVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票价; 示例：`1000.00`","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"税费; 示例：`100.00`","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"服务费; 示例：`30.00`","x-java-type":"BigDecimal"},"totalAmount":{"type":"number","description":"总金额（票价+税费）; 示例：`1130.00`","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"passengerCount":{"type":"integer","description":"人数; 示例：`1`","x-java-type":"Integer","format":"int32"},"markupAmount":{"type":"number","description":"产品加幅金额（按乘客类型分摊）; 示例：`40.00`","x-java-type":"BigDecimal"},"fareDiff":{"type":"number","description":"票税差。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"改签手续费。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用。","x-java-type":"BigDecimal"}}}},"refundDetailList":{"type":"array","description":"退款列表","x-java-type":"List<AdminOrderRefundDetailVo>","items":{"type":"object","properties":{"refundAmount":{"type":"number","description":"退改金额; 示例：`500.00`","x-java-type":"BigDecimal"},"refundTime":{"type":"string","description":"退改时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"refundStatus":{"type":"integer","description":"退改状态：3-退款成功; 示例：`3`","x-java-type":"Integer","format":"int32"},"refundMethod":{"type":"integer","description":"退改方式：0-信用卡，1-挂账; 示例：`0`","x-java-type":"Integer","format":"int32"}}}},"orderTransactionFee":{"type":"number","description":"订单交易手续费; 示例：`50.00`","x-java-type":"BigDecimal"},"feeCalculationType":{"type":"string","description":"手续费计算类型：percentage-按比例、fixed-固定金额；枚举取值：percentage-按比例、fixed-固定金额; 示例：`percentage`","x-java-type":"String"},"feeValue":{"type":"number","description":"手续费计费值; 示例：`3.00`","x-java-type":"BigDecimal"},"feePayer":{"type":"string","description":"手续费承担方：customer/platform/waived; 示例：`customer`","x-java-type":"String"},"totalPayAmount":{"type":"number","description":"总支付金额（含手续费）; 示例：`1230.00`","x-java-type":"BigDecimal"},"orderServiceFee":{"type":"number","description":"订单服务费; 示例：`50.00`","x-java-type":"BigDecimal"}}},"payRecordList":{"type":"array","description":"订单支付流水","x-java-type":"List<PayRecordVo>","items":{"type":"object","properties":{"payRecordType":{"type":"integer","description":"支付记录类型；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`1`","x-java-type":"Integer","format":"int32"},"payRecordAmount":{"type":"number","description":"流水金额; 示例：`1180.00`","x-java-type":"BigDecimal"},"payRecordNumber":{"type":"string","description":"交易号; 示例：`PAY202501010001`","x-java-type":"String"},"payRecordChannel":{"type":"integer","description":"支付渠道；枚举取值：0-信用卡、1-挂账、8-Airwallex、9-UUPay; 示例：`1`","x-java-type":"Integer","format":"int32"},"payRecordStatus":{"type":"integer","description":"状态；枚举取值：1-已支付、2-支付失败、3-退款成功、4-退款失败; 示例：`1`","x-java-type":"Integer","format":"int32"},"payRecordRemark":{"type":"string","description":"备注; 示例：`支付成功`","x-java-type":"String"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"payFailReason":{"type":"string","description":"失败原因","x-java-type":"String"}}}},"fareDiff":{"type":"number","description":"票税差（仅改签单有值）; 示例：`120.00`","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"改签服务费（仅改签单有值）; 示例：`30.00`","x-java-type":"BigDecimal"},"changeTaxFee":{"type":"number","description":"改签税费（仅改签单有值）; 示例：`50.00`","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用（仅改签单有值）; 示例：`10.00`","x-java-type":"BigDecimal"}},"required":["refundAmount","payRecordList"]},"orderTripInfo":{"type":"array","description":"行程信息","x-java-type":"List<OrderTripInfoVo>","items":{"type":"object","properties":{"segment":{"type":"array","description":"行程段信息","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","stopoverInfos","cabin","cabinClass","supplierOrderNo","aircraftCode"]}},"originZh":{"type":"string","description":"出发地（中文）; 示例：`北京`","x-java-type":"String"},"originEn":{"type":"string","description":"出发地（英文）; 示例：`Beijing`","x-java-type":"String"},"originTc":{"type":"string","description":"出发地（繁体）; 示例：`北京`","x-java-type":"String"},"destinationZh":{"type":"string","description":"目的地（中文）; 示例：`上海`","x-java-type":"String"},"destinationEn":{"type":"string","description":"目的地（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationTc":{"type":"string","description":"目的地（繁体）; 示例：`上海`","x-java-type":"String"},"journeysTime":{"type":"string","description":"行程耗时; 示例：`150`","x-java-type":"String"},"baggageChangeRefundRuleVo":{"type":"object","description":"退改条件","x-java-type":"AdminBaggageChangeRefundRuleVo","properties":{"baggageChangeRefundRuleList":{"type":"array","description":"行李额规则列表","x-java-type":"List<AdminBaggageRuleItemVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"depTime":{"type":"string","description":"航段始发日期+时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"depCityZh":{"type":"string","description":"航段出发地（中文）; 示例：`北京`","x-java-type":"String"},"depCityEn":{"type":"string","description":"航段出发地（英文）; 示例：`Beijing`","x-java-type":"String"},"depCityTc":{"type":"string","description":"航段出发地（繁体）; 示例：`北京`","x-java-type":"String"},"depCityCode":{"type":"string","description":"航段出发地三字码; 示例：`PEK`","x-java-type":"String"},"arrCityZh":{"type":"string","description":"航段目的地（中文）; 示例：`上海`","x-java-type":"String"},"arrCityEn":{"type":"string","description":"航段目的地（英文）; 示例：`Shanghai`","x-java-type":"String"},"arrCityTc":{"type":"string","description":"航段目的地（繁体）; 示例：`上海`","x-java-type":"String"},"arrCityCode":{"type":"string","description":"航段目的地三字码; 示例：`SHA`","x-java-type":"String"},"flightNo":{"type":"string","description":"航段航班号; 示例：`CA1234`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierCode":{"type":"string","description":"航司二字码; 示例：`CA`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"baggageList":{"type":"array","description":"行李额列表","x-java-type":"List<AdminBaggageItemVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"carryOnPieces":{"type":"integer","description":"手提行李件数; 示例：`1`","x-java-type":"int","format":"int32"},"carryOnWeight":{"type":"integer","description":"手提行李重量; 示例：`7`","x-java-type":"int","format":"int32"},"carryOnWeightUnit":{"type":"string","description":"手提行李重量单位; 示例：`KG`","x-java-type":"String"},"carryOnSize":{"type":"string","description":"手提行李尺寸; 示例：`55x40x20cm`","x-java-type":"String"},"carryOnDescriptionEn":{"type":"string","description":"手提行李描述（英文）; 示例：`1 piece, 7kg`","x-java-type":"String"},"carryOnDescriptionTc":{"type":"string","description":"手提行李描述（繁体）; 示例：`1件，7公斤`","x-java-type":"String"},"carryOnDescriptionZh":{"type":"string","description":"手提行李描述（中文）; 示例：`1件，7公斤`","x-java-type":"String"},"checkedPieces":{"type":"integer","description":"托运行李件数; 示例：`1`","x-java-type":"int","format":"int32"},"checkedWeight":{"type":"integer","description":"托运行李重量; 示例：`23`","x-java-type":"int","format":"int32"},"checkedWeightUnit":{"type":"string","description":"托运行李重量单位; 示例：`KG`","x-java-type":"String"},"checkedSize":{"type":"string","description":"托运行李尺寸; 示例：`158cm`","x-java-type":"String"},"checkedDescriptionZh":{"type":"string","description":"托运行李描述（中文）; 示例：`1件，23公斤`","x-java-type":"String"},"checkedDescriptionTc":{"type":"string","description":"托运行李描述（繁体）; 示例：`1件，23公斤`","x-java-type":"String"},"checkedDescriptionEn":{"type":"string","description":"托运行李描述（英文）; 示例：`1 piece, 23kg`","x-java-type":"String"}}}}}}},"changeRuleList":{"type":"array","description":"改签规则列表","x-java-type":"List<RefundSegmentVo>","items":{"type":"object","properties":{"nodeTime":{"type":"string","description":"节点时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"beforeAfter":{"type":"boolean","description":"是否为节点前; 示例：`true`","x-java-type":"Boolean"},"adultChargeFee":{"type":"number","description":"成人手续费; 示例：`200.00`","x-java-type":"BigDecimal"},"childChargeFee":{"type":"number","description":"儿童手续费; 示例：`100.00`","x-java-type":"BigDecimal"},"infantChargeFee":{"type":"number","description":"婴儿手续费; 示例：`0.00`","x-java-type":"BigDecimal"},"dayCount":{"type":"integer","description":"天数; 示例：`1`","x-java-type":"Integer","format":"int32"},"hourCount":{"type":"integer","description":"小时; 示例：`8`","x-java-type":"Integer","format":"int32"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"changeOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段号","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号","x-java-type":"String"}}}},"refundRuleList":{"type":"array","description":"退票规则列表","x-java-type":"List<RefundSegmentVo>","items":{"type":"object","properties":{"nodeTime":{"type":"string","description":"节点时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"beforeAfter":{"type":"boolean","description":"是否为节点前; 示例：`true`","x-java-type":"Boolean"},"adultChargeFee":{"type":"number","description":"成人手续费; 示例：`200.00`","x-java-type":"BigDecimal"},"childChargeFee":{"type":"number","description":"儿童手续费; 示例：`100.00`","x-java-type":"BigDecimal"},"infantChargeFee":{"type":"number","description":"婴儿手续费; 示例：`0.00`","x-java-type":"BigDecimal"},"dayCount":{"type":"integer","description":"天数; 示例：`1`","x-java-type":"Integer","format":"int32"},"hourCount":{"type":"integer","description":"小时; 示例：`8`","x-java-type":"Integer","format":"int32"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"changeOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段号","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号","x-java-type":"String"}}}},"flightChangeRuleVOList":{"type":"array","description":"改签规则列表","x-java-type":"List<FlightChangeRuleVo>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"changeOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segment":{"type":"object","description":"航段实体对象","x-java-type":"SegmentVo","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}}}}}},"flightRefundRuleVoList":{"type":"array","description":"退票规则列表","x-java-type":"List<FlightRefundRuleVo>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"passengerType":{"type":"string","description":"乘客类型：adult成人，child儿童，infant婴儿","x-java-type":"String"},"refundOriginalText":{"type":"string","description":"改签航司原文","x-java-type":"String"},"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"segment":{"type":"object","description":"航段实体对象","x-java-type":"SegmentVo","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）; 示例：`CA1234`","x-java-type":"String"},"cabin":{"type":"string","description":"舱等; 示例：`Y`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"aircraft":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码; 示例：`PEK`","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）; 示例：`北京`","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼; 示例：`T3`","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码; 示例：`SHA`","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）; 示例：`上海`","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）; 示例：`Shanghai`","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）; 示例：`上海`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码; 示例：`SHA`","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼; 示例：`T2`","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班; 示例：`false`","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码; 示例：`CA`","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号; 示例：`CA1234`","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）; 示例：`中国国际航空CA1234`","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）; 示例：`中國國際航空CA1234`","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）; 示例：`Air China CA1234`","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"destinationTime":{"type":"string","description":"到达时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8","x-java-type":"DateTime"},"meal":{"type":"string","description":"餐食信息; 示例：`有餐食`","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息; 示例：`有wifi`","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型; 示例：`1`","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）; 示例：`Luggage through check`","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）; 示例：`行李直掛`","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）; 示例：`行李直挂`","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）; 示例：`Entry tips`","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）; 示例：`出入境提示`","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）; 示例：`出入境提示`","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长; 示例：`150`","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是; 示例：`0`","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是; 示例：`1`","x-java-type":"Integer","format":"int32"}}}}}}},"required":["baggageChangeRefundRuleList","changeRuleList","refundRuleList","flightChangeRuleVOList","flightRefundRuleVoList"]}},"required":["segment","originZh","originEn","originTc","destinationZh","destinationEn","destinationTc","baggageChangeRefundRuleVo"]}},"orderQuoteInfo":{"type":"array","description":"报价信息","x-java-type":"List<OrderQuoteInfoVo>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"ticketPrice":{"type":"number","description":"票价; 示例：`1000.00`","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"税费; 示例：`100.00`","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"服务费; 示例：`30.00`","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种; 示例：`CNY`","x-java-type":"String"},"totalPrice":{"type":"number","description":"总价（票面价+税费+服务费）; 示例：`1130.00`","x-java-type":"BigDecimal"},"productMarkupAmount":{"type":"number","description":"产品加幅金额（按乘客类型分摊）; 示例：`40.00`","x-java-type":"BigDecimal"}}}},"orderPassengerInfo":{"type":"array","description":"乘客信息","x-java-type":"List<OrderPassengerInfoVo>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘客ID; 示例：`101`","x-java-type":"Long","format":"int64"},"passengerName":{"type":"string","description":"乘机人姓名; 示例：`ZHANG/SAN`","x-java-type":"String"},"firstName":{"type":"string","description":"乘机人姓; 示例：`ZHANG`","x-java-type":"String"},"lastName":{"type":"string","description":"乘机人名; 示例：`SAN`","x-java-type":"String"},"passengerType":{"type":"string","description":"乘机人类型；枚举取值：adult-成人、child-儿童、infant-婴儿; 示例：`adult`","x-java-type":"String"},"country":{"type":"string","description":"国籍; 示例：`CN`","x-java-type":"String"},"sex":{"type":"integer","description":"性别：0男，1女; 示例：`0`","x-java-type":"Integer","format":"int32"},"certificate":{"type":"string","description":"证件号码; 示例：`E12345678`","x-java-type":"String"},"certificateType":{"type":"integer","description":"证件类型；枚举取值：1-身份证、2-护照、3-军官证、4-国际海员证、5-港澳通行证、6-台湾通行证、7-台胞证、8-回乡证、9-学生证、10-外国人居留证、11-其他; 示例：`1`","x-java-type":"Integer","format":"int32"},"certificateValidity":{"type":"string","description":"证件有效期; 示例：`2030-01-01`","x-java-type":"String"},"birthDate":{"type":"string","description":"出生日期; 示例：`1990-01-01`","x-java-type":"String"},"phone":{"type":"string","description":"手机号; 示例：`13800138000`","x-java-type":"String"},"email":{"type":"string","description":"邮箱; 示例：`example@test.com`","x-java-type":"String"},"cardCode":{"type":"string","description":"常旅客卡航司; 示例：`CA`","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"常旅客卡航司名称（简体中文）; 示例：`中国国际航空`","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"常旅客卡航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"常旅客卡航司名称（繁体中文）; 示例：`中國國際航空`","x-java-type":"String"},"cardNumber":{"type":"string","description":"常旅客卡号; 示例：`123456789`","x-java-type":"String"},"ticketNumber":{"type":"string","description":"票号; 示例：`999-1234567890`","x-java-type":"String"},"ticketStatus":{"type":"integer","description":"票状态；枚举取值：0-待出票、1-已出票、2-已退票、3-已改签; 示例：`1`","x-java-type":"Integer","format":"int32"},"ticketDetails":{"type":"array","description":"按航段的票号明细列表","x-java-type":"List<TicketDetailVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID; 示例：`SEG001`","x-java-type":"String"},"ticketNo":{"type":"string","description":"票号; 示例：`999-1234567890`","x-java-type":"String"},"ticketStatus":{"type":"integer","description":"票号状态：1已出票 2已退票 3已改签; 示例：`1`","x-java-type":"Integer","format":"int32"}}}}},"required":["passengerId","passengerName","firstName","lastName","passengerType","country","sex","certificate","certificateType","certificateValidity","birthDate","phone","email"]}},"orderChangeInfo":{"type":"array","description":"改签记录","x-java-type":"List<OrderChangeInfoVo>","items":{"type":"object","properties":{"changeOrderNo":{"type":"string","description":"改签单号; 示例：`CHG202501010001`","x-java-type":"String"},"applicantName":{"type":"string","description":"申请人; 示例：`张三`","x-java-type":"String"},"beforeSegmentInfo":{"type":"string","description":"改签前航段信息; 示例：`PEK-SHA`","x-java-type":"String"},"beforeSegmentDetailList":{"type":"array","description":"改签前航段明细","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","stopoverInfos","cabin","cabinClass","supplierOrderNo","aircraftCode"]}},"afterSegmentInfo":{"type":"string","description":"改签后航段信息; 示例：`PEK-CAN`","x-java-type":"String"},"afterSegmentDetailList":{"type":"array","description":"改签后航段明细","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","stopoverInfos","cabin","cabinClass","supplierOrderNo","aircraftCode"]}},"changePassengerName":{"type":"string","description":"改签乘客; 示例：`ZHANG/SAN`","x-java-type":"String"},"applyTime":{"type":"string","description":"申请时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"changeFee":{"type":"number","description":"改签费用; 示例：`200.00`","x-java-type":"BigDecimal"},"changeStatus":{"type":"integer","description":"改签状态；枚举取值：0-待审核、1-提交中、2-待支付、3-待出票、4-已出票、5-部分出票、6-已取消、7-部分退票、8-部分改签、9-全部退票、10-全部改签; 示例：`1`","x-java-type":"Integer","format":"int32"}}}},"orderRefundInfo":{"type":"array","description":"退票记录","x-java-type":"List<OrderRefundInfoVo>","items":{"type":"object","properties":{"refundOrderNo":{"type":"string","description":"退票订单号; 示例：`REF202501010001`","x-java-type":"String"},"applicantName":{"type":"string","description":"申请人; 示例：`张三`","x-java-type":"String"},"refundTrip":{"type":"string","description":"退票行程; 示例：`北京-上海`","x-java-type":"String"},"refundSegmentDetailList":{"type":"array","description":"退票航段明细","x-java-type":"List<FlightSegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID（供应商标识）; 示例：`SEG001`","x-java-type":"String"},"departureAirport":{"type":"string","description":"出发机场三字码; 示例：`PEK`","x-java-type":"String"},"arrivalAirport":{"type":"string","description":"到达机场三字码; 示例：`SHA`","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号; 示例：`CA1234`","x-java-type":"String"},"takeOffAirportNameZh":{"type":"string","description":"出发机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"takeOffAirportNameEn":{"type":"string","description":"出发机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"takeOffAirportNameTc":{"type":"string","description":"出发机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"takeOffTime":{"type":"string","description":"航班出发时间; 示例：`08:00`","x-java-type":"String"},"arrivalTime":{"type":"string","description":"航班到达时间; 示例：`10:30`","x-java-type":"String"},"takeOffTerminal":{"type":"string","description":"出发航站楼; 示例：`T3`","x-java-type":"String"},"arrivalTerminal":{"type":"string","description":"到达航站楼; 示例：`T2`","x-java-type":"String"},"stopoverInfos":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码; 示例：`WUH`","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）; 示例：`武汉`","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）; 示例：`Wuhan`","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）; 示例：`武漢`","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码; 示例：`WUH`","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）; 示例：`武汉天河国际机场`","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）; 示例：`Wuhan Tianhe International Airport`","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）; 示例：`武漢天河國際機場`","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长; 示例：`1h 20m`","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 09:00:00`","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间; 格式：`yyyy-MM-dd HH:mm:ss`；时区：GMT+8；示例：`2025-01-15 10:20:00`","x-java-type":"String"}}}},"cabinDiscount":{"type":"string","description":"舱位折扣; 示例：`Y`","x-java-type":"String"},"cabin":{"type":"string","description":"舱位; 示例：`Y`","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等; 示例：`经济舱`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）; 示例：`ABC123`","x-java-type":"String"},"airlinePnr":{"type":"string","description":"航空公司记录编号; 示例：`XYZ789`","x-java-type":"String"},"aircraftCode":{"type":"string","description":"机型; 示例：`B738`","x-java-type":"String"}},"required":["segmentId","departureAirport","arrivalAirport","flightNumber","takeOffAirportNameZh","takeOffAirportNameEn","takeOffAirportNameTc","arrivalAirportNameZh","arrivalAirportNameEn","arrivalAirportNameTc","takeOffTime","arrivalTime","stopoverInfos","cabin","cabinClass","supplierOrderNo","aircraftCode"]}},"refundPassengerName":{"type":"string","description":"退票乘客姓名; 示例：`ZHANG/SAN`","x-java-type":"String"},"refundApplyTime":{"type":"string","description":"退票申请时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"refundAmount":{"type":"number","description":"退款金额; 示例：`180.00`","x-java-type":"BigDecimal"},"refundStatus":{"type":"integer","description":"退票状态；枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票; 示例：`1`","x-java-type":"Integer","format":"int32"}}}},"orderScheduleChangeInfo":{"type":"array","description":"航变记录","x-java-type":"List<OrderScheduleChangeInfoVo>","items":{"type":"object","properties":{"changeType":{"type":"integer","description":"航变类型；枚举取值：1-航班延误、2-航班取消、3-航班提前、4-航班变更、5-航班待定、6-恢复; 示例：`1`","x-java-type":"Integer","format":"int32"},"segmentId":{"type":"string","description":"航程id; 示例：`SEG001`","x-java-type":"String"},"originalAirlineLogo":{"type":"string","description":"原航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"originalAirlineNameEn":{"type":"string","description":"原航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"originalAirlineNameZh":{"type":"string","description":"原航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"originalFlightNameTc":{"type":"string","description":"原航班名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"originalFlightNumber":{"type":"string","description":"原航班号; 示例：`CA1234`","x-java-type":"String"},"originalTakeOffTime":{"type":"string","description":"原起飞时间; 示例：`2025-01-15 08:00:00`","x-java-type":"String"},"originalArrivalTime":{"type":"string","description":"原到达时间; 示例：`2025-01-15 10:30:00`","x-java-type":"String"},"originalFromCityEn":{"type":"string","description":"原出发城市（英文）; 示例：`Beijing`","x-java-type":"String"},"originalFromCityZh":{"type":"string","description":"原出发城市（中文）; 示例：`北京`","x-java-type":"String"},"originalFromCityTc":{"type":"string","description":"原出发城市（繁体）; 示例：`北京`","x-java-type":"String"},"originalToCityEn":{"type":"string","description":"原到达城市（英文）; 示例：`Shanghai`","x-java-type":"String"},"originalToCityZh":{"type":"string","description":"原到达城市（中文）; 示例：`上海`","x-java-type":"String"},"originalToCityTc":{"type":"string","description":"原到达城市（繁体）; 示例：`上海`","x-java-type":"String"},"originalFromCityCode":{"type":"string","description":"原出发城市三字码; 示例：`PEK`","x-java-type":"String"},"originalToCityCode":{"type":"string","description":"原到达城市三字码; 示例：`SHA`","x-java-type":"String"},"originalDepartureAirportCode":{"type":"string","description":"原出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originalArrivalAirportCode":{"type":"string","description":"原到达机场三字码; 示例：`SHA`","x-java-type":"String"},"originalTakeOffAirportEn":{"type":"string","description":"原起飞机场（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"originalTakeOffAirportZh":{"type":"string","description":"原起飞机场（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originalTakeOffAirportTc":{"type":"string","description":"原起飞机场（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"originalTakeOffTerminal":{"type":"string","description":"原出发航站楼; 示例：`T3`","x-java-type":"String"},"originalArrivalTerminal":{"type":"string","description":"原到达航站楼; 示例：`T2`","x-java-type":"String"},"originalAircraftModel":{"type":"string","description":"原机型; 示例：`B738`","x-java-type":"String"},"originalFlightTime":{"type":"string","description":"原飞行时间; 示例：`150`","x-java-type":"String"},"originalCabinClass":{"type":"string","description":"原舱等; 示例：`Y`","x-java-type":"String"},"originalArrivalAirportEn":{"type":"string","description":"原到达机场（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"originalArrivalAirportZh":{"type":"string","description":"原到达机场（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"originalArrivalAirportTc":{"type":"string","description":"原到达机场（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"newAirlineLogo":{"type":"string","description":"新航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"newAirlineNameEn":{"type":"string","description":"新航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"newFlightNameZh":{"type":"string","description":"新航班名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"newFlightNameTc":{"type":"string","description":"新航班名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"newFlightNumber":{"type":"string","description":"新航班号; 示例：`CA5678`","x-java-type":"String"},"newTakeOffTime":{"type":"string","description":"新起飞时间; 示例：`2025-01-15 10:00:00`","x-java-type":"String"},"newArrivalTime":{"type":"string","description":"新到达时间; 示例：`2025-01-15 12:30:00`","x-java-type":"String"},"newFromCityEn":{"type":"string","description":"新出发城市（英文）; 示例：`Beijing`","x-java-type":"String"},"newFromCityZh":{"type":"string","description":"新出发城市（中文）; 示例：`北京`","x-java-type":"String"},"newFromCityTc":{"type":"string","description":"新出发城市（繁体）; 示例：`北京`","x-java-type":"String"},"newToCityEn":{"type":"string","description":"新到达城市（英文）; 示例：`Shanghai`","x-java-type":"String"},"newToCityZh":{"type":"string","description":"新到达城市（中文）; 示例：`上海`","x-java-type":"String"},"newToCityTc":{"type":"string","description":"新到达城市（繁体）; 示例：`上海`","x-java-type":"String"},"newFromCityCode":{"type":"string","description":"新出发城市三字码; 示例：`PEK`","x-java-type":"String"},"newDepartureAirportCode":{"type":"string","description":"新出发机场三字码; 示例：`PEK`","x-java-type":"String"},"newToCityCode":{"type":"string","description":"新到达城市三字码; 示例：`SHA`","x-java-type":"String"},"newArrivalAirportCode":{"type":"string","description":"新到达机场三字码; 示例：`SHA`","x-java-type":"String"},"newTakeOffAirportEn":{"type":"string","description":"新起飞机场（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"newTakeOffAirportZh":{"type":"string","description":"新起飞机场（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"newTakeOffAirportTc":{"type":"string","description":"新起飞机场（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"newArrivalAirportEn":{"type":"string","description":"新到达机场（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"newArrivalAirportZh":{"type":"string","description":"新到达机场（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"newArrivalAirportTc":{"type":"string","description":"新到达机场（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"newTakeOffTerminal":{"type":"string","description":"新出发航站楼; 示例：`T3`","x-java-type":"String"},"newArrivalTerminal":{"type":"string","description":"新到达航站楼; 示例：`T2`","x-java-type":"String"},"newAircraftModel":{"type":"string","description":"新机型; 示例：`B738`","x-java-type":"String"},"newFlightTime":{"type":"string","description":"新飞行时间; 示例：`150`","x-java-type":"String"},"newCabinClass":{"type":"string","description":"新舱等; 示例：`Y`","x-java-type":"String"},"changeDescriptionEn":{"type":"string","description":"航变原因（英文）; 示例：`Flight delayed due to weather`","x-java-type":"String"},"changeDescriptionZh":{"type":"string","description":"航变原因（中文）; 示例：`因天气原因航班延误`","x-java-type":"String"},"changeDescriptionTc":{"type":"string","description":"航变原因（繁体）; 示例：`因天氣原因航班延誤`","x-java-type":"String"},"createTime":{"type":"string","description":"创建时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"}}}},"orderRemarkRespList":{"type":"array","description":"BMS机票订单或退票单备注列表，按最新备注优先排序","x-java-type":"List<FlightOrderRemarkResult>","items":{"type":"object","properties":{"id":{"type":"integer","description":"备注ID","x-java-type":"Long","format":"int64"},"orderCode":{"type":"string","description":"备注目标编码：机票订单号或退票申请单号","x-java-type":"String"},"remarkType":{"type":"integer","description":"备注类型：1-内部备注 2-与客人备注 3-与供应商备注","x-java-type":"Integer","format":"int32"},"content":{"type":"string","description":"备注内容","x-java-type":"String"},"operatorEmail":{"type":"string","description":"备注人邮箱","x-java-type":"String"},"createdDt":{"type":"string","description":"备注时间; 格式：`yyyy-MM-dd HH:mm:ss`","x-java-type":"LocalDateTime"}}}},"feeAdjustment":{"type":"object","description":"机票订单人工调整后的展示费用","x-java-type":"FlightOrderFeeAdjustmentRespDTO","properties":{"orderCode":{"type":"string","description":"订单号","x-java-type":"String"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"version":{"type":"integer","description":"版本号，首次调整前为0","x-java-type":"Integer","format":"int32"},"adjusted":{"type":"boolean","description":"是否已经发生过人工调整","x-java-type":"Boolean"},"totalAmount":{"type":"number","description":"调整后的售价总计","x-java-type":"BigDecimal"},"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<Item>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型；枚举取值：adult-成人、child-儿童、infant-婴儿","x-java-type":"String"},"passengerCount":{"type":"integer","description":"人数","x-java-type":"Integer","format":"int32"},"ticketPrice":{"type":"number","description":"单人票面价","x-java-type":"BigDecimal"},"tax":{"type":"number","description":"单人税费及附加费","x-java-type":"BigDecimal"},"serviceFee":{"type":"number","description":"单人服务费","x-java-type":"BigDecimal"},"subtotal":{"type":"number","description":"乘客类型小计","x-java-type":"BigDecimal"}}}}}},"refundDetail":{"type":"object","description":"退票单详情节点","x-java-type":"AdminRefundOrderDetailVo","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号","x-java-type":"String"},"supplierRefundOrderNo":{"type":"string","description":"供应商退票单号","x-java-type":"String"},"customerName":{"type":"string","description":"客户名称","x-java-type":"String"},"applicantName":{"type":"string","description":"申请人名称","x-java-type":"String"},"applicantEmail":{"type":"string","description":"申请人邮箱","x-java-type":"String"},"platformStatus":{"type":"integer","description":"平台退票状态枚举值；枚举取值：0-待审核、1-待确认、2-已取消、3-退票中、4-已退票","x-java-type":"Integer","format":"int32"},"failureReason":{"type":"string","description":"失败原因","x-java-type":"String"},"latestValidOrderCode":{"type":"string","description":"最新有效票面单号","x-java-type":"String"},"reasonDesc":{"type":"string","description":"原因说明","x-java-type":"String"},"refundType":{"type":"integer","description":"退票类型：1自愿 2非自愿","x-java-type":"Integer","format":"int32"},"attachmentUrls":{"type":"array","description":"附件URL列表","x-java-type":"List<String>","items":{"type":"string"}},"refundableAmount":{"type":"number","description":"可退金额","x-java-type":"BigDecimal"},"actualRefundAmount":{"type":"number","description":"实际退款金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"processRemark":{"type":"string","description":"处理备注","x-java-type":"String"},"requestTime":{"type":"string","description":"申请时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"auditPassedTime":{"type":"string","description":"审核通过时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"refundingTime":{"type":"string","description":"退票中时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"refundedTime":{"type":"string","description":"退票成功时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"callbackTime":{"type":"string","description":"最近回调时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"contactName":{"type":"string","description":"联系人姓名","x-java-type":"String"},"contactRegion":{"type":"string","description":"联系人区号","x-java-type":"String"},"contactPhone":{"type":"string","description":"联系人电话","x-java-type":"String"},"contactEmail":{"type":"string","description":"联系人邮箱","x-java-type":"String"},"paymentMethod":{"type":"integer","description":"支付方式：0信用卡 1挂账; 示例：`0`","x-java-type":"Integer","format":"int32"},"refundServiceFee":{"type":"number","description":"退票服务费; 示例：`10.00`","x-java-type":"BigDecimal"},"refundFee":{"type":"number","description":"退票手续费; 示例：`20.00`","x-java-type":"BigDecimal"},"ticketPrice":{"type":"number","description":"票价","x-java-type":"BigDecimal"},"taxFee":{"type":"number","description":"退票税费; 示例：`30.00`","x-java-type":"BigDecimal"},"fuelFee":{"type":"number","description":"燃油费","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"其他费用; 示例：`5.00`","x-java-type":"BigDecimal"},"totalRefundAmount":{"type":"number","description":"退票单总退款（仅已退票时返回）; 示例：`100.00`","x-java-type":"BigDecimal"},"supplierInfo":{"type":"object","description":"供应商信息","x-java-type":"SupplierInfoVo","properties":{"supplierId":{"type":"string","description":"供应商ID; 示例：`1`","x-java-type":"String"},"supplierOrderNo":{"type":"string","description":"供应商订单号; 示例：`SUP202501010001`","x-java-type":"String"},"supplierName":{"type":"string","description":"供应商名称; 示例：`供应商A`","x-java-type":"String"},"supplierCode":{"type":"string","description":"供应商代码; 示例：`SUP001`","x-java-type":"String"},"supplierType":{"type":"string","description":"供应商类型; 示例：`GDS`","x-java-type":"String"}},"required":["supplierId","supplierOrderNo","supplierName","supplierCode","supplierType"]},"passengerAmountDetailList":{"type":"array","description":"按乘客类型聚合的退票金额明细","x-java-type":"List<PassengerRefundAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。","x-java-type":"String"},"passengerCount":{"type":"integer","description":"该类型人数，必填。","x-java-type":"Integer","format":"int32"},"ticketPrice":{"type":"number","description":"单人票价，必填。","x-java-type":"BigDecimal"},"taxFee":{"type":"number","description":"单人税费，必填。","x-java-type":"BigDecimal"},"fuelFee":{"type":"number","description":"单人燃油费，必填。","x-java-type":"BigDecimal"},"refundFee":{"type":"number","description":"单人退票手续费，必填。","x-java-type":"BigDecimal"},"refundServiceFee":{"type":"number","description":"单人退票服务费，必填。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"单人其他费用，必填。","x-java-type":"BigDecimal"},"refundableAmount":{"type":"number","description":"单人可退金额，必填。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种，必填。","x-java-type":"String"}},"required":["passengerType","passengerCount","ticketPrice","taxFee","fuelFee","refundFee","refundServiceFee","otherFee","refundableAmount","currency"]}},"orderSourceType":{"type":"integer","description":"订单来源类型：0-来源于正单，1-来源于改签单; 示例：`0`","x-java-type":"Integer","format":"int32"},"isManualAftersale":{"type":"integer","description":"是否手工售后单：0否 1是","x-java-type":"Integer","format":"int32"}},"required":["refundRequestCode","supplierRefundOrderNo","customerName","applicantName","applicantEmail","platformStatus","latestValidOrderCode","reasonDesc","refundType","attachmentUrls","refundableAmount","actualRefundAmount","currency","requestTime","refundingTime","callbackTime","contactName","contactRegion","contactPhone","contactEmail","paymentMethod","refundServiceFee","refundFee","ticketPrice","taxFee","fuelFee","otherFee","supplierInfo","passengerAmountDetailList","orderSourceType","isManualAftersale"]}},"required":["orderLogs","orderPayInfo","orderTripInfo","orderQuoteInfo","orderPassengerInfo","orderScheduleChangeInfo","orderRemarkRespList","refundDetail"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/supplier-order-no":{"put":{"operationId":"bms.putOrderFlightAftersaleAdminRefundSupplierOrderNo","x-api-code":"bms.putOrderFlightAftersaleAdminRefundSupplierOrderNo","x-open-platform-sort":115,"summary":"修改供应商退票单号","description":"**接口：** `PUT /bms/order/flight/aftersale/admin/refund/supplier-order-no`\n\n修改退票单对应的供应商退票单号。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号; 不可为空白字符串","x-java-type":"String"},"supplierRefundOrderNo":{"type":"string","description":"供应商退票单号; 不可为空白字符串；长度/元素数：最大 128","x-java-type":"String","maxLength":128}},"required":["refundRequestCode","supplierRefundOrderNo"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundSupplierNoUpdateResp","properties":{"refundRequestCode":{"type":"string","description":"退票申请单号; 示例：`FR202610190001`","x-java-type":"String"},"supplierRefundOrderNo":{"type":"string","description":"更新后的供应商退票单号; 示例：`SR202610190001`","x-java-type":"String"}},"required":["refundRequestCode","supplierRefundOrderNo"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/passenger/list":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminPassengerList","x-api-code":"bms.postOrderFlightAftersaleAdminPassengerList","x-open-platform-sort":116,"summary":"查询退改单乘机人列表","description":"**接口：** `POST /bms/order/flight/aftersale/admin/passenger/list`\n\n读取退改单乘机人列表。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subOrderCode":{"type":"string","description":"子单号（退票单号或改签单号），必填。; 不可为空白字符串","x-java-type":"String"},"orderType":{"type":"integer","description":"订单类型：根据业务类型枚举值传入，必填。枚举取值：1-改签、2-退票; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2}},"required":["subOrderCode","orderType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightAftersalePassengerListResp","properties":{"subOrderCode":{"type":"string","description":"子单号。","x-java-type":"String"},"sourceOrderCode":{"type":"string","description":"来源订单号。","x-java-type":"String"},"passengerList":{"type":"array","description":"乘机人列表。","x-java-type":"List<FlightAdminAftersalePassengerItemDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型。枚举取值：adult-成人、child-儿童、infant-婴儿","x-java-type":"String"},"passengerTypeName":{"type":"string","description":"乘客类型名称。","x-java-type":"String"},"passengerCount":{"type":"integer","description":"乘客数量。","x-java-type":"Integer","format":"int32"}},"required":["passengerType","passengerCount"]}}},"required":["subOrderCode","passengerList"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/passenger-segment/list":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminPassengerSegmentList","x-api-code":"bms.postOrderFlightAftersaleAdminPassengerSegmentList","x-open-platform-sort":117,"summary":"查询退改子单乘机人航段","description":"**接口：** `POST /bms/order/flight/aftersale/admin/passenger-segment/list`\n\n读取退改子单对应的乘机人及航段信息。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subOrderCode":{"type":"string","description":"子单号，必填。 改签场景：改签申请单号。 退票场景：退票申请单号。; 不可为空白字符串","x-java-type":"String"},"orderType":{"type":"integer","description":"订单类型，必填。 1=改签，2=退票。; 不可为 null；≥ 1；≤ 2","x-java-type":"Integer","format":"int32","minimum":1,"maximum":2}},"required":["subOrderCode","orderType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightAftersalePassengerSegmentListResp","properties":{"subOrderCode":{"type":"string","description":"子单号。","x-java-type":"String"},"passengerList":{"type":"array","description":"乘机人列表。","x-java-type":"List<FlightAdminPassengerSimpleDTO>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘机人 ID。","x-java-type":"Long","format":"int64"},"passengerName":{"type":"string","description":"乘机人姓名。","x-java-type":"String"},"passengerType":{"type":"string","description":"乘机人类型。枚举取值：adult-成人、child-儿童、infant-婴儿","x-java-type":"String"}},"required":["passengerId","passengerName","passengerType"]}},"segmentList":{"type":"array","description":"航段列表。","x-java-type":"List<FlightAdminSegmentAirportDTO>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段 ID。","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段序号。","x-java-type":"Integer","format":"int32"},"departureAirportCode":{"type":"string","description":"出发机场三字码。","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场中文名。","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场英文名。","x-java-type":"String"},"arrivalAirportCode":{"type":"string","description":"到达机场三字码。","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场中文名。","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场英文名。","x-java-type":"String"}},"required":["segmentId","segmentIndex","departureAirportCode","departureAirportNameZh","departureAirportNameEn","arrivalAirportCode","arrivalAirportNameZh","arrivalAirportNameEn"]}},"passengerAmountDetailList":{"type":"array","description":"按乘机人类型聚合的改签费用明细（单人口径）。","x-java-type":"List<PassengerChangeAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。","x-java-type":"String"},"passengerCount":{"type":"integer","description":"该类型人数，必填。","x-java-type":"Integer","format":"int32"},"fareDiff":{"type":"number","description":"单人票税差，必填。","x-java-type":"BigDecimal"},"changeFee":{"type":"number","description":"单人改签手续费，必填。","x-java-type":"BigDecimal"},"changeServiceFee":{"type":"number","description":"单人改签服务费，必填。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"单人其他费用，必填。","x-java-type":"BigDecimal"},"totalAmount":{"type":"number","description":"单人总费用，必填。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种，必填。","x-java-type":"String"}},"required":["passengerType","passengerCount","fareDiff","changeFee","changeServiceFee","otherFee","totalAmount","currency"]}},"refundPassengerAmountDetailList":{"type":"array","description":"按乘机人类型聚合的退票费用明细（单人口径）。","x-java-type":"List<PassengerRefundAmountDetailDTO>","items":{"type":"object","properties":{"passengerType":{"type":"string","description":"乘客类型：adult/child/infant，必填。","x-java-type":"String"},"passengerCount":{"type":"integer","description":"该类型人数，必填。","x-java-type":"Integer","format":"int32"},"ticketPrice":{"type":"number","description":"单人票价，必填。","x-java-type":"BigDecimal"},"taxFee":{"type":"number","description":"单人税费，必填。","x-java-type":"BigDecimal"},"fuelFee":{"type":"number","description":"单人燃油费，必填。","x-java-type":"BigDecimal"},"refundFee":{"type":"number","description":"单人退票手续费，必填。","x-java-type":"BigDecimal"},"refundServiceFee":{"type":"number","description":"单人退票服务费，必填。","x-java-type":"BigDecimal"},"otherFee":{"type":"number","description":"单人其他费用，必填。","x-java-type":"BigDecimal"},"refundableAmount":{"type":"number","description":"单人可退金额，必填。","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种，必填。","x-java-type":"String"}}}}},"required":["subOrderCode","passengerList","segmentList","passengerAmountDetailList"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/change/remaining/segments":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminChangeRemainingSegments","x-api-code":"bms.postOrderFlightAftersaleAdminChangeRemainingSegments","x-open-platform-sort":118,"summary":"查询剩余可改签航段交集","description":"**接口：** `POST /bms/order/flight/aftersale/admin/change/remaining/segments`\n\n查询所选乘机人剩余可改签航段的交集。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"主订单号。; 不可为空白字符串","x-java-type":"String"},"passengerIds":{"type":"array","description":"乘机人ID集合。; 不可为空集合或空值；数组元素：> 0","x-java-type":"List<Long>","items":{"type":"integer"}}},"required":["orderCode","passengerIds"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightChangeRemainingSegmentsResp","properties":{"orderCode":{"type":"string","description":"主订单号。","x-java-type":"String"},"passengerIds":{"type":"array","description":"请求乘机人ID集合。","x-java-type":"List<Long>","items":{"type":"integer"}},"commonJourneySegmentList":{"type":"array","description":"交集航程航段集合。","x-java-type":"List<FlightAftersaleJourneySegmentsVO>","items":{"type":"object","properties":{"journeyId":{"type":"string","description":"航程ID。","x-java-type":"String"},"segmentIds":{"type":"array","description":"航段ID集合。","x-java-type":"List<String>","items":{"type":"string"}},"segmentCount":{"type":"integer","description":"航段数量。","x-java-type":"Integer","format":"int32"},"journeyIndex":{"type":"integer","description":"航程序号。","x-java-type":"Integer","format":"int32"},"origin":{"type":"string","description":"出发地三字码。","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）。","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）。","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）。","x-java-type":"String"},"destination":{"type":"string","description":"到达地三字码。","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）。","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）。","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）。","x-java-type":"String"},"segments":{"type":"array","description":"航段明细集合。","x-java-type":"List<JourneySegmentItemVO>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID。","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段序号。","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号。","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号。","x-java-type":"String"},"carrierCode":{"type":"string","description":"航司二字码。","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）。","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）。","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）。","x-java-type":"String"},"origin":{"type":"string","description":"出发城市三字码。","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发城市名称（中文）。","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发城市名称（英文）。","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发城市名称（繁体）。","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码。","x-java-type":"String"},"originAirportNameZh":{"type":"string","description":"出发机场名称（中文）。","x-java-type":"String"},"originAirportNameEn":{"type":"string","description":"出发机场名称（英文）。","x-java-type":"String"},"originAirportNameTc":{"type":"string","description":"出发机场名称（繁体）。","x-java-type":"String"},"departureTime":{"type":"string","description":"出发时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"destination":{"type":"string","description":"到达城市三字码。","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达城市名称（中文）。","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达城市名称（英文）。","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达城市名称（繁体）。","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"到达机场三字码。","x-java-type":"String"},"destinationAirportNameZh":{"type":"string","description":"到达机场名称（中文）。","x-java-type":"String"},"destinationAirportNameEn":{"type":"string","description":"到达机场名称（英文）。","x-java-type":"String"},"destinationAirportNameTc":{"type":"string","description":"到达机场名称（繁体）。","x-java-type":"String"},"arrivalTime":{"type":"string","description":"到达时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"cabinClass":{"type":"string","description":"舱等。","x-java-type":"String"},"cabin":{"type":"string","description":"舱位。","x-java-type":"String"}},"required":["segmentId","segmentIndex","flightNumber","marketingFlightNumber","carrierCode","carrierNameZh","carrierNameEn","carrierNameTc","origin","originNameZh","originNameEn","originNameTc","originAirportCode","originAirportNameZh","originAirportNameEn","originAirportNameTc","departureTime","destination","destinationNameZh","destinationNameEn","destinationNameTc","destinationAirportCode","destinationAirportNameZh","destinationAirportNameEn","destinationAirportNameTc","arrivalTime","cabinClass","cabin"]}}},"required":["journeyId","segmentIds","segmentCount","journeyIndex","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","segments"]}}},"required":["orderCode","passengerIds","commonJourneySegmentList"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/aftersale/admin/refund/remaining/passenger-journeys":{"post":{"operationId":"bms.postOrderFlightAftersaleAdminRefundRemainingPassengerJourneys","x-api-code":"bms.postOrderFlightAftersaleAdminRefundRemainingPassengerJourneys","x-open-platform-sort":119,"summary":"查询剩余可退票乘机人与航程航段","description":"**接口：** `POST /bms/order/flight/aftersale/admin/refund/remaining/passenger-journeys`\n\n查询剩余可退票的乘机人及其航程、航段。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单号。; 不可为空白字符串","x-java-type":"String"}},"required":["orderCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightRefundRemainingJourneysResp","properties":{"orderCode":{"type":"string","description":"主订单号。","x-java-type":"String"},"passengerList":{"type":"array","description":"剩余可退票乘机人集合。","x-java-type":"List<FlightAftersaleRemainingPassengerVO>","items":{"type":"object","properties":{"passengerId":{"type":"integer","description":"乘机人ID。","x-java-type":"Long","format":"int64"},"passengerName":{"type":"string","description":"乘机人姓名。","x-java-type":"String"},"passengerCode":{"type":"string","description":"乘机人编码。","x-java-type":"String"},"passengerType":{"type":"string","description":"乘机人类型编码：adult 成人、child 儿童、infant 婴儿（与 `f_flight_passenger.passenger_type` 一致）。","x-java-type":"String"},"remainingJourneySegmentList":{"type":"array","description":"剩余可操作航程航段集合。","x-java-type":"List<FlightAftersaleJourneySegmentsVO>","items":{"type":"object","properties":{"journeyId":{"type":"string","description":"航程ID。","x-java-type":"String"},"segmentIds":{"type":"array","description":"航段ID集合。","x-java-type":"List<String>","items":{"type":"string"}},"segmentCount":{"type":"integer","description":"航段数量。","x-java-type":"Integer","format":"int32"},"journeyIndex":{"type":"integer","description":"航程序号。","x-java-type":"Integer","format":"int32"},"origin":{"type":"string","description":"出发地三字码。","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）。","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）。","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）。","x-java-type":"String"},"destination":{"type":"string","description":"到达地三字码。","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）。","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）。","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）。","x-java-type":"String"},"segments":{"type":"array","description":"航段明细集合。","x-java-type":"List<JourneySegmentItemVO>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID。","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段序号。","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号。","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号。","x-java-type":"String"},"carrierCode":{"type":"string","description":"航司二字码。","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）。","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）。","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）。","x-java-type":"String"},"origin":{"type":"string","description":"出发城市三字码。","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发城市名称（中文）。","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发城市名称（英文）。","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发城市名称（繁体）。","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码。","x-java-type":"String"},"originAirportNameZh":{"type":"string","description":"出发机场名称（中文）。","x-java-type":"String"},"originAirportNameEn":{"type":"string","description":"出发机场名称（英文）。","x-java-type":"String"},"originAirportNameTc":{"type":"string","description":"出发机场名称（繁体）。","x-java-type":"String"},"departureTime":{"type":"string","description":"出发时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"destination":{"type":"string","description":"到达城市三字码。","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达城市名称（中文）。","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达城市名称（英文）。","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达城市名称（繁体）。","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"到达机场三字码。","x-java-type":"String"},"destinationAirportNameZh":{"type":"string","description":"到达机场名称（中文）。","x-java-type":"String"},"destinationAirportNameEn":{"type":"string","description":"到达机场名称（英文）。","x-java-type":"String"},"destinationAirportNameTc":{"type":"string","description":"到达机场名称（繁体）。","x-java-type":"String"},"arrivalTime":{"type":"string","description":"到达时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"cabinClass":{"type":"string","description":"舱等。","x-java-type":"String"},"cabin":{"type":"string","description":"舱位。","x-java-type":"String"}},"required":["segmentId","segmentIndex","flightNumber","marketingFlightNumber","carrierCode","carrierNameZh","carrierNameEn","carrierNameTc","origin","originNameZh","originNameEn","originNameTc","originAirportCode","originAirportNameZh","originAirportNameEn","originAirportNameTc","departureTime","destination","destinationNameZh","destinationNameEn","destinationNameTc","destinationAirportCode","destinationAirportNameZh","destinationAirportNameEn","destinationAirportNameTc","arrivalTime","cabinClass","cabin"]}}},"required":["journeyId","segmentIds","segmentCount","journeyIndex","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","segments"]}}},"required":["passengerId","passengerName","passengerCode","passengerType","remainingJourneySegmentList"]}},"commonJourneySegmentList":{"type":"array","description":"剩余可退票公共航程航段（只返回一份）。","x-java-type":"List<FlightAftersaleJourneySegmentsVO>","items":{"type":"object","properties":{"journeyId":{"type":"string","description":"航程ID。","x-java-type":"String"},"segmentIds":{"type":"array","description":"航段ID集合。","x-java-type":"List<String>","items":{"type":"string"}},"segmentCount":{"type":"integer","description":"航段数量。","x-java-type":"Integer","format":"int32"},"journeyIndex":{"type":"integer","description":"航程序号。","x-java-type":"Integer","format":"int32"},"origin":{"type":"string","description":"出发地三字码。","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）。","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）。","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）。","x-java-type":"String"},"destination":{"type":"string","description":"到达地三字码。","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）。","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）。","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）。","x-java-type":"String"},"segments":{"type":"array","description":"航段明细集合。","x-java-type":"List<JourneySegmentItemVO>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID。","x-java-type":"String"},"segmentIndex":{"type":"integer","description":"航段序号。","x-java-type":"Integer","format":"int32"},"flightNumber":{"type":"string","description":"航班号。","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号。","x-java-type":"String"},"carrierCode":{"type":"string","description":"航司二字码。","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）。","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）。","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）。","x-java-type":"String"},"origin":{"type":"string","description":"出发城市三字码。","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发城市名称（中文）。","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发城市名称（英文）。","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发城市名称（繁体）。","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码。","x-java-type":"String"},"originAirportNameZh":{"type":"string","description":"出发机场名称（中文）。","x-java-type":"String"},"originAirportNameEn":{"type":"string","description":"出发机场名称（英文）。","x-java-type":"String"},"originAirportNameTc":{"type":"string","description":"出发机场名称（繁体）。","x-java-type":"String"},"departureTime":{"type":"string","description":"出发时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"destination":{"type":"string","description":"到达城市三字码。","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达城市名称（中文）。","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达城市名称（英文）。","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达城市名称（繁体）。","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"到达机场三字码。","x-java-type":"String"},"destinationAirportNameZh":{"type":"string","description":"到达机场名称（中文）。","x-java-type":"String"},"destinationAirportNameEn":{"type":"string","description":"到达机场名称（英文）。","x-java-type":"String"},"destinationAirportNameTc":{"type":"string","description":"到达机场名称（繁体）。","x-java-type":"String"},"arrivalTime":{"type":"string","description":"到达时间。; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"cabinClass":{"type":"string","description":"舱等。","x-java-type":"String"},"cabin":{"type":"string","description":"舱位。","x-java-type":"String"}},"required":["segmentId","segmentIndex","flightNumber","marketingFlightNumber","carrierCode","carrierNameZh","carrierNameEn","carrierNameTc","origin","originNameZh","originNameEn","originNameTc","originAirportCode","originAirportNameZh","originAirportNameEn","originAirportNameTc","departureTime","destination","destinationNameZh","destinationNameEn","destinationNameTc","destinationAirportCode","destinationAirportNameZh","destinationAirportNameEn","destinationAirportNameTc","arrivalTime","cabinClass","cabin"]}}},"required":["journeyId","segmentIds","segmentCount","journeyIndex","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","segments"]}},"contactName":{"type":"string","description":"订单联系人姓名。","x-java-type":"String"},"contactRegion":{"type":"string","description":"订单联系人区号。","x-java-type":"String"},"contactPhone":{"type":"string","description":"订单联系人电话。","x-java-type":"String"},"contactEmail":{"type":"string","description":"订单联系人邮箱。","x-java-type":"String"}},"required":["orderCode","passengerList","commonJourneySegmentList","contactName","contactRegion","contactPhone","contactEmail"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/scheduleChangeList":{"post":{"operationId":"bms.postOrderFlightScheduleChangeList","x-api-code":"bms.postOrderFlightScheduleChangeList","x-open-platform-sort":120,"summary":"航变列表查询","description":"**接口：** `POST /bms/order/flight/scheduleChangeList`\n\n分页查询机票航班变更记录。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Long","format":"int64","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数; 不可为 null；≥ 1；≤ 100；不传时默认值：`25`","x-java-type":"Long","format":"int64","default":25,"minimum":1,"maximum":100},"changeType":{"type":"integer","description":"航变类型；枚举取值：1-航班延误、2-航班取消、3-航班提前、4-航班变更、5-航班待定、6-恢复; ≥ 1；≤ 6；示例：`1`","x-java-type":"Integer","format":"int32","minimum":1,"maximum":6},"emailChangeStatus":{"type":"integer","description":"邮件处理状态；枚举取值：1-待处理、2-已处理、3-已忽略; ≥ 1；≤ 3；示例：`1`","x-java-type":"Integer","format":"int32","minimum":1,"maximum":3},"startDate":{"type":"string","description":"开始时间; 示例：`2026-01-01`","x-java-type":"String"},"endDate":{"type":"string","description":"结束时间; 示例：`2026-02-24`","x-java-type":"String"},"orderCode":{"type":"string","description":"订单号; 示例：`FO202602240001`","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码; 示例：`AG001`","x-java-type":"String"}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightScheduleChangeListResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<ScheduleChangeListResult>","items":{"type":"object","properties":{"id":{"type":"integer","description":"航变记录ID; 示例：`1`","x-java-type":"Long","format":"int64"},"orderCode":{"type":"string","description":"订单编码; 示例：`FO202602240001`","x-java-type":"String"},"changeType":{"type":"integer","description":"航变类型；枚举取值：1-航班延误、2-航班取消、3-航班提前、4-航班变更、5-航班待定、6-恢复; 示例：`1`","x-java-type":"Integer","format":"int32"},"emailChangeStatus":{"type":"integer","description":"邮件处理状态；枚举取值：1-待处理、2-已处理、3-已忽略; 示例：`1`","x-java-type":"Integer","format":"int32"},"scheduleChangeInfo":{"type":"object","description":"航变信息","x-java-type":"OrderScheduleChangeInfoVo","properties":{"changeType":{"type":"integer","description":"航变类型；枚举取值：1-航班延误、2-航班取消、3-航班提前、4-航班变更、5-航班待定、6-恢复; 示例：`1`","x-java-type":"Integer","format":"int32"},"segmentId":{"type":"string","description":"航程id; 示例：`SEG001`","x-java-type":"String"},"originalAirlineLogo":{"type":"string","description":"原航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"originalAirlineNameEn":{"type":"string","description":"原航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"originalAirlineNameZh":{"type":"string","description":"原航司名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"originalFlightNameTc":{"type":"string","description":"原航班名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"originalFlightNumber":{"type":"string","description":"原航班号; 示例：`CA1234`","x-java-type":"String"},"originalTakeOffTime":{"type":"string","description":"原起飞时间; 示例：`2025-01-15 08:00:00`","x-java-type":"String"},"originalArrivalTime":{"type":"string","description":"原到达时间; 示例：`2025-01-15 10:30:00`","x-java-type":"String"},"originalFromCityEn":{"type":"string","description":"原出发城市（英文）; 示例：`Beijing`","x-java-type":"String"},"originalFromCityZh":{"type":"string","description":"原出发城市（中文）; 示例：`北京`","x-java-type":"String"},"originalFromCityTc":{"type":"string","description":"原出发城市（繁体）; 示例：`北京`","x-java-type":"String"},"originalToCityEn":{"type":"string","description":"原到达城市（英文）; 示例：`Shanghai`","x-java-type":"String"},"originalToCityZh":{"type":"string","description":"原到达城市（中文）; 示例：`上海`","x-java-type":"String"},"originalToCityTc":{"type":"string","description":"原到达城市（繁体）; 示例：`上海`","x-java-type":"String"},"originalFromCityCode":{"type":"string","description":"原出发城市三字码; 示例：`PEK`","x-java-type":"String"},"originalToCityCode":{"type":"string","description":"原到达城市三字码; 示例：`SHA`","x-java-type":"String"},"originalDepartureAirportCode":{"type":"string","description":"原出发机场三字码; 示例：`PEK`","x-java-type":"String"},"originalArrivalAirportCode":{"type":"string","description":"原到达机场三字码; 示例：`SHA`","x-java-type":"String"},"originalTakeOffAirportEn":{"type":"string","description":"原起飞机场（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"originalTakeOffAirportZh":{"type":"string","description":"原起飞机场（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"originalTakeOffAirportTc":{"type":"string","description":"原起飞机场（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"originalTakeOffTerminal":{"type":"string","description":"原出发航站楼; 示例：`T3`","x-java-type":"String"},"originalArrivalTerminal":{"type":"string","description":"原到达航站楼; 示例：`T2`","x-java-type":"String"},"originalAircraftModel":{"type":"string","description":"原机型; 示例：`B738`","x-java-type":"String"},"originalFlightTime":{"type":"string","description":"原飞行时间; 示例：`150`","x-java-type":"String"},"originalCabinClass":{"type":"string","description":"原舱等; 示例：`Y`","x-java-type":"String"},"originalArrivalAirportEn":{"type":"string","description":"原到达机场（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"originalArrivalAirportZh":{"type":"string","description":"原到达机场（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"originalArrivalAirportTc":{"type":"string","description":"原到达机场（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"newAirlineLogo":{"type":"string","description":"新航司logo; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"},"newAirlineNameEn":{"type":"string","description":"新航司名称（英文）; 示例：`Air China`","x-java-type":"String"},"newFlightNameZh":{"type":"string","description":"新航班名称（中文）; 示例：`中国国际航空`","x-java-type":"String"},"newFlightNameTc":{"type":"string","description":"新航班名称（繁体）; 示例：`中國國際航空`","x-java-type":"String"},"newFlightNumber":{"type":"string","description":"新航班号; 示例：`CA5678`","x-java-type":"String"},"newTakeOffTime":{"type":"string","description":"新起飞时间; 示例：`2025-01-15 10:00:00`","x-java-type":"String"},"newArrivalTime":{"type":"string","description":"新到达时间; 示例：`2025-01-15 12:30:00`","x-java-type":"String"},"newFromCityEn":{"type":"string","description":"新出发城市（英文）; 示例：`Beijing`","x-java-type":"String"},"newFromCityZh":{"type":"string","description":"新出发城市（中文）; 示例：`北京`","x-java-type":"String"},"newFromCityTc":{"type":"string","description":"新出发城市（繁体）; 示例：`北京`","x-java-type":"String"},"newToCityEn":{"type":"string","description":"新到达城市（英文）; 示例：`Shanghai`","x-java-type":"String"},"newToCityZh":{"type":"string","description":"新到达城市（中文）; 示例：`上海`","x-java-type":"String"},"newToCityTc":{"type":"string","description":"新到达城市（繁体）; 示例：`上海`","x-java-type":"String"},"newFromCityCode":{"type":"string","description":"新出发城市三字码; 示例：`PEK`","x-java-type":"String"},"newDepartureAirportCode":{"type":"string","description":"新出发机场三字码; 示例：`PEK`","x-java-type":"String"},"newToCityCode":{"type":"string","description":"新到达城市三字码; 示例：`SHA`","x-java-type":"String"},"newArrivalAirportCode":{"type":"string","description":"新到达机场三字码; 示例：`SHA`","x-java-type":"String"},"newTakeOffAirportEn":{"type":"string","description":"新起飞机场（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"newTakeOffAirportZh":{"type":"string","description":"新起飞机场（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"newTakeOffAirportTc":{"type":"string","description":"新起飞机场（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"newArrivalAirportEn":{"type":"string","description":"新到达机场（英文）; 示例：`Shanghai Hongqiao International Airport`","x-java-type":"String"},"newArrivalAirportZh":{"type":"string","description":"新到达机场（中文）; 示例：`上海虹桥国际机场`","x-java-type":"String"},"newArrivalAirportTc":{"type":"string","description":"新到达机场（繁体）; 示例：`上海虹橋國際機場`","x-java-type":"String"},"newTakeOffTerminal":{"type":"string","description":"新出发航站楼; 示例：`T3`","x-java-type":"String"},"newArrivalTerminal":{"type":"string","description":"新到达航站楼; 示例：`T2`","x-java-type":"String"},"newAircraftModel":{"type":"string","description":"新机型; 示例：`B738`","x-java-type":"String"},"newFlightTime":{"type":"string","description":"新飞行时间; 示例：`150`","x-java-type":"String"},"newCabinClass":{"type":"string","description":"新舱等; 示例：`Y`","x-java-type":"String"},"changeDescriptionEn":{"type":"string","description":"航变原因（英文）; 示例：`Flight delayed due to weather`","x-java-type":"String"},"changeDescriptionZh":{"type":"string","description":"航变原因（中文）; 示例：`因天气原因航班延误`","x-java-type":"String"},"changeDescriptionTc":{"type":"string","description":"航变原因（繁体）; 示例：`因天氣原因航班延誤`","x-java-type":"String"},"createTime":{"type":"string","description":"创建时间; 示例：`2025-01-01 12:00:00`","x-java-type":"String"}}},"emailProcessedBy":{"type":"string","description":"邮件处理人; 示例：`admin`","x-java-type":"String"},"emailProcessedTime":{"type":"string","description":"邮件处理时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"emailProcessRemark":{"type":"string","description":"邮件处理备注; 示例：`已联系客户确认`","x-java-type":"String"},"createdDt":{"type":"string","description":"航变创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"emailSendCount":{"type":"integer","description":"邮件发送次数; 示例：`1`","x-java-type":"Integer","format":"int32"},"lastEmailSendTime":{"type":"string","description":"最后发送时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"}}}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/scheduleChangeProcess":{"post":{"operationId":"bms.postOrderFlightScheduleChangeProcess","x-api-code":"bms.postOrderFlightScheduleChangeProcess","x-open-platform-sort":121,"summary":"处理航变","description":"**接口：** `POST /bms/order/flight/scheduleChangeProcess`\n\n处理航变事项并更新处理结果。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","description":"航变记录ID; 不可为 null；> 0；示例：`1`","x-java-type":"Long","format":"int64"},"changeStatus":{"type":"integer","description":"处理结果；枚举取值：2-已处理、3-已忽略; 不可为 null；≥ 2；≤ 3；示例：`2`","x-java-type":"Integer","format":"int32","minimum":2,"maximum":3},"processRemark":{"type":"string","description":"处理备注; 示例：`已联系客户确认`","x-java-type":"String"}},"required":["id","changeStatus"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightScheduleChangeProcessResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/airports/search":{"get":{"operationId":"bms.getOrderFlightAirportsSearch","x-api-code":"bms.getOrderFlightAirportsSearch","x-open-platform-sort":122,"summary":"查询机场信息","description":"**接口：** `GET /bms/order/flight/airports/search`\n\n按关键词和语言查询机场选项，辅助机票录单。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"header","name":"language","required":false,"schema":{"type":"string","description":"语言代码","x-java-type":"String"}},{"in":"query","name":"keyword","required":true,"schema":{"type":"string","description":"关键字搜索（地址名称/详细地址/城市/省份/国家）; 不可为 null","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"array","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightAirportSearchResp","items":{"type":"object","properties":{"id":{"type":"integer","description":"机场ID; 示例：`1`","x-java-type":"Integer","format":"int32"},"airportCode":{"type":"string","description":"机场三字码; 示例：`PEK`","x-java-type":"String"},"airportNameEn":{"type":"string","description":"机场名称（英文）; 示例：`Beijing Capital International Airport`","x-java-type":"String"},"airportNameZh":{"type":"string","description":"机场名称（中文）; 示例：`北京首都国际机场`","x-java-type":"String"},"airportNameTc":{"type":"string","description":"机场名称（繁体）; 示例：`北京首都國際機場`","x-java-type":"String"},"cityCode":{"type":"string","description":"城市三字码; 示例：`BJS`","x-java-type":"String"},"cityNameEn":{"type":"string","description":"城市名称（英文）; 示例：`Beijing`","x-java-type":"String"},"cityNameZh":{"type":"string","description":"城市名称（中文）; 示例：`北京`","x-java-type":"String"},"cityNameTc":{"type":"string","description":"城市名称（繁体）; 示例：`北京`","x-java-type":"String"},"countryCode":{"type":"string","description":"国家二字码; 示例：`CN`","x-java-type":"String"},"countryNameEn":{"type":"string","description":"国家名称（英文）; 示例：`China`","x-java-type":"String"},"countryNameZh":{"type":"string","description":"国家名称（中文）; 示例：`中国`","x-java-type":"String"},"countryNameTc":{"type":"string","description":"国家名称（繁体）; 示例：`中國`","x-java-type":"String"},"isInternational":{"type":"integer","description":"是否国际机场：0国内，1国际; 示例：`1`","x-java-type":"Integer","format":"int32"},"isActive":{"type":"integer","description":"是否启用：0禁用，1启用; 示例：`1`","x-java-type":"Integer","format":"int32"}},"required":["id","airportCode","airportNameEn","airportNameZh","airportNameTc","cityCode","cityNameEn","cityNameZh","cityNameTc","countryCode","countryNameEn","countryNameZh","countryNameTc","isInternational","isActive"]},"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/flight/airlines/search":{"get":{"operationId":"bms.getOrderFlightAirlinesSearch","x-api-code":"bms.getOrderFlightAirlinesSearch","x-open-platform-sort":123,"summary":"查询航司信息","description":"**接口：** `GET /bms/order/flight/airlines/search`\n\n按关键词和语言分页查询航司选项。","tags":["机票订单"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"header","name":"language","required":false,"schema":{"type":"string","description":"语言代码","x-java-type":"String"}},{"in":"query","name":"keyword","required":true,"schema":{"type":"string","description":"关键字; 不可为 null","x-java-type":"String"}},{"in":"query","name":"currentPage","required":true,"schema":{"type":"integer","description":"当前页码; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1}},{"in":"query","name":"pageSize","required":true,"schema":{"type":"integer","description":"每页条数; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"FlightAirlineSearchResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<AirlineInfoDTO>","items":{"type":"object","properties":{"id":{"type":"integer","description":"航司ID; 示例：`1`","x-java-type":"Integer","format":"int32"},"airlineCode":{"type":"string","description":"航司二字码; 示例：`CA`","x-java-type":"String"},"airlineName":{"type":"string","description":"航司名称; 示例：`中国国际航空`","x-java-type":"String"},"logo":{"type":"string","description":"航司LOGO; 示例：`https://example.com/logo/ca.png`","x-java-type":"String"}},"required":["id","airlineCode","logo"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/report/flight/reportPage":{"post":{"operationId":"bms.postReportFlightReportPage","x-api-code":"bms.postReportFlightReportPage","x-open-platform-sort":124,"summary":"机票销售统计表分页","description":"**接口：** `POST /bms/report/flight/reportPage`\n\n按筛选条件分页查询机票销售统计，部门或人员数据范围由下游服务处理。","tags":["机票报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"tradingType":{"type":"integer","description":"交易类型：0-原单，1-改签单，2-退票单; ≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"payType":{"type":"integer","description":"支付方式：0-信用卡，1-挂账; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"startCreatedDt":{"type":"string","description":"创建开始时间","x-java-type":"String"},"endCreatedDt":{"type":"string","description":"创建结束时间","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"},"language":{"type":"string","description":"语言","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsFlightSalesReportPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FlightReportResult>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"originalCode":{"type":"string","description":"原订单编码","x-java-type":"String"},"orderStatus":{"type":"integer","description":"订单状态：1提交中，2待支付，3待出票，4已出票，5部分出票，6已取消，7部分退票，8部分改签，9全部退票，10全部改签","x-java-type":"Integer","format":"int32"},"payType":{"type":"integer","description":"支付类型：0信用卡，1额度","x-java-type":"Integer","format":"int32"},"tradingType":{"type":"integer","description":"交易类型：0-出票单，1-改签单，2-退票单，3-取消单","x-java-type":"Integer","format":"int32"},"payStatus":{"type":"integer","description":"支付状态：1-支付成功，2-支付失败，3退款成功，4.退款失败","x-java-type":"Integer","format":"int32"},"totalAmount":{"type":"number","description":"订单总金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"passengerNames":{"type":"string","description":"乘客姓名","x-java-type":"String"},"employeeId":{"type":"string","description":"乘机人员工ID","x-java-type":"String"},"operationName":{"type":"string","description":"运营人员姓名","x-java-type":"String"},"businessName":{"type":"string","description":"商务人员姓名","x-java-type":"String"},"tripType":{"type":"integer","description":"行程类型：1单程，2往返，3多程","x-java-type":"Integer","format":"int32"},"flightDetail":{"type":"array","description":"航班信息","x-java-type":"List<FlightDetailVo>","items":{"type":"object","properties":{"departureTime":{"type":"string","description":"始发时间","x-java-type":"String"},"arrivalTime":{"type":"string","description":"抵达时间","x-java-type":"String"},"origin":{"type":"string","description":"出发地","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）","x-java-type":"String"},"destination":{"type":"string","description":"到达地","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等","x-java-type":"String"},"segments":{"type":"array","description":"航段列表","x-java-type":"List<SegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）","x-java-type":"String"},"cabin":{"type":"string","description":"舱等","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo","x-java-type":"String"},"aircraft":{"type":"string","description":"机型","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间","x-java-type":"String"},"destinationTime":{"type":"string","description":"到达时间","x-java-type":"String"},"meal":{"type":"string","description":"餐食信息","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是","x-java-type":"Integer","format":"int32"}},"required":["segmentId","flightNumber","marketingFlightNumber","cabin","carrierNameZh","carrierNameEn","carrierNameTc","carrierLogo","aircraft","origin","originNameZh","originNameEn","originNameTc","departureAirportNameEn","departureAirportNameTc","departureAirportNameZh","originAirportCode","originTerminal","destination","destinationNameZh","destinationNameEn","destinationNameTc","arrivalAirportNameEn","arrivalAirportNameTc","arrivalAirportNameZh","destinationAirportCode","destinationTerminal","isShare","operatingFliCode","operatingFlightNumber","codeshareFlightInfoZh","codeshareFlightInfoTc","codeshareFlightInfoEn","originTime","destinationTime","flightDuration","stopoverList","isChanged"]}},"flightNumbers":{"type":"string","description":"航班号（,拼接）","x-java-type":"String"},"marketingFlightNumbers":{"type":"string","description":"营销航班号（,拼接，未格式化原始值）","x-java-type":"String"},"scheduleChangeCount":{"type":"integer","description":"航变条数","x-java-type":"Integer","format":"int32"},"journeyId":{"type":"string","description":"行程段id","x-java-type":"String"},"journeyIndex":{"type":"integer","description":"行程段序号","x-java-type":"Integer","format":"int32"},"journeysTime":{"type":"string","description":"行程耗时","x-java-type":"String"}},"required":["departureTime","arrivalTime","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","cabinClass","segments","flightNumbers","marketingFlightNumbers","scheduleChangeCount","journeyId","journeyIndex","journeysTime"]}},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私","x-java-type":"Integer","format":"int32"}},"required":["orderCode","agentName","orderStatus","payType","tradingType","payStatus","totalAmount","currency","createdBy","createdDt","passengerNames","operationName","businessName","tripType","flightDetail","travelType"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/report/flight/reportExport":{"post":{"operationId":"bms.postReportFlightReportExport","x-api-code":"bms.postReportFlightReportExport","x-open-platform-sort":125,"summary":"机票销售统计表导出","description":"**接口：** `POST /bms/report/flight/reportExport`\n\n按筛选条件导出机票销售统计，部门或人员数据范围由下游服务处理。","tags":["机票报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"tradingType":{"type":"integer","description":"交易类型：0-原单，1-改签单，2-退票单; ≥ 0；≤ 2","x-java-type":"Integer","format":"int32","minimum":0,"maximum":2},"payType":{"type":"integer","description":"支付方式：0-信用卡，1-挂账; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"startCreatedDt":{"type":"string","description":"创建开始时间","x-java-type":"String"},"endCreatedDt":{"type":"string","description":"创建结束时间","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"},"language":{"type":"string","description":"语言","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}}}}}},"responses":{"200":{"description":"文件字节；业务失败时可能返回 JSON","headers":{"Content-Disposition":{"schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}},"/openapi/v1/bms/report/flight/transactionPage":{"post":{"operationId":"bms.postReportFlightTransactionPage","x-api-code":"bms.postReportFlightTransactionPage","x-open-platform-sort":126,"summary":"机票订单交易分页","description":"**接口：** `POST /bms/report/flight/transactionPage`\n\n按筛选条件分页查询机票订单交易记录，部门或人员数据范围由下游服务处理。","tags":["机票报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currentPage":{"type":"integer","description":"当前页码，从 1 开始；不传默认 1; 不可为 null；≥ 1；不传时默认值：`1`","x-java-type":"Integer","format":"int32","default":1,"minimum":1},"pageSize":{"type":"integer","description":"每页条数，范围 1-100；不传默认 10; 不可为 null；≥ 1；≤ 100；不传时默认值：`10`","x-java-type":"Integer","format":"int32","default":10,"minimum":1,"maximum":100},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"startTradingTime":{"type":"string","description":"交易开始时间","x-java-type":"String"},"endTradingTime":{"type":"string","description":"交易结束时间","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"},"language":{"type":"string","description":"语言","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}},"required":["currentPage","pageSize"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsFlightTransactionPageResp","properties":{"list":{"type":"array","description":"当前页数据列表","x-java-type":"List<FlightTransactionResult>","items":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"originalCode":{"type":"string","description":"原订单编码","x-java-type":"String"},"agentName":{"type":"string","description":"客户名称","x-java-type":"String"},"payType":{"type":"integer","description":"支付类型：0信用卡，1额度","x-java-type":"Integer","format":"int32"},"tradingType":{"type":"integer","description":"交易订单类别：0-原单，1-改签单，2-退票单","x-java-type":"Integer","format":"int32"},"flightOrderType":{"type":"integer","description":"关联订单类型（内部转换用，不对外展示）；枚举取值：0-正单、1-改签单、3-退票单","x-java-type":"Integer","format":"int32"},"payStatus":{"type":"integer","description":"支付状态：1-支付成功，2-支付失败，3退款成功，4.退款失败","x-java-type":"Integer","format":"int32"},"tradingAmount":{"type":"number","description":"交易金额","x-java-type":"BigDecimal"},"currency":{"type":"string","description":"币种","x-java-type":"String"},"cardType":{"type":"string","description":"卡类型","x-java-type":"String"},"cardLastFourDigit":{"type":"string","description":"卡号后四位","x-java-type":"String"},"cardBodyType":{"type":"integer","description":"卡主体类型：0-公司，1-个人","x-java-type":"Integer","format":"int32"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"createdDt":{"type":"string","description":"创建时间; 日期时间格式遵循服务端序列化配置","x-java-type":"LocalDateTime"},"passengerNames":{"type":"string","description":"乘客姓名","x-java-type":"String"},"operationName":{"type":"string","description":"运营人员姓名","x-java-type":"String"},"businessName":{"type":"string","description":"商务人员姓名","x-java-type":"String"},"tripType":{"type":"integer","description":"行程类型：1单程，2往返，3多程","x-java-type":"Integer","format":"int32"},"flightDetail":{"type":"array","description":"航班信息","x-java-type":"List<FlightDetailVo>","items":{"type":"object","properties":{"departureTime":{"type":"string","description":"始发时间","x-java-type":"String"},"arrivalTime":{"type":"string","description":"抵达时间","x-java-type":"String"},"origin":{"type":"string","description":"出发地","x-java-type":"String"},"originNameZh":{"type":"string","description":"出发地名称（中文）","x-java-type":"String"},"originNameEn":{"type":"string","description":"出发地名称（英文）","x-java-type":"String"},"originNameTc":{"type":"string","description":"出发地名称（繁体）","x-java-type":"String"},"destination":{"type":"string","description":"到达地","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"到达地名称（中文）","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"到达地名称（英文）","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"到达地名称（繁体）","x-java-type":"String"},"cabinClass":{"type":"string","description":"舱等","x-java-type":"String"},"segments":{"type":"array","description":"航段列表","x-java-type":"List<SegmentVo>","items":{"type":"object","properties":{"segmentId":{"type":"string","description":"航段ID","x-java-type":"String"},"flightNumber":{"type":"string","description":"航班号","x-java-type":"String"},"marketingFlightNumber":{"type":"string","description":"营销航班号（未格式化原始值）","x-java-type":"String"},"cabin":{"type":"string","description":"舱等","x-java-type":"String"},"pnr":{"type":"string","description":"旅客订座记录（PNR）","x-java-type":"String"},"carrierNameZh":{"type":"string","description":"航司名称（中文）","x-java-type":"String"},"carrierNameEn":{"type":"string","description":"航司名称（英文）","x-java-type":"String"},"carrierNameTc":{"type":"string","description":"航司名称（繁体）","x-java-type":"String"},"carrierLogo":{"type":"string","description":"航司logo","x-java-type":"String"},"aircraft":{"type":"string","description":"机型","x-java-type":"String"},"origin":{"type":"string","description":"始发城市三字码","x-java-type":"String"},"originNameZh":{"type":"string","description":"始发城市名称（中文）","x-java-type":"String"},"originNameEn":{"type":"string","description":"始发城市名称（英文）","x-java-type":"String"},"originNameTc":{"type":"string","description":"始发城市名称（繁体）","x-java-type":"String"},"departureAirportNameEn":{"type":"string","description":"出发机场名称（英文）","x-java-type":"String"},"departureAirportNameTc":{"type":"string","description":"出发机场名称（繁体）","x-java-type":"String"},"departureAirportNameZh":{"type":"string","description":"出发机场名称（中文）","x-java-type":"String"},"originAirportCode":{"type":"string","description":"出发机场三字码","x-java-type":"String"},"originTerminal":{"type":"string","description":"始发航站楼","x-java-type":"String"},"destination":{"type":"string","description":"目的地城市三字码","x-java-type":"String"},"destinationNameZh":{"type":"string","description":"目的地城市名称（中文）","x-java-type":"String"},"destinationNameEn":{"type":"string","description":"目的地城市名称（英文）","x-java-type":"String"},"destinationNameTc":{"type":"string","description":"目的地城市名称（繁体）","x-java-type":"String"},"arrivalAirportNameEn":{"type":"string","description":"到达机场名称（英文）","x-java-type":"String"},"arrivalAirportNameTc":{"type":"string","description":"到达机场名称（繁体）","x-java-type":"String"},"arrivalAirportNameZh":{"type":"string","description":"到达机场名称（中文）","x-java-type":"String"},"destinationAirportCode":{"type":"string","description":"目的地机场三字码","x-java-type":"String"},"destinationTerminal":{"type":"string","description":"目的地航站楼","x-java-type":"String"},"isShare":{"type":"boolean","description":"是否共享航班","x-java-type":"Boolean"},"operatingFliCode":{"type":"string","description":"承运航司二字码","x-java-type":"String"},"operatingAirlineNameZh":{"type":"string","description":"承运航司名称（中文）","x-java-type":"String"},"operatingAirlineNameTc":{"type":"string","description":"承运航司名称（繁体）","x-java-type":"String"},"operatingAirlineNameEn":{"type":"string","description":"承运航司名称（英文）","x-java-type":"String"},"operatingFlightNumber":{"type":"string","description":"承运航班号","x-java-type":"String"},"codeshareFlightInfoZh":{"type":"string","description":"联营航班信息（中文）","x-java-type":"String"},"codeshareFlightInfoTc":{"type":"string","description":"联营航班信息（繁体）","x-java-type":"String"},"codeshareFlightInfoEn":{"type":"string","description":"联营航班信息（英文）","x-java-type":"String"},"originTime":{"type":"string","description":"始发时间","x-java-type":"String"},"destinationTime":{"type":"string","description":"到达时间","x-java-type":"String"},"meal":{"type":"string","description":"餐食信息","x-java-type":"String"},"wifi":{"type":"string","description":"wifi信息","x-java-type":"String"},"tips":{"type":"object","description":"行程提示信息列表","x-java-type":"Map<String, String>","properties":{}},"luggageType":{"type":"string","description":"行李直挂类型","x-java-type":"String"},"luggageExtEn":{"type":"string","description":"行李直挂说明（英文）","x-java-type":"String"},"luggageExtTc":{"type":"string","description":"行李直挂说明（繁体）","x-java-type":"String"},"luggageExtZh":{"type":"string","description":"行李直挂说明（中文）","x-java-type":"String"},"travelTextEn":{"type":"string","description":"出入境提示信息（英文）","x-java-type":"String"},"travelTextTc":{"type":"string","description":"出入境提示信息（繁体）","x-java-type":"String"},"travelTextZh":{"type":"string","description":"出入境提示信息（中文）","x-java-type":"String"},"flightDuration":{"type":"string","description":"飞行时长","x-java-type":"String"},"stopoverList":{"type":"array","description":"经停信息","x-java-type":"List<StopoverVo>","items":{"type":"object","properties":{"layoverCity":{"type":"string","description":"经停城市三字码","x-java-type":"String"},"layoverCityNameZh":{"type":"string","description":"经停城市名称（中文）","x-java-type":"String"},"layoverCityNameEn":{"type":"string","description":"经停城市名称（英文）","x-java-type":"String"},"layoverCityNameTc":{"type":"string","description":"经停城市名称（繁体）","x-java-type":"String"},"layoverAirportCode":{"type":"string","description":"经停机场三字码","x-java-type":"String"},"layoverAirportNameZh":{"type":"string","description":"经停机场名称（中文）","x-java-type":"String"},"layoverAirportNameEn":{"type":"string","description":"经停机场名称（英文）","x-java-type":"String"},"layoverAirportNameTc":{"type":"string","description":"经停机场名称（繁体）","x-java-type":"String"},"layoverDuration":{"type":"string","description":"经停时长","x-java-type":"String"},"layoverArrivalTime":{"type":"string","description":"经停开始时间","x-java-type":"String"},"layoverDepartureTime":{"type":"string","description":"经停离开时间","x-java-type":"String"}}}},"isChanged":{"type":"integer","description":"是否已改签：0否 1是","x-java-type":"Integer","format":"int32"},"selectable":{"type":"integer","description":"是否可选：0否 1是","x-java-type":"Integer","format":"int32"}},"required":["segmentId","flightNumber","marketingFlightNumber","cabin","carrierNameZh","carrierNameEn","carrierNameTc","carrierLogo","aircraft","origin","originNameZh","originNameEn","originNameTc","departureAirportNameEn","departureAirportNameTc","departureAirportNameZh","originAirportCode","originTerminal","destination","destinationNameZh","destinationNameEn","destinationNameTc","arrivalAirportNameEn","arrivalAirportNameTc","arrivalAirportNameZh","destinationAirportCode","destinationTerminal","isShare","operatingFliCode","operatingFlightNumber","codeshareFlightInfoZh","codeshareFlightInfoTc","codeshareFlightInfoEn","originTime","destinationTime","flightDuration","stopoverList","isChanged"]}},"flightNumbers":{"type":"string","description":"航班号（,拼接）","x-java-type":"String"},"marketingFlightNumbers":{"type":"string","description":"营销航班号（,拼接，未格式化原始值）","x-java-type":"String"},"scheduleChangeCount":{"type":"integer","description":"航变条数","x-java-type":"Integer","format":"int32"},"journeyId":{"type":"string","description":"行程段id","x-java-type":"String"},"journeyIndex":{"type":"integer","description":"行程段序号","x-java-type":"Integer","format":"int32"},"journeysTime":{"type":"string","description":"行程耗时","x-java-type":"String"}},"required":["departureTime","arrivalTime","origin","originNameZh","originNameEn","originNameTc","destination","destinationNameZh","destinationNameEn","destinationNameTc","cabinClass","segments","flightNumbers","marketingFlightNumbers","scheduleChangeCount","journeyId","journeyIndex","journeysTime"]}},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私","x-java-type":"Integer","format":"int32"},"failReason":{"type":"string","description":"失败原因","x-java-type":"String"}},"required":["orderCode","agentName","payType","tradingType","flightOrderType","payStatus","tradingAmount","currency","createdBy","createdDt","passengerNames","operationName","businessName","tripType","flightDetail","travelType"]}},"totalCount":{"type":"integer","description":"总记录数","x-java-type":"Long","format":"int64"},"pageSize":{"type":"integer","description":"每页记录数","x-java-type":"Long","format":"int64"},"totalPage":{"type":"integer","description":"总页数","x-java-type":"Long","format":"int64"},"currentPage":{"type":"integer","description":"当前页码","x-java-type":"Long","format":"int64"}},"required":["list","totalCount","pageSize","totalPage","currentPage"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/report/flight/transactionExport":{"post":{"operationId":"bms.postReportFlightTransactionExport","x-api-code":"bms.postReportFlightTransactionExport","x-open-platform-sort":127,"summary":"机票订单交易导出","description":"**接口：** `POST /bms/report/flight/transactionExport`\n\n按筛选条件导出机票订单交易记录，部门或人员数据范围由下游服务处理。","tags":["机票报表"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"startTradingTime":{"type":"string","description":"交易开始时间","x-java-type":"String"},"endTradingTime":{"type":"string","description":"交易结束时间","x-java-type":"String"},"agentCode":{"type":"string","description":"客户编码","x-java-type":"String"},"operationId":{"type":"integer","description":"运营用户id; > 0","x-java-type":"Integer","format":"int32"},"businessId":{"type":"integer","description":"商务用户id; > 0","x-java-type":"Integer","format":"int32"},"language":{"type":"string","description":"语言","x-java-type":"String"},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"travelType":{"type":"integer","description":"出行类型：0-因公，1-因私; ≥ 0；≤ 1","x-java-type":"Integer","format":"int32","minimum":0,"maximum":1}}}}}},"responses":{"200":{"description":"文件字节；业务失败时可能返回 JSON","headers":{"Content-Disposition":{"schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}},"/openapi/v1/bms/common/coin":{"get":{"operationId":"bms.getCommonCoin","x-api-code":"bms.getCommonCoin","x-open-platform-sort":128,"summary":"获取币种列表","description":"**接口：** `GET /bms/common/coin`\n\n按可选名称查询币种列表，供金额及客户配置选项使用。","tags":["公共"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"coinName","required":false,"schema":{"type":"string","description":"结算币种名称","x-java-type":"String"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsCurrencyListResp","properties":{"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<CoinResp>","items":{"type":"object","properties":{"coinId":{"type":"integer","description":"前端选择的展示币种 ID；币种编码为空时使用","x-java-type":"Integer","format":"int32"},"coinName":{"type":"string","description":"结算币种名称","x-java-type":"String"}},"required":["coinId","coinName"]}}},"required":["items"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/common/regionList":{"get":{"operationId":"bms.getCommonRegionList","x-api-code":"bms.getCommonRegionList","x-open-platform-sort":129,"summary":"获取手机区号列表","description":"**接口：** `GET /bms/common/regionList`\n\n按语言查询手机区号列表，供联系信息表单使用。","tags":["公共"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"language","required":false,"schema":{"type":"string","description":"语言：zh-CN-简体中文，en-US-英文，zh-TW-繁体中文；不传默认 en-US; 正则：`^(zh-CN&#124;en-US&#124;zh-TW)$`；不传时默认值：`\"en-US\"`","x-java-type":"String","default":"en-US","pattern":"^(zh-CN|en-US|zh-TW)$"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsPhoneRegionListResp","properties":{"items":{"type":"array","description":"手机区号信息列表","x-java-type":"List<RegionRespVO>","items":{"type":"object","properties":{"countryCode":{"type":"string","description":"国家编码","x-java-type":"String"},"countryName":{"type":"string","description":"国家名称","x-java-type":"String"},"keyword":{"type":"string","description":"编码名称组合","x-java-type":"String"}},"required":["countryCode","countryName","keyword"]}}},"required":["items"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/common/s3/uploads":{"post":{"operationId":"bms.postCommonS3Uploads","x-api-code":"bms.postCommonS3Uploads","x-open-platform-sort":130,"summary":"批量上传文件","description":"**接口：** `POST /bms/common/s3/uploads`\n\n上传单个或多个文件，依据 uploadType 使用对应的大小限制。\nfile 为重复字段，可上传多个文件；uploadType 为每个文件大小上限（MB，1–10）。Open 签名覆盖原始 multipart 请求体；下游 multipart 签名按协议使用空 body。","tags":["公共"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"array","description":"上传文件，同一字段 file 可传多个文件; 不可为空集合或空值","x-java-type":"MultipartFile[]","items":{"type":"string","format":"binary"}},"uploadType":{"type":"integer","description":"每个文件的大小上限（MB）；取值 1-10，如传 2 表示每个文件最大 2MB; 不可为 null；≥ 1；≤ 10","x-java-type":"Integer","format":"int32","minimum":1,"maximum":10}},"required":["file","uploadType"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsFileBatchUploadResp","properties":{"items":{"type":"array","description":"乘客类型费用列表","x-java-type":"List<String>","items":{"type":"string"}}},"required":["items"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/common/s3/download":{"get":{"operationId":"bms.getCommonS3Download","x-api-code":"bms.getCommonS3Download","x-open-platform-sort":131,"summary":"下载文件","description":"**接口：** `GET /bms/common/s3/download`\n\n按文件地址下载文件。","tags":["公共"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"imgUrl","required":true,"schema":{"type":"string","description":"已上传文件的完整访问地址; 不可为空白字符串","x-java-type":"String"}}],"responses":{"200":{"description":"文件字节；业务失败时可能返回 JSON","headers":{"Content-Disposition":{"schema":{"type":"string"}}},"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}}},"/openapi/v1/bms/common/s3/delete":{"delete":{"operationId":"bms.deleteCommonS3Delete","x-api-code":"bms.deleteCommonS3Delete","x-open-platform-sort":132,"summary":"删除文件","description":"**接口：** `DELETE /bms/common/s3/delete`\n\n按文件地址删除文件；仅删除客户 Logo 时传入客户 ID。","tags":["公共"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}},{"in":"query","name":"imgUrl","required":true,"schema":{"type":"string","description":"已上传文件的完整访问地址; 不可为空白字符串","x-java-type":"String"}},{"in":"query","name":"id","required":false,"schema":{"type":"integer","description":"客户 ID；仅删除客户 Logo 时传入，其他文件删除不传; > 0","x-java-type":"Integer","format":"int32"}}],"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsFileDeleteResp","properties":{"value":{"type":"boolean","description":"接口返回值","x-java-type":"Boolean"}},"required":["value"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/order/platform/travelApprovalOrder/bmsApprovalDetail":{"post":{"operationId":"bms.postOrderPlatformTravelApprovalOrderBmsApprovalDetail","x-api-code":"bms.postOrderPlatformTravelApprovalOrderBmsApprovalDetail","x-open-platform-sort":133,"summary":"BMS 审批详情（订单数据权限在审批服务内校验）","description":"**接口：** `POST /bms/order/platform/travelApprovalOrder/bmsApprovalDetail`\n\n读取订单关联的 BMS 审批详情；订单数据权限由审批服务校验。","tags":["平台订单与审批"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}},{"in":"header","name":"token","required":true,"description":"由本环境 BMS Token 接口返回的 Token","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"approvalNo":{"type":"string","description":"审批单号; 不可为空白字符串","x-java-type":"String"},"orderCode":{"type":"string","description":"订单号，须与审批单关联订单号一致; 不可为空白字符串","x-java-type":"String"}},"required":["approvalNo","orderCode"]}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码；字符串 \"0\" 表示成功，其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息；成功时为 \"success\"","x-java-type":"String"},"data":{"type":"object","description":"业务数据；以下子字段在 data 对象存在时适用","x-java-type":"BmsPlatformApprovalDetailResp","properties":{"id":{"type":"integer","description":"主键ID","x-java-type":"Integer","format":"int32"},"approvalNo":{"type":"string","description":"审批单号","x-java-type":"String"},"orderCode":{"type":"string","description":"订单编码","x-java-type":"String"},"isValid":{"type":"integer","description":"是否有效：0-否，1-是","x-java-type":"Integer","format":"int32"},"bookingScenario":{"type":"integer","description":"预订场景：0-酒店，1-机票","x-java-type":"Integer","format":"int32"},"approvalStatus":{"type":"integer","description":"审批状态：0-待审核，1-审核中，2-已同意，3-已拒绝","x-java-type":"Integer","format":"int32"},"rejectReason":{"type":"string","description":"驳回原因","x-java-type":"String"},"invalidReason":{"type":"string","description":"失效原因","x-java-type":"String"},"isSecondarySubmit":{"type":"integer","description":"是否二次提交：0-否，1-是","x-java-type":"Integer","format":"int32"},"resubmitReason":{"type":"string","description":"重新提交原因","x-java-type":"String"},"allowPayBeforeApproval":{"type":"integer","description":"允许审批前支付：0-禁止，1-允许","x-java-type":"Integer","format":"int32"},"jointApprovalType":{"type":"integer","description":"联合审批类型：0-所有审批人同意，1-任一审批人同意","x-java-type":"Integer","format":"int32"},"isApproval":{"type":"integer","description":"当前审批轮次是否已审批或已不可操作：0-否，1-是","x-java-type":"Integer","format":"int32"},"createdDt":{"type":"string","description":"创建时间","x-java-type":"String"},"createdBy":{"type":"string","description":"创建人","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"avatar":{"type":"string","description":"用户头像","x-java-type":"String"},"records":{"type":"array","description":"一级审批记录列表","x-java-type":"List<TravelApprovalBmsRecordResp>","items":{"type":"object","properties":{"approverUserId":{"type":"integer","description":"审批人用户 ID。","x-java-type":"Integer","format":"int32"},"approvalSequence":{"type":"integer","description":"当前审批轮次内的实际审批顺位，从 1 开始。","x-java-type":"Integer","format":"int32"},"isCurrentApprover":{"type":"integer","description":"是否为当前可审批人：0-否，1-是。","x-java-type":"Integer","format":"int32"},"approvalAction":{"type":"integer","description":"审批动作 0待审核 1同意 2拒绝","x-java-type":"Integer","format":"int32"},"approvalReason":{"type":"string","description":"审批理由","x-java-type":"String"},"username":{"type":"string","description":"用户名","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"avatar":{"type":"string","description":"用户头像","x-java-type":"String"},"auditTime":{"type":"string","description":"审核时间","x-java-type":"String"}},"required":["approverUserId","isCurrentApprover","approvalAction","username","email"]}},"secondRecords":{"type":"array","description":"二级审批记录列表","x-java-type":"List<TravelApprovalBmsRecordResp>","items":{"type":"object","properties":{"approverUserId":{"type":"integer","description":"审批人用户 ID。","x-java-type":"Integer","format":"int32"},"approvalSequence":{"type":"integer","description":"当前审批轮次内的实际审批顺位，从 1 开始。","x-java-type":"Integer","format":"int32"},"isCurrentApprover":{"type":"integer","description":"是否为当前可审批人：0-否，1-是。","x-java-type":"Integer","format":"int32"},"approvalAction":{"type":"integer","description":"审批动作 0待审核 1同意 2拒绝","x-java-type":"Integer","format":"int32"},"approvalReason":{"type":"string","description":"审批理由","x-java-type":"String"},"username":{"type":"string","description":"用户名","x-java-type":"String"},"email":{"type":"string","description":"邮箱","x-java-type":"String"},"avatar":{"type":"string","description":"用户头像","x-java-type":"String"},"auditTime":{"type":"string","description":"审核时间","x-java-type":"String"}},"required":["approverUserId","isCurrentApprover","approvalAction","username","email"]}}},"required":["id","approvalNo","orderCode","isValid","bookingScenario","approvalStatus","isSecondarySubmit","allowPayBeforeApproval","jointApprovalType","createdDt","createdBy","email","records"],"nullable":true}},"required":["code","message"]}}}}}}},"/openapi/v1/bms/auth/customer/register":{"post":{"operationId":"bms.postAuthCustomerRegister","x-api-code":"bms.postAuthCustomerRegister","x-open-platform-sort":134,"summary":"CBT 客户注册","description":"**接口：** `POST /auth/customer/register`\n\n由 BMS 一级分销提交 CBT 客户注册，使用 BMS 应用签名，无需 token。自动审核返回 CBT 凭证；人工审核 code=0 仅表示申请提交成功，data 可为空对象或字段为空。externalUserId 是新客户管理员的外部 ID，不是当前 Open App ID。响应不包含 autoApproved、审核单号或 agentCode；data 按 JSON 对象读取。请求结果未知时不得自动重试。商户归属由 BMS 应用身份确定。\n\n业务规则：\n1. BMS 应用与对应一级分销记录均需启用，凭证和分销记录的商户归属需一致。\n2. 同一一级分销下的客户 `externalUserId` 已建立注册关系时，拒绝再次注册；下游同时执行邮箱、公司名称等注册校验。\n3. 是否人工审核由下游注册审核配置决定。自动审核所需的客户类型、支付结算配置等由服务端维护；结算币种优先取本次请求值。\n4. 自动审核通过后创建客户和初始管理员，签发或复用 CBT 凭证，保存外部用户映射及一级分销与客户的归属关系，再返回凭证结果。\n5. 人工审核提交阶段不返回可用凭证。审核通过后，由审核通知链路签发凭证，并按平台实际通知配置推送给对接方。\n6. 商户 ID 由已验证的 BMS 应用及分销记录确定，注册相关写入沿用该商户范围。","tags":["CBT 客户注册"],"parameters":[{"in":"header","name":"X-OP-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-OP-Sign","required":true,"schema":{"type":"string"}}],"x-downstream-path":"/auth/customer/register","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"邮箱; 不可为 null 或空字符串，必须符合邮箱格式；下游检查邮箱是否可用于注册","x-java-type":"String","minLength":1,"format":"email"},"agentName":{"type":"string","description":"公司名称; 不可为 null 或空字符串；下游检查公司名称是否可用于注册","x-java-type":"String","minLength":1},"settlementCurrency":{"type":"integer","description":"结算币种 ID，取值参考币种列表接口; 自动审核时优先使用请求值；未提供时使用下游自动审核配置。请求和配置均无值时，自动审核不能通过","x-java-type":"Integer","format":"int32"},"externalUserId":{"type":"string","description":"请求方系统用户 ID; 不可为 null 或空字符串；最大长度 64。同一 BMS 一级分销下，已注册客户不能重复占用此 ID；审核通过后建立管理员映射并跳过邮件激活","x-java-type":"String","minLength":1,"maxLength":64},"lastName":{"type":"string","description":"姓; 不可为 null 或空字符串；最大长度 128；审核通过后写入初始管理员账号","x-java-type":"String","minLength":1,"maxLength":128},"firstName":{"type":"string","description":"名; 不可为 null 或空字符串；最大长度 128；审核通过后写入初始管理员账号","x-java-type":"String","minLength":1,"maxLength":128}},"required":["email","agentName","externalUserId","lastName","firstName"],"additionalProperties":false}}}},"responses":{"200":{"description":"code 为字符串 0 表示成功；失败时 data 可为 null","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"业务码; 字符串 `\"0\"` 表示成功；其他业务码表示失败","x-java-type":"String"},"message":{"type":"string","description":"提示信息; 成功为 `\"success\"`；失败时为错误提示","x-java-type":"String"},"data":{"type":"object","description":"业务数据; 自动审核通过时包含凭证；人工审核时返回空业务对象；失败时为 null","x-java-type":"CbtCustomerRegisterResp","properties":{"appId":{"type":"string","description":"应用标识; 审核通过后签发或复用的 CBT 客户应用标识","x-java-type":"String","nullable":true},"appSecret":{"type":"string","description":"签名密钥; 该 CBT 客户后续调用接口时使用的 HMAC-SHA256 密钥","x-java-type":"String","nullable":true},"aesKey":{"type":"string","description":"AES-256 响应加密密钥; Base64 编码，对应该 CBT 客户凭证的 `aes_key`","x-java-type":"String","nullable":true},"userId":{"type":"integer","description":"首个管理员账号 userId; 审核通过后生成的客户初始管理员 ID","x-java-type":"Long","format":"int64","nullable":true},"externalUserId":{"type":"string","description":"请求方系统用户 ID; 审核通过后返回所关联的外部用户 ID","x-java-type":"String","nullable":true}},"nullable":true}},"required":["code","message"]}}}}}}}},"components":{"securitySchemes":{"OpenAppKey":{"type":"apiKey","in":"header","name":"X-OP-App-Key"}}},"security":[{"OpenAppKey":[]}]}