报销单列表V2接口

业务场景说明

查询单据列表接口，会返回单据的基本信息，可以根据条件来进行对单据的筛选，查询到单据列表后，如果需要更多详情，可以调用单据详情查询接口进行查询。

注意事项

1. 该接口默认只会查询一年的单据（根据单据创建时间）
2. 若传了其他时间参数，则创建参数非必填
3. 若入参有多个时间参数，则以and关系查询符合条件的数据
4. 反参数据以create时间倒序返回（最新的在最前面）
5. 入参formStatus为DELETED时，返参的formStatus仍为删除前状态，且单据详情接口不支持查询DELETED状态的单据。

接口地址

/api/openapi/form/v2/reimburse

请求类型

POST

请求参数

参数说明

参数样例

{
  "createdAtStart": 1569859200000,
  "createdAtEnd": 1569945600000,
  "submittedAtStart": 1569859200000,
  "submittedAtEnd": 1569945600000,
  "approvedAtStart": 1569859200000,
  "approvedAtEnd": 1569945600000,
  "settledAtStart": 1569859200000,
  "settledAtEnd": 1569945600000,
  "auditedAtStart": 1569859200000,
  "auditedAtEnd": 1569945600000,
  "updatedAtStart": 1569859200000,
  "updatedAtEnd": 1569945600000,
  "formSubTypeBizCode": "FST0001",
  "formStatus": "COMPLETED",
  "procInstEndTimeStart": 1569859200000,
  "procInstEndTimeEnd": 1569945600000,
  "exportStatus": 0,
  "legalEntityBizCodes": [
    "ELC21102113BP29A8"
  ],
  "formCodes": [
    "FORMCODE001"
  ],
  "externalStates": [
    "A",
    "EMPTY"
  ],
  "fillUserList": [
    "MK001"
  ],
  "coverUserList": [
    "MK001"
  ],
  "pageNo": 1,
  "pageSize": 10
}

响应参数

响应参数说明

ReimburseListResponseDto 报销单对象

参数样例

1. 正常响应参数示例

   {
   "code": "ACK", 
   "message": "成功",
   "data":{ 
      "hasNextPage": true,
      "list": [{
         "formSubTypeBizCode": "BXD001",
         "formSubTypeName": "单据小类名称",
         "formCode": "MK19099001",
         "formDataCode": "PC1909251U9B2K1S",
         "formName": "报销导入Junit",
         "employeeName": "张三",
         "employeeId": "emp001",
         "fillEmployeeName": "李四",
         "fillEmployeeId": "emp002",
         "coverEmployeeName": "王五",
         "coverEmployeeId": "emp003",
         "amount": {"amount": 1200.00, "currency": "USD"},
         "departmentBizCode": "DI1803221E22UHXF",
         "departmentName": "杭州每时每刻有限公司",
         "submittedAt": 1569410436063,
         "formStatus": "APPROVING",
         "statusText": "审批中",
         "formType": "REIMBURSE",
         "allocated": false,
         "exportStatus": 1,
         "exportComments": "导出备注",
         "externalVoucherCodes": "CODE01,CODE02",
         "externalState": "A",
         "multiplePayeeFlag": false,
         "paymentAmount": {"amount": 1200.00, "currency": "USD"},
         "legalEntityBizCode": null,
         "legalEntityName": null,
         "settledAt": 1569410436063,
         "approvedAt": 1569410436063
      }]
   }
   }
   

修改记录

2023-08-07  新增报销单列表接口文档
2023-09-15  支持根据修改时间区间查询
2023-10-27  支持根据填单人列表、承担人列表查询