订单推送接口

接口：thirdparty/common/order/save
Method：POST
数据格式：JSON
接口说明：此接口用于保存订单信息，主键为source&orderId，相同主键会更新订单。
正式环境：https://api.cloudpense.com/thirdparty/common/order/save
测试环境：https://qaapi.cloudpense.com/thirdparty/common/order/save
注：因每家TMC订单信息各不一样，对接时先找云简侧开发对一遍数据，根据实际情况传值，以实际情况为准。
文档末尾有文档版本记录

参数

请求参数

字段	类型	释义	必填
userId	Integer	云简的预订人员工编号	Y
userNo	String	预订人员工的对接key	Y
companyId	Integer	云简的公司编号	Y
account	String	公司的账户	Y
orderId	String	订单编号（云间系统内渠道唯一，如果订单号重复，会根据此订单编号做更新）	Y
source	String	订单来源，标准值列表-附录1：渠道	Y
sourceType	String	订单类型，标准值列表-附录2：订单类型	Y
data	json	订单原始数据，随便渠道定义，要求是json，可以传递{}，可以传递null。	N
detail	detail	详细信息，具体分为机票（flightDetail）、酒店（hotelDetail）、火车票（trainDetail）、用车（taxiDetail）、用餐（mealDetail）、服务单（serviceDetail）、集采（purchaseDetail）、买酒（alcoholDetail）	Y
orderType	Integer	细分订单类型，标准值列表-附录4：细分订单类型	Y
orderStatus	Integer	细分订单状态，标准值列表-附录5：订单状态	Y
payType	Integer	支付方式，标准值列表-附录3：支付方式，空值默认为公司支付	Y
amount	Decimal	订单总额	Y
companyPay	Decimal	公司支付金额	Y
currency	String	价格币种，默认CNY	N
taxation	Decimal	总税费(酒店为0，国际机票为总税费，国内机票为机建费+燃油费)	N
servicePrice	Decimal	总服务费(包含退改签服务费)	Y
destinationCity	Integer	出发城市在云简的城市编号	Y
destinationCityTo	Integer	到达城市在云简的城市编号	Y
startDate	long	出发时间，入住时间的13位时间戳，0时区时间	Y
endDate	long	到达时间，离店时间的13位时间戳，0时区时间	Y
orderDate	long	订单创建时间的13位时间戳，0时区时间	Y
originalOrder	String	原始订单的订单号，没有不传	N
parentAssociation	String	父订单的订单号，没有不传	N
documentNum	String	云简的申请单号，没有不传	N
journeyId	String	外部申请单号	N

detail通用字段

所有具体 detail 均继承以下字段；各业务 detail 在此基础上增加自己的字段。

字段	类型	释义	必填
source	String	渠道，标准值列表-附录1：渠道	Y
source_type	String	订单类型，标准值列表-附录2：订单类型	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	Object	订单的详细信息，按业务类型分别为 FlightOrderInfo、HotelOrderInfo 等	Y

BaseOrderInfo通用字段

各业务 OrderInfo 均继承以下字段，业务独有字段见对应小节。

字段	类型	释义	必填
source	String	订单来源	N
source_type	String	订单类型	N
order_id	String	订单号，渠道内唯一	Y
document_num	String	云简申请单号	N
amount	Decimal	订单总价，实际金额	N
price	Decimal	原始价格	N
service_price	Decimal	服务费	N
coupon	Decimal	购买优惠券金额	N
deduction_coupon	Decimal	优惠券抵扣金额	N
person_pay	Decimal	个人实际支付金额	N
company_pay	Decimal	公司实际支付金额	N
currency	String	币种，默认CNY	N
other_price	List<BasePrice>	其他费用	N
scene_code	String	场景代码	N
scene_name	String	场景名称	N
order_datetime	Long	预定时间，13位时间戳	N
start_datetime	Long	开始时间，13位时间戳	N
end_datetime	Long	结束时间，13位时间戳	N
order_date_time	String	预定时间，当地时间，yyyy-MM-dd HH:mm:ss	N
start_date_time	String	开始时间，当地时间，yyyy-MM-dd HH:mm:ss	N
end_date_time	String	结束时间，当地时间，yyyy-MM-dd HH:mm:ss	N
seller_invoice_title	String	开票方的发票抬头	N

BasePassenger通用字段

各业务 Passenger 均继承以下字段；业务独有字段或必填要求覆盖见对应 Passenger 小节。

字段	类型	释义	必填
pay_type	Integer	支付类型，标准值列表-附录3：支付方式	N
bind_id	String	第三方人员编号	N
user_no	String	主数据同步时候约定的主键	N
email_address	String	邮箱	N
passenger_name	String	出行人/入住人/用餐人姓名	N
passenger_type	String	乘客类型描述	N
passenger_type_id	Integer	乘客类型编号，标准值列表-附录8：乘客类型	N
nationality	String	国籍	N
gender	String	性别，标准值列表-附录19：性别	N
card_no	String	证件号码	N
card_type	String	证件类型	N
card_type_id	Integer	证件类型编号，标准值列表-附录7：证件类型	N
amount	Decimal	个人支付总费用	N
price	Decimal	个人原始费用	N
service_price	Decimal	个人服务费	N
penalty_price	Decimal	个人违约金	N
person_pay	Decimal	个人实际支付金额	N
company_pay	Decimal	公司实际支付金额	N
currency	String	币种，默认CNY	N
mobile_number	String	手机号	N
document_num	String	云简申请单号	N
price_list	List<BasePrice>	金额列表	N

FlightDetail

字段	类型	释义	必填
flight	List<Flight>	机票行程	Y
source	String	渠道，标准值列表-附录1：渠道	Y
source_type	String	订单类型，标准值列表-附录2：订单类型	Y
remarks_list	List<String>	备注，是字符串的数组，没有可以不填	N
order_info	FlightOrderInfo	订单的详细信息	Y
passengers	List<FlightPassenger>	出行人的详细信息	Y

FlightOrderInfo

继承 BaseOrderInfo通用字段，下表为机票订单独有字段。

字段	类型	释义	必填
price	Decimal	总的票价，等于每个人的price之和，，没有可不填或填0	Y
amount	Decimal	总的支付金额，没有填0	Y
oil_fee	Decimal	总的燃油费，没有可不填或填0	N
airport_fee	Decimal	总的基建费，没有可不填或填0	N
order_id	String	订单号，渠道内唯一	Y
taxation	Decimal	总税费，主要为国际机票准备，国内机票为机建费+燃油费，没有可不填或填0	N
change_price	Decimal	改签费，没有可不填或填0，改签单必填	N
refund_price	Decimal	退票费，没有可不填或填0	N
document_num	String	申请单号，没有可不填	N
service_price	Decimal	总预定服务费，没有可不填或填0	N
change_service_price	Decimal	总改签服务费，没有可不填或填0	N
refund_service_price	Decimal	总退票服务费，没有可不填或填0	N
send_ticket_price	Decimal	总送票费，没有可不填或填0	N
insurance_price	Decimal	总保险费，没有可不填或填0	N
person_pay	Decimal	个人支付金额，没有可不填或填0	N
company_pay	Decimal	公司支付金额，没有可不填或填0	N

Flight

字段	类型	释义	必填
flight_no	String	航班号	Y
is_share	Boolean	是共享航班	Y
carrier	String	共享航班号	Y
cabin_type	String	飞机舱位的具体编号	Y
cabin	String	舱位名字	Y
cabin_code	String	舱位代码：Y 经济舱; F 头等舱; C 公务舱; S 超级经济舱	Y
seat	Integer	云简的舱位，标准值列表-附录6：舱位	Y
air_company	String	航空公司	Y
air_company_code	String	航司代码，例MU	Y
price	Decimal	航班价格，单个行程的价格	N
oil_fee	Decimal	单个航班的燃油费	N
airport_fee	Decimal	单个航班的机建费	N
cprice	Decimal	商务舱价格	N
fprice	Decimal	头等舱价格	N
yprice	Decimal	经济舱价格	N
dep_city	Integer	出发城市在云简系统内的城市编号	Y
dep_date	String	出发日期，"yyyy-MM-dd"	Y
dep_time	String	出发时间，"HH:mm:ss"	Y
dep_term	String	出发航站楼	Y
dep_city_name	String	出发城市名字	Y
dep_airport	String	出发机场	Y
dep_airport_code	String	出发机场IATA代码	Y
arr_city	Integer	到达城市在云简系统内的城市编号	Y
arr_date	String	到达日期，"yyyy-MM-dd"	Y
arr_time	String	到达时间，"HH:mm:ss"	Y
arr_term	String	到达航站楼	Y
arr_city_name	String	到达城市名字	Y
arr_airport	String	到达机场	Y
arr_airport_code	String	到达机场IATA代码	Y
currency	String	价格币种，CNY	Y
fly_time	String	飞行时间，（秒），无法提供可以填写0	Y
discount	Decimal	折扣，经济舱按1计，经济舱8折填0.80	N
no	String	行程编号	N
trip_time	Integer	行程时长，单位秒	N
trip_mileage	Decimal	行程里程，单位千米	N
dep_datetime	Long	出发时间，13位时间戳	N
dep_date_time	String	出发时间，yyyy-MM-dd HH:mm:ss	N
arr_datetime	Long	到达时间，13位时间戳	N
arr_date_time	String	到达时间，yyyy-MM-dd HH:mm:ss	N
taxation	Decimal	国际机票为税费，国内机票为机建费+燃油费	N
lowest_price	Decimal	当日最低价	N
change_datetime	Long	改签时间，13位时间戳	N
refund_datetime	Long	退票时间，13位时间戳	N
change_reason	String	改签原因	N
refund_reason	String	退票原因	N

FlightPassenger

继承 BasePassenger通用字段，下表为机票乘客独有字段及必填要求覆盖。

字段	类型	释义	必填
card_no	String	证件号码	N
card_type	String	证件类型	N
card_type_id	Integer	证件类型编号,标准值列表-附录7：证件类型	N
ticket_info	List<FlightTicketInfo>	票号信息	Y
oil_fee	Decimal	个人的燃油费，没有可不填或填0	N
taxation	Decimal	税费，没有可不填或填0	N
airport_fee	Decimal	个人的机建费，没有可不填或填0	N
price	Decimal	个人支付的票价·，没有可不填或填0	N
amount	Decimal	个人支付的总费用，没有可不填或填0	N
nationality	String	乘客国籍	N
passenger_type	String	乘客类型的描述	N
passenger_type_id	Integer	乘客类型编号,标准值列表-附录8：乘客类型	N
gender	String	F为女，M为男，性别，标准值列表-附录19：性别	N
user_id	Integer	云简提供的员工序号，如果不是内部员工则不填。	N
user_no	String	云简提供的对接key	N
change_price	Decimal	个人的总的改签费，没有可不填或填0，改签单必填	N
refund_price	Decimal	个人的退票费，没有可不填或填0	N
service_price	Decimal	个人的总预定服务费，没有可不填或填0	N
change_service_price	Decimal	个人的改签服务费，没有可不填或填0	N
refund_service_price	Decimal	个人的退票服务费，没有可不填或填0	N
send_ticket_price	Decimal	个人的送票费，没有可不填或填0	N
insurance_price	Decimal	个人的保险费，没有可不填或填0	N
service_package_price	Decimal	个人总服务包金额	N
other_price	List<OtherPrice>	其他费用，如果没有可以不传	N
passenger_name	String	用户名字（证件上的名字）	Y
bind_id	String	第三方的人员编号（为了防止有只在TMC添加的出行人员，导致回传回来的订单人员关联不上）	Y
price_list	BasePrice	金额列表，如果返回会根据此信息生成消费记录	Y
person_pay	Decimal	个人支付金额，没有可不填或填0	N
company_pay	Decimal	公司支付金额，没有可不填或填0	N
actual_flight	List<Flight>	实际出行航程信息，改签时传递	N
refund_flight	List<Flight>	退掉不再出发的行程	N

FlightTicketInfo

字段	类型	释义	必填
ticket_info_no	String	票价信息的编号	Y
ticket_no	String	票号，能提供必须提供	N
flight_no	String	航班号	Y
status	Integer	票状态，标准值列表-附录9：机票使用状态	Y
seat	Integer	云简的舱位代码，标准值列表-附录6：舱位	Y
is_main_trip	Boolean	是不是主行程	Y
main_ticket_info_no	String	主行程编号（如果is_main_trip为false时必填）	N
ticket_price	Decimal	票面价格（包含票价和税费），is_main_trip为true时必填，不填则认为0	N
price	Decimal	票价，is_main_trip为true时必填，不填则认为0	N
cabin	String	舱位的中文名字	Y
oil_fee	Decimal	航班燃油费，is_main_trip为true时必填，不填则认为0	N
taxation	Decimal	总税费（国内机票为机建费+燃油费，国际机票为所有税费），is_main_trip为true时必填，不填则认为0	N
airport_fee	Decimal	机建费，is_main_trip为true时必填，不填则认为0	N
discount	Decimal	折扣，经济舱按1计，is_main_trip为true时必填，不填则认为0	N
currency	String	价格币种如果is_main_trip为true时必填	N
other_price	List<OtherPrice>	没有可不填	N

HotelDetail

字段	类型	释义	必填
source	String	渠道，标准值列表-附录1：渠道	Y
source_type	String	订单类型，标准值列表-附录2：订单类型	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	HotelOrderInfo	订单的详细信息	Y
passengers	List<HotelPassenger>	出行人的详细信息	Y

HotelOrderInfo

继承 BaseOrderInfo通用字段，下表为酒店订单独有字段。

字段	类型	释义	必填
star	Integer	酒店星级	N
rooms	Integer	房间数	Y
city_id	Integer	城市在云简系统内的城市编号	Y
order_id	String	订单号，渠道内唯一	Y
city_name	String	城市名字	Y
room_type	String	房型	Y
hotel_name	String	酒店名字	Y
hotel_address	String	酒店地址	N
brand_code	String	品牌或者集团代码	N
brand_name	String	品牌名称	N
brand_group	String	品牌集团	N
document_num	String	申请单号	N
person_pay	Decimal	个人支付金额，没有可不填或填0	N
company_pay	Decimal	公司支付金额，没有可不填或填0	N
service_price	Decimal	总服务费，没有可不填或填0	N
extra_charge	Decimal	后收服务费（补税点的费用），没有可不填或填0	N
invoice_type	Integer	发票类型，标准值列表-附录12：发票类型	N
send_invoice_price	Decimal	配送发票的费用，没有可不填或填0	N
price	Decimal	总房费，没有可不填或填0	N
penalty_price	Decimal	酒店违约金，没有可不填或填0	N
amount	Decimal	总金额，没有可不填或填0	N
currency	String	币种	Y
start_date	String	入住日期，"yyyy-MM-dd"	Y
end_date	String	离店日期，"yyyy-MM-dd"	Y
meal_description	String	餐食综合描述信息	N
meal_num	Integer	餐食份数	N
other_price	List<OtherPrice>	其他费用	N

HotelPassenger

继承 BasePassenger通用字段，下表为酒店入住人独有字段及必填要求覆盖。

字段	类型	释义	必填
room_id	String	房间Id	Y
quantity	Integer	人数	N
standard_price	Decimal	标价	N
mobile_number	String	手机号	N
is_main_room	Boolean	是不是房间的主计费人	Y
card_no	String	证件号码	N
card_type	String	证件类型	N
card_type_id	Integer	证件类型编号，标准值列表-附录7：证件类型	N
price_info	List<HotelPriceInfo>	价格信息，主要来罗列每日费用。is_main_room为true时才需要传递	N
price	Decimal	支付的房费, is_main_room为true时必填，不填则认为0	N
amount	Decimal	支付的总费，is_main_room为true时必填，不填则认为0	N
penalty_price	Decimal	酒店违约金，is_main_room为true时必填，不填则认为0	N
person_pay	Decimal	个人支付金额，没有可不填或填0	N
company_pay	Decimal	公司支付金额，没有可不填或填0	N
passenger_type	String	乘客类型的描述	N
passenger_type_id	Integer	乘客类型编号，标准值列表-附录8：乘客类型	N
gender	String	F为女，M为男，标准值列表-附录19：性别	N
user_id	Integer	云简提供的员工序号，非本公司员工时可不填	N
user_no	String	员工的对接key	N
service_price	Decimal	个人的总服务费，is_main_room为true时必填，不填则认为0	N
passenger_name	String	入住人姓名	Y
bind_id	String	第三方的人员编号（为了防止有只在TMC添加的出行人员，导致回传回来的订单人员关联不上）	Y
price_list	BasePrice	金额列表，如果返回会根据此信息生成消费记录	Y
actual_arrival_datetime	String	实际入住时间，yyyy-MM-dd HH:mm:ss	N
actual_leave_datetime	String	实际离店时间，yyyy-MM-dd HH:mm:ss	N
actual_start_datetime	Long	实际入住时间戳	N
actual_end_datetime	Long	实际离店时间戳	N

HotelPriceInfo

字段	类型	释义	必填
start_date	String	入住日期，"yyyy-MM-dd"	Y
end_date	String	离店日期，"yyyy-MM-dd"	Y
room_name	String	房型名字	N
bed_type	String	床型	N
basic_room_name	String	基础房型名字	N
meals	Integer	餐食份数	N
breakfast	Integer	早餐份数	N
price	Decimal	总房费	Y
currency	String	币种，默认CNY	N
other_price	List<OtherPrice>	其他费用	N

TrainDetail

字段	类型	释义	必填
train	List<Train>	火车票行程信息	Y
source	String	渠道，标准值列表-附录1：渠道	Y
source_type	String	订单类型，标准值列表-附录2：订单类型	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	TrainOrderInfo	订单的详细信息	Y
passengers	List<TrainPassenger>	出行人的详细信息	Y

TrainOrderInfo

继承 BaseOrderInfo通用字段，下表为火车票订单独有字段。

字段	类型	释义	必填
order_id	String	订单号，渠道内唯一	Y
document_num	String	申请单号	N
price	Decimal	总的票价，等于每个人的price之和，没有可不填或填0	N
amount	Decimal	总的支付金额，没有可不填或填0	N
person_pay	Decimal	个人支付金额，没有可不填或填0	N
company_pay	Decimal	公司支付金额，没有可不填或填0	N
service_price	Decimal	订单预定服务费，没有可不填或填0	N
change_price	Decimal	改签费，没有可不填或填0，改签单必填	N
change_service_price	Decimal	总改签服务费，没有可不填或填0	N
refund_price	Decimal	退票金额，没有可不填或填0	N
refund_service_price	Decimal	总退票服务费，没有可不填或填0	N
insurance_price	Decimal	总保险费，没有可不填或填0	N
send_ticket_price	Decimal	配送费，没有可不填或填0	N
paper_ticket_fee	Decimal	纸质票出票费，没有可不填或填0	N
grab_service_fee	Decimal	抢票费，没有可不填或填0	N
other_price	List<OtherPrice>	其他费用，没有不填	N

Train

字段	类型	释义	必填
ticket_price	Decimal	票面价格（包含票价和税费），没有可不填或填0	N
train_code	String	车次，例，G235	Y
train_no	String	第三方车次编码	Y
train_class	Integer	舱位代码，标准值列表-附录21：火车票坐席代码	Y
train_class_name	String	舱位名字，例2等座。	Y
train_type	String	火车类型编码，标准值列表-附录22：火车类型代码	N
train_type_name	String	火车类型，比如动车、快车等	Y
price	Decimal	价格，单个行程，没有可不填或填0	N
dep_city	Integer	出发城市在云简系统内的城市编号	Y
dep_date_time	String	出发日期(yyyy-MM-dd HH:mm:ss )	Y
dep_station_code	Integer	出发火车站编码	Y
dep_station_name	String	出发火车站名称	Y
dep_station_en	String	出发火车站名称英文	N
dep_city_name	String	出发城市名字	Y
arr_city	Integer	到达城市在云简系统内的城市编号	Y
arr_date_time	String	到达日期(yyyy-MM-dd HH:mm:ss )	Y
arr_station_code	integer	到达火车站编码	Y
arr_station_name	String	到达火车站名称	Y
arr_station_en	String	到达火车站名称英文	N
arr_city_name	String	到达城市	Y
no	String	行程编号（唯一主键，不能重复）	N
trip_time	Integer	行程时长，单位秒	N
trip_mileage	Decimal	行程里程，单位千米	N
dep_datetime	Long	出发时间，13位时间戳	N
arr_datetime	Long	到达时间，13位时间戳	N
change_datetime	Long	改签时间，13位时间戳	N
refund_datetime	Long	退票时间，13位时间戳	N

TrainPassenger

继承 BasePassenger通用字段，下表为火车票乘客独有字段及必填要求覆盖。

字段	类型	释义	必填
card_no	String	证件号码	N
card_type	String	证件类型	N
card_type_id	Integer	证件类型编号，标准值列表-附录7：证件类型	N
passenger_name	String	用户名字（证件上的名字）	Y
ticket_info	List<TrainTicketInfo>	票号信息	Y
price	Decimal	个人支付的票价·，没有可不填或填0	N
amount	Decimal	个人支付的总费用，没有可不填或填0	N
person_pay	Decimal	个人支付金额，没有可不填或填0	N
company_pay	Decimal	公司支付金额，没有可不填或填0	N
passenger_type	String	乘客类型的描述	N
passenger_type_id	Integer	乘客类型编号,标准值列表-附录8：乘客类型	N
gender	String	F为女，M为男,标准值列表-附录19：性别	N
user_id	Integer	云简提供的员工序号，非本公司员工可不填	N
user_no	String	员工的对接ke y	N
change_price	Decimal	个人的总的改签费，没有可不填或填0，改签单必填	Y
refund_price	Decimal	个人的退票费，没有可不填或填0	N
service_price	Decimal	个人的预定服务费，没有可不填或填0	N
change_service_price	Decimal	个人的改签服务费，没有可不填或填0	Y
refund_service_price	Decimal	个人的退票服务费，没有可不填或填0	Y
send_ticket_price	Decimal	个人的送票费，没有可不填或填0	N
insurance_price	Decimal	个人的保险费，没有可不填或填0	N
grab_service_fee	Decimal	抢票服务费，没有可不填或填0	N
bind_id	String	第三方的人员编号（为了防止有只在TMC添加的出行人员，导致回传回来的订单人员关联不上）	Y
price_list	BasePrice	金额列表，如果返回会根据此信息生成消费记录	Y
actual_train	List<Train>	实际出行火车信息，改签时传递	N
refund_train	List<Train>	退掉不再出发的行程	N

TrainTicketInfo

字段	类型	释义	必填
ticket_no	String	票号	Y
train_no	String	火车编码（车次）例G220	Y
status	Integer	票状态，标准值列表-附录9：机票使用状态	Y
train_class	Integer	舱位代码，标准值列表-附录21：火车票坐席代码	N
train_class_name	String	舱位名字，例2等座。	N
train_code	String	第三方车次编码	Y

taxiDetail

字段	类型	释义	必填
source	String	渠道	Y
source_type	String	订单类型	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	TaxiOrderInfo	订单的详细信息	Y

TaxiOrderInfo

继承 BaseOrderInfo通用字段，下表为用车订单独有字段。

字段	类型	释义	必填
amount	Decimal	订单总价，实际金额，没有可不填或填0，amount = price - refund_price；amount = company_pay + person_pay	N
price	Decimal	原始价格，没有可不填或填0，price = amount + refund_price；price = company_pay + company_refund + person_pay + person_refund	N
order_id	String	订单号，渠道内唯一	Y
refund_price	Decimal	退款金额，没有可不填或填0	N
document_num	String	云简得申请单号	N
mileage	Decimal	里程	N
pay_time	String	支付时间 yyyy-MM-dd HH:mm:ss	N
phone	String	预定人手机号	Y
city_name	String	城市名字	Y
city_id	Integer	城市编号	Y
dep_city	Integer	出发城市云简id	N
dep_city_name	String	出发城市名称	N
arr_city	Integer	到达城市云简id	N
arr_city_name	String	到达城市名称	N
company_pay	Decimal	公司实际支付金额，没有可不填或填0	N
person_pay	Decimal	个人实际支付金额，没有可不填或填0	N
is_invoice	Integer	0，未开票，1已开票	Y
use_car_type	Integer	用车类型,标准值列表-附录10：用车方式	Y
location_from	String	出发地址	N
location_to	String	到达地址	N
order_location_from	String	订单出发地址	N
order_location_to	String	订单到达地址	N
order_date	String	订单时间yyyy-MM-dd HH:mm:ss	N
start_datetime	String	出发时间yyyy-MM-dd HH:mm:ss	N
end_datetime	String	到达时间yyyy-MM-dd HH:mm:ss	N
company_refund	Decimal	公司实际退款金额，没有可不填或填0	N
person_refund	Decimal	个人实际退款金额，没有可不填或填0	N
passenger_phone	String	乘客手机号	Y
passenger_name	String	乘客名字	Y
refund_time	String	退款时间 yyyy-MM-dd HH:mm:ss	N
service_price	Decimal	服务费金额	N
penalty_price	Decimal	取消罚金	N
extra_charge	Decimal	后收服务费	N
park_fee	Decimal	停车费	N
wait_fee	Decimal	等待费	N
highway_fee	Decimal	高速路桥费	N
history_destinations	List<TaxiHistoryDestination>	历史目的地	N
modify_destination_flag	Boolean	是否修改过目的地	N

mealDetail

字段	类型	释义	必填
source	String	渠道	Y
source_type	String	订单类型	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	MealOrderInfo	订单的详细信息	Y
sign_info	MealSignInfo	签到信息	N
report_info	MealReportInfo	报备信息	N
meal	List<mealPrice>	菜品的价格信息	Y
passengers	List<MealPassenger>	用餐人员信息	N
extra_order_info	List<BaseExtraOrderInfo>	订单扩展信息	N

mealOrderInfo

继承 BaseOrderInfo通用字段，下表为用餐订单独有字段。

字段	类型	释义	必填
amount	Decimal	订单总价，实际金额，没有可不填或填0，amount = price - refund_price；amount = company_pay + person_pay	N
price	Decimal	原始价格，没有可不填或填0，price = amount + refund_price；price = company_pay + company_refund + person_pay + person_refund	N
order_id	String	订单号，渠道内唯一	Y
document_num	String	云简的申请单号	N
service_price	Decimal	服务费，没有可不填或填0	N
currency	String	价格币种必填，默认CNY	Y
company_pay	Decimal	公司实际支付金额，没有可不填或填0	N
person_pay	Decimal	个人实际支付金额，没有可不填或填0	N
city_name	String	城市名称	Y
city_id	Integer	城市在云简系统内的城市编号	Y
is_grep_shop	String	是否灰度商家(Y-是，N-否，默认为N)	N
is_online_pay	String	是否线上支付(Y-线上支付，N-线下支付，默认为Y)	N
pay_method	List<String>	支付方式，支付宝、微信、手机银行、银联等	N
shop_code	String	店铺唯一值	N
restaurant_name	String	店铺名称	Y
restaurant_address	String	店铺地址	Y
restaurant_mobile	String	店铺手机号	Y
date	String	用餐时间	Y
receive_address	String	收货人地址	Y
addressee_name	String	收件人名字	N
receive_name	String	收货人名字	Y
receive_mobile	String	收货人手机号	Y
order_date	String	订单日期 yyyy-MM-dd HH:mm:ss	N
booker_name	String	预定人名称	N
estimate_arrival_datetime	Long	预计送达或预计自取时间戳	N
estimate_arrival_date_time	String	预计送达或预计自取时间，yyyy-MM-dd HH:mm:ss	N
arrival_datetime	Long	实际送达或实际自取时间戳	N
arrival_date_time	String	实际送达或实际自取时间，yyyy-MM-dd HH:mm:ss	N
pick_type	Integer	0：普通订单，1：到店自取订单	N
pre_book	Boolean	是否预约	N
other_price	List<OtherPrice>	其他费用，没有不填	N

mealSignInfo

字段	类型	释义	必填
user_id	Integer	云简的员工编号	Y
sign_flag	String	是否签到成功(Y-成功，N-失败)	Y
sign_address	String	签到地点	N
sign_time	String	签到时间 yyyy-MM-dd HH:mm:ss	N

mealReportInfo

字段	类型	释义	必填
type	String	报备类型	Y
category	String	消费场景	N
consumer_num	Integer	消费人数	N
avg_amount	Decimal	人均消费金额	N
remarks_list	List<String>	备注信息	N
picture_urls	List<String>	用餐小票图片地址	N
report_type	Integer	报备类型，1：线上报备；2：特许报备	N
report_status	Integer	报备状态，0：无需稍后填写；1：需要稍后报备；2：已报备	N

remarkInfo

字段	类型	释义	必填
time	String	备注时间，yyyy-MM-dd HH:mm:ss	Y
remark	String	备注信息	N
business_remark	String	商家备注信息	N

mealPrice

字段	类型	释义	必填
price	Decimal	菜品价格	Y
name	String	菜品名称	Y
currency	String	价格币种必填，默认CNY	Y
quantity	Integer	菜品数量，默认1	N

MealPassenger

继承 BasePassenger通用字段，下表为用餐人员常用字段及必填要求覆盖。

字段	类型	释义	必填
pay_type	Integer	支付类型，标准值列表-附录3：支付方式	N
user_id	Integer	云简员工编号	N
bind_id	String	第三方人员编号	N
user_no	String	人员同步时对接的主键	N
passenger_name	String	用餐人姓名	N
amount	Decimal	个人支付总费用	N
price	Decimal	个人原始费用	N
service_price	Decimal	个人服务费	N
person_pay	Decimal	个人实际支付金额	N
company_pay	Decimal	公司实际支付金额	N
currency	String	币种，默认CNY	N
price_list	BasePrice	金额列表	N

otherPrice

字段	类型	释义	必填
price	Decimal	金额	Y
price_type	Decimal	费用的描述（比如：餐费）	Y

serviceDetail

服务单 detail 仅包含通用 detail 字段，order_info 类型为 ServiceOrderInfo。

字段	类型	释义	必填
source	String	渠道	Y
source_type	String	订单类型，固定为service	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	ServiceOrderInfo	服务单订单信息	Y
compliance_info_list	List<ComplianceInfo>	合规信息	N
external_cost_center	List<ExternalCostCenterInfo>	外部成本中心信息	N

ServiceOrderInfo

继承 BaseOrderInfo通用字段，无额外独有字段。

alcoholDetail

字段	类型	释义	必填
source	String	渠道	Y
source_type	String	订单类型，固定为alcohol	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	AlcoholOrderInfo	买酒订单信息	Y
sign_info	AlcoholSignInfo	签到信息	N
report_info	AlcoholReportInfo	报备信息	N
alcohol	List<AlcoholPrice>	酒水价格信息	Y
compliance_info_list	List<ComplianceInfo>	合规信息	N
external_cost_center	List<ExternalCostCenterInfo>	外部成本中心信息	N

AlcoholOrderInfo

继承 BaseOrderInfo通用字段，下表为买酒订单独有字段。

字段	类型	释义	必填
city_name	String	城市名称	Y
city_id	Integer	城市在云简系统内的城市编号	Y
is_grep_shop	String	是否灰度商家(Y-是，N-否，默认为N)	N
is_online_pay	String	是否线上支付(Y-线上支付，N-线下支付，默认为Y)	N
pay_method	List<String>	支付方式，支付宝、微信、手机银行、银联等	N
restaurant_name	String	店铺名称	Y
restaurant_address	String	店铺地址	Y
restaurant_mobile	String	店铺手机号	Y
date	String	用餐/购酒时间，yyyy-MM-dd HH:mm:ss	Y
receive_address	String	收货人地址	Y
addressee_name	String	收件人名字	N
receive_name	String	收货人名字	Y
receive_mobile	String	收货人手机号	Y
order_date	String	订单日期 yyyy-MM-dd HH:mm:ss	N
booker_name	String	预定人名称	N
estimate_arrival_datetime	Long	预计送达或预计自取时间戳	N
estimate_arrival_date_time	String	预计送达或预计自取时间，yyyy-MM-dd HH:mm:ss	N
arrival_datetime	Long	实际送达或实际自取时间戳	N
arrival_date_time	String	实际送达或实际自取时间，yyyy-MM-dd HH:mm:ss	N
pick_type	Integer	0：普通订单，1：到店自取订单	N
pre_book	Boolean	是否预约	N

AlcoholSignInfo

字段同 MealSignInfo。

AlcoholReportInfo

字段同 MealReportInfo。

AlcoholPrice

字段同 mealPrice。

purchaseDetail

字段	类型	释义	必填
source	String	渠道	Y
source_type	String	订单类型	Y
remarks_list	List<String>	备注，是字符串的数组	N
order_info	PurchaseOrderInfo	订单的详细信息purchaseOrderInfo	Y
commodities	List<CommodityInfo>	商品信息 CommodityInfo	Y

purchaseOrderInfo

字段	类型	释义	必填
amount	Decimal	订单总价，实际金额，没有可不填或填0，amount = price - refund_price；amount = company_pay + person_pay	N
price	Decimal	原始价格，没有可不填或填0	N
order_id	String	订单号，渠道内唯一	Y
document_num	String	云简的申请单号	N
service_price	Decimal	服务费，没有可不填或填0	N
currency	String	价格币种必填，默认CNY	Y
company_pay	Decimal	公司实际支付金额，没有可不填或填0	N
person_pay	Decimal	个人实际支付金额，没有可不填或填0	N
logistic_status	Integer	物流状态	Y
confirm_status	Integer	订单预占确定状态	Y
order_status	Integer	集采订单状态	N
freight	Decimal	运费	Y
tax	Decimal	税费	Y
delivery_date_time	String	配送时间，yyyy-MM-dd HH:mm:ss	N
delivery_datetime	Long	配送时间戳	N
harvest_address	String	收货地址	Y
harvest_user_name	String	收货人	Y
harvest_mobile	String	收货人手机号	Y
invoice_type	Integer	发票类型	N
other_price	List<otherPrice>	其他费用，没有不填	N

CommodityInfo

字段	类型	释义	必填
commodity_id	String	商品id	Y
main_commodity_id	String	主商品id	N
commodity_name	String	商品名称	Y
commodity_num	String	商品数量	Y
commodity_category	Integer	商品大类	Y
commodity_sub_category	Integer	商品小类	Y
commodity_type	Integer	商品类型	Y
price	BigDecimal	价格	Y
freight	BigDecimal	运费	Y
tax	BigDecimal	税费	Y
tax_rate	Integer	税率	N

TaxiHistoryDestination

字段	类型	释义	必填
sequence	Integer	目的地序号	N
address	String	目的地详细地址	N
name	String	目的地名称	N
destination_point	Object	目的地坐标	N

BasePrice

字段	类型	释义	必填
price_type	String	参考Passenger里的金额类型信息，例，火车的为price，amount，change_price，refund_price，service_price，change_service_price，refund_service_price，send_ticket_price，insurance_price，grab_service_fee	Y
price	BigDecimal	金额	Y
currency	String	币种	Y
pay_type	int	0是公司支付，1是个人支付，3是混合支付	Y

返回参数

字段名称	字段类型	字段描述
resCode	Integer	200000是成功
resMsg	String	success是成功，如果失败，则这里描述错误原因。

示例：

请求数据：

飞机示例：

{
    "orderType": 10,
    "amount": 462.0,
    "passengers": [
        "xxx"
    ],
    "data": "{}",
    "endDate": 1763804700000,
    "orderId": "2511211146208660af27f8ea6e59112",
    "userNo": "A01665",
    "orderStatus": 2,
    "source": "xxx",
    "destinationCity": 6,
    "companyPay": 462.0,
    "originalOrder": "",
    "payType": 0,
    "servicePrice": 2.0,
    "sourceType": "flight",
    "documentNum": "FSAA000022490",
    "destinationCityTo": 241,
    "passingCities": [
        241
    ],
    "detail": {
        "flight": [
            {
                "air_company": "祥鹏航空",
                "air_company_code": "8L",
                "airport_fee": 50.0,
                "arr_airport": "长水机场",
                "arr_airport_code": "KMG",
                "arr_city": 241,
                "arr_city_name": "昆明",
                "arr_date": "2025-11-22",
                "arr_term": "",
                "arr_time": "17:45:00",
                "cabin": "经济舱",
                "cabin_code": "Z",
                "cabin_type": "Z",
                "carrier": "",
                "currency": "CNY",
                "dep_airport": "天府机场",
                "dep_airport_code": "TFU",
                "dep_city": 6,
                "dep_city_name": "成都",
                "dep_date": "2025-11-22",
                "dep_term": "T2",
                "dep_time": "00:00:00",
                "discount": 0.21,
                "flight_no": "8L9948",
                "fly_time": "0",
                "is_share": false,
                "oil_fee": 10.0,
                "price": 400.0,
                "seat": 3
            }
        ],
        "order_info": {
            "airport_fee": 50.0,
            "amount": 462.0,
            "change_price": 0,
            "change_service_price": 0,
            "company_pay": 462.0,
            "document_num": "FSAA000022490",
            "insurance_price": 0,
            "oil_fee": 10.0,
            "order_id": "2511211146208660af27f8ea6e59112",
            "person_pay": 0,
            "price": 400.0,
            "refund_price": 0,
            "refund_service_price": 0,
            "send_ticket_price": 0.0,
            "service_price": 2.0,
            "taxation": 60.0
        },
        "passengers": [
            {
                "airport_fee": 50.0,
                "amount": 0,
                "bind_id": "A01665",
                "card_no": "xxx",
                "card_type": "1",
                "card_type_id": 1,
                "change_price": 0,
                "company_pay": 462.0,
                "oil_fee": 10.0,
                "passenger_name": "xxx",
                "passenger_type": "成人",
                "passenger_type_id": 1,
                "person_pay": 0,
                "price": 400.0,
                "refund_price": 0,
                "service_price": 2.0,
                "taxation": 60.0,
                "ticket_info": [
                    {
                        "airport_fee": 50.0,
                        "cabin": "经济舱",
                        "currency": "CNY",
                        "discount": 0.21,
                        "flight_no": "8L9948",
                        "is_main_trip": true,
                        "oil_fee": 10.0,
                        "price": 400.0,
                        "seat": 3,
                        "status": 2,
                        "taxation": 60.0,
                        "ticket_info_no": "xxx",
                        "ticket_no": "xxxx",
                        "ticket_price": 460.0
                    }
                ],
                "user_no": "A01665"
            }
        ],
        "source": "xxx",
        "source_type": "flight"
    },
    "orderDate": 1763696781000,
    "parentAssociation": "",
    "taxation": 60.0,
    "account": "xxxx",
    "startDate": 1763799600000
}

酒店示例：

{
  "orderType": 30,
  "amount": 429,
  "passengers": [
    "xxx"
  ],
  "data": "{}",
  "endDate": 1763740800000,
  "orderId": "2511211529111370h237d267c682818",
  "userNo": "A04806",
  "orderStatus": 2,
  "source": "xxx",
  "destinationCity": 429,
  "companyPay": 429,
  "originalOrder": "",
  "payType": 0,
  "servicePrice": 0,
  "sourceType": "hotel",
  "documentNum": "FSAA000022236",
  "destinationCityTo": 429,
  "passingCities": [
    429
  ],
  "detail": {
    "order_info": {
      "amount": 429,
      "city_id": 429,
      "city_name": "郑州市",
      "company_pay": 429,
      "currency": "CNY",
      "document_num": "FSAA000022236",
      "end_date": "2025-11-22 00:00:00",
      "extra_charge": 0,
      "hotel_name": "郑州未来大酒店",
      "order_id": "2511211529111370h237d267c682818",
      "penalty_price": 0,
      "person_pay": 0,
      "price": 429,
      "room_type": "商务大床房",
      "rooms": 1,
      "send_invoice_price": 0,
      "service_price": 0,
      "start_date": "2025-11-21 00:00:00"
    },
    "passengers": [
      {
        "bind_id": "A04806",
        "card_no": "xxx",
        "card_type": "1",
        "card_type_id": 1,
        "company_pay": 429,
        "is_main_room": true,
        "mobile_number": "xxx",
        "passenger_name": "xxx",
        "person_pay": 0,
        "price": 429,
        "room_id": "1"
      }
    ],
    "source": "xxx",
    "source_type": "hotel"
  },
  "orderDate": 1763710714000,
  "parentAssociation": "",
  "taxation": 0,
  "account": "xxxx",
  "startDate": 1763654400000
}

火车示例：

{
  "orderType": 60,
  "amount": 444.0,
  "passengers": [
    "xxx"
  ],
  "data": "{}",
  "endDate": 1764054660000,
  "orderId": "2511211552149030cc3cb23cf575ca8",
  "userNo": "A04136",
  "orderStatus": 2,
  "source": "xxx",
  "destinationCity": 350,
  "companyPay": 444.0,
  "originalOrder": "",
  "payType": 0,
  "servicePrice": 5.0,
  "sourceType": "train",
  "documentNum": "FMAA000001324",
  "destinationCityTo": 282,
  "passingCities": [
    282
  ],
  "detail": {
    "order_info": {
      "amount": 444.0,
      "company_pay": 444.0,
      "document_num": "FMAA000001324",
      "insurance_price": 0,
      "order_id": "2511211552149030cc3cb23cf575ca8",
      "person_pay": 0,
      "price": 439.0,
      "send_ticket_price": 0.0,
      "service_price": 5.0
    },
    "passengers": [
      {
        "amount": 444.0,
        "bind_id": "A04136",
        "card_no": "xxx",
        "card_type": "1",
        "card_type_id": 1,
        "change_service_price": 0,
        "company_pay": 444.0,
        "passenger_name": "xxx",
        "passenger_type": "成人",
        "passenger_type_id": 1,
        "price": 439.0,
        "refund_service_price": 0,
        "service_price": 5.0,
        "ticket_info": [
          {
            "status": 2,
            "ticket_no": "xxx",
            "train_class": 209,
            "train_class_name": "二等座",
            "train_no": "G445"
          }
        ],
        "user_no": "A04136"
      }
    ],
    "source": "xxx",
    "source_type": "train",
    "train": [
      {
        "arr_city": 282,
        "arr_city_name": "南京",
        "arr_date_time": "2025-11-25 15:11:00",
        "arr_station_name": "南京南",
        "dep_city": 350,
        "dep_city_name": "天津",
        "dep_date_time": "2025-11-25 10:55:00",
        "dep_station_name": "天津西",
        "price": 439.0,
        "ticket_price": 439.0,
        "train_class": 209,
        "train_class_name": "二等座",
        "train_code": "G445",
        "train_no": "G445",
        "train_type": "G",
        "train_type_name": "高铁"
      }
    ]
  },
  "orderDate": 1763711535000,
  "parentAssociation": "",
  "taxation": 0,
  "account": "xxx",
  "startDate": 1764039300000
}

用餐示例：

{
  "endDate": 1765844759000,
  "amount": 27.7,
  "passengers": [
    "xxx"
  ],
  "account": "xxx",
  "servicePrice": 0.7,
  "sourceType": "meal",
  "source": "xxx",
  "destinationCity": 0,
  "userNo": "A05465",
  "orderStatus": 2,
  "bindId": "84169728",
  "companyPay": 27.7,
  "orderDate": 1765844759000,
  "emailAddress": "",
  "documentNum": "FSBA000029295",
  "payType": 0,
  "detail": {
    "meal": [],
    "passengers": [
      {
        "user_no": "A04136",
        "amount": 27.7,
        "service_price": 0.7,
        "person_pay": 0,
        "passenger_name": "xxx",
        "bind_id": "A04136",
        "company_pay": 27.7,
        "price": 27
      }
    ],
    "source_type": "meal",
    "source": "xxx",
    "sign_info": {
      "sign_address": "东江海南鸡饭(离餐厅39米)",
      "sign_flag": "Y",
      "sign_time": "2025-12-16 08:25:34"
    },
    "order_info": {
      "date": "2025-12-16 08:25:59",
      "pick_type": 0,
      "person_pay": 0,
      "restaurant_mobile": "xxx",
      "company_pay": 27.7,
      "city_name": "广州市",
      "price": 27,
      "document_num": "FSBA000029295",
      "scene_name": "商务宴请",
      "amount": 27.7,
      "service_price": 0.7,
      "is_grep_shop": "N",
      "restaurant_address": "中山三路3号东汇城B1层烈士陵园地铁站B3出入口",
      "booker_name": "xxx",
      "restaurant_name": "荔银肠粉（省医店）",
      "is_online_pay": "Y",
      "seller_invoice_title": "广州荔银餐饮管理有限公司东川分公司",
      "scene_code": "1",
      "order_id": "2000724050313961529",
      "city_id": 4
    }
  },
  "orderType": 75,
  "orderId": "2000724050313961529",
  "destinationCityTo": 4,
  "startDate": 1765844759000
}

打车示例：

{
  "orderType": 53,
  "amount": 105.6,
  "passengers": [
    "xx"
  ],
  "data": "{}",
  "endDate": 1765636833000,
  "orderId": "2512132153433020uf88c26c2d13e34",
  "userNo": "3131",
  "orderStatus": 5,
  "source": "xxx",
  "destinationCity": 2,
  "companyPay": 105.6,
  "payType": 0,
  "servicePrice": 0,
  "sourceType": "taxi",
  "documentNum": "REQ0000040508",
  "destinationCityTo": 2,
  "passingCities": [
    2
  ],
  "detail": {
    "order_info": {
      "amount": 105.6,
      "city_id": 2,
      "city_name": "北京市",
      "document_num": "REQ0000040508",
      "end_datetime": "2025-12-13 22:40:33",
      "location_from": "首都T3-停车楼负二层-网约车（H区）上车点",
      "location_to": "安慧东里一号院-南门",
      "order_date": "2025-12-13 21:59:30",
      "order_id": "2512132153433020uf88c26c2d13e34",
      "passenger_phone": "xxx",
      "phone": "xxx",
      "price": 105.6,
      "service_price": 0,
      "start_datetime": "2025-12-13 21:59:30",
      "use_car_type": 3
    },
    "source": "fbt",
    "source_type": "taxi"
  },
  "orderDate": 1765634370000,
  "parentAssociation": "",
  "taxation": 0,
  "account": "xxxxxxxxxx",
  "startDate": 1765634370000
}

返参数据：

保存成功

{
    "resCode": 200000,
    "resMsg": "success"
}

保存失败

{
  "resCode": 9999,
  "resMsg": "保存失败"
}

文档版本记录

版本号	编写日期	更改内容
V1.0	2020.01.01	初稿
V1.1	2023.05.01	增加flight的is_share（是否为共享航班）和carrier（共享航班号）。
V1.2	2023.09.23	service_price均改为预定服务费，servicePrice为包含退改签服务费的总服务费。
V1.3	2021.01.22	增加用餐订单信息
V1.4	2022.06.01	将一部分云简内部id修正为对接key
V1.5	2022.10.24	detail.flight中增加no；detail.passengers中增加bind_id，price_list
V1.6	2024.02.21	更改订单保存地址
V1.7	2025.03.03	补充预定人描述信息
V1.8	2026.06.16	根据common-charlie补充OrderInfo、BaseDetail、BaseOrderInfo通用字段，补充serviceDetail、alcoholDetail及多业务缺失字段