DocuSign API: 이메일 알림 없이 봉투를 무효화하는 방법

DocuSign API 및 봉투 관리 소개

디지털 문서 워크플로가 끊임없이 진화하는 환경에서 DocuSign의 API는 개발자가 전자 서명 기능을 비즈니스 애플리케이션에 통합할 수 있도록 지원하는 강력한 도구로 부상했습니다. 서명할 문서를 캡슐화하는 봉투(Envelopes)는 이 생태계의 핵심이며, 생성부터 완료까지 계약을 원활하게 관리할 수 있도록 합니다. 그러나 어떤 경우에는 봉투를 취소해야 합니다. 즉, 서명 프로세스 전이나 도중에 오류를 수정하거나 변화하는 비즈니스 요구 사항에 맞춰야 합니다. API 사용자에게 중요한 과제는 알림을 제어하는 것, 특히 수신자를 혼란스럽게 할 수 있는 원치 않는 이메일 알림을 피하는 것입니다. 이 문서는 공식 문서 및 실제 구현 통찰력을 참조하여 중단을 최소화하면서 DocuSign API를 통해 봉투를 취소하는 메커니즘을 살펴봅니다.

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

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

👉 무료 평가판 시작

DocuSign에서 봉투 취소: 핵심 개념

DocuSign에서 봉투란 무엇입니까?

DocuSign에서 봉투는 하나 이상의 문서, 수신자 및 서명 지침을 포함하는 완전한 패키지를 나타냅니다. API를 통해 개발자는 이러한 봉투를 프로그래밍 방식으로 생성, 전송 및 관리할 수 있습니다. 봉투를 취소하면 사실상 무효화되어 서명과 같은 추가 작업을 수행할 수 없습니다. 이는 거래 실패 또는 문서 수정이 필요한 경우와 같이 비즈니스 프로세스에서 매우 유용하여 불완전하거나 잘못된 프로세스가 계속 진행되는 것을 방지합니다.

DocuSign의 REST API(버전 2.1)는 voidEnvelope 메서드를 포함하여 봉투 작업을 위한 엔드포인트를 제공합니다. 기본적으로 취소는 모든 수신자에게 알림을 트리거하여 취소에 대해 이메일로 알립니다. 이는 투명성을 보장하지만 자동화된 시스템이나 사전 알림 내부 수정에는 적합하지 않을 수 있습니다.

기본 취소 프로세스 및 알림 동작

DocuSign API를 사용하여 봉투를 취소하려면 일반적으로 /envelopes/{envelopeId}/void 엔드포인트로 PUT 요청을 보냅니다. 다음은 DocuSign eSignature SDK를 사용하는 Python의 기본 예입니다.

from docusign_esign import ApiClient, EnvelopesApi

# API 클라이언트 초기화
api_client = ApiClient()
api_client.host = 'https://demo.docusign.net/restapi'
api_client.set_default_header('Authorization', 'Bearer YOUR_ACCESS_TOKEN')

envelopes_api = EnvelopesApi(api_client)

# 봉투 취소
void_request = {
    'status': 'voided',
    'voidedReason': 'Document needs revision before sending'
}

envelopes_api.update_envelope_status(
    account_id='YOUR_ACCOUNT_ID',
    envelope_id='ENVELOPE_ID',
    envelope=None,  # Not required for void
    void_uri=void_request
)

이 표준 프로세스에서 DocuSign은 자동으로 봉투에 나열된 수신자에게 이메일 알림을 보내 취소 상태 및 이유를 자세히 설명합니다. 이러한 이메일에는 취소 이유가 포함되어 있으며 참조용으로 봉투에 대한 링크가 포함될 수 있습니다. DocuSign의 개발자 가이드에 따르면 이는 감사 추적 및 사용자 인식을 유지하기 위해 예상되는 동작이며 ESIGN 및 eIDAS와 같은 규정 준수 표준을 준수합니다.

그러나 CRM 통합 또는 일괄 처리 도구와 같은 API 기반 애플리케이션의 경우 이러한 이메일을 보내면 받은 편지함이 복잡해지거나 내부 변경 사항이 너무 일찍 노출될 수 있습니다. 좋은 소식은 DocuSign을 통해 이러한 알림을 억제하여 보다 제어된 경험을 제공할 수 있다는 것입니다.

이메일 알림을 보내지 않고 봉투를 취소하는 방법

취소 프로세스 중에 이메일 알림을 억제하려면 취소 API 호출 자체에 직접적인 “no-notify” 플래그가 없기 때문에 봉투 또는 계정 수준에서 미리 구성해야 합니다. 이 전략에는 DocuSign의 알림 설정 및 수신자 역할을 활용하여 외부 통신을 최소화하는 것이 포함됩니다. 이 방법은 봉투 수가 많고 자동화가 중요한 Business Pro 또는 Advanced API 수준을 사용하는 엔터프라이즈 사용자에게 특히 유용합니다.

1단계: 봉투 알림 기본 설정 구성

봉투를 생성하거나 보내기 전에 API를 통해 알림 규칙을 설정합니다. 봉투 정의에서 notification 객체를 사용하여 취소를 포함한 상태 변경에 대한 수신자의 이메일을 비활성화합니다. Envelopes API의 createEnvelope 엔드포인트에 다음을 포함합니다.

{
  "notification": {
    "reminders": {
      "reminderDelay": 0,
      "reminderOffset": 0,
      "reminderFrequency": "none"
    },
    "expirations": {
      "expireAfter": 0,
      "expireWarn": 0
    },
    "recipientEmailNotification": {
      "emailSubject": "",
      "emailBlurb": "",
      "emailBody": ""
    }
  }
}

recipientEmailNotification 블록은 비워 두거나 기본값을 억제하도록 설정할 수 있습니다. 특정 제어를 취소하려면 봉투가 “초안” 상태(status: 'sent' = false)로 생성되었는지 확인하여 초기 알림 없이 취소할 수 있습니다. 초안에서 취소되면 알림이 비활성화된 경우 이메일이 트리거되지 않습니다.

2단계: 초안 상태에서 취소

초안 모드에서 봉투를 취소하면(보내기 전에) 수신자가 아직 알림을 받지 못했기 때문에 본질적으로 알림을 피할 수 있습니다. 동일한 update_envelope_status 호출을 사용하되 초안 봉투에 대해 사용합니다.

# 초안으로 봉투 생성
envelope_definition = {
    'status': 'created',  # 초안 모드
    'emailSubject': 'Internal Review Document',
    'documents': [...],  # 문서
    'recipients': {
        'signers': [...]  # 정의되었지만 아직 알리지 않음
    },
    'notification': {  # 모두 억제
        'recipientEmailNotification': {}
    }
}

envelopes_api.create_envelope(account_id='YOUR_ACCOUNT_ID', envelope_definition=envelope_definition)

# 나중에 보내지 않고 취소
void_request = {'status': 'voided', 'voidedReason': 'Internal correction'}
envelopes_api.update_envelope_status(account_id='YOUR_ACCOUNT_ID', envelope_id='DRAFT_ENVELOPE_ID', void_uri=void_request)

이 방법을 사용하면 취소 프로세스 중에 이메일이 전송되지 않습니다. 진행 중인 봉투(이미 보낸 봉투)의 경우 먼저 correct API를 사용하여 초안으로 다시 가져온 다음 취소합니다. allowReassign: false 및 빈 알림 필드를 사용하여 수정 요청에서 알림을 억제합니다.

3단계: 계정 수준 및 고급 구성

더 광범위한 제어를 위해 Enhanced 또는 Enterprise 플랜에서 사용할 수 있는 DocuSign의 ID 및 액세스 관리(IAM) 기능을 통합합니다. IAM을 사용하면 Connect API의 웹후크를 통해 이벤트 알림을 사용자 지정하여 취소 이벤트를 이메일 대신 서버로 라우팅할 수 있습니다. Connect 구성 설정:

• 엔드포인트: /accounts/{accountId}/connect
• 이메일 전달을 제외하고 “voided” 상태에 대한 envelopeEvents를 포함합니다.

또한 API 플랜(Starter는 연간 $600 또는 Advanced는 연간 $5,760)의 경우 웹후크를 활용하여 취소를 자동으로 처리합니다. connect 리스너를 모니터링하여 취소 이벤트를 확인하고 DocuSign 기본 이메일을 트리거하지 않고 내부적으로 응답합니다.

모범 사례 및 제한 사항

• 테스트: 프로덕션 취소는 되돌릴 수 없으므로 DocuSign의 데모 환경을 사용하여 프로세스를 확인합니다.
• 규정 준수: 알림 억제는 내부 취소에 적합하지만 감사 로그가 규제 요구 사항을 충족하기 위해 이유를 캡처하는지 확인합니다.
• 할당량: API 플랜은 봉투 수를 제한하므로(예: Intermediate는 월 100개) 효율적인 취소는 할당량을 유지하는 데 도움이 됩니다.
• 예외적인 경우: 봉투가 부분적으로 서명된 경우 미리 구성하지 않으면 취소로 인해 해당 서명자에게 알림이 전송될 수 있습니다.

이 기술은 API 통합을 간소화하고 대용량 시나리오에서 작동 소음을 줄입니다. 비즈니스 관점에서 볼 때 CRM 또는 ERP 시스템에 DocuSign API를 사용하는 팀의 효율성을 향상시키지만 사전 계획이 필요합니다.

경쟁 환경: 전자 서명 플랫폼 개요

DocuSign은 핵심 서명을 위한 eSignature와 엔드 투 엔드 계약 처리를 위한 CLM(계약 수명 주기 관리)을 포함한 포괄적인 API 제품군으로 전자 서명 시장을 선도하고 있습니다. CLM은 AI 기반 통찰력, 템플릿 관리 및 분석을 통합하여 복잡한 계약을 관리하는 기업에 적합합니다. 가격은 Personal의 경우 월 $10부터 시작하지만 API 집약적 사용을 위해 사용자 지정 Enterprise로 확장되며 인증과 같은 추가 기능에 대한 사용량 기반 비용이 추가됩니다.

Adobe Sign(현재 Adobe Acrobat Sign)은 강력한 PDF 통합 및 모바일 서명을 통해 Adobe의 문서 생태계를 보완합니다. 자동화를 위한 API 액세스를 제공하며 유사한 REST 엔드포인트를 통해 취소를 지원하지만 Adobe의 독점적인 알림 제어가 있습니다. 플랜은 Individual의 경우 사용자당 월 $10부터 Enterprise의 경우 사용자당 월 $40까지이며 Creative Cloud 도구와의 원활한 워크플로를 강조합니다. 그러나 대용량 사용자의 경우 API 할당량이 고급 업그레이드 없이는 제한적일 수 있습니다.

eSignGlobal은 100개의 주요 국가 및 지역에서 규정을 준수하는 글로벌 경쟁자로 자리매김하고 있으며 특히 아시아 태평양(APAC) 지역에서 강점을 보입니다. APAC의 전자 서명 환경은 미국/EU의 ESIGN/eIDAS 프레임워크 표준과 대조적으로 파편화되고 높은 기준과 엄격한 규정을 제시합니다. APAC에서 솔루션은 정부 대 기업(G2B) 디지털 ID와의 심층적인 하드웨어/API 수준의 도킹을 포함하는 “생태계 통합” 접근 방식이 필요합니다. 이는 서양에서 흔히 볼 수 있는 이메일 기반 또는 자체 신고 방법의 기술적 장벽을 훨씬 뛰어넘습니다. eSignGlobal은 강력한 검증을 위해 홍콩의 iAM Smart 및 싱가포르의 Singpass와 원활하게 통합되어 이 분야에서 탁월합니다. Essential 플랜은 월 $16.6에 최대 100개의 문서, 무제한 사용자 시트 및 액세스 코드 검증을 허용하여 규정 준수 기반에서 강력한 가치를 제공하면서 경쟁사보다 가격이 저렴합니다. 이 플랫폼은 DocuSign 및 Adobe Sign의 실행 가능한 대안으로 글로벌 시장(미국 및 EU 포함)으로 적극적으로 확장하고 있습니다.

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

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

👉 무료 평가판 시작

HelloSign(현재 Dropbox Sign)은 단순성에 중점을 두고 있으며 사용자 지정 설정을 통해 알림 억제를 허용하는 취소 옵션을 포함하여 봉투 관리를 위한 직관적인 API를 제공합니다. 무료(제한적)부터 사용자당 월 $20(Essentials)까지의 플랜으로 SMB에 적합하지만 고급 IAM과 같은 엔터프라이즈급 기능이 부족합니다.

이 비교는 절충점을 강조합니다. DocuSign은 깊이에서 탁월하고 eSignGlobal과 같은 대안은 지역적 이점을 제공합니다.

전자 서명 구현의 지역적 뉘앙스

DocuSign API는 전 세계적으로 액세스할 수 있지만 지역적 차이가 채택에 영향을 미칠 수 있습니다. APAC에서는 앞서 언급한 바와 같이 더 엄격한 데이터 상주 및 인증 규칙으로 인해 현지화된 솔루션에 대한 필요성이 증폭됩니다. 기업은 취소 프로세스가 법적 무결성을 유지하는지 확인하기 위해 현지 법률에 따라 API 동작을 평가해야 합니다.

결론적으로 알림 없는 취소를 위한 DocuSign의 API를 마스터하면 효율적인 워크플로를 지원할 수 있습니다. 대안을 찾는 사람들에게 eSignGlobal은 특히 APAC 지향적인 운영에 적합한 중립적이고 지역적으로 규정을 준수하는 옵션으로 고려할 가치가 있습니다.