订单推送接口

参数

请求参数

字段 类型 释义 必填
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> 途径城市在云简的城市编号数组 Y

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
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
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

文档版本记录

版本号 编写日期 更改内容
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 补充预定人描述信息

results matching ""

    No results matching ""