4.7 查询文件签名记录

注：查询已完成的文件签名记录，filters参数中 type=SUCCESS_COMPLETED 是必传的；
查询时尽量缩小查询数据的范围，比如按时间查询所有数据时，每次查询将时间范围缩小到3~8个小时，数据处理完毕后再进行下一个时间范围的数据查询。
不要直接查询全部。
filters 参数值是由支持筛选的字段名+符号+值构成，多个条件使用英文逗号分隔；
比如 filters=type=SUCCESS_COMPLETED 是查询已完成的
filters=type=SUCCESS_COMPLETED,envelopeFinishedDatetime>=1735660800000 是查询已完成且完成时间大于等于 2025-01-01 00:00:00

请求参数

Authorization

Query 参数

filters

string

必需

查询条件参数，支持以下条件：
doctorID：发起签署的医生工号
envelopeStatus：签署状态，ED_SUCCESS-签署成功
customTagID：自定义业务编号
serviceType：业务模板名称
patientID：患者就诊卡号
envelopeSendDatetime：发起签名时间，毫秒时间戳
envelopeFinishedDatetime：完成签名时间，毫秒时间戳

示例值:

type=SUCCESS_COMPLETED,envelopeFinishedDatetime>=1735660800000

offset

string

分页偏移量

必需

示例值:

limit

string

必需

分页数量，limit 参数传值范围：0<=limit<=100

示例值:

searchAfter

string

可选

分页游标，上一页最后一条数据的createdDatetime字段值；
深度分页时使用，筛选后数据总量totalElements小于1万时可不传此参数

access_token

string

必需

授权码；正式环境联系签署平台方获取

默认值:

3e9dec5f-4a9d-4af8-8abc-23e4675a1eb6

Header 参数

X-Signit-App-Id

string

必需

应用id；正式环境联系签署平台方获取

默认值:

1931fabdb516e66ca2f8c42691a

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

接口响应码

必需

100870000 = 成功

message

string

接口响应消息

必需

records

array [object {20}]

签名记录

必需

serviceId

string

自定义业务编号

必需

patientName

string

患者姓名

必需

patientId

string

患者就诊卡号

必需

departmentName

string

科室名称

必需

departmentCode

string

科室代码

必需

createdDatetime

integer

发起时间

必需

毫秒时间戳

serviceType

string

业务模板名称

必需

serviceTypeName

string

业务模板中文名称

必需

currentVersion

string

当前业务版本

必需

使用同一个自定义业务编号多次发起时，会生成版本信息

latestVersionEnvelopeWsid

string

最新版本的文件签署流程id

必需

latestVersionEnvelopeStatus

string

最新版本的文件签署状态

必需

ED_SUCCESS - 签名完成

latestVersionEnvelopeStatusDescription

string

最新版本的文件签署状态说明

必需

signStatus

string

签名状态

必需

SUCCESS_COMPLETED - 签名完成

signStatusDescription

string

签名状态说明

必需

title

string

签名记录标题

必需

senderWsid

string

发起签署人的用户wisd

必需

admissionNumber

string

住院号

必需

finishedDatetime

integer

完成签名时间

必需

毫秒时间戳

senderName

string

发起方姓名

必需

envelopeFileUrls

array[string]

文件下载地址

必需

集合，取第一个就行。

page

object

分页信息

必需

size

integer

当前返回的记录数量

必需

totalElements

integer

筛选出的数据总数

必需

totalPages

integer

总页码

必需

number

integer

当前页码

必需

示例

{
    "code": "100870000",
    "message": "操作成功",
    "records": [
        {
            "signWsid": null,
            "hospitalBusinessWsid": "WSID_BUSI_000001967a803dd1da733d7cdf470001",
            "serviceId": "4b579AA4-9FBD-FF62-5A4F-5F2D9eAD6ab8",
            "patientName": "王二发",
            "patientId": "A1122334455",
            "departmentName": "骨科",
            "departmentCode": "0095",
            "createdDatetime": 1745811946885,
            "serviceType": "医学影像学报告单",
            "serviceTypeName": "医学影像学报告单",
            "currentVersion": "V1",
            "latestVersionEnvelopeWsid": "WSID_ENVE_000001967a803d855e6a56f35bdd0001",
            "latestVersionEnvelopeStatus": "ED_SUCCESS",
            "latestVersionEnvelopeStatusDescription": "成功处理完成",
            "signStatus": "SUCCESS_COMPLETED",
            "signStatusDescription": "成功已完成",
            "signDatetime": null,
            "modifiedDatetime": null,
            "title": "医学影像学报告单",
            "senderWsid": "WSID_EMEM_0000019385dee32042a1072cd6c0a81d",
            "admissionNumber": "8777202101171970",
            "businessMissing": false,
            "signingData": null,
            "origin": null,
            "finishedDatetime": 1745811949000,
            "senderName": "杨鹏",
            "envelopeFileUrls": [
                "http://47.108.149.104:6153/v1/file/files/WSID_FILE_0000019666ef25226e4a1b5c5b28aa6f?token=db068e068ea28d49dd91106bd078089f&salt=9m0chJ3bBL3a6uhE5N&open=true&ts=1745483672840&ets=E76DEB0A7317A83B0077B10B635CD6E0E282DD7C516ECB94"
            ]
        }
    ],
    "page": {
        "size": 20,
        "totalElements": 2023334,
        "totalPages": 101167,
        "number": 1
    },
    "userMessage": null,
    "developerMessage": null
}

🟠400参数不正确