订单推送接口
参数
请求参数
| 字段 |
类型 |
释义 |
必填 |
| 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) |
Y |
| orderType |
Integer |
细分订单类型,标准值列表-附录4:细分订单类型 |
Y |
| orderStatus |
Integer |
细分订单状态,标准值列表-附录5:订单状态 |
Y |
| payType |
Integer |
支付方式,标准值列表-附录3:支付方式,空值默认为公司支付 |
Y |
| amount |
Decimal |
订单总额 |
Y |
| taxation |
Decimal |
总税费(酒店为0,国际机票为总税费,国内机票为机建费+燃油费) |
Y |
| companyPay |
Decimal |
公司支付金额 |
Y |
| servicePrice |
Decimal |
总服务费(包含退改签服务费) |
Y |
| destinationCity |
Integer |
出发城市在云简的城市编号 |
Y |
| destinationCityTo |
Integer |
到达城市在云简的城市编号 |
Y |
| passengers |
List<String> |
出行人/入住人的姓名数组 |
Y |
| passengerList |
List<Integer> |
出行人/入住人在云简的对接信息key,因为可能是外部出行人,此时可以为空。 |
N |
| startDate |
long |
出发时间,入住时间的13位时间戳,0时区时间 |
Y |
| endDate |
long |
到达时间,离店时间的13位时间戳,0时区时间 |
Y |
| orderDate |
long |
订单创建时间的13位时间戳,0时区时间 |
Y |
| originalOrder |
String |
原始订单的订单号,没有不传 |
N |
| parentAssociation |
String |
父订单的订单号,没有不传 |
N |
| documentNum |
String |
云简的申请单号,没有不传 |
N |
| passingCities |
List<Integer> |
途径城市在云简的城市编号数组 |
N |
| paperItineraryFlag |
String |
订单是否存在纸质发票。枚举值:Y:是;N:否 |
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
| 字段 |
类型 |
释义 |
必填 |
| 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 |
FlightPassenger
| 字段 |
类型 |
释义 |
必填 |
| 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 |
| 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 |
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
| 字段 |
类型 |
释义 |
必填 |
| 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 |
| 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 |
| other_price |
List<OtherPrice> |
其他费用 |
N |
HotelPassenger
| 字段 |
类型 |
释义 |
必填 |
| room_id |
String |
房间Id |
Y |
| 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 |
HotelPriceInfo
| 字段 |
类型 |
释义 |
必填 |
| start_date |
String |
入住日期,"yyyy-MM-dd" |
Y |
| end_date |
String |
离店日期,"yyyy-MM-dd" |
Y |
| price |
Decimal |
总房费 |
Y |
| other_price |
List<OtherPirce> |
其他费用 |
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
| 字段 |
类型 |
释义 |
必填 |
| 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 |
TrainPassenger
| 字段 |
类型 |
释义 |
必填 |
| card_no |
String |
证件号码 |
N |
| card_type |
String |
证件类型 |
N |
| card_type_id |
Integer |
值列表见附录2 |
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 |
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_no |
String |
第三方车次编码 |
Y |
--
taxiDetail
| 字段 |
类型 |
释义 |
必填 |
| source |
String |
渠道 |
Y |
| source_type |
String |
订单类型 |
Y |
| remarks_list |
List<String> |
备注,是字符串的数组 |
N |
| order_info |
TaxiOrderInfo |
订单的详细信息 |
Y |
TaxiOrderInfo
| 字段 |
类型 |
释义 |
必填 |
| 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 |
| 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_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 |
--
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 |
mealOrderInfo
| 字段 |
类型 |
释义 |
必填 |
| 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 |
String |
支付方式,支付宝、微信、手机银行、银联等 |
N |
| restaurant_name |
String |
店铺名称 |
Y |
| restaurant_address |
String |
店铺地址 |
Y |
| restaurant_mobile |
String |
店铺手机号 |
Y |
| date |
String |
用餐时间 |
Y |
| receive_address |
String |
收货人地址 |
Y |
| address_name |
String |
收货人名字 |
Y |
| receive_mobile |
String |
收货人手机号 |
Y |
| 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 |
| 字段 |
类型 |
释义 |
必填 |
| 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 |
otherPrice
| 字段 |
类型 |
释义 |
必填 |
| price |
Decimal |
金额 |
Y |
| price_type |
Decimal |
费用的描述(比如:餐费) |
Y |
--
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_time |
String |
发货时间 |
Y |
| 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 |
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 |
补充预定人描述信息 |
|