本文详解如何通过 docusign php sdk 实现多签署人**并行签署**（而非串行流转），解决因 `routing_order` 设置不当导致仅首名签署人收件的问题，并提供可直接运行的完整代码示例与关键注意事项。
在使用 DocuSign PHP SDK 进行批量签署时，一个常见误区是误将多个签署人的 routing_order 设置为递增数值（如 1、2、3…），这会触发 DocuSign 的串行路由机制：只有前一签署人完成签名后，下一签署人才能收到文档。因此，你观察到“只有一人收到、无报错”的现象——并非代码失败，而是逻辑配置使然。
✅ 正确做法：若需所有签署人同时收到签署邀请（即并行签署），必须将所有 Signer 对象的 routing_order 设为 相同值（通常为 1）。DocuSign 将把该值解释为“同一签署阶段”，从而并发投递。
以下是修正后的核心代码段（已优化结构、增强可读性与健壮性）：
// 初始化签署人数组
$signers = [];
// 主签署人（routing_order = 1）
$signer1 = new \DocuSign\eSign\Model\Signer([
'email' => $this->email_signatario,
'name' => $this->nome_signatario,
'recipient_id' => '1',
'routing_order' => '1' // ⚠️ 关键：设为 1，非 5
]);
array_push($signers, $signer1);
// 额外签署人（全部 routing_order = 1，实现并行）
foreach ($this->emails_adicionais as $index => $endereco_adicional) {
$signer = new \DocuSign\eSign\Model\Signer([
'email' => $endereco_adicional,
'name' => $this->nome_signatario . "_{$index}",
'recipient_id' => (string)($index + 2), // 确保 recipient_id 唯一且为字符串
'routing_order' => '1' // ✅ 统一设为 1
]);
array_push($signers, $signer);
}
// 定义签名标签（支持所有签署人）
$signHereTabs = [
new \DocuSign\eSign\Model\SignHere([
'anchor_string' => '*signature_1*',
'anchor_units' => 'pixels',
'anchor_y_offset' => '10',
'anchor_x_offset' => '20'
]),
new \DocuSign\eSign\Model\SignHere([
'anchor_string' => '/sn1/',
'anchor_units' => 'pixels',
'anchor_y_offset' => '10',
'anchor_x_offset' => '20'
])
];
// 为每个签署人分配相同的签名标签
foreach ($signers as $signer) {
$tabs = new \DocuSign\eSign\Model\Tabs([
'sign_here_tabs' => $signHereTabs
]);
$signer->setTabs($tabs);
}
// 添加抄送人（Carbon Copies）
$ccs = array_filter([$cc1, $cc2, $cc3, $cc4]); // 过滤空值
// 构建收件人对象（注意：recipient_count 可省略，SDK 会自动计算）
$recipients = new \DocuSign\eSign\Model\Recipients([
'signers' => $signers,
'carbon_copies' => $ccs
]);
$envelope_definition->setRecipients($recipients);? 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
- recipient_id 必须为唯一字符串（如 '1', '2', '3'），不可重复；
- routing_order 决定签署流程：1 = 并行，1,2,3 = 串行；
- recipient_count 字段在新版 SDK 中非必需，建议省略以避免维护负担；
- 所有签署人共享的 Tabs（如 sign_here_tabs）需显式赋值给每个 Signer 实例；
- 若需区分不同签署人的签名位置，应使用不同 anchor_string 或显式坐标（document_id/page_number）；
- 发送前务必调用 $apiClient->createEnvelope($accountId, $envelope_definition) 并检查返回的 envelopeId。
? 进阶提示： 如需混合流程（例如：2 人并行签署 → 第3人审阅 → 第4人归档），可设置 routing_order = 1（前两人）、routing_order = 2（第三人）、routing_order = 3（第四人），DocuSign 将严格按阶段执行。
正确配置 routing_order 是实现高效批量签署的基石。一次修正，全员同步收件——告别“只发一人”的隐形陷阱。
