dingtalk.oapi.alitrip.btrip.hotel.order.search (企业获取商旅酒店订单数据)

企业获取商旅酒店订单数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq OpenSearchRq 必须 rq
  • └ start_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 开始时间
  • └ apply_id
  • Number
  • 可选
  • 12345
  • 商旅审批单id
  • └ page
  • Number
  • 可选
  • 1
  • 默认值:1
  • 页数,从1开始
  • └ userid
  • String
  • 可选
  • user1
  • 用户id
  • └ page_size
  • Number
  • 可选
  • 10
  • 默认值:10
  • 每页数量,默认10,最大50
  • └ deptid
  • String
  • 可选
  • dept1
  • 部门id
  • └ end_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 结束时间
  • └ corpid
  • String
  • 必须
  • corp1
  • 企业id
  • └ update_end_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 更新开始时间
  • └ update_start_time
  • Date
  • 可选
  • 2017-05-01 00:00:00
  • 更新结束时间
  • └ all_apply
  • Boolean
  • 可选
  • true
  • false:搜索未报销订单
  • └ thirdpart_apply_id
  • String
  • 可选
  • 123
  • 第三方申请单ID

响应参数

名称 类型 示例值 描述
success Boolean true 成功标识
errmsg String 成功 错误信息
errcode Number 0 错误码
module OpenHotelOrderRs [] module 酒店订单列表
  • └ id
  • Number
  • 12345
  • 订单id
  • └ gmt_create
  • Date
  • 2017-05-01 00:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 2017-05-01 00:00:00
  • 更新时间
  • └ corpid
  • String
  • corp1
  • 企业id
  • └ corp_name
  • String
  • 阿里巴巴
  • 企业名称
  • └ userid
  • String
  • user1
  • 用户id
  • └ user_name
  • String
  • 张三
  • 用户名称
  • └ deptid
  • String
  • dept1
  • 部门id
  • └ dept_name
  • String
  • 淘宝
  • 部门名称
  • └ apply_id
  • Number
  • 123
  • 商旅申请单id
  • └ contact_name
  • String
  • 李四
  • 联系人姓名
  • └ city
  • String
  • 北京
  • 酒店所在城市
  • └ hotel_name
  • String
  • 未来酒店
  • 酒店名称
  • └ check_in
  • Date
  • 2017-05-01 00:00:00
  • 入住时间
  • └ check_out
  • Date
  • 2017-05-01 00:00:00
  • 离店时间
  • └ room_type
  • String
  • 标间
  • 房型
  • └ room_num
  • Number
  • 1
  • 房间数
  • └ night
  • Number
  • 4
  • 总共住几晚
  • └ guest
  • String
  • 张三,李四
  • 入住顾客,多个用','分割
  • └ order_type_desc
  • String
  • 信用住
  • 订单类型描述
  • └ order_status_desc
  • String
  • 预订成功
  • 订单状态描述
  • cost_center
  • OpenCostCenterDo
  • costCenter
  • 成本中心对象
  • └ id
  • Number
  • 123
  • 商旅成本中心id
  • └ corpid
  • String
  • corp1
  • 企业id
  • └ number
  • String
  • abc
  • 成本中心编号
  • └ name
  • String
  • 测试成本中心
  • 成本中心名称
  • invoice
  • OpenInvoiceDo
  • invoice
  • 发票对象
  • └ id
  • Number
  • 123
  • 商旅发票id
  • └ title
  • String
  • 阿里巴巴
  • 发票抬头
  • └ invoice_type
  • Number
  • 1
  • 发票类型:1:增值税普通发票 2:增值税专用发票
  • price_info_list
  • OpenPriceInfo []
  • priceInfoList
  • 价目详情列表
  • └ price
  • String
  • 100.0
  • 价格
  • └ type
  • Number
  • 1
  • 资金流向:1:支出,2:收入
  • └ category
  • String
  • 酒店费用
  • 交易类型(作废)
  • └ pay_type
  • Number
  • 1
  • 结算方式:1个人现付,2:企业现付,4:企业月结,8企业预存
  • └ gmt_create
  • Date
  • 2017-05-01 00:00:00
  • 流水创建时间
  • └ passenger_name
  • String
  • 张三,李四
  • 入住人信息,多个用‘,’分割
  • └ tradeId
  • String
  • 2342423000
  • 流水单号
  • └ category_type
  • Number
  • 1
  • 交易类目类型1-飞机,2-酒店,3-火车,4-用车
  • └ category_code
  • Number
  • 1
  • 交易类目编码
  • └ thirdpart_itinerary_id
  • String
  • abcdef
  • 第三方行程id
  • └ order_status
  • Number
  • 1
  • 订单状态
  • └ order_type
  • Number
  • 1
  • 订单类型
  • user_affiliate_list
  • OpenUserAffiliateDo []
  • 张三,李四
  • 入住人列表
  • └ userid
  • String
  • 123
  • 入住人ID
  • └ user_name
  • String
  • 张三
  • 入住人名称
  • └ thirdpart_apply_id
  • String
  • 123
  • 第三方申请单ID
  • └ btrip_title
  • String
  • 出差
  • 申请单名称
  • └ project_id
  • Number
  • 1
  • 项目id
  • └ project_code
  • String
  • abc
  • 项目code
  • └ project_title
  • String
  • 测试项目
  • 项目名称
  • └ thirdpart_Project_Id
  • String
  • test1231
  • 第三方项目id
  • └ hotel_support_vat_invoice_type
  • Number
  • 11
  • 酒店开票支持类型:11 仅支持增值税普通发票 12 支持增值税专用发票和增值税普通发票
page_info PageInfoRs module 分页相关信息
  • └ page
  • Number
  • 1
  • 当前页
  • └ page_size
  • Number
  • 10
  • 每页大小
  • └ total_number
  • Number
  • 100
  • 总记录数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/alitrip/btrip/hotel/order/search");
OapiAlitripBtripHotelOrderSearchRequest req = new OapiAlitripBtripHotelOrderSearchRequest();
OpenSearchRq obj1 = new OpenSearchRq();
obj1.setStartTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setApplyId(12345L);
obj1.setPage(1L);
obj1.setUserid("user1");
obj1.setPageSize(10L);
obj1.setDeptid("dept1");
obj1.setEndTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setCorpid("corp1");
obj1.setUpdateEndTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setUpdateStartTime(StringUtils.parseDateTime("2017-05-01 00:00:00"));
obj1.setAllApply(true);
obj1.setThirdpartApplyId("123");
req.setRq(obj1);
OapiAlitripBtripHotelOrderSearchResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

  • JSON示例
{
    "success":true,
    "errmsg":"成功",
    "errcode":0,
    "module":[
        {
                "id":12345,
                "gmt_create":"2017-05-01 00:00:00",
                "gmt_modified":"2017-05-01 00:00:00",
                "corpid":"corp1",
                "corp_name":"阿里巴巴",
                "userid":"user1",
                "user_name":"张三",
                "deptid":"dept1",
                "dept_name":"淘宝",
                "apply_id":123,
                "contact_name":"李四",
                "city":"北京",
                "hotel_name":"未来酒店",
                "check_in":"2017-05-01 00:00:00",
                "check_out":"2017-05-01 00:00:00",
                "room_type":"标间",
                "room_num":1,
                "night":4,
                "guest":"张三,李四",
                "order_type_desc":"信用住",
                "order_status_desc":"预订成功",
                "cost_center":{
                    "id":123,
                    "corpid":"corp1",
                    "number":"abc",
                    "name":"测试成本中心"
                },
                "invoice":{
                    "id":123,
                    "title":"阿里巴巴",
                    "invoice_type":1
                },
                "price_info_list":[
                    {
                            "price":"100.0",
                            "type":1,
                            "category":"酒店费用",
                            "pay_type":1,
                            "gmt_create":"2017-05-01 00:00:00",
                            "passenger_name":"张三,李四",
                            "tradeId":"2342423000",
                            "category_type":1,
                            "category_code":1
                    }
                ],
                "thirdpart_itinerary_id":"abcdef",
                "order_status":1,
                "order_type":1,
                "user_affiliate_list":[
                    {
                            "userid":"123",
                            "user_name":"张三"
                    }
                ],
                "thirdpart_apply_id":"123",
                "btrip_title":"出差",
                "project_id":1,
                "project_code":"abc",
                "project_title":"测试项目",
                "thirdpart_Project_Id":"test1231",
                "hotel_support_vat_invoice_type":11
        }
    ],
    "page_info":{
        "page":1,
        "page_size":10,
        "total_number":100
    }
}

异常示例

  • JSON示例
{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部