expensesclaimlist/batch_get
目录 |
1.接口说明
1.1接口描述
获取费用报销单列表信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
移动报销、报销应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/expensesclaimlist/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| page_index | 否 | string | 页号 |
| rows_per_page | 否 | string | 每页行数 |
| code_begin | 否 | string | 起始单据编号 |
| code_end | 否 | string | 结束单据编号 |
| date_begin | 否 | date | 起始报销日期，格式:yyyy-MM-dd |
| date_end | 否 | date | 结束报销日期，格式:yyyy-MM-dd |
| cuscode | 否 | string | 客户编码，可以通过 api/customer 获取 |
| cusname | 否 | string | 客户名称关键字，可以通过 api/customer 获取 |
| vencode | 否 | string | 供应商编码，可以通过 api/vendor 获取 |
| venname | 否 | string | 供应商名称关键字，可以通过 api/vendor 获取 |
| personcode | 否 | string | 报销人编码，可以通过 api/person 获取 |
| personname | 否 | string | 报销人名关键字，可以通过 api/person 获取 |
| deptid | 否 | string | 部门编码，可以通过 api/department 获取 |
| deptname | 否 | string | 部门名称关键字，可以通过 api/department 获取 |
| used | 否 | string | 用途关键字 |
| agentid | 否 | string | 经办人 |
| auditorid | 否 | string | 审核人 |
| makerid | 否 | string | 制单人 |
3.3请求示例
GET https://api.yonyouup.com/api/expensesclaimlist/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&page_index=1&rows_per_page=20&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| page_index | string | 页号 | |
| rows_per_page | string | 每页行数 | |
| row_count | string | 总行数 | |
| page_count | string | 页数 | |
| operationtypecode | string | 单据类型编码 | |
| typename | string | 单据类型 | |
| code | string | 单据编号 | |
| expensedate | date | 报销日期 | |
| expenserid | string | 报销人编码 | |
| cpsn_name | string | 报销人 | |
| deptid | string | 部门 | |
| cdepname | string | 部门名称 | |
| expensemoney | number | 报销金额 | |
| budgetitemid | string | 预算项目编码 | |
| cbgitemname | string | 预算项目 | |
| currency | string | 币种 | |
| agentid | string | 经办人 | |
| makerid | string | 制单人 | |
| auditorid | string | 审核人 | |
| auditdate | date | 审核日期 | |
| cuscode | string | 客户编码 | |
| ccusname | string | 客户名称 | |
| ccusabbname | string | 客户简称 | |
| vencode | string | 供应商编码 | |
| cvenname | string | 供应商名称 | |
| cvenabbname | string | 供应商简称 | |
| auditdatetime | date | 审核日期时间 | |
| auditstate | number | 审核状态 | |
| paystate | number | 支付状态 | |
| vouchstate | number | 单据状态 | |
| used | string | 用途 | |
| exchangerate | number | 汇率 | |
| itemclassid | string | 项目大类 | |
| itemid | string | 头项目 | |
| citem_name | string | 项目大类名称 | |
| citemname | string | 头项目 | |
| spreaddeptid | string | 头分摊部门 | |
| spreaddepname | string | 部门名称 | |
| cdefine1 | string | 自定义项1 | |
| cdefine2 | string | 自定义项2 | |
| cdefine3 | string | 自定义项3 | |
| cdefine4 | date | 自定义项4 | |
| cdefine5 | number | 自定义项5 | |
| cdefine6 | date | 自定义项6 | |
| cdefine7 | number | 自定义项7 | |
| cdefine8 | string | 自定义项8 | |
| cdefine9 | string | 自定义项9 | |
| cdefine10 | string | 自定义项10 | |
| cdefine11 | string | 自定义项11 | |
| cdefine12 | string | 自定义项12 | |
| cdefine13 | string | 自定义项13 | |
| cdefine14 | string | 自定义项14 | |
| cdefine15 | number | 自定义项15 | |
| cdefine16 | number | 自定义项16 | |
| costapplycode | string | 申请单号 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"10",
"row_count":"23",
"errmsg":"",
"errcode":"0",
"page_count":"3",
"expensesclaimlist":[
{
"cbgitemname":null,
"spreaddeptid":"01",
"cuscode":null,
"cvenabbname":null,
"ccusname":null,
"used":"12345",
"exchangerate":"1.0",
"operationtypecode":"3001",
"spreaddepname":"总裁会",
"deptid":"01",
"ccusabbname":null,
"citemname":null,
"budgetitemid":null,
"iswfcontrolled":"0",
"expenserid":"00001",
"citem_name":null,
"cdepname":"总裁会",
"code":"0000000023",
"agentid":"demo",
"auditdate":null,
"cvenname":null,
"cdefine12":null,
"costapplycode":null,
"cdefine11":null,
"cdefine10":null,
"auditdatetime":null,
"cpsn_name":"王铭",
"expensemoney":"2.00",
"itemid":null,
"cdefine14":null,
"vouchstate":"1",
"cdefine13":null,
"cdefine16":null,
"cdefine15":null,
"currency":"人民币",
"itemclassid":null,
"vencode":null,
"paystate":"0",
"cdefine9":null,
"cdefine8":null,
"expensedate":"2015-12-2900:00:00.0",
"cdefine7":null,
"cdefine6":null,
"cdefine5":null,
"cdefine4":null,
"cdefine3":null,
"cdefine2":null,
"cdefine1":null,
"auditorid":null,
"typename":"交通费报销单",
"auditstate":"0",
"makerid":"demo"
},
{
"cbgitemname":null,
"spreaddeptid":"01",
"cuscode":null,
"cvenabbname":null,
"ccusname":null,
"used":"12345",
"exchangerate":"1.0",
"operationtypecode":"3002",
"spreaddepname":"总裁会",
"deptid":"01",
"ccusabbname":null,
"citemname":null,
"budgetitemid":null,
"iswfcontrolled":"0",
"expenserid":"00001",
"citem_name":null,
"cdepname":"总裁会",
"code":"0000000022",
"agentid":"demo",
"auditdate":null,
"cvenname":null,
"cdefine12":null,
"costapplycode":null,
"cdefine11":null,
"cdefine10":null,
"auditdatetime":null,
"cpsn_name":"王铭",
"expensemoney":"104.00",
"itemid":null,
"cdefine14":null,
"vouchstate":"1",
"cdefine13":null,
"cdefine16":null,
"cdefine15":null,
"currency":"人民币",
"itemclassid":null,
"vencode":null,
"paystate":"0",
"cdefine9":null,
"cdefine8":null,
"expensedate":"2015-12-2900:00:00.0",
"cdefine7":null,
"cdefine6":null,
"cdefine5":null,
"cdefine4":null,
"cdefine3":null,
"cdefine2":null,
"cdefine1":null,
"auditorid":null,
"typename":"差旅费报销单",
"auditstate":"0",
"makerid":"demo"
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}