businesstravelorder/add
目录 |
1.接口说明
1.1接口描述
新增一张商旅订单
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
移动报销、报销应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/businesstravelorder/add |
| 格式 | JSON |
| https请求方式 | POST |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| from_account | string | 是 | 调用方id |
| to_account | string | 是 | 提供方id |
| app_key | string | 是 | 应用编码 |
| token | string | 是 | api调用唯一识别码 |
| tradeid | string | 是 | 交易唯一识别码，tradeid与biz_id只能传入一个 |
| ds_sequence | number | 否 | 数据源序号（默认取应用的第一个数据源） |
| biz_id | string | 是 | 上游id，需要保证biz_id与ERP主键唯一对应关系，tradeid与biz_id只能传入一个 |
| sync | number | 否 | 0=异步新增（默认）;1=同步新增; |
3.3请求体参数说明
| 参数 | 类型 | 参数路径 | 是否必填 | 描述 |
|---|---|---|---|---|
| TicketSource | string | 否 | 订单来源 | |
| OrderID | string | 是 | 订单编号 | |
| OrderStatusName | string | 否 | 订单状态 | |
| Amount | number | 否 | 订单总价 | |
| EmployeeID | string | 否 | 员工编码 | |
| OrderDate | date | 否 | 预订日期 | |
| CorporationName | string | 否 | 公司名 | |
| FlightClass | string | 否 | 国际/国内标识 | |
| PassengerName | string | entry | 否 | 乘机人姓名 |
| TakeOffTime | date | entry | 否 | 起飞时间 |
| ArrivalTime | date | entry | 否 | 到达时间 |
| DPortName | string | entry | 否 | 出发机场名称 |
| DCityName | string | entry | 否 | 出发城市名称 |
| DPortCode | string | entry | 否 | 出发机场代码 |
| DCityCode | string | entry | 否 | 出发城市代码 |
| AmountSub | number | entry | 否 | 航段总价 |
| OilFee | number | entry | 否 | 燃油费 |
| Tax | number | entry | 否 | 机建税 |
| Class | string | entry | 否 | 舱位代码 |
| ClassName | string | entry | 否 | 舱位名称 |
| PriceRate | number | entry | 否 | 机票折扣 |
3.4请求示例
POST https://api.yonyouup.com/api/businesstravelorder/add?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&biz_id=0971&ds_sequence=1
POST 内容：
{
"businesstravelorder":{
"OrderID":"1000000101",
"Amount":"1287",
"UID":"2106338909",
"OrderDate":"2015-9-2310:20:48",
"CorporationName":"携程商旅公司（测试222）",
"entry":{
"OrderCode":"1000000101",
"PassengerName":"xxx",
"NationalityCode":"CN",
"NationalityName":"中国大陆",
"CardTypeName":"身份证",
"CardTypeNumber":"211003197706202116",
"PassengerNamePY":"xxx_py",
"AirlineCode":"MU",
"AirLineName":"东方航空",
"DCityCode":"SHA",
"DCityName":"上海",
"ACityCode":"BJS",
"ACityName":"北京",
"DPortCode":"SHA",
"DPortName":"虹桥",
"APortCode":"PEK",
"APortName":"首都",
"TakeOffTime":"2014-12-2513:00:00",
"ArrivalTime":"2014-12-2515:20:00",
"ClassName":"经济舱",
"Price":"11079",
"PrintPrice":"11309",
"ServerFee":"109",
"CorpPrice":"11079",
"AmountSub":"12779",
"Tax":"509",
"OilFee":"1209",
"StandardPrice":"11309"
}
}
}
3.5返回参数说明
| 参数说明 | 类型 | 描述 |
|---|---|---|
| errcode | string | 错误码，0 为正常。 |
| errmsg | string | 错误信息。 |
| id | string | 主键（订单编号）由开发者传入，因此新增成功后不返回主键。 |
| tradeid | string | 新增成功后返回交易唯一识别码 |
3.6正确返回示例
JSON示例:
{
"tradeid": "158f3f05730711e591c702004c4f4f50",
"ping_after": "3",
"url": "https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50"
}
上述 api 请求返回信息表示建议客户端 3 秒钟后向 https://api.yonyouup.com/result?requestid=158f3f05730711e591c702004c4f4f50 发送 GET 请求获取真正的 api 调用结果，结果格式如下：
{
"errcode" : "0",
"errmsg" : "",
"id" : "883",
"tradeid" : "158f3f05730711e591c702004c4f4f50"
}
3.7错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}