DocuSign API: 발송 후 '참조' 수신자를 추가하는 방법?

DocuSign에서 참조 수신인 이해하기

전자 서명 분야에서 DocuSign의 API는 문서 워크플로를 자동화하는 강력한 도구를 제공하지만, 봉투 생성 후 수신인을 추가하는 것은 까다로울 수 있습니다. “참조”(CC) 수신인은 서명이나 승인 없이 보기 또는 기록 보관을 위해 서명된 문서의 사본을 받는 비서명 역할입니다. 비즈니스 관점에서 이 기능은 서명 체인을 변경할 필요 없이 알림을 받아야 하는 규정 준수 팀, 법률 부서 또는 영업 관리자에게 매우 유용합니다. 그러나 DocuSign의 API는 봉투를 보낸 후 수정에 제한이 있으며, 이러한 제한 사항을 자세히 살펴보겠습니다.

이 문서는 DocuSign eSignature API를 통해 봉투를 보낸 후 CC 수신인을 추가하는 실제 단계를 자세히 살펴봅니다. 사전 요구 사항, API 호출, 잠재적인 함정 및 모범 사례를 다루고 공식 문서 및 실제 구현 통찰력을 참조합니다. DocuSign을 통합하는 기업의 경우 이러한 미묘한 차이를 이해하면 워크플로 중단을 방지하고 감사 준비가 완료된 프로세스를 보장할 수 있습니다.

DocuSign API 수신인 관리 기본 사항

보낸 후 CC 수신인을 추가하기 전에 DocuSign의 봉투 수명 주기를 이해하는 것이 중요합니다. 봉투는 문서 패키지를 나타내며, "보내기"되면 활성 상태가 되며, 이때 서명자 경험과 법적 무결성을 보호하기 위해 변경이 제한됩니다. eSignature REST API(v2.1)는 이러한 상호 작용을 관리하며, 안전한 액세스를 위해 JWT 또는 OAuth를 통해 인증해야 합니다.

핵심 개념:

• 수신인: 서명자, 승인자 및 CC를 포함합니다. CC는 수신인 객체의 carbonCopies 배열을 통해 추가됩니다.
• 봉투 상태: 보낸 후 봉투는 “sent” 또는 “delivered” 상태가 됩니다. 수정에는 제한이 있습니다. 조치가 필요한 서명자를 추가할 수는 없지만 CC는 서명 순서를 변경하지 않으므로 허용됩니다.
• API 엔드포인트: /envelopes/{envelopeId}/recipients를 사용하여 업데이트합니다.

비즈니스 관점에서 DocuSign의 API 가격은 Starter 플랜의 경우 연간 600달러부터 시작하여 월 최대 40개의 봉투를 지원하므로 소규모 통합에 적합하지만, 대용량 요구 사항은 비용이 증가합니다.

단계별 가이드: 보낸 후 CC 수신인 추가하기

보낸 후 CC를 추가하려면 직접 보낸 후 추가가 항상 간단하지 않으므로 correct 모드 또는 void-and-resend 우회 방법을 사용해야 합니다. DocuSign은 수신인을 미리 계획할 것을 권장하지만, 조건부 비즈니스 로직(예: 조건에 따라 관리자 추가)과 같은 동적 시나리오의 경우 다음 단계를 따르십시오. 이 프로세스는 개발자 계정과 API 액세스 토큰이 있다고 가정합니다.

사전 요구 사항

1. API 설정: DocuSign SDK(Java, .NET, PHP 등용)를 통합하거나 원시 REST 호출을 사용합니다. 통합 키와 사용자 ID를 사용하여 인증합니다.
2. 봉투 ID: 초기 보내기 응답에서 ID를 검색합니다(예: /envelopes POST를 통해).
3. 권한: 계정에서 봉투 수정이 허용되는지 확인합니다(Admin 설정의 "Features"에서 활성화).
4. 봉투 상태 확인: /envelopes/{envelopeId}를 쿼리하여 “sent” 상태인지, 서명자가 변경 사항을 잠그는 조치를 완료하지 않았는지 확인합니다.

비즈니스 팁: 기업의 경우 Advanced API 플랜(연간 5,760달러)은 완료 시 CC에 자동으로 알릴 수 있는 Bulk Send 및 webhook과 같은 기능을 잠금 해제합니다.

방법 1: 봉투 수정 사용(작은 변경에 권장)

DocuSign의 “Correct” 기능을 사용하면 봉투를 무효화하지 않고 진행 중인 수정이 가능하며, CC를 추가하는 데 적합합니다.

1. 수정 시작:

   • 본문이 다음과 같은 /envelopes/{envelopeId}/correct에 PUT합니다.

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     이렇게 하면 봉투가 일시적으로 중단됩니다.

2. CC 수신인 추가:

   • CC 세부 정보가 포함된 /envelopes/{envelopeId}/recipients에 POST합니다.

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // 예: "CC1"
           "routingOrder": 0  // CC는 순서에 영향을 미치지 않습니다.
         }
       ],
       "resendEnvelope": false  // 아직 알림을 다시 보내지 마십시오.
     }
     

     • recipientId는 고유해야 합니다. 기존 수신인과 충돌하지 않도록 하십시오.
     • 선택 사항: 암호로 보호된 CC 액세스를 위해 accessControl을 추가합니다.

3. 다시 보내기 또는 알림:

   • 다시 /envelopes/{envelopeId}/correct에 PUT하여 복원합니다.

     {
       "resendEnvelope": true  // 새 CC에 대한 이메일을 트리거합니다.
     }
     

     봉투가 완료되거나 요청 시 CC는 사본을 받게 됩니다.

잠재적인 함정: 봉투가 "completed"된 경우 수정할 수 없습니다. Connect 기능(Advanced 플랜)을 통해 webhook을 사용하여 상태를 모니터링합니다.

방법 2: 무효화하고 다시 보내기(복잡한 시나리오에 적합)

수정이 불가능한 경우(예: 서명자 조치로 인해) 봉투를 무효화하고 새 CC를 사용하여 다시 만듭니다.

1. 봉투 무효화:

   • /envelopes/{envelopeId}에 PUT합니다.

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. CC를 사용하여 다시 만들기:

   • 원래 페이로드와 함께 recipients 객체의 CC를 사용하여 /envelopes에 POST합니다.

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. 원래 서명자에게 알림: 각 서명자에 대해 /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend를 사용하여 복원합니다.

비즈니스 관찰: 이 방법은 추가 봉투 사용 비용을 발생시키므로(예: Business Pro는 사용자당 연간 ~100개의 봉투, 480달러/사용자/년), 낮은 볼륨 수정에 적합합니다. API를 통해 대시보드를 사용하여 할당량을 추적하여 관리합니다.

모범 사례 및 제한 사항

• 오류 처리: 일반적인 오류에는 400(잘못된 수신인) 또는 403(권한 부족)이 포함됩니다. 항상 먼저 /envelopes/{envelopeId}/recipients GET을 사용하여 확인합니다.
• 테스트: DocuSign의 Developer Sandbox(무료)를 사용하여 프로덕션 봉투를 소비하지 않고 시뮬레이션합니다.
• 규정 준수: CC 추가는 감사 추적을 유지 관리하고 ESIGN/UETA 표준을 준수하지만 분쟁을 피하기 위해 이유를 기록합니다.
• 자동화 대안: 빈번한 보낸 후 요구 사항의 경우 API 수정 대신 외부 알림을 트리거하기 위해 webhook(Advanced 플랜)을 통합합니다.

실제로 기업은 이러한 작업을 스크립팅하는 SDK를 통해 20-30%의 효율성 향상을 보고하지만, 대규모 작업의 경우 무제한 조정을 위해 Enterprise 사용자 지정 플랜을 고려하십시오.

전자 서명 플랫폼을 DocuSign 또는 Adobe Sign과 비교하고 계십니까?

eSignGlobal은 글로벌 규정 준수, 투명한 가격 책정 및 더 빠른 온보딩을 통해 더 유연하고 비용 효율적인 전자 서명 솔루션을 제공합니다.

👉 무료 평가판 시작

DocuSign을 주요 경쟁업체와 비교

균형 잡힌 관점을 제공하기 위해 DocuSign의 API 기능을 Adobe Sign, eSignGlobal 및 HelloSign(현재 Dropbox Sign)과 같은 대안과 비교해 보겠습니다. 이 표는 2025년 공개 데이터를 기반으로 하며, 가격 책정, 수신인 관리 및 지역적 강점을 강조하여 기업이 공급업체 선택에서 결정을 내리는 데 도움이 됩니다.

이 비교는 DocuSign이 성숙한 API 깊이에서 탁월하지만 비용이 더 많이 들고, 경쟁업체는 특정 세그먼트에 유연성을 제공한다는 것을 보여줍니다.

Adobe Sign 초점

Adobe Document Cloud의 일부인 Adobe Sign은 “Amend” API 엔드포인트를 통해 더 쉽게 보낸 후 CC 추가를 포함하여 수신인 관리를 위한 원활한 API를 제공합니다. 가격은 경쟁력이 있으며, 기본 버전은 월 10달러/사용자이며 Enterprise 사용자 지정으로 확장됩니다. 이미 Adobe 제품군에 있는 기업에 적합하며, 강력한 PDF 처리 및 글로벌 규정 준수를 제공하지만 APAC 지연이 문제가 될 수 있습니다.

eSignGlobal 초점

eSignGlobal은 100개 이상의 주요 국가에서 규정을 준수하는 글로벌 플레이어로 자리매김하고 있으며, 특히 아시아 태평양(APAC) 지역에서 강력한 입지를 확보하고 있습니다. APAC의 전자 서명 환경은 파편화되어 있으며, 높은 표준과 엄격한 규정을 가지고 있습니다. 미국/EU의 프레임워크 ESIGN/eIDAS와 달리 APAC은 “에코시스템 통합” 솔루션이 필요합니다. 이는 정부 디지털 ID(G2B)와의 심층적인 하드웨어/API 수준의 도킹을 의미하며, 이는 서양에서 흔히 볼 수 있는 이메일 확인 또는 자기 선언 모델을 훨씬 뛰어넘는 기술적 장벽입니다. eSignGlobal은 홍콩의 iAM Smart 및 싱가포르의 Singpass와 같은 기본 통합을 통해 이 문제를 해결하여 추가 비용 없이 법적 유효성을 보장합니다.

가격은 저렴하며, Essential 플랜은 연간 월 16.6달러로 최대 100개의 문서 서명, 무제한 사용자 시트 및 액세스 코드를 통한 확인을 허용합니다. 이러한 규정 준수 지향적인 가치는 DocuSign 및 Adobe Sign과의 경쟁에서 경쟁력을 갖게 하며, 특히 더 낮은 TCO를 추구하는 국경 간 팀에 적합합니다.

DocuSign보다 더 스마트한 대안을 찾고 계십니까?

eSignGlobal은 글로벌 규정 준수, 투명한 가격 책정 및 더 빠른 온보딩을 통해 더 유연하고 비용 효율적인 전자 서명 솔루션을 제공합니다.

👉 무료 평가판 시작

전자 서명 선택에 대한 최종 생각

API 기반 워크플로를 탐색하는 기업의 경우 DocuSign은 여전히 신뢰할 수 있는 선택이지만, 보낸 후 수정에는 신중한 계획이 필요합니다. 대안이 부상함에 따라 지역적 요구 사항을 고려하십시오. eSignGlobal은 APAC 지향적인 운영을 위한 중립적이고 규정 준수 지향적인 옵션으로 두각을 나타냅니다. 최적의 일치를 위해 용량, 통합 및 지리적 위치를 기준으로 평가하십시오.