5.2 发起签名或填写表单

请求参数

Authorization

Path 参数

customTagID

string

必需

业务方自定义编号；此处传 “发起签署流程”用的customTagID

fill-step

string

必需

流程标识；根据业务模板中配置的流程标识传参；（由平台方和业务方约定好流程标识后制作模板）
可查看“发起签署流程”接口返回的flowDef中fillStep值.

Query 参数

access_token

string

必需

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

默认值:

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

Header 参数

X-Signit-App-Id

string

必需

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

默认值:

1931fabdb516e66ca2f8c42691a

Body 参数application/json

formData

object

要填写的表单内容

可选

根据模板配置，如果当前流程需要填写表单内容，可以在此参数内传表单值；参数格式为 Map 键值对，键对应表单名称，值对应表单值。

signData

object

签名参数

必需

当前流程中需要签名时，可以设置此参数

inUser

array [object {2}]

医护签名

必需

outUser

array [object {1}]

患者签名

必需

设置患者签名后，使用签字板签名

completedAfterSign

boolean

签署后自动完成

可选

是否在当前流程签署后自动完成；适用于调用方需要在流程中途完成的情况。

示例

{
  "formData": {
    "name": "杨晓燕",
    "bedNo": "A01",
    "admissionNumber": "10086",
    "diagnose": "妊娠",
    "inHospitalDate": "2023年8月7日",
    "rcDate": "2023.08.01",
    "rcTime": "10:00-11:00",
    "weeks": "20",
    "fetalMovementCount": "150",
    "remark": "第一次记录"
  },
  "signData": {
    "inUser": [
      {
        "jobId": "job_wutao"
      }
    ],
    "outUser": [
      {
        "signerKey": "signer"
      }
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://m1.apifoxmock.com/m1/4604434-0-default/v1/open/hospital/hospitals/templates/form//fill-in/?access_token=' \
--header 'X-Signit-App-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "formData": {
        "name": "杨晓燕",
        "bedNo": "A01",
        "admissionNumber": "10086",
        "diagnose": "妊娠",
        "inHospitalDate": "2023年8月7日",
        "rcDate": "2023.08.01",
        "rcTime": "10:00-11:00",
        "weeks": "20",
        "fetalMovementCount": "150",
        "remark": "第一次记录"
    },
    "signData": {
        "inUser": [
            {
                "jobId": "job_wutao"
            }
        ],
        "outUser": [
            {
                "signerKey": "signer"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

code

string

接口响应码

必需

100870000=成功，其他=失败

message

string

接口响应消息

必需

signData

object

业务信息

必需

patientName

string

患者姓名

必需

idCode

string

身份证号

必需

serviceId

string

业务方自定义编号

必需

等同于 customTagID

envelopeWsid

string

签署流程唯一标识

必需

当前填写的签署流程唯一标识

nextFlow

object

下个流程的定义

必需

fillStep

string

流程填写标识

必需

fill-in 接口需要使用此参数

sequence

integer

流程顺序

必需

序号相同则表示无序签署

participantConfigs

array [object {5}]

流程中签署方配置

必需

示例

{
  "code": "100870000",
  "message": "操作成功",
  "signData": {
    "patientName": "张三",
    "idCode": "21031119851130004x",
    "serviceId": "20230804175445",
    "envelopeWsid": "WSID_ENVE_00000189bff88e74c27eee096d6d0001"
  },
  "nextFlow": {
    "fillStep": "RECORD_2",
    "sequence": 1,
    "participantConfigs": [
      {
        "type": "DOCTOR",
        "sequence": 2,
        "name": "护士",
        "forms": [
          {
            "id": "25541730",
            "name": "rcDate",
            "type": "TEXT",
            "title": "日期",
            "position": {
              "ulx": 37.875,
              "uly": 158.89453125,
              "lrx": 96.498046875,
              "lry": 178.89453125,
              "docPage": 1
            }
          },
          {
            "id": "37125434",
            "name": "rcTime",
            "type": "TEXT",
            "title": "时间(起始-结束)",
            "position": {
              "ulx": 37.875,
              "uly": 158.89453125,
              "lrx": 96.498046875,
              "lry": 178.89453125,
              "docPage": 1
            }
          },
          {
            "id": "10875938",
            "name": "weeks",
            "type": "TEXT",
            "title": "孕周",
            "position": {
              "ulx": 181.125,
              "uly": 159.64453125,
              "lrx": 223.435546875,
              "lry": 179.64453125,
              "docPage": 1
            }
          },
          {
            "id": "23196827",
            "name": "fetalMovementCount",
            "type": "TEXT",
            "title": "胎动次数",
            "position": {
              "ulx": 226.125,
              "uly": 159.64453125,
              "lrx": 270.123046875,
              "lry": 179.64453125,
              "docPage": 1
            }
          },
          {
            "id": "74985370",
            "name": "remark",
            "type": "TEXT",
            "title": "备注",
            "position": {
              "ulx": 398.625,
              "uly": 158.89453125,
              "lrx": 555.6796875,
              "lry": 178.89453125,
              "docPage": 1
            }
          }
        ],
        "signs": [
          {
            "id": "4497415",
            "name": "signer",
            "type": "WRITE_SIGN",
            "title": "护士签名",
            "position": {
              "ulx": 335.49609375,
              "uly": 157.640625,
              "lrx": 394.640625,
              "lry": 180.28125,
              "docPage": 1
            }
          }
        ]
      },
      {
        "type": "PATIENT",
        "sequence": 2,
        "name": "孕妇",
        "forms": [],
        "signs": [
          {
            "id": "77379697",
            "name": "signer",
            "type": "WRITE_SIGN",
            "title": "孕妇签名",
            "position": {
              "ulx": 272.49609375,
              "uly": 157.640625,
              "lrx": 333.328125,
              "lry": 180.97265625,
              "docPage": 1
            }
          }
        ]
      }
    ]
  }
}

🟠400参数不正确