信封管理

openapi发起的信封在草稿状态下支持预览么？

openapi本地文件发起的信封在草稿状态下不支持预览，openapi模版发起的信封可以通过查询文件合成任务详情(/esignglobal/v1/templates/renderTask)接口获取文件进行预览。

openapi接口无法查询web端发起的信封么？

是的，目前openapi接口不支持查询web端发起的信封，但是web端可以查询openapi发起的信封。

用户撤销签署后，重新开始，taskId、fileKey、envelopeId 能重复使用吗？

fileKey可以重复使用，taskid的作用是为了拿到文件，文件是可以重复使用的，所以不用创建新的，envelopeId不能重复。

eSignGlobal是否支持签名和图章自动(静默)签？

esignglobal支持图章自动(静默)触发文档的签署流程，无需人工干预，当企业在处理大量标准化合同（如员工入职合同、供应商合作协议等）时，可通过静默签署一次性完成众多合同的签署，节省大量时间和人力。

在保证证据链的合规性上个人签名需要手动签完，不支持个人自动(静默)签。

openapi一步发起或者分布发起接口传autoSign位true为静默签。

详情可参见如下接口：

        {
            "userEmail": "fengnian@tsign.cn",
            "userFirstName": "",
            "userLastName": "fengnian",
            "signOrder": 2,
            "autoSign": true, //静默签只支持图章，静默签需要传autoSign和stampId(图章ID的值)
            "signDateConfigs": [
                {
                    "posX": 200,
                    "posY": 765,
                    "pageNo": "1",
                    "signDateFormat": "yyyy-MM-dd"
                }
            ],
            "sealInfos": [
                {
                    "fileKey": "xxxxx",
                    "signConfigs": [
                        {
                            "fieldType": "stamp",
                            "posX": "455.61234",
                            "posY": "375.12186",
                            "pageNo": "1",
                            "width": 164,
                            "height": 162,
                            "stampId": "xxxxxxx"
                        }
                    ]
                }
            ]
        }

openapi是否支持指定图章发起签署？

以下是关于openapi是否支持指定图章发起签署相关问题的详细解答： 关于openapi常规发起签署: 在一般情况下，openapi是不支持指定图章来发起签署操作的。 关于openapi自动（静默）签署时指定图章发起: 当使用openapi进行自动（静默）签署时，是可以指定图章发起签署的。但这需要满足一定的条件，具体来说，要在相关操作中传递两个关键参数：一是将“autoSign”参数传值为“true”，以此来表明是自动（静默）签署的操作模式；二是要传入“stampId”参数，这个参数对应的就是具体要指定使用的图章的唯一标识，只有同时传递这两个参数，才能够实现指定图章发起签署这一功能。 关于签署人使用图章的前置条件: 倘若签署人想要使用公司或者部门的图章来进行签署，那么需要由工作空间的管理员来提前创建相应的图章。只有在管理员完成图章创建工作之后，签署人在后续进行签署操作的时候，才能够有可供选择的图章来完成签署流程。 希望以上内容能让您清晰地了解openapi在指定图章发起签署方面的相关规则与操作要求。

签署人是否支持使用公司或者部门的图章？

签署人如果需要使用公司或者部门的图章，需要满足如下2个条件：

1）需要先检查签署人和发起人是否在同一个租户下，如果不在可以在成员列表邀请签署人为同一租户下的成员并获得邀请人同意；

2）需要检查此租户下是有已创建图章，如果没有图章需要管理员来创建图章，签署人签署的时候才可以选择图章签署。

openapi发起静默签署支持非同一租户下的人静默签么？或报：{"code":"120132","message":"The participant and initiator of the silent sign are not the same tenant"}

关于通过openapi发起静默签署，是不支持非同一租户下的人员进行静默签的。 如果签署人属于未注册账号的情况，又或者是和发起人不属于同一租户下的账户，那么在发起静默签署时，操作就会失败，并会出现报错信息，比如报{"code":"120132","message":"The participant and initiator of the silent sign are not the same tenant"}这样的提示。 要是您希望能够顺利发起静默签署的话，可以通过在成员列表中邀请签署人成为同一租户下的成员，并且要获得被邀请人的同意。只有当发起人和签署人处于同一租户下之后，才可以正常发起静默签署。关于具体的操作详情，您可以查看相关的示意图：

匿名签和登录签的区别？

以下是关于匿名签和登录签区别的详细介绍： 当您登录esignglobal平台后，在信封列表点击相应的签署按钮进入签署链接，此时如果您在别的浏览器再次打开这个签署链接，那么系统会要求您先进行登录操作，只有登录成功后，才能进入到签署页面开展后续的签署工作，这种需要先登录才能进入签署页的签署方式就是登录签。 有两种常见的情况属于匿名签。其一，当您从邮箱中直接点击签署链接，或者把邮箱里收到的签署链接复制下来，然后粘贴到任意的浏览器中打开，此时系统会直接引导您进入签署页面，并不需要您进行登录操作，这就是匿名签的一种体现形式；其二，通过openapi接口发起签署后所获取到的签署链接，当您使用浏览器打开这个链接时，同样也无需用户进行登录，便可直接进入签署页面，这同样属于匿名签的范畴。 简单来说，登录签需先登录才能进入签署页，而匿名签则无需登录就能直接进入签署页开展签署工作，二者在进入签署页面这一环节存在明显的操作差异。

openapi发起信封报{"code":"120142","message":"Signer XXX does not support enabling security mode for automatic signing."}

当您通过openapi发起信封时，若收到报错信息{"code":"120142","message":"Signer XXX does not support enabling security mode for automatic signing."}，这通常意味着您在发起信封的操作过程中，已经设置了自动（静默）签署功能，但是与此同时又开启了身份验证模式，而这种情况是不被支持的。 为了能够顺利地发起信封，避免出现此类报错情况，建议您在相关操作中对authModes参数进行相应处理。您可以选择将authModes参数传值为0，或者直接采用默认的方式，也就是不传该参数，这样就能确保整个发起信封的流程可以正常进行啦。

openapi模版发起信封后，签署页面签名和图章区大小和模版中设置的宽高和位置不一致

当通过 openapi 模版发起信封后，若发现签署页面中签名和图章区的大小以及所处位置，与模版里预先设置的宽高和位置存在不一致的情况时，您可以按照以下步骤来排查和解决问题：

首先，需要仔细检查调用 /esignglobal/v1/templates/renderTask 接口所返回的签名区相关信息，重点关注其宽高以及所处位置的具体参数情况。然后，将这些通过该接口获取到的签名区宽高和位置信息，与在使用 openapi 发起操作时所传递的对应宽高和位置参数进行对比。

倘若经过对比发现二者并不一致，那么就需要对通过 openapi 发起操作时所传递的签名区宽高以及坐标等参数进行相应的更改，务必使其与调用 /esignglobal/v1/templates/renderTask 接口获取到的签名区的宽高和位置保持完全一致，这样才能确保签署页面中签名和图章区的呈现效果符合模版预设要求。