email - RecipientCorrection 错误：收件人的电子邮件地址无效。收件人 ID 如下

Question

我正在使用 SOAP 从 DocuSignAPI 请求 CorrectAndResendEnvelope；从 DocuSign 获取错误消息“收件人的电子邮件地址无效。收件人 ID 如下”。该请求包括一个 RecipientCorrection 对象，其中包含 DocuSignAPI 使用信封的 RequestStatus 返回的确切电子邮件地址、用户名和路由号，用于需要更改名称的收件人。

API 文档中不包含此错误消息，位于 API 抛出的异常下。还有人看到这个吗？

Answer 1

最后，在我提交了请求和响应的 SOAP 消息后，支持人员发现了问题。一个未记录的要求是，即使您实际上并未更正电子邮件地址，您也需要应用 <CorrectedEmail>。如果您要更改电子邮件，可能还需要应用 <CorrectedUserName>。

支持人员还确认 <SignerName> 仅在为收件人使用当面签名时使用。在后一种情况下，<...UserName> 将是拥有 DocuSign 会员资格的人，而 <...SignerName> 将是实际签署信封的人。

Answer 2

我相信您只能在以下情况下更正/修改收件人：

1)  They have not signed yet
2)  It is NOT their turn in the routingOrder yet.

根据您的评论，您似乎正在创建一个包含 3 个收件人的信封，他们都拥有routingOrder = 1并发送了信封，但尚未签署任何内容。这意味着您应该无法更正这些收件人中的任何一个，因为它们都是 routingOrder = 1 并且信封的当前 routingOrder 是 1。

#2 的原因是，如果它当前是收件人的 routingOrder，他们可能会在任何时候签名，所以如果您尝试在他们在发送请求之间登录的同时进行收件人更正，那么就在那里会发生冲突。

要解决此问题，您必须在发送信封之前尝试更正收件人，或者为收件人提供不同的路由顺序（即 1、2、2 或 1、2、3 等）。