添加抄送方

更新时间:2023-08-29 18:03:19

接口描述

向已发起的流程中添加抄送方的信息,以使未参与到签署流程中的个人或企业接收到已发起的签署相关信息。

“抄送方”的概念:

  • 指不参与签署文件的机构或个人,可以进行查看签署流程中的签署文件以及附属材料等信息,当流程中的签署方全部完成签署,抄送方也会收到签署完成的通知。

接口注意事项:

  • 自动完结的流程(autoFinish设置为true)不支持添加抄送方,否则将会报错:“自动归档流程开启后,不允许添加签署区”。
  • 添加的抄送方不可与流程中已有的抄送方重复。

接口地址:https://{host}/v3/sign-flow/{signFlowId}/copiers

请求方法:POST

请求头格式

具体请求头参数,请查看公共请求头格式

请求参数

展开全部参数参数名称

参数类型

必选

参数位置

参数说明(请左右滑动查看完整描述)

signFlowId

string

path

签署流程ID(通过【基于文件发起签署】接口获取)

copiers(点击“+”展开详情)

array

body

添加的抄送方信息

copierOrgInfo

object

body

抄送机构信息(orgId与orgName二选一传入)

  • 抄送给企业/机构场景时,copierPsnInfo必须传入接收人信息

orgId

string

body

抄送机构账号ID

orgName

string

body

抄送机构账号标识(企业名称)

copierPsnInfo

object

body

抄送人信息(psnId与psnAccount二选一传入)

  • 抄送给个人
  • 抄送给企业的接收人

psnId

string

body

抄送人账号ID

psnAccount

string

body

抄送人账号标识(手机号或邮箱)

响应参数

参数名称

参数类型

必选

参数说明

code

int32

业务码,0表示成功,非0表示异常。

message

string

业务信息

请根据 code 来判断错误情况,不应该依赖 message匹配,因为 message 可能会调整。

data

object

业务数据

请求示例

{
    "copiers":[
        {
            "copierOrgInfo":{
                "orgName":"这是个抄送通知企业的名称",
                "orgId":""
            },
            "copierPsnInfo":{
                "psnAccount":"153****7650",
                "psnId":""
            }
        }
    ]
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": null
}

错误码

点击查看错误码

我要纠错