DocuSign API: 진행 중인 봉투의 만료 날짜를 업데이트하는 방법?

DocuSign API에서 봉투 관리 이해하기

디지털 계약이 빠르게 발전하는 세상에서 진행 중인 (또는 “진행 중인”) 봉투를 관리하는 것은 전자 서명 워크플로의 중요한 측면입니다. 기업은 종종 서명자의 응답 지연, 협상 연장 또는 프로젝트 일정 변경으로 인해 봉투 만료 날짜를 조정해야 하는 상황에 직면합니다. DocuSign의 API는 이를 가능하게 하는 강력한 도구를 제공하여 개발자가 프로세스를 중단하지 않고도 규정 준수 및 효율성을 유지할 수 있도록 합니다. 이 기사에서는 전자 서명 시장의 비즈니스 관점에서 영향 및 대안을 논의하면서 DocuSign API를 사용하여 진행 중인 봉투의 만료 날짜를 업데이트하는 방법을 살펴봅니다.

진행 중인 봉투에서 만료 날짜를 업데이트해야 하는 이유는 무엇입니까?

DocuSign 봉투의 만료 날짜는 설정된 기간 후 서명되지 않은 문서를 자동으로 만료시켜 민감한 정보를 보호하고 적시 완료를 보장하는 안전 장치 역할을 합니다. 그러나 실제 비즈니스 운영에서는 엄격한 마감일로 인해 불필요한 만료가 발생하여 재전송이 필요하고 관리 오버헤드 및 잠재적 비용이 증가할 수 있습니다. 비즈니스 관점에서 API를 통해 이러한 날짜를 연장하는 기능은 리소스 할당을 최적화하고 봉투 수수료를 줄이며 (사용하지 않은 봉투도 할당량에 포함됨) 서명자 만족도를 높이는 데 도움이 됩니다. 이는 부동산, 인사 및 금융과 같은 대용량 산업에서 중요한 요소입니다.

DocuSign의 설계는 보안 및 감사 가능성을 우선시하므로 진행 중인 봉투의 만료 날짜를 업데이트하는 것이 항상 간단하지는 않습니다. 변조를 방지하기 위해 생성 후 핵심 봉투 속성을 직접 수정하는 것은 제한됩니다. 대신 API는 수정 또는 무효화 후 재작성과 같은 간접적인 방법을 지원합니다. 이 접근 방식은 미국 ESIGN 법률 및 EU eIDAS 표준 준수와 같은 DocuSign의 규정 준수 중시와 일치하며 변경 사항이 법적 방어를 위해 기록되도록 보장합니다.

단계별 가이드: DocuSign API를 통해 만료 날짜 업데이트

이 문제를 해결하기 위해 개발자는 일반적으로 OAuth 2.0 (JWT 또는 권한 부여 코드 부여)을 통해 인증해야 하는 DocuSign eSignature REST API (버전 2.1 이상)를 사용합니다. API 액세스 권한이 있는 개발자 계정이 있다고 가정합니다. 가격은 Starter 플랜의 경우 연간 600달러부터 시작하며 매달 약 40개의 봉투가 포함됩니다. 다음은 실용적인 연습입니다.

1. 봉투 상태 검색

먼저 봉투가 진행 중인 상태인지 확인합니다 (상태: “sent” 또는 “in progress”). GET /accounts/{accountId}/envelopes/{envelopeId} 엔드포인트를 사용합니다.

예제 요청 (cURL):

curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Accept: application/json"

응답 조각:

{
  "status": "sent",
  "expireDateTime": "2025-01-15T12:00:00Z",
  "envelopeId": "abc123"
}

이렇게 하면 현재 만료 날짜가 가져옵니다. 상태가 “voided” 또는 "completed"인 경우 업데이트할 수 없습니다. 봉투를 다시 만들어야 합니다.

2. 봉투 수정 (사소한 변경에 선호되는 방법)

서명자가 아직 작업을 수행하지 않은 진행 중인 봉투의 경우 PUT /accounts/{accountId}/envelopes/{envelopeId}를 수정 요청과 함께 사용합니다. 만료 날짜를 업데이트하기 위해 단일 필드를 직접 편집하는 것은 지원되지 않지만 새 날짜로 무효화하고 다시 보내거나 “수정” 기능을 사용하여 간접적으로 타이머를 재설정할 수 있습니다.

DocuSign의 수정 API를 사용하면 서명이 발생하지 않은 경우 만료 날짜와 같은 특정 속성을 수정할 수 있습니다. 수정 봉투 정의를 준비합니다.

수정 요청 본문 (JSON):

{
  "status": "sent",
  "expireAfter": "30",  // 지금부터의 일수; 필요에 따라 조정 (최대 999일)
  "expireDateTime": "2025-02-15T12:00:00Z"  // 또는 절대 날짜 지정
}

cURL 예제:

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/correct" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "clientUserId": "signer1",
  "routingOrder": "1",
  "corrector": {
    "email": "admin@company.com",
    "userId": "{userId}"
  },
  "envelopeDefinition": {
    "expireAfter": "60"
  }
}'

이렇게 하면 만료 날짜가 60일 연장됩니다. 참고: 수정하려면 봉투를 수정할 수 있어야 하며 (완료된 탭 없음) 변경 사항을 서명자에게 알릴 수 있으므로 감사 추적이 유지됩니다.

3. 무효화 후 재전송 (복잡한 업데이트에 적합)

봉투가 부분적으로 진행 중이거나 직접 편집이 차단된 경우 먼저 무효화한 다음 업데이트된 만료 날짜로 다시 만듭니다. 이는 규정 준수 위험을 피하기 위해 기업 워크플로에서 일반적입니다.

3a단계: 봉투 무효화

curl -X PUT "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{
  "status": "voided",
  "voidedReason": "Extending expiration for ongoing negotiations"
}'

3b단계: 새 정의로 다시 보내기 POST /accounts/{accountId}/envelopes를 사용하여 원래 문서와 수신자를 복사하되 새 expireAfter 또는 expireDateTime을 설정하여 다시 만듭니다.

새 봉투 요청 본문:

{
  "emailSubject": "Updated Agreement",
  "documents": [ /* Original docs */ ],
  "recipients": [ /* Original signers */ ],
  "expireAfter": "90",  // 새 90일 만료
  "status": "sent"
}

cURL:

curl -X POST "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes" \
-H "Authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d '{ /* Full envelope definition with updated expiration */ }'

4. 모범 사례 및 제한 사항

• 할당량 및 비용: 각 무효화/재전송은 봉투 제한에 포함됩니다 (Business Pro 플랜의 경우 사용자당 연간 약 100개, 가격은 사용자당 연간 480달러). API를 통해 대시보드를 사용하여 초과를 방지합니다.
• 오류 처리: 일반적인 문제는 400 Bad Request (잘못된 상태) 또는 401 Unauthorized입니다. 코드에서 try-catch를 사용합니다 (예: Node.js 또는 Python SDK).
• 보안: 모든 변경 사항은 봉투의 감사 추적에 기록되어 SSO 및 Enhanced 플랜의 고급 액세스 제어와 같은 DocuSign의 IAM 기능을 지원합니다.
• 테스트: 샌드박스 환경 (개발자에게 무료)은 프로덕션 전에 이상적입니다.

비즈니스 관점에서 이 프로세스는 운영을 간소화하지만 API 가격 책정 계층을 강조합니다. Advanced 플랜 (연간 5760달러)은 대량 전송 및 자동화를 위한 웹후크를 잠금 해제하여 수동 개입을 줄입니다.

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

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

👉 무료 평가판 시작

DocuSign의 더 넓은 생태계 및 IAM 기능

API를 포함한 DocuSign의 eSignature 플랫폼은 보안을 강화하기 위해 ID 및 액세스 관리 (IAM) 도구와 원활하게 통합됩니다. DocuSign의 IAM에는 SSO 통합 (예: Okta 또는 Azure AD), 역할 기반 액세스 제어 및 다단계 인증이 포함되며 이는 엔터프라이즈급 배포에 필수적입니다. 이러한 기능은 Enhanced 플랜 (50명 이상의 사용자를 위한 맞춤형 가격 책정)에서 사용할 수 있으며 만료 날짜 변경과 같은 API 기반 업데이트가 민감한 데이터를 노출하지 않고 글로벌 표준을 준수하도록 보장합니다. 가격은 Personal 플랜의 경우 연간 120달러부터 엔터프라이즈 맞춤형 플랜까지 DocuSign은 확장성을 강조하지만 SMS 전송 또는 ID 확인과 같은 추가 기능에는 추가 비용이 발생할 수 있습니다.

경쟁 환경: 전자 서명 플랫폼 비교

전자 서명 시장은 경쟁이 치열하며 DocuSign은 전 세계 채택 측면에서 선두를 달리고 있지만 지역적 요구 사항으로 인해 대안이 추진되고 있습니다. 다음은 가격, 기능 및 규정 준수를 기반으로 한 주요 플랫폼의 중립적 비교입니다 (2025년 데이터; 실제 값은 다를 수 있음).

이 표는 강력한 API 기능에서 DocuSign의 탁월함을 강조하지만 성장하는 팀에게는 더 비쌀 수 있으며 다른 플랫폼은 유연성을 제공합니다.

Adobe Sign: PDF 중심의 대안

Adobe Document Cloud의 일부인 Adobe Sign은 Acrobat과 같은 PDF 도구와의 심층적인 통합으로 두각을 나타내며 문서 집약적인 워크플로에 매우 적합합니다. 만료 변경에는 일반적으로 프로토콜 수정이 필요하지만 프로토콜 수정을 위한 엔드포인트가 있는 DocuSign과 유사한 API 업데이트를 지원합니다. 가격은 경쟁력이 있으며 개인 버전은 월 10달러부터 시작하여 조건부 필드 및 지불과 같은 기능이 있는 엔터프라이즈 맞춤형 플랜으로 확장됩니다. 그러나 크리에이티브 산업에서 빛을 발하지만 Adobe 사용자가 아닌 경우 번들로 느껴질 수 있습니다.

HelloSign: 중소기업을 위한 간편함

현재 Dropbox Sign인 HelloSign은 빠른 템플릿 생성과 고급 계층의 무제한 전송을 통해 사용자 친화적인 인터페이스를 우선시합니다. API를 통해 업데이트 호출을 통해 만료 날짜를 연장하는 것을 포함하여 봉투를 수정할 수 있지만 대량 작업에서 DocuSign의 깊이가 부족합니다. 시작 가격은 월 15달러이며 중소기업에 적합하며 엔터프라이즈 규정 준수보다는 원활한 Dropbox 동기화에 중점을 둡니다.

eSignGlobal: 지역 규정 준수 리더

eSignGlobal은 100개 이상의 주요 국가 및 지역에서 규정을 준수하고 아시아 태평양 지역에서 강력한 입지를 확보하여 글로벌 경쟁자로 자리매김하고 있습니다. 이 지역의 규정은 파편화되어 있고 표준이 높으며 감독이 엄격합니다. 미국/EU의 프레임워크 ESIGN/eIDAS와 달리 아시아 태평양 지역에는 “생태계 통합” 솔루션이 필요합니다. 이는 서양에서 흔히 볼 수 있는 이메일 확인 또는 자기 선언 모드를 훨씬 능가하는 정부 디지털 ID (G2B)와의 심층적인 하드웨어/API 통합을 의미합니다. eSignGlobal은 이 분야에서 탁월하며 법적 효력이 있는 서명을 위해 홍콩의 iAM Smart 및 싱가포르의 Singpass를 원활하게 통합합니다.

가격은 경쟁력이 있으며 Essential 플랜은 연간 청구 시 월 16.6달러에 불과하며 최대 100개의 전자 서명 문서, 무제한 사용자 좌석 및 액세스 코드 확인을 허용합니다. 이 모든 것이 규정 준수를 기반으로 구축되었습니다. 이 좌석 비용 없는 모델은 팀에 높은 가치를 제공하며 위험 평가 및 번역을 위한 AI 도구가 장착되어 있습니다. 미국/EU로 확장됨에 따라 eSignGlobal은 추가 개발자 플랜 없이 대량 전송을 포함하여 더 낮은 비용과 더 빠른 아시아 태평양 성능으로 DocuSign 및 Adobe Sign과 같은 기존 플레이어에 도전합니다.

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

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

👉 무료 평가판 시작

비즈니스 통찰력 및 최종 생각

API를 통해 진행 중인 봉투를 관리하는 것은 전자 서명 분야의 더 광범위한 추세를 반영합니다. 자동화는 효율성을 높이지만 규정 준수 및 비용이 선택을 결정합니다. DocuSign의 API는 업데이트에 매우 강력하지만 좌석 기반 모델과 아시아 태평양 과제로 인해 대안을 모색하게 됩니다.

DocuSign 대안을 찾는 사용자의 경우 eSignGlobal은 특히 글로벌 요구 사항과 비용 절감을 균형 있게 유지하는 아시아 태평양 운영에 적합한 중립적이고 지역 규정을 준수하는 옵션으로 두각을 나타냅니다. 워크플로 양과 지리적 위치에 따라 평가하십시오.