文档中心 > API类目 > 欢行开发平台API

alibaba.tae.expense.report.save (报销单保存)

创建报销单或保存报销单基本信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tp_request ReportSaveOpenRequestDto 可选 报销单保存请求
  • report
  • TopReportDto
  • 必须
  • 报销单数据
  • └ id
  • Number
  • 可选
  • 212186004
  • 报销单主键ID
  • └ corp_id
  • Number
  • 可选
  • 1
  • 欢行企业ID,由服务端身份上下文确定
  • └ submit_time
  • Date
  • 可选
  • 2026-08-24 00:00:00
  • 报销单提交时间
  • └ save_time
  • Date
  • 可选
  • 2026-08-24 00:00:00
  • 报销单保存时间
  • └ apply_id
  • Number
  • 可选
  • 3
  • 关联的预申请单ID
  • └ cost_ou_change_reason
  • String
  • 可选
  • xxxxx
  • 修改费用归属公司的原因
  • └ cost_ou_company_name
  • String
  • 可选
  • 杭州乌鸫科技有限公司
  • 费用归属公司名称快照
  • └ user_credit_card
  • Boolean
  • 可选
  • false
  • 是否使用信用卡报销
  • └ remark
  • String
  • 可选
  • 【测试】报销
  • 报销说明
  • └ currency_code
  • String
  • 可选
  • CNY
  • 报销币种编码
  • attachment_list
  • AttachmentDto []
  • 可选
  • XXXXX
  • 报销单附件列表
  • └ id
  • Number
  • 可选
  • 3
  • 文件中心返回的文件ID
  • └ filename
  • String
  • 可选
  • xxxxx
  • 文件名,包含后缀
  • └ biz_type
  • String
  • 可选
  • xxxxx
  • 业务类型
  • └ auth_key
  • String
  • 可选
  • xxxxx
  • 根据文件ID构造的授权码
  • └ file_size
  • Number
  • 可选
  • 3
  • 文件大小
  • └ data_source
  • String
  • 可选
  • TAE
  • 报销单数据来源
  • └ state
  • String
  • 可选
  • W_BIZ_APV
  • 报销单状态
  • └ editable
  • Boolean
  • 可选
  • false
  • 报销单是否可编辑
  • pre_apply
  • PreApplyDto
  • 可选
  • 关联预申请单信息
  • └ id
  • Number
  • 可选
  • 3
  • 预申请单ID
  • └ travel_type
  • String
  • 可选
  • xxxxx
  • 差旅类型
  • └ out_together_list
  • String []
  • 可选
  • Top,Pub
  • 外部同行人列表
  • └ is_nc
  • String
  • 可选
  • xxxxx
  • 是否为NC处理单据
  • └ nc_handler
  • String
  • 可选
  • xxxxx
  • NC处理人
  • └ is_modify_itinerary
  • String
  • 可选
  • xxxxx
  • 是否修改行程
  • └ is_flash_report
  • String
  • 可选
  • xxxxx
  • 是否为闪报单据
  • └ flash_report_type
  • String
  • 可选
  • xxxxx
  • 闪报类型
  • └ biz_detect_flag
  • String
  • 可选
  • xxxxx
  • 异常检测标记
  • report_dist_dto_list
  • ReportDistDto []
  • 可选
  • [{"a" : "b"}]
  • 收款人分配列表
  • └ user_name
  • String
  • 可选
  • xxxxx
  • 用户名
  • └ work_no
  • String
  • 可选
  • 553568
  • 工号
  • └ dist_id
  • Number
  • 可选
  • 14477340
  • 收款人分配ID
  • └ user_id
  • Number
  • 可选
  • 17799338
  • 欢行用户ID
  • └ corp_id
  • Number
  • 可选
  • 3
  • 欢行企业ID
  • └ user_id
  • Number
  • 可选
  • 17799338
  • 报销申请人的欢行用户ID
  • └ cost_ou
  • String
  • 可选
  • AX8
  • 费用归属组织编码
  • └ currency
  • String
  • 可选
  • CNY
  • 报销币种
  • └ owner_id
  • Number
  • 可选
  • 17799338
  • 实际申请人ID
  • └ owner_account
  • String
  • 可选
  • 553568
  • 实际申请人员工账号
  • └ owner_fin_bu
  • String
  • 可选
  • AD
  • 实际申请人财务业务单元
  • └ owner_hr_bu
  • String
  • 可选
  • 1234
  • 实际申请人人力业务单元
  • └ owner_dept
  • String
  • 可选
  • Q0524
  • 实际申请人部门
  • └ is_credit_card
  • String
  • 可选
  • n
  • 是否使用信用卡报销
  • └ loan_no
  • String
  • 可选
  • xxxxx
  • 借款单号
  • └ description
  • String
  • 可选
  • 【测试】报销
  • 报销单描述
  • └ audit_ht_user_id
  • Number
  • 可选
  • 3
  • 审核人的欢行用户ID
  • └ audit_ht_user_emp_code
  • String
  • 可选
  • xxxxx
  • 审核人员工编码
  • └ audit_ht_user_name
  • String
  • 可选
  • xxxxx
  • 审核人姓名
  • └ owner_fin_group
  • String
  • 可选
  • GROUP_INLAND
  • 实际申请人财务组
  • └ order_field
  • String
  • 可选
  • NULL
  • 单据扩展字段
  • └ item_id_list
  • String []
  • 可选
  • 77499201
  • 费用明细ID列表
  • └ template_type
  • String
  • 可选
  • standard
  • 单据业务流模板类型
  • └ rebute_free_approve
  • Boolean
  • 可选
  • false
  • 是否满足驳回后免审条件
  • report_check_dto_list
  • ReportCheckDto []
  • 可选
  • [{"a" : "b"}]
  • 报销单异常检测结果列表
  • └ id
  • Number
  • 可选
  • 3
  • 主键ID
  • └ gmt_create
  • Date
  • 可选
  • 2026-08-24 00:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 可选
  • 2026-08-24 00:00:00
  • 修改时间
  • └ report_no
  • String
  • 可选
  • xxxxx
  • 报销单号
  • └ apply_type
  • String
  • 可选
  • xxxxx
  • 报销单类型
  • └ item_id
  • Number
  • 可选
  • 3
  • 检测的数据ID
  • └ item_type
  • String
  • 可选
  • xxxxx
  • 检测的数据类型
  • └ check_type
  • String
  • 可选
  • xxxxx
  • 检测类型
  • └ content_cn
  • String
  • 可选
  • xxxxx
  • 检测内容-中文
  • └ content_en
  • String
  • 可选
  • xxxxx
  • 检测内容-英文
  • └ summary
  • String
  • 可选
  • xxxxx
  • 检测异常数据
  • └ creator
  • String
  • 可选
  • xxxxx
  • 创建人
  • └ modifier
  • String
  • 可选
  • xxxxx
  • 修改人
  • └ is_deleted
  • String
  • 可选
  • xxxxx
  • 是否删除
  • └ level
  • String
  • 可选
  • xxxxx
  • 前端展示级别
  • └ corp_id
  • Number
  • 可选
  • 3
  • 欢行企业ID
  • └ opt_user_type
  • String
  • 可选
  • xxxxx
  • 操作用户类型
  • └ ext_info
  • String
  • 可选
  • xxxxx
  • 扩展数据
  • travel_main_project
  • ProjectData
  • 可选
  • 一级业务项目
  • └ project_id
  • String
  • 可选
  • xxxxx
  • 项目ID
  • └ project_value
  • String
  • 可选
  • xxxxx
  • 项目名称
  • travel_sub_project
  • ProjectData
  • 可选
  • 二级业务项目
  • └ project_id
  • String
  • 可选
  • xxxxx
  • 项目ID
  • └ project_value
  • String
  • 可选
  • xxxxx
  • 项目名称
  • └ source_id
  • String
  • 可选
  • xxxxx
  • 三方系统业务单号
  • └ source_type
  • String
  • 可选
  • xxxxx
  • 报销单来源类型
  • └ is_clear_write_off
  • Boolean
  • 可选
  • false
  • 是否清空借款核销信息
  • └ department_code
  • String
  • 可选
  • xxxxx
  • 部门编码
  • └ department_name
  • String
  • 可选
  • xxxxx
  • 部门名称
  • └ report_no
  • String
  • 可选
  • 212186004
  • 报销单号
  • └ apply_type
  • String
  • 可选
  • ER
  • 单据类型,例如ER表示费用报销单
  • └ amount_reimburse
  • String
  • 可选
  • 37
  • 报销金额
  • submit_user
  • HtUserProfile
  • 可选
  • 欢行用户信息
  • └ corp_id
  • Number
  • 可选
  • 2
  • 租户
  • └ user_id
  • Number
  • 可选
  • 12386219
  • 欢行用户ID
  • └ emp_no
  • String
  • 可选
  • 091103
  • 工号
  • └ account
  • String
  • 可选
  • 091103-0
  • 兼职身份
  • └ nick_name
  • String
  • 可选
  • 书宾
  • 别名
  • └ name
  • String
  • 可选
  • 张晓磊
  • 姓名
  • └ work_no
  • String
  • 可选
  • 091103
  • 工号
  • itinerary_list
  • Itinerary []
  • 可选
  • 关联行程列表
  • └ ta_head_id
  • Number
  • 可选
  • 123
  • 差旅申请单id
  • └ line_id
  • Number
  • 可选
  • 456
  • 来源系统差旅单行程ID
  • └ begin_date
  • String
  • 可选
  • 2026-01-01
  • 开始时间
  • └ end_date
  • String
  • 可选
  • 2026-01-03
  • 结束时间
  • └ begin_date_locale
  • String
  • 可选
  • 2026-01-01 00:00:00
  • 开始时间文本(前端展示)
  • └ end_date_locale
  • String
  • 可选
  • 2026-01-03 23:59:59
  • 结束时间文本(前端展示)
  • └ itinerary_type
  • String
  • 可选
  • ROUND_TRIP
  • 行程类型,单程(ONE_WAY)、往返(ROUND_TRIP)
  • └ from_site
  • String
  • 可选
  • 杭州
  • 出发地
  • └ from_site_id
  • Number
  • 可选
  • 330100
  • 出发地城市id
  • └ to_site
  • String
  • 可选
  • 北京
  • 目的地
  • └ to_site_id
  • Number
  • 可选
  • 110100
  • 目的地城市id
  • └ travel_region
  • String
  • 可选
  • INTERNAL
  • 差旅区域,国内(INTERNAL)、国际(INTERNATIONAL)
  • └ transport_type
  • String
  • 可选
  • AIR
  • 交通方式,其他(OTHER)、飞机(PLANE)、火车(TRAIN)、汽车(AUTOMOTIVE)、轮船(STEAMSHIP)
  • └ remark
  • String
  • 可选
  • 示例备注
  • 行程备注
  • └ from_site_group_code
  • String
  • 可选
  • 330100
  • 出发城市行政区划码/城市分组,通过城市查询获取
  • └ to_site_group_code
  • String
  • 可选
  • 110100
  • 目的城市行政区划码/城市分组,通过城市查询获取
  • └ travel_regin
  • String
  • 可选
  • INTERNAL
  • 差旅区域
  • └ tenant_key
  • String
  • 必须
  • ant
  • 租户身份标识;开放API调用必填,Agent调用由上下文识别
  • └ employee_no
  • String
  • 必须
  • 553568
  • 企业员工工号;开放API调用必填,Agent调用由登录态注入
  • └ app_key
  • String
  • 必须
  • ant_group
  • 调用方应用身份;开放API调用必填,Agent调用由上下文识别

响应参数

名称 类型 示例值 描述
platform_result_d_t_o PlatformResultDto platformResultDTO
  • └ result_code
  • String
  • 0
  • 结果编码,0表示成功
  • └ result_message
  • String
  • success
  • 结果消息
  • └ is_success
  • Boolean
  • true
  • 是否成功
  • content
  • TOPReportDTO
  • 单据实体
  • └ id
  • Number
  • 11111
  • 报销单号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTaeExpenseReportSaveRequest req = new AlibabaTaeExpenseReportSaveRequest();
AlibabaTaeExpenseReportSaveRequest.ReportSaveOpenRequestDto obj1 = new AlibabaTaeExpenseReportSaveRequest.ReportSaveOpenRequestDto();
AlibabaTaeExpenseReportSaveRequest.TopReportDto obj2 = new AlibabaTaeExpenseReportSaveRequest.TopReportDto();
obj2.setId(212186004L);
obj2.setCorpId(1L);
obj2.setSubmitTime(StringUtils.parseDateTime("2026-08-24 00:00:00"));
obj2.setSaveTime(StringUtils.parseDateTime("2026-08-24 00:00:00"));
obj2.setApplyId(3L);
obj2.setCostOuChangeReason("xxxxx");
obj2.setCostOuCompanyName("杭州乌鸫科技有限公司");
obj2.setUserCreditCard(false);
obj2.setRemark("【测试】报销");
obj2.setCurrencyCode("CNY");
List<AlibabaTaeExpenseReportSaveRequest.AttachmentDto> list4 = new ArrayList<AlibabaTaeExpenseReportSaveRequest.AttachmentDto>();
AlibabaTaeExpenseReportSaveRequest.AttachmentDto obj5 = new AlibabaTaeExpenseReportSaveRequest.AttachmentDto();
list4.add(obj5);
obj5.setId(3L);
obj5.setFilename("xxxxx");
obj5.setBizType("xxxxx");
obj5.setAuthKey("xxxxx");
obj5.setFileSize(3L);
obj2.setAttachmentList(list4);
obj2.setDataSource("TAE");
obj2.setState("W_BIZ_APV");
obj2.setEditable(false);
AlibabaTaeExpenseReportSaveRequest.PreApplyDto obj6 = new AlibabaTaeExpenseReportSaveRequest.PreApplyDto();
obj6.setId(3L);
obj6.setTravelType("xxxxx");
obj6.setOutTogetherList("Top,Pub");
obj2.setPreApply(obj6);
obj2.setIsNc("xxxxx");
obj2.setNcHandler("xxxxx");
obj2.setIsModifyItinerary("xxxxx");
obj2.setIsFlashReport("xxxxx");
obj2.setFlashReportType("xxxxx");
obj2.setBizDetectFlag("xxxxx");
List<AlibabaTaeExpenseReportSaveRequest.ReportDistDto> list8 = new ArrayList<AlibabaTaeExpenseReportSaveRequest.ReportDistDto>();
AlibabaTaeExpenseReportSaveRequest.ReportDistDto obj9 = new AlibabaTaeExpenseReportSaveRequest.ReportDistDto();
list8.add(obj9);
obj9.setUserName("xxxxx");
obj9.setWorkNo("553568");
obj9.setDistId(14477340L);
obj9.setUserId(17799338L);
obj9.setCorpId(3L);
obj2.setReportDistDtoList(list8);
obj2.setUserId(17799338L);
obj2.setCostOu("AX8");
obj2.setCurrency("CNY");
obj2.setOwnerId(17799338L);
obj2.setOwnerAccount("553568");
obj2.setOwnerFinBu("AD");
obj2.setOwnerHrBu("1234");
obj2.setOwnerDept("Q0524");
obj2.setIsCreditCard("n");
obj2.setLoanNo("xxxxx");
obj2.setDescription("【测试】报销");
obj2.setAuditHtUserId(3L);
obj2.setAuditHtUserEmpCode("xxxxx");
obj2.setAuditHtUserName("xxxxx");
obj2.setOwnerFinGroup("GROUP_INLAND");
obj2.setOrderField("NULL");
obj2.setItemIdList("77499201");
obj2.setTemplateType("standard");
obj2.setRebuteFreeApprove(false);
List<AlibabaTaeExpenseReportSaveRequest.ReportCheckDto> list11 = new ArrayList<AlibabaTaeExpenseReportSaveRequest.ReportCheckDto>();
AlibabaTaeExpenseReportSaveRequest.ReportCheckDto obj12 = new AlibabaTaeExpenseReportSaveRequest.ReportCheckDto();
list11.add(obj12);
obj12.setId(3L);
obj12.setGmtCreate(StringUtils.parseDateTime("2026-08-24 00:00:00"));
obj12.setGmtModified(StringUtils.parseDateTime("2026-08-24 00:00:00"));
obj12.setReportNo("xxxxx");
obj12.setApplyType("xxxxx");
obj12.setItemId(3L);
obj12.setItemType("xxxxx");
obj12.setCheckType("xxxxx");
obj12.setContentCn("xxxxx");
obj12.setContentEn("xxxxx");
obj12.setSummary("xxxxx");
obj12.setCreator("xxxxx");
obj12.setModifier("xxxxx");
obj12.setIsDeleted("xxxxx");
obj12.setLevel("xxxxx");
obj12.setCorpId(3L);
obj12.setOptUserType("xxxxx");
obj12.setExtInfo("xxxxx");
obj2.setReportCheckDtoList(list11);
AlibabaTaeExpenseReportSaveRequest.ProjectData obj13 = new AlibabaTaeExpenseReportSaveRequest.ProjectData();
obj13.setProjectId("xxxxx");
obj13.setProjectValue("xxxxx");
obj2.setTravelMainProject(obj13);
AlibabaTaeExpenseReportSaveRequest.ProjectData obj14 = new AlibabaTaeExpenseReportSaveRequest.ProjectData();
obj14.setProjectId("xxxxx");
obj14.setProjectValue("xxxxx");
obj2.setTravelSubProject(obj14);
obj2.setSourceId("xxxxx");
obj2.setSourceType("xxxxx");
obj2.setIsClearWriteOff(false);
obj2.setDepartmentCode("xxxxx");
obj2.setDepartmentName("xxxxx");
obj2.setReportNo("212186004");
obj2.setApplyType("ER");
obj2.setAmountReimburse("37");
AlibabaTaeExpenseReportSaveRequest.HtUserProfile obj15 = new AlibabaTaeExpenseReportSaveRequest.HtUserProfile();
obj15.setCorpId(2L);
obj15.setUserId(12386219L);
obj15.setEmpNo("091103");
obj15.setAccount("091103-0");
obj15.setNickName("书宾");
obj15.setName("张晓磊");
obj15.setWorkNo("091103");
obj2.setSubmitUser(obj15);
List<AlibabaTaeExpenseReportSaveRequest.Itinerary> list17 = new ArrayList<AlibabaTaeExpenseReportSaveRequest.Itinerary>();
AlibabaTaeExpenseReportSaveRequest.Itinerary obj18 = new AlibabaTaeExpenseReportSaveRequest.Itinerary();
list17.add(obj18);
obj18.setTaHeadId(123L);
obj18.setLineId(456L);
obj18.setBeginDate("2026-01-01");
obj18.setEndDate("2026-01-03");
obj18.setBeginDateLocale("2026-01-01 00:00:00");
obj18.setEndDateLocale("2026-01-03 23:59:59");
obj18.setItineraryType("ROUND_TRIP");
obj18.setFromSite("杭州");
obj18.setFromSiteId(330100L);
obj18.setToSite("北京");
obj18.setToSiteId(110100L);
obj18.setTravelRegion("INTERNAL");
obj18.setTransportType("AIR");
obj18.setRemark("示例备注");
obj18.setFromSiteGroupCode("330100");
obj18.setToSiteGroupCode("110100");
obj18.setTravelRegin("INTERNAL");
obj2.setItineraryList(list17);
obj1.setReport(obj2);
obj1.setTenantKey("ant");
obj1.setEmployeeNo("553568");
obj1.setAppKey("ant_group");
req.setTpRequest(obj1);
AlibabaTaeExpenseReportSaveResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_tae_expense_report_save_response>
    <platform_result_d_t_o>
        <result_code>0</result_code>
        <result_message>success</result_message>
        <is_success>true</is_success>
        <content>
            <id>11111</id>
        </content>
    </platform_result_d_t_o>
</alibaba_tae_expense_report_save_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部